Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 61586 - All packages need man page to at least point to real documentation
Summary: All packages need man page to at least point to real documentation
Status: RESOLVED WONTFIX
Alias: None
Product: Gentoo Linux
Classification: Unclassified
Component: [OLD] Unspecified (show other bugs)
Hardware: All Linux
: High enhancement (vote)
Assignee: Gentoo Quality Assurance Team
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2004-08-24 18:39 UTC by Greg Slocum
Modified: 2004-10-01 19:01 UTC (History)
0 users

See Also:
Package list:
Runtime testing required: ---


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Greg Slocum 2004-08-24 18:39:16 UTC
We need a consistent documentation system.

Many packages have man pages.  Others have info system.  Still others have html in their own directories.  Still others have /usr/doc/*, and some others (like pxes) install their documentation somewhere where I can't find it.

The man system is tried, easy and true.  Everybody knows how to use it.  Most people don't know emacs, so any system based on that can't be the standard.

I propose this:  Every package in the build system must have a man page which at the very least tells where the real documentation is.

Thoughts?

Reproducible: Always
Steps to Reproduce:
1.
2.
3.
Comment 1 Ciaran McCreesh 2004-08-24 18:48:49 UTC
The GNU standard is info, not man...
Comment 2 Daniel Black (RETIRED) gentoo-dev 2004-10-01 19:01:19 UTC
feel free to add submissions against individual packaged however we don't have the resources to create info (or man) and support this idea.