List Archive: gentoo-dev
Note: Due to technical difficulties, the Archives are currently not up to date.
provides an alternative service for most mailing lists.c.f. bug 424647
I tried to convert our ebuild man pages to Linux Doc style first, but I
found that it misses too much of the
docbook stuff and is only usefull for small howto's.
So I decided to use sgml-docbook-dtd-4.1 for my tests.
There are three new files in gentoo-doc/files.
ebuild.sgml The Book
refentry/ebuild-1.sgml The ebuild(1) man page sgmlized
refentry/ebuild-5.sgml The ebuild(5) man page
If you have a working docbook environment you can make html, pdf and man
output from that (texi makes problems , others should work).
If you run "docbook2man ebuild.sgml" you will get the two man pages
ebuild.1 and ebuild.2 without the other
If you run "docbook2html ebuild.sgml" you will get a bunch of html pages
index.html contains the TOC.
Give "docbook2pdf ebuild.sgml" a try and open ebuild.pdf with acroread.
You will see that you have a nice toc
in there too.
Assuming you have updated kdelibs to the version that installs docbook
stuff in /usr/share/sgml, you can
even run "kdb2html ebuild.sgml".
The result will be a dir called HTML with a bunch of html's, that fit
perfectly into kde's documentation.
Please guys give this stuff a try and me feedback. !