On Tue, 12 Nov 2002, Colin Watson wrote: > --- policy.sgml.orig 2002-11-12 12:50:40.000000000 +0000 > +++ policy.sgml 2002-11-12 12:51:30.000000000 +0000 > @@ -7485,22 +7485,22 @@ > page included as well. > </p> > > - <p> > - If no manual page is available for a particular program, > - utility, function or configuration file and this is reported > - as a bug to the Debian Bug Tracking System, a symbolic link > - from the requested manual page to the <manref > - name="undocumented" section="7"> manual page may be > - provided. This symbolic link can be created from > - <file>debian/rules</file> like this: > - <example compact="compact"> > -ln -s ../man7/undocumented.7.gz \ > - debian/tmp/usr/share/man/man[1-9]/<var>requested_manpage</var>.[1-9].gz > - </example> > - This manpage claims that the lack of a manpage has been > - reported as a bug, so you may only do this if it really has > - (you can report it yourself, if you like). Do not close the > - bug report until a proper manpage is available.</p> > + <p> > + There should be a manual page at least for every program. If > + no manual page is available, this is considered as a bug and > + should be reported to the Debian Bug Tracking System (the > + maintainer of the package is allowed to write this bug report > + himself, too). Do not close the bug report until a proper > + manpage is available.<footnote> > + <p> > + It is not very hard to write a man page. See the <url > + id="http://www.schweikhardt.net/man_page_howto.html"; > + name="Man-Page-HOWTO">, <tt>man(7)</tt>, the examples > + created by <tt>debmake</tt> or <tt>dh_make</tt>, or the > + directory <file>/usr/share/doc/man-db/examples</file>. > + </p> > + </footnote> > + </p> > > <p> > You may forward a complaint about a missing manpage to the
Yes, undocumented(7) needs to die. Seconded.
yours,
peter
--
PGP signed and encrypted | .''`. ** Debian GNU/Linux **
messages preferred. | : :' : The universal
| `. `' Operating System
http://www.palfrader.org/ | `- http://www.debian.org/
pgpdenIILRqHA.pgp
Description: PGP signature
