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