Bug#51116: Suggestion: Packages should carry a manpage

[Goswin Brederlow <goswin.brederlo@student.uni-tuebingen.de>]

Package: debian-policy
Version: 3.1.1.0
Severity: wishlist

Policy says that any binary must come with a manpage. I would like to have
the same for packages.

I just looked for a parser generator that outputs C++ code and found pccts.
After installation I tried "man pccts", but that failed.
/usr/doc/pccts doesn't contain examples, so how do I use the thing?

pccts in fact contains several binaries, but non is called pccts. The main
binary is called antlr and has a good manpage.

My suggestion is now, that "man pccts" should eigther point to the main
binarys manpage or show a page that gives a oneline description of the 
binaries of the package or one that has just relevant "see also: xxx" entries.

What do you think?

May the Source be with you.
			Goswin


-- System Information
Debian Release: potato
Architecture: i386
Kernel: Linux mrvnbook 2.2.12 #2 Sat Nov 6 15:01:17 CET 1999 i686