diff options
author | rillig <rillig> | 2006-07-23 15:35:08 +0000 |
---|---|---|
committer | rillig <rillig> | 2006-07-23 15:35:08 +0000 |
commit | 2854c3a4050d2fdc94086962b98fdeab4d22ce7d (patch) | |
tree | ec15904659c0e1f093fa571101b3bf175f8ce27e | |
parent | 7d527ec5df7c3adac39b3338fe066ea7f1666652 (diff) | |
download | pkgsrc-2854c3a4050d2fdc94086962b98fdeab4d22ce7d.tar.gz |
Rewrote the section on manual pages, avoiding to say everything twice.
-rw-r--r-- | doc/guide/files/fixes.xml | 37 |
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 |