[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
pkgsrc/doc/guide/files/fixes.xml: 1.35 -> 1.37
以下のページの更新をしました。ツッコミをお願いします。
pkgsrc/doc/guide/files/fixes.xml: 1.35 -> 1.37
> revision 1.37
> date: 2005/11/08 16:39:47; author: reed; state: Exp; lines: +3 -3
> Add "para" tags for a "note" paragraph. This fixed a problem
> where a "varname" was immediately followed (without a space)
> the next word.
> ----------------------------
> revision 1.36
> date: 2005/11/08 03:45:37; author: reed; state: Exp; lines: +46 -1
> Add some docs about PKGMANDIR.
金曜日までに異議がなければ、 commit します。
以下、訳と原文それぞれの新旧の差分です。
--- fixes.xml.orig 2006-10-18 23:49:05.000000000 +0900
+++ fixes.xml 2006-10-18 23:49:05.000000000 +0900
@@ -1,6 +1,6 @@
-<!-- $NetBSD: fixes.xml,v 1.35 2005/11/03 17:31:57 tv Exp $ -->
+<!-- $NetBSD: fixes.xml,v 1.37 2005/11/08 16:39:47 reed Exp $ -->
<!-- Based on english version: -->
-<!-- NetBSD: fixes.xml,v 1.35 2005/11/03 17:31:57 tv Exp -->
+<!-- NetBSD: fixes.xml,v 1.37 2005/11/08 16:39:47 reed Exp -->
<chapter id="fixes"> <?dbhtml filename="fixes.html"?>
<title>パッケージを動くようにする</title>
@@ -1112,6 +1112,52 @@
または異常終了します。</para>
</sect2>
+ <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>
+
+ <note><para>このような <varname>PKGMANDIR</varname> の独自設定には、
+ 完全には対応していません。
+ </para></note>
+
+ <para><filename>PLIST</filename> ファイル内では、
+ マニュアルページのファイルの最上層ディレクトリーを、
+ 単に <filename>man/</filename> と書くことができます。
+ これは pkgsrc の枠組みが必要に応じて変換してくれます。
+ </para>
+
+ <para> <varname>GNU_CONFIGURE</varname> が
+ <quote>yes</quote> に設定されているパッケージでは、
+ 標準では
+ <filename>./configure</filename>
+ --mandir スイッチを使って、マニュアルページをどこにインストールするかを設定します。
+ このパスは <varname>GNU_CONFIGURE_MANDIR</varname> で、
+ 標準では <varname>${PREFIX}/${PKGMANDIR}</varname> になります。
+ </para>
+
+ <para>
+ パッケージが <varname>GNU_CONFIGURE</varname> を使うが、
+ --mandir は使わない場合は、<varname>CONFIGURE_HAS_MANDIR</varname> を
+ <quote>no</quote> に設定することができます、
+ また、<filename>./configure</filename>
+ スクリプトが標準的ではない --mandir の使い方をする場合は、
+ 必要に応じて <varname>GNU_CONFIGURE_MANDIR</varname> を設定することができます。
+ </para>
+
+ <para>圧縮したマニュアルページのインストールに関する情報は、
+ <xref linkend="manpage-compression"/> をご覧ください。
+ </para>
+
+ </sect2>
<sect2 id="gconf2-data-files">
<title>GConf2 のデータファイルをインストールするパッケージ</title>
Index: fixes.xml
===================================================================
RCS file: /cvsroot/pkgsrc/doc/guide/files/fixes.xml,v
retrieving revision 1.35
retrieving revision 1.37
diff -u -r1.35 -r1.37
--- fixes.xml 3 Nov 2005 17:31:57 -0000 1.35
+++ fixes.xml 8 Nov 2005 16:39:47 -0000 1.37
@@ -1,4 +1,4 @@
-<!-- $NetBSD: fixes.xml,v 1.35 2005/11/03 17:31:57 tv Exp $ -->
+<!-- $NetBSD: fixes.xml,v 1.37 2005/11/08 16:39:47 reed Exp $ -->
<chapter id="fixes"> <?dbhtml filename="fixes.html"?>
<title>Making your package work</title>
@@ -1176,6 +1176,51 @@
<command>makeinfo</command> command or exit on error.</para>
</sect2>
+ <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> Packages that are
+ configured with <varname>GNU_CONFIGURE</varname> set as
+ <quote>yes</quote>, by default will use the
+ <filename>./configure</filename>
+ --mandir switch to set where the man pages should be installed.
+ The path is <varname>GNU_CONFIGURE_MANDIR</varname> which defaults
+ to <varname>${PREFIX}/${PKGMANDIR}</varname>.
+ </para>
+
+ <para>
+ Packages that use <varname>GNU_CONFIGURE</varname> but do not
+ use --mandir, can set <varname>CONFIGURE_HAS_MANDIR</varname>
+ to <quote>no</quote>.
+ Or if the <filename>./configure</filename> script uses
+ a non-standard use of --mandir, you can set
+ <varname>GNU_CONFIGURE_MANDIR</varname> as needed.
+ </para>
+
+ <para>See <xref linkend="manpage-compression"/> for
+ information on installation of compressed manual pages.
+ </para>
+
+ </sect2>
<sect2 id="gconf2-data-files">
<title>Packages installing GConf2 data files</title>