This is the mail archive of the
mailing list for the DocBook project.
UNIX manpage -> DocBook -> manpage ?
- To: docbook at lists dot oasis-open dot org
- Subject: DOCBOOK: UNIX manpage -> DocBook -> manpage ?
- From: D dot Thomas at imb dot uq dot edu dot au (Danny Thomas)
- Date: Tue, 21 Dec 1999 15:31:00 +1000
- Reply-To: docbook at lists dot oasis-open dot org
This is my first contribution to the list. I haven't used or installed
DocBook stuff yet and am still waiting for my DocBook book to arrive, so
please be patient if this seems naive.
I'm wondering what is around to convert unix manpages into DocBook. Assume
the source manpages are cleanly and comprehensively marked up, BSD mandoc
While *roff macros are ultimately executed to effect physical formatting
(adding headers, handling indents, etc), the authors of mandoc realised
that the macro symbols themselves were a form of markup enabling relatively
easy conversion into other formats - provided the macros were restricted to
logical (structural) markup instead of physical formatting. At least that's
my reading of a section of the mandoc manpage.
However I have seen some manpages where nroff macros outside the mandoc set
have been used. For example, .br ocassionally used to produce a line break
within a paragraph being a table cell. Apart from the issue of whether any
manpage -> DocBook converter can handle this, does DocBook support such
concrete formatting amidst the logical markup ?
Also, standard mandoc does not include markup for url's but perhaps such
has been added? A single one for URL would handle email addresses too, such
as often used for manpage authors.
PS I also interested to know what conversions are available from DocBook to
mandoc manpages. I'm mainly interested in whether DocBook can be an
internal representation for holding manpages but also convertable to html,
pdf etc in perhaps better ways (eg HTML CSS) than the normal manpage
converters. The distinction is I'm not looking to convert arbitrary DocBook
to manpag, just the subset of DocBook likely to be produced from a manpage
-> DocBook conversion.