Thread: Docs

Docs

From
"Ansley, Michael"
Date:
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


RE: [HACKERS] Docs

From
Vince Vielhaber
Date:
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@michvhf.com    http://www.pop4.net  128K ISDN: $24.95/mo or less - 56K Dialup:
$17.95/moor less at Pop4       Online Campground Directory    http://www.camping-usa.com      Online Giftshop
Superstore   http://www.cloudninegifts.com
 
==========================================================================




Re: [HACKERS] Docs

From
Bruce Momjian
Date:
> 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@candle.pha.pa.us            |  (610)
853-3000+  If your life is a hard drive,     |  830 Blythe Avenue +  Christ can be your backup.        |  Drexel Hill,
Pennsylvania19026
 


Re: [HACKERS] Docs

From
Thomas Lockhart
Date:
> 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@alumni.caltech.edu
South Pasadena, California


Re: [HACKERS] Docs

From
Ed Loehr
Date:
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. :)



Re: [HACKERS] Docs

From
Thomas Lockhart
Date:
> > > 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@alumni.caltech.edu
South Pasadena, California


Re: [HACKERS] Docs

From
Ed Loehr
Date:
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



Re: [HACKERS] Docs

From
Thomas Lockhart
Date:
> 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@alumni.caltech.edu
South Pasadena, California