Feature proposal: New, Standard Documentation System

Michael Cronenworth mike at cchtml.com
Mon Dec 1 01:45:31 UTC 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.




More information about the devel mailing list