Re: sgml tool

Started by Thomas Lockhartalmost 27 years ago4 messageshackersdocs
Jump to latest
#1Thomas Lockhart
lockhart@alumni.caltech.edu
hackersdocs

Thomas, can you check this out and let me know if it helps you with
conversion:
http://xtalk.price.ru/SGML/TEItools/index-en.html

Looks like a possibility, but I didn't see direct *roff support.

I started looking at docbook2man, and got good initial results after
fixing some bugs/problems. There are still some things to fix of
course (like the file name which is generated), but look at these two
sample man pages. For some reason, the ABORT man page puts double
quotes around some headers, but the SELECT page looks better...

- Thomas

--
Thomas Lockhart lockhart@alumni.caltech.edu
South Pasadena, California

Attachments:

ABORT.text/plain; charset=us-ascii; name=ABORT.Download
SELECT.text/plain; charset=us-ascii; name=SELECT.Download
#2Bruce Momjian
bruce@momjian.us
In reply to: Thomas Lockhart (#1)
hackersdocs

Thomas, can you check this out and let me know if it helps you with
conversion:
http://xtalk.price.ru/SGML/TEItools/index-en.html

Looks like a possibility, but I didn't see direct *roff support.

I started looking at docbook2man, and got good initial results after
fixing some bugs/problems. There are still some things to fix of
course (like the file name which is generated), but look at these two
sample man pages. For some reason, the ABORT man page puts double
quotes around some headers, but the SELECT page looks better...

Wow, that select manual page does look good.

-- 
  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, Pennsylvania 19026
#3Thomas Lockhart
lockhart@alumni.caltech.edu
In reply to: Bruce Momjian (#2)
hackersdocs

Wow, that select manual page does look good.

OK, here is a first cut at new man pages. Things aren't perfect and
need improving, but this is a good start.

I'll be going through the ref/*.sgml files to change formatting which
seems to give docbook2man trouble. I'll also be massaging docbook2man
to fix up its behavior. A few man pages weren't generated at all, but
the symptom was similar to things I've already fixed so I think that I
can fix these too.

After I've gotten these things done, then we should think about taking
the existing old man page content and making sure that it is all in
the sgml files somewhere (not everything should stay in the reference
pages, but it should show up somewhere: ref pages, User's Guide, or
Admin Guide are likely candidates).

We'll have new man pages for v6.6!

- Thomas

--
Thomas Lockhart lockhart@alumni.caltech.edu
South Pasadena, California

Attachments:

man.tar.gzapplication/gzip; name=man.tar.gzDownload+1-0
#4Thomas Lockhart
lockhart@alumni.caltech.edu
In reply to: Bruce Momjian (#2)
hackersdocs

(enclosure bounced, so posting the tar file on the patches list
instead)

Wow, that select manual page does look good.

OK, here is a first cut at new man pages. Things aren't perfect and
need improving, but this is a good start.

I'll be going through the ref/*.sgml files to change formatting which
seems to give docbook2man trouble. I'll also be massaging docbook2man
to fix up its behavior. A few man pages weren't generated at all, but
the symptom was similar to things I've already fixed so I think that I
can fix these too.

After I've gotten these things done, then we should think about taking
the existing old man page content and making sure that it is all in
the sgml files somewhere (not everything should stay in the reference
pages, but it should show up somewhere: ref pages, User's Guide, or
Admin Guide are likely candidates).

We'll have new man pages for v6.6!

- Thomas

--
Thomas Lockhart lockhart@alumni.caltech.edu
South Pasadena, California