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

Bug#39830: [AMENDMENT]: get rid of undocumented(7) symlinks



On Wed, Oct 30, 2002 at 01:56:35PM +0000, Mark Brown wrote:
> On Wed, Oct 30, 2002 at 11:09:25AM +0000, Colin Watson wrote:
> > +	  To avoid duplicate bug reports about missing manual pages,
> > +	  you should inform the user that you know about the missing
> > +	  manual page in
> > +	  <file>/usr/share/doc/<var>package</var>/TODO.Debian</file>.
> 
> Why not just remove this or add a note reminding users to check the BTS
> before filing bugs?  There's no great point in having that list in
> addition to BTS bugs, particularly when the list contains information
> that can readily be autogenerated.

Makes sense. If the maintainer wants to do that kind of thing, fine, but
it's up to them.

--- policy.sgml.orig	2002-10-30 16:13:24.000000000 +0000
+++ policy.sgml	2002-10-30 16:14:13.000000000 +0000
@@ -7476,22 +7476,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 must 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

-- 
Colin Watson                                  [cjwatson@flatline.org.uk]

Attachment: pgpv10ET2ywUn.pgp
Description: PGP signature


Reply to: