[Xorg] DocBook SGML/XML manual pages...

[Roland Mainz]

Alan Coopersmith wrote:
> > I don't think there are imake rules to handle docbook files.  However, we
> > should start incorporating the autotool build files into the X.Org tree,
> > and we should certainly find a way to deal with docbook files in that
> > environment.
> >
> > Egbert suggested that perhaps we might like to create a common set of
> > autotool macros for us to share across multiple modules; perhaps rules for
> > docbook would be a good candidate for inclusion in that module.
> 
> It would be very good to just have one place to edit common rules like this.

There is already a small script in xc/config/docbook/docbookconv.sh
which tries to deal with the problem, e.g. DocBook--->man/troff and
DocBook--->HTML (e.g. not the braindead DocBook--->man--->HTML
conversion which completely kills tables and other more complex layout
stuff) ... the script would need some adjustments for the main Xorg
tree, the neccesary tools (incl. the DocBook/XSL stylesheets) need to be
imported into the xc/ tree and someone has to add Imake rules for
DocBookManPage--->man, DocBookManPage--->HTML and DocBookGeneric--->HTML
(for normal (non-unix manual page) DocBook documents).

> For instance, on Solaris, we probably don't want to convert docbook man pages
> to troff, but to the solbook subset of docbook that the Solaris man pages and
> commands use.

I wish the Solaris manual page subsystem would understand DocBook
directly without cutting it down to Solbook... :)
Is there already a DocBook--->SolBook converter script somewhere (and
the SolBook DTD needs to be added to the Xorg tree) ?

----

Bye,
Roland

-- 
  __ .  . __
 (o.\ \/ /.o) roland.mainz at nrubsig.org
  \__\/\/__/  MPEG specialist, C&&JAVA&&Sun&&Unix programmer
  /O /==\ O\  TEL +49 2426 901568 FAX +49 2426 901569
 (;O/ \/ \O;)