RE: [HACKERS] Docs

Another question... how do people normally edit the docs? Is there an sgml
editor that I can use, or should I do it in some other format, and have it
converted, or what?

MikeA

On 03-Jan-00 Ansley, Michael wrote:
> Another question... how do people normally edit the docs? Is there an sgml
> editor that I can use, or should I do it in some other format, and have it
> converted, or what?

I use xemacs.

Vince.
--
==========================================================================
Vince Vielhaber -- KA8CSH email: vev(at)michvhf(dot)com http://www.pop4.net
128K ISDN: $24.95/mo or less - 56K Dialup: $17.95/mo or less at Pop4
Online Campground Directory http://www.camping-usa.com
Online Giftshop Superstore http://www.cloudninegifts.com
==========================================================================

> Another question... how do people normally edit the docs? Is there an sgml
> editor that I can use, or should I do it in some other format, and have it
> converted, or what?

They just use a standard text editor.

--
Bruce Momjian | http://www.op.net/~candle
maillist(at)candle(dot)pha(dot)pa(dot)us | (610) 853-3000
+ If your life is a hard drive, | 830 Blythe Avenue
+ Christ can be your backup. | Drexel Hill, Pennsylvania 19026

> Another question... how do people normally edit the docs? Is there an sgml
> editor that I can use, or should I do it in some other format, and have it
> converted, or what?

As Vince mentioned, xemacs is the first choice. Though I think I used
vi for a bunch of the original editing...

Check the appendix on "Documentation" for some hints on editing.

- Thomas

--
Thomas Lockhart lockhart(at)alumni(dot)caltech(dot)edu
South Pasadena, California

Thomas Lockhart wrote:

> > Another question... how do people normally edit the docs? Is there an sgml
> > editor that I can use, or should I do it in some other format, and have it
> > converted, or what?
>
> As Vince mentioned, xemacs is the first choice.

Now, don't go startin' no feud here... if you need a space shuttle, xemacs is
it. But if you need the One True Editor, well, of course...it's vi/vim. :)

> > > Another question... how do people normally edit the docs? Is there an sgml
> > > editor that I can use, or should I do it in some other format, and have it
> > > converted, or what?
> > As Vince mentioned, xemacs is the first choice.
> Now, don't go startin' no feud here... if you need a space shuttle, xemacs is
> it. But if you need the One True Editor, well, of course...it's vi/vim. :)

Michael wasn't asking for a space shuttle, but he *was* asking for "an
sgml editor", which implied to me an editor with some knowledge of
sgml notation. afaik The AntiEditor is the only freeware tool to do
this...

btw, xemacs is preferred over emacs since the xemacs "version 6"
implementation of DTD parsing can handle the DocBook DTD, whereas the
newer emacs "version 7" implementation barfs with some internal array
error when reading our docs after parsing the DTD. These are recent
results from my Mandrake/RedHat-6.1 Linux distro.

- Thomas

--
Thomas Lockhart lockhart(at)alumni(dot)caltech(dot)edu
South Pasadena, California

Thomas Lockhart wrote:

> > > > Another question... how do people normally edit the docs? Is there an sgml
> > > > editor that I can use, or should I do it in some other format, and have it
> > > > converted, or what?
> > > As Vince mentioned, xemacs is the first choice.
> > Now, don't go startin' no feud here... if you need a space shuttle, xemacs is
> > it. But if you need the One True Editor, well, of course...it's vi/vim. :)
>
> Michael wasn't asking for a space shuttle, but he *was* asking for "an
> sgml editor", which implied to me an editor with some knowledge of
> sgml notation. afaik The AntiEditor is the only freeware tool to do
> this...

Vim understands sgml notation to the extent of syntax highlighting.

http://relay.nuxi.com/vim/lang.html

I don't know what xemacs does for sgml.

It appears my attempt at a little late night humor was lost. Please pardon any
offense; it was unintended.

Cheers,
Ed Loehr

> Vim understands sgml notation to the extent of syntax highlighting.
> http://relay.nuxi.com/vim/lang.html
> It appears my attempt at a little late night humor was lost. Please
> pardon any offense; it was unintended.

Ah, we once again have proven to be a humorless lot ;)

Thanks for the tip regarding vim...

- Thomas

--
Thomas Lockhart lockhart(at)alumni(dot)caltech(dot)edu
South Pasadena, California