[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
pkgsrc/doc/guide/files/fixes.xml: 1.47 -> 1.48
以下のページの更新をしました。ツッコミをお願いします。
pkgsrc/doc/guide/files/fixes.xml: 1.47 -> 1.48
> revision 1.48
> date: 2006/03/20 01:48:57; author: jlam; state: Exp; lines: +33 -31
> * Creates a new variable PKGINFODIR (named similarly to PKGMANDIR)
> that is a purely user-settable variable to represent the relative
> path under ${PREFIX} where info files are stored and "dir" files
> are managed. PKGINFODIR defaults to "info". INFO_DIR still works,
> but will be obsoleted after the 2006Q1 branch.
>
> * Modify GNU_CONFIGURE_INFODIR to only honor ${PKGINFODIR} if the
> package installs directly into ${PREFIX} and not some subdirectory
> under ${PREFIX}. This fixes packages that don't really honor
> $(infodir) all that well, and also avoids PLIST problems relating
> to directory removal for those packages.
>
> * Since the majority of Emacs Lisp packages use GNU_CONFIGURE, just
> set GNU_CONFIGURE_INFODIR directly to ${EMACS_INFOPREFIX}, which is
> the Emacs-distro-specific location for info files. Also pass
> EMACS_INFOPREFIX through PLIST_SUBST for PLIST substitution.
>
> * INFO_FILES should be defined if the package installs info files.
> If the info files are not listed in the PLIST, then INFO_FILES
> must list the filenames for the info files installed by the package,
> which are assumed to be located in ${PREFIX}/${PKGINFODIR}.
>
> * The plist module can now better detect info files listed in PLISTs
> and exports a command to the pkginstall module to append info file
> names to the +INFO_FILES scriptlet at install-time.
>
> * The print-PLIST target is updated to properly list info files in
> the auto-generated PLIST.
>
> * The check-files code is updated to skip all "dir" Info database files.
追加された部分の一部は 1.51 で削除されるため、訳してありません。
水曜日までに異議がなければ、 commit します。
以下、訳と原文それぞれの新旧の差分です。
--- fixes.xml.orig 2006-11-07 23:57:17.000000000 +0900
+++ fixes.xml 2006-11-07 23:57:17.000000000 +0900
@@ -1,6 +1,6 @@
-<!-- $NetBSD: fixes.xml,v 1.47 2006/03/12 11:34:09 rillig Exp $ -->
+<!-- $NetBSD: fixes.xml,v 1.48 2006/03/20 01:48:57 jlam Exp $ -->
<!-- Based on english version: -->
-<!-- NetBSD: fixes.xml,v 1.47 2006/03/12 11:34:09 rillig Exp -->
+<!-- NetBSD: fixes.xml,v 1.48 2006/03/20 01:48:57 jlam Exp -->
<chapter id="fixes"> <?dbhtml filename="fixes.html"?>
<title>パッケージを動くようにする</title>
@@ -1083,36 +1083,44 @@
<title>infoファイルをインストールするパッケージ</title>
<para>パッケージによっては、infoファイルをインストールしたり、<quote>makeinfo</quote>または
- <quote>install-info</quote>コマンドを使ったりします。各 info ファイルは、</para>
-
- <itemizedlist>
- <listitem>
- <para><filename>${PREFIX}/${INFO_DIR}</filename>
- ディレクトリーにインストールされるものとして扱われます。</para>
- </listitem>
-
- <listitem>
- <para>Info ディレクトリーファイル
- <filename>${PREFIX}/${INFO_DIR}/dir</filename> に登録されます。</para>
- </listitem>
-
- <listitem>
- <para>パッケージの Makefile で、
- <varname>INFO_FILES</varname> 変数に、
- ファイル名の形で列挙する必要があります。</para>
- </listitem>
- </itemizedlist>
-
- <para><varname>INFO_DIR</varname> のデフォルトは <quote>info</quote> ですが、
- パッケージの Makefile で上書きすることができます。 info ファイルを
+ <quote>install-info</quote>コマンドを使ったりします。
+ このようなパッケージでは、パッケージの Makefile で
+ <varname>INFO_FILES</varname> を定義するようにします。
+ これを定義しておくと、info ファイルを
Info ディレクトリーファイルに登録するために、<filename>INSTALL</filename> および
- <filename>DEINSTALL</filename> スクリプトが作られます。
+ <filename>DEINSTALL</filename> スクリプトが作られるようになります。
info ファイルの登録用の <quote>install-info</quote> コマンドは、
システム附属のものが使われるか、
または、必要があればそれ用のパッケージが自動的に追加されて使われます。</para>
+ <para><varname>PKGINFODIR</varname> は
+ <filename>${PREFIX}</filename> 以下のディレクトリーで、
+ info ファイルが置かれる主な場所です。
+ <varname>PKGINFODIR</varname> は標準では
+ <quote>info</quote> となっており、利用者が上書きすることができます。
+
+ <para>There are two mutually exclusive ways to specify the info
+ files for the package:</para>
+
+ <itemizedlist>
+ <listitem>
+ <para>list each of info files in the package
+ <filename>PLIST</filename>; however any split info files
+ need not be listed, or</para>
+ </listitem>
+
+ <listitem>
+ <para>list the filename of each info file in the
+ <varname>INFO_FILES</varname> variable; however any split
+ info file filenames need not be listed. In this case
+ each of the info files should be installed into the
+ directory <filename>${PREFIX}/${PKGINFODIR}</filename>.
+ </listitem>
+
+ </itemizedlist>
+
<para>構築時に <quote>makeinfo</quote> コマンドが必要なパッケージは、
- Makefile で <varname>USE_MAKEINFO</varname> 変数を定義する必要があります。
+ Makefile で <varname>USE_TOOLS</varname> 変数に <quote>makeinfo</quote> を追加する必要があります。
あるバージョン以上の<quote>makeinfo</quote>コマンドが必要な場合は、
パッケージの <filename>Makefile</filename> で
<varname>TEXINFO_REQD</varname> 変数を必要な最低バージョンに設定します。
@@ -1120,8 +1128,7 @@
<command>makeinfo</command> コマンドがシステムにないか、
最低限必要なバージョンを満たさない場合は、
<filename role="pkg">devel/gtexinfo</filename>
- パッケージへの構築時の依存関係が自動的に追加されます。
-</para>
+ パッケージへの構築時の依存関係が自動的に追加されます。</para>
<para>パッケージで提供されるソフトウェアの構築やインストールの過程では、
<command>install-info</command> コマンドを使ってはいけません。
@@ -1135,9 +1142,9 @@
<para><command>install-info</command> を上書きするスクリプトは、メッセージを記録すること以外、
何の効果もありません。<command>makeinfo</command> を上書きするスクリプトは、
- メッセージを記録し、<varname>USE_MAKEINFO</varname> や <varname>TEXINFO_REQD</varname>
+ メッセージを記録し、<varname>TEXINFO_REQD</varname>
の値に従って、適切な <command>makeinfo</command> コマンドを実行するか、
- または異常終了します。</para>
+ または異常終了します。</para>
</sect2>
<sect2 id="manpages">
Index: fixes.xml
===================================================================
RCS file: /cvsroot/pkgsrc/doc/guide/files/fixes.xml,v
retrieving revision 1.47
retrieving revision 1.48
diff -u -r1.47 -r1.48
--- fixes.xml 12 Mar 2006 11:34:09 -0000 1.47
+++ fixes.xml 20 Mar 2006 01:48:57 -0000 1.48
@@ -1,4 +1,4 @@
-<!-- $NetBSD: fixes.xml,v 1.47 2006/03/12 11:34:09 rillig Exp $ -->
+<!-- $NetBSD: fixes.xml,v 1.48 2006/03/20 01:48:57 jlam Exp $ -->
<chapter id="fixes"> <?dbhtml filename="fixes.html"?>
<title>Making your package work</title>
@@ -1139,29 +1139,8 @@
<para>Some packages install info files or use the
<quote>makeinfo</quote> or <quote>install-info</quote>
- commands. Each of the info files:</para>
-
- <itemizedlist>
- <listitem>
- <para>is considered to be installed in the directory
- <filename>${PREFIX}/${INFO_DIR}</filename>,</para>
- </listitem>
-
- <listitem>
- <para>is registered in the Info directory file
- <filename>${PREFIX}/${INFO_DIR}/dir</filename>,</para>
- </listitem>
-
- <listitem>
- <para>and must be listed as a filename in the
- <varname>INFO_FILES</varname> variable in the package
- Makefile.</para>
- </listitem>
- </itemizedlist>
-
- <para><varname>INFO_DIR</varname> defaults to <quote>info</quote>
- and can be overridden in the package
- Makefile. <filename>INSTALL</filename> and
+ commands. <varname>INFO_FILES</varname> should be defined in
+ the package Makefile so that <filename>INSTALL</filename> and
<filename>DEINSTALL</filename> scripts will be generated to
handle registration of the info files in the Info directory
file. The <quote>install-info</quote> command used for the info
@@ -1169,9 +1148,34 @@
special purpose package automatically added as dependency if
needed.</para>
+ <para><varname>PKGINFODIR</varname> is the directory under
+ <filename>${PREFIX}</filename> where info files are primarily
+ located. <varname>PKGINFODIR</varname> defaults to
+ <quote>info</quote> and can be overridden by the user.
+
+ <para>There are two mutually exclusive ways to specify the info
+ files for the package:</para>
+
+ <itemizedlist>
+ <listitem>
+ <para>list each of info files in the package
+ <filename>PLIST</filename>; however any split info files
+ need not be listed, or</para>
+ </listitem>
+
+ <listitem>
+ <para>list the filename of each info file in the
+ <varname>INFO_FILES</varname> variable; however any split
+ info file filenames need not be listed. In this case
+ each of the info files should be installed into the
+ directory <filename>${PREFIX}/${PKGINFODIR}</filename>.
+ </listitem>
+
+ </itemizedlist>
+
<para>A package which needs the <quote>makeinfo</quote> command
- at build time must define the variable
- <varname>USE_MAKEINFO</varname> in its Makefile. If a minimum
+ at build time must add <quote>makeinfo</quote> to
+ <varname>USE_TOOLS</varname> in its Makefile. If a minimum
version of the <quote>makeinfo</quote> command is needed it
should be noted with the <varname>TEXINFO_REQD</varname>
variable in the package <filename>Makefile</filename>. By
@@ -1179,8 +1183,7 @@
does not provide a <command>makeinfo</command> command or if it
does not match the required minimum, a build dependency on the
<filename role="pkg">devel/gtexinfo</filename> package will
- be added automatically.
-</para>
+ be added automatically.</para>
<para>The build and installation process of the software provided
by the package should not use the
@@ -1197,9 +1200,8 @@
<para>The script overriding <command>install-info</command> has
no effect except the logging of a message. The script overriding
<command>makeinfo</command> logs a message and according to the
- value of <varname>USE_MAKEINFO</varname> and
- <varname>TEXINFO_REQD</varname> either run the appropriate
- <command>makeinfo</command> command or exit on error.</para>
+ value of <varname>TEXINFO_REQD</varname> either runs the appropriate
+ <command>makeinfo</command> command or exit on error.</para>
</sect2>
<sect2 id="manpages">