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

Bug#238958: doesn't use the term manpage consistently



tags 238958 +patch
stop

On Fri, 2004-03-19 at 20:59 +0000, Martin Michlmayr wrote:

> debian-policy uses the term "manpage" most of the time, but uses a
> different spelling, namely "man page" once.  It would be good if this
> would be replaced with "manpage" in order to be consistent.

Actually, I think that it would be better if the instances of "manpage"
were replaced with their two-word equivalents, instances of "man page."
I have attached a patch in that effect.
--- policy.sgml.ORIGINAL	2003-08-19 08:32:23.000000000 -0400
+++ policy.sgml	2004-03-19 17:54:50.000000000 -0500
@@ -1661,7 +1661,7 @@
 	      contact the <package>dpkg</package> maintainer to have the
 	      parser script for it included in the <prgn>dpkg</prgn>
 	      package.  (You will need to agree that the parser and its
-	      manpage may be distributed under the GNU GPL, just as the rest
+	      man page may be distributed under the GNU GPL, just as the rest
 	      of <prgn>dpkg</prgn> is.)
 	    </footnote>
 	  </p>
@@ -5537,7 +5537,7 @@
 
 	    <p>
 	      For more information about using <tt>update-rc.d</tt>,
-	      please consult its manpage <manref name="update-rc.d"
+	      please consult its man page <manref name="update-rc.d"
 		section="8">.
 	    </p>
 	  </sect2>
@@ -5595,7 +5595,7 @@
 
 	    <p>
 	      For more information about using
-	      <prgn>invoke-rc.d</prgn>, please consult its manpage
+	      <prgn>invoke-rc.d</prgn>, please consult its man page
 	      <manref name="invoke-rc.d" section="8">.
 	    </p>
 	  </sect2>
@@ -8140,7 +8140,7 @@
           and should be reported to the Debian Bug Tracking System (the
           maintainer of the package is allowed to write this bug report
           themselves, if they so desire).  Do not close the bug report
-          until a proper manpage is available.<footnote>
+          until a proper man page is available.<footnote>
               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">,
@@ -8152,10 +8152,10 @@
 	</p>
 
 	<p>
-	  You may forward a complaint about a missing manpage to the
+	  You may forward a complaint about a missing man page to the
 	  upstream authors, and mark the bug as forwarded in the
 	  Debian bug tracking system.  Even though the GNU Project do
-	  not in general consider the lack of a manpage to be a bug,
+	  not in general consider the lack of a man page to be a bug,
 	  we do; if they tell you that they don't consider it a bug
 	  you should leave the bug in our bug tracking system open
 	  anyway.
@@ -8166,21 +8166,21 @@
         </p>
 
 	<p>
-	  If one manpage needs to be accessible via several names it
+	  If one man page needs to be accessible via several names it
 	  is better to use a symbolic link than the <file>.so</file>
 	  feature, but there is no need to fiddle with the relevant
 	  parts of the upstream source to change from <file>.so</file> to
 	  symlinks: don't do it unless it's easy.  You should not
 	  create hard links in the manual page directories, nor put
 	  absolute filenames in <file>.so</file> directives.  The filename
-	  in a <file>.so</file> in a manpage should be relative to the
-	  base of the manpage tree (usually
+	  in a <file>.so</file> in a man page should be relative to the
+	  base of the man page tree (usually
 	  <file>/usr/share/man</file>). If you do not create any links
 	  (whether symlinks, hard links, or <tt>.so</tt> directives)
-	  in the filesystem to the alternate names of the manpage,
+	  in the filesystem to the alternate names of the man page,
 	  then you should not rely on <prgn>man</prgn> finding your
-	  manpage under those names based solely on the information in
-	  the manpage's header.<footnote>
+	  man page under those names based solely on the information in
+	  the man page's header.<footnote>
 	      Supporting this in <prgn>man</prgn> often requires
 	      unreasonable processing time to find a manual page or to
 	      report that none exists, and moves knowledge into man's
@@ -8512,7 +8512,7 @@
 	This manual does not go into detail about the options and
 	usage of the package building and installation tools.  It
 	should therefore be read in conjuction with those programs'
-	manpages.
+	man pages.
       </p>
 
       <p>
@@ -8520,7 +8520,7 @@
 	for managing various system configuration and similar issues,
 	such as <prgn>update-rc.d</prgn> and
 	<prgn>install-info</prgn>, are not described in detail here -
-	please see their manpages.
+	please see their man pages.
       </p>
 
       <p>
@@ -8558,7 +8558,7 @@
 	In the future binary packages may also contain other
 	components, such as checksums and digital signatures. The
 	format for the archive is described in full in the
-	<file>deb(5)</file> manpage.
+	<file>deb(5)</file> man page.
       </p>
 
 
@@ -8629,7 +8629,7 @@
 	</p>
 
 	<p>
-	  See the manpage <manref name="dpkg-deb" section="8"> for details of how
+	  See the man page <manref name="dpkg-deb" section="8"> for details of how
 	  to examine the contents of this newly-created file.  You may find the
 	  output of following commands enlightening:
 	  <example>
@@ -9897,7 +9897,7 @@
       </p>
 
       <p>
-	See the manpage <manref name="update-alternatives"
+	See the man page <manref name="update-alternatives"
 	section="8"> for details.
       </p>
 

Attachment: signature.asc
Description: This is a digitally signed message part


Reply to: