Missing where? [LWN.net]

Missing where?

Posted Sep 18, 2006 19:42 UTC (Mon) by kreutzm (guest, #4700)
In reply to: Missing where? by JLCdjinn
Parent article: A survey of the DocBook landscape

I use docbook2man to create man pages. You can read the entire problem including my patch and attempts to reach the author or Debian maintainer at my bug report regarding this issue.

The first of your items sounds interesting, but from a practical point of view (i.e. for applications I envisage) having all languages in one file does not look optimal. The second paragraph is exactly the one describing my problem. If there are better tools (not ideas) for transforming a docbook file to a man page I will certainly have a look. The third paragraph describes an issue I have not thought about. First, of course, as I speak english but secondly because I treat docbook like a programming language - you'll have to know the tags/keywords to get your work done. It's very interesting, though, that there are solutions for this, even. Hopefully it'll work even if documents are interchanged.

(Log in to post comments)

Missing where?

Posted Sep 18, 2006 21:56 UTC (Mon) by JLCdjinn (guest, #1905) [Link]

I use docbook2man to create man pages.
If there are better tools (not ideas) for transforming a docbook file to a man page I will certainly have a look.

Some casual poking around the Internet leads me to believe that the DocBook XSL stylesheets seem to be a better-supported solution than docbook2man. For example, I created a simple DocBook-formatted man page with the lang="ru" attribute set on the root element. I then ran xsltproc http://docbook.sourceforge.net/release/xsl/current/manpages/docbook.xsl manpage.docbook, and the resulting troff source contains Russian section headings (although I cannot speak at all to their accuracy, not being able to speak Russian and all). Any incompleteness or inaccuracy in a particular l10n should be fixed through the DocBook XSL stylesheets project.

Granted, after generating the UTF-8 troff source, I was unable to actually view the Russian headings in a formatted man page, but that's a different story...