viewing Docbook files?
eric at brouhaha.com
Wed Jan 12 02:49:17 UTC 2005
The kernel-doc package provides a bunch of documentation in the
Documentation/DocBook directory as .tmpl files. I'm trying to figure
out how to view them. They come up fine in an editor as SGML, but
I want to see the formatted result. Nautilus seems to know that they're
DocBook files (judging by the icon it uses), but doesn't seem to know
what to view them with. A Google search turned up a posting that suggested
that yelp knows how to view them, but when I load them with yelp it just
shows me the raw SGML, just as gedit does.
I see that the docbook-utils package includes docbook2ps. Sounds promising.
I read the man page on docbook2ps, and it indicates that there should also
be a docbook2pdf, but that doesn't appear to actually be in the package.
It goes on to say that it is just a wrapper for jw. So I try
"jw -b pdf usb.tmpl", and out pops a usb.tex file. Hmmm. Next I try
"docbook2ps usb.tmpl", thinking that I will be able to run the Postscript
output through ps2pdf. But out pops a usb.tex file again. No error
message or warning about anything being missing. I do have tetex,
tetex-dvips, tetex-latex, tetex-fonts, and jadetex installed; is there
something else jw needs to finish the process?
Surely there must be an easier way?
Thanks for any advice!
More information about the users