Re: Feature proposal: New, Standard Documentation System

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

 



2008/11/27 Michael Cronenworth <mike@xxxxxxxxxx>:
> 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

-- 
fedora-devel-list mailing list
fedora-devel-list@xxxxxxxxxx
https://www.redhat.com/mailman/listinfo/fedora-devel-list

[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[Index of Archives]     [Fedora Announce]     [Fedora Kernel]     [Fedora Testing]     [Fedora Formulas]     [Fedora PHP Devel]     [Kernel Development]     [Fedora Legacy]     [Fedora Maintainers]     [Fedora Desktop]     [PAM]     [Red Hat Development]     [Gimp]     [Yosemite News]
  Powered by Linux