summaryrefslogtreecommitdiff
path: root/doc/guide
diff options
context:
space:
mode:
authorrillig <rillig@pkgsrc.org>2006-07-23 15:35:08 +0000
committerrillig <rillig@pkgsrc.org>2006-07-23 15:35:08 +0000
commit85becf15a79dcfe2464e4899dc6d36d91838a92f (patch)
treeec15904659c0e1f093fa571101b3bf175f8ce27e /doc/guide
parenta7a9b2e0c32a7d6c4ae18bd9c97c772efb0d8167 (diff)
downloadpkgsrc-85becf15a79dcfe2464e4899dc6d36d91838a92f.tar.gz
Rewrote the section on manual pages, avoiding to say everything twice.
Diffstat (limited to 'doc/guide')
-rw-r--r--doc/guide/files/fixes.xml37
1 files changed, 18 insertions, 19 deletions
diff --git a/doc/guide/files/fixes.xml b/doc/guide/files/fixes.xml
index 23e5d2a2df8..ee5019de92f 100644
--- a/doc/guide/files/fixes.xml
+++ b/doc/guide/files/fixes.xml
@@ -1,4 +1,4 @@
-<!-- $NetBSD: fixes.xml,v 1.63 2006/07/02 10:01:11 rillig Exp $ -->
+<!-- $NetBSD: fixes.xml,v 1.64 2006/07/23 15:35:08 rillig Exp $ -->
<chapter id="fixes"> <?dbhtml filename="fixes.html"?>
<title>Making your package work</title>
@@ -1260,24 +1260,23 @@ Changes to the PLIST
<sect2 id="manpages">
<title>Packages installing man pages</title>
- <para>Many packages install manual pages. The man pages
- are installed under <varname>${PREFIX}/${PKGMANDIR}</varname>
- which is <filename>/usr/pkg/man</filename> by default.
- <varname>PKGMANDIR</varname> defaults to <quote>man</quote>.
- For example, you can set <varname>PKGMANDIR</varname> to
- <quote>share/man</quote> to have man pages install under
- <filename>/usr/pkg/share/man/</filename> by default.
- </para>
-
- <note><para>The support for a custom <varname>PKGMANDIR</varname>
- is not complete.
- </para></note>
-
- <para>The <filename>PLIST</filename> files can just
- use <filename>man/</filename> as the top level directory
- for the man page file entries
- and the pkgsrc framework will convert as needed.
- </para>
+ <para>All packages that install manual pages should install them
+ into the same directory, so that there is one common place to
+ look for them. In pkgsrc, this place is
+ <literal>${PREFIX}/${PKGMANDIR}</literal>, and this expression
+ should be used in packages. The default for
+ <varname>PKGMANDIR</varname> is
+ <quote><filename>man</filename></quote>. Another often-used
+ value is <quote><filename>share/man</filename></quote>.</para>
+
+ <note><para>The support for a custom
+ <varname>PKGMANDIR</varname> is far from complete.</para></note>
+
+ <para>The <filename>PLIST</filename> files can just use
+ <filename>man/</filename> as the top level directory for the man
+ page file entries, and the pkgsrc framework will convert as
+ needed. In all other places, the correct
+ <varname>PKGMANDIR</varname> must be used.</para>
<para> Packages that are
configured with <varname>GNU_CONFIGURE</varname> set as