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