[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
pkgsrc/doc/guide/files/fixes.xml: 1.63 -> 1.64
以下のページの更新をしました。ツッコミをお願いします。
pkgsrc/doc/guide/files/fixes.xml: 1.63 -> 1.64
> revision 1.64
> date: 2006/07/23 15:35:08; author: rillig; state: Exp; lines: +18 -19
> Rewrote the section on manual pages, avoiding to say everything twice.
金曜日までに異議がなければ、 commit します。
以下、訳と原文それぞれの新旧の差分です。
--- fixes.xml.orig 2006-12-07 00:38:53.000000000 +0900
+++ fixes.xml 2006-12-07 00:38:53.000000000 +0900
@@ -1,6 +1,6 @@
-<!-- $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 $ -->
<!-- Based on english version: -->
-<!-- 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>パッケージを動くようにする</title>
@@ -1208,25 +1208,24 @@
<sect2 id="manpages">
<title>マニュアルページをインストールするパッケージ</title>
- <para>多くのパッケージはマニュアルページをインストールします。
- マニュアルページは <varname>${PREFIX}/${PKGMANDIR}</varname>
- (これは標準では <filename>/usr/pkg/man</filename> です) 以下にインストールされます。
- <varname>PKGMANDIR</varname> は標準では <quote>man</quote> です。
- たとえば、<varname>PKGMANDIR</varname> を
- <quote>share/man</quote> に設定して、
- マニュアルページが標準で
- <filename>/usr/pkg/share/man/</filename> 以下にインストールされるようにすることができます。
- </para>
+ <para>マニュアルページをインストールするパッケージはすべて、
+ マニュアルページを同じディレクトリー内にインストールして、
+ マニュアルページを共通のひとつの場所から探せるようにします。
+ pkgsrc では、この場所は
+ <literal>${PREFIX}/${PKGMANDIR}</literal> であり、パッケージ内ではこの表記を使うようにします。
+ <varname>PKGMANDIR</varname> の値は標準では
+ <quote><filename>man</filename></quote> です。これ以外によく使われる値は、
+ <quote><filename>share/man</filename></quote> です。</para>
- <note><para>このような <varname>PKGMANDIR</varname> の独自設定には、
- 完全には対応していません。
- </para></note>
+ <note><para><varname>PKGMANDIR</varname> の独自設定には、
+ 完全には対応していません。</para></note>
- <para><filename>PLIST</filename> ファイル内では、
+ <para><filename>PLIST</filename> ファイル内では、
マニュアルページのファイルの最上層ディレクトリーを、
単に <filename>man/</filename> と書くことができます。
これは pkgsrc の枠組みが必要に応じて変換してくれます。
- </para>
+ これ以外の場所の場合は、正確な
+ <varname>PKGMANDIR</varname> を使って書く必要があります。</para>
<para> <varname>GNU_CONFIGURE</varname> が
<quote>yes</quote> に設定されているパッケージでは、
Index: fixes.xml
===================================================================
RCS file: /cvsroot/pkgsrc/doc/guide/files/fixes.xml,v
retrieving revision 1.63
retrieving revision 1.64
diff -u -r1.63 -r1.64
--- fixes.xml 2 Jul 2006 10:01:11 -0000 1.63
+++ fixes.xml 23 Jul 2006 15:35:08 -0000 1.64
@@ -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 @@
<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