Docbook to Man pages

Dan McGarry it.psl at fsp.org.vu
Sun Aug 13 22:30:00 UTC 2006


Matthew East wrote:
> 
> Or to ship an ubuntu-server-docs package with the HTML files. Are you
> quite sure a "man page" is necessary, it sounds to me like more work
> than it is worth. I'm confident we can prepare HTML which looks good in
> a text based browser.

For a server installation, I'd suggest that man pages are highly 
desirable. They are the de facto standard for usage documentation on the 
  console.

Personally, I often measure the value of a utility based on the quality 
of its man page. I accept that anecdote is not the singular form of 
'data', but I know I'm not alone in this regard. 8^)

Second, the difference in effort is, if I understand correctly, entirely 
in the creation of the XSL file. Once that exists, you have an avenue 
not only for this document, but for any other that could be usefully put 
into man format. I think the benefits far outweigh the costs, even of a 
simple compromise.

My two vatu....

-- 
Dan McGarry	it.psl at fsp.org.vu

IT Consultant
Community Communications Project




More information about the ubuntu-doc mailing list