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