fedora-devel-list

[Prev] Thread [Next]  |  [Prev] Date [Next]

Re: Feature proposal: New, Standard Documentation System Michael Cronenworth Mon Dec 01 02:08:36 2008 

Gergely Buday wrote:

I think you cannot make each software package maintainer to use your
new tool. And, anyway, most people are fine with man pages. If there
is one...

But it is indeed possible to use modern tools to create textual
documentation. With xmlto you can create man pages (and other formats)
from the same docbook source. Yesterday I started using it and having
found a basic docbook xml source I was able to write a small man page
in two hours.

Now the documentation project is in favor of the Publican system,
which is yet unable to create man pages.

- Gergely


I'm not demanding this feature replace everything immediately.
Man pages, while informative, are limited. If examples or detailed information are required then you're back to Google searching. 

Two hours? I should hope to create something in 10 minutes.

--
fedora-devel-list mailing list
[EMAIL PROTECTED]
https://www.redhat.com/mailman/listinfo/fedora-devel-list