Feature proposal: New, Standard Documentation System

[Gergely Buday]

2008/11/27 Michael Cronenworth <mike at cchtml.com>:
> Far too often I find myself looking for non-existent man pages, Google
> results, or help menus in GNU/Linux software. What's the problem? There is
> no single, reliable, standardized documentation system that is universally
> accepted or appreciated. Yes, what I'm about to describe should obsolete
> man, info, and all the other dozen "help" documentation found in all the
> Fedora packages.

Hi Michael,

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