[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
pkgsrc/doc/guide/files/fixes.xml: 1.72 -> 1.73
以下のページの更新をしました。ツッコミをお願いします。
pkgsrc/doc/guide/files/fixes.xml: 1.72 -> 1.73
> revision 1.73
> date: 2006/09/13 23:38:21; author: wiz; state: Exp; lines: +39 -31
> Document BATCH. Undocument deprecated BUILD_USES_MSGFMT.
> Document OSVERSION_SPECIFIC.
水曜日までに異議がなければ、 commit します。
以下、訳と原文それぞれの新旧の差分です。
--- fixes.xml.orig 2006-12-26 22:27:41.000000000 +0900
+++ fixes.xml 2006-12-26 22:27:41.000000000 +0900
@@ -1,6 +1,6 @@
-<!-- $NetBSD: fixes.xml,v 1.72 2006/09/10 19:36:31 wiz Exp $ -->
+<!-- $NetBSD: fixes.xml,v 1.73 2006/09/13 23:38:21 wiz Exp $ -->
<!-- Based on english version: -->
-<!-- NetBSD: fixes.xml,v 1.72 2006/09/10 19:36:31 wiz Exp -->
+<!-- NetBSD: fixes.xml,v 1.73 2006/09/13 23:38:21 wiz Exp -->
<chapter id="fixes"> <?dbhtml filename="fixes.html"?>
<title>パッケージを動くようにする</title>
@@ -15,7 +15,6 @@
そのため、pkgsrc のパッケージの移植性をできるかぎり高めることが重要になります。
本章では、pkgsrc の作業に際して、
注意が必要となる具体的な事項を説明します。</para>
-
</sect2>
<sect2 id="pulling-vars-from-etc-mk.conf">
@@ -43,14 +42,13 @@
<note><para>各変数が読み込み時に使用可能か、
実行時にのみ使用可能かを網羅した一覧は、現在のところありませんが、
準備をしているところです。</para></note>
-
</sect2>
<sect2 id="user-interaction">
<title>ユーザーとの対話</title>
- <para>時々、パッケージがユーザーとの対話を必要とする場合がありますが、そのような
- 状況は何通りもありえます:</para>
+ <para>時々、パッケージがユーザーとの対話を必要とする場合がありますが、
+ そのような状況は何通りもありえます:</para>
<itemizedlist>
@@ -61,7 +59,8 @@
</listitem>
<listitem>
- <para>distfile の展開時に、パッケージによってはパスワードを要求することがあります。</para>
+ <para>distfile の展開時に、
+ パッケージによってはパスワードを要求することがあります。</para>
</listitem>
<listitem>
@@ -77,9 +76,10 @@
</listitem>
</itemizedlist>
- <para>どの段階で対話が必要になるかをpkgsrcの機構に知らせるため、<varname>INTERACTIVE_STAGE</varname>
- 定義が用意されており、パッケージの<filename>Makefile</filename>で定義します。たとえば以下のよう
- にします。</para>
+ <para>どの段階で対話が必要になるかをpkgsrcの機構に知らせるため、
+ <varname>INTERACTIVE_STAGE</varname> 定義が用意されており、
+ パッケージの<filename>Makefile</filename>で定義します。
+ たとえば以下のようにします。</para>
<programlisting>
INTERACTIVE_STAGE= build
@@ -91,6 +91,8 @@
INTERACTIVE_STAGE= configure install
</programlisting>
+ <para>利用者は、<varname>BATCH</varname> 変数を設定して、
+ この定義がおこなわれているパッケージをとばすことができます。</para>
</sect2>
<sect2 id="handling-licenses">
@@ -235,8 +237,8 @@
<para>パッケージは他のパッケージに依存するかもしれません。そして、この依存性を定
義するためのいろいろな方法があります。pkgsrc は、<filename>buildlink3.mk</filename>を使った依存関
係 (依存性の処理用としては、こちらが望ましい方法です。
- この方法では以下の各変数を使っています。さらなる情報は<xref
- linkend="buildlink"/>を参照してください)
+ この方法では以下の各変数を使っています。
+ さらなる情報は<xref linkend="buildlink"/>を参照してください)
のほか、
<varname>BUILD_DEPENDS</varname> および <varname>DEPENDS</varname> 定義、
<varname>USE_TOOLS</varname> 定義をサポートしています。</para>
@@ -379,12 +381,13 @@
(このパッケージは、
構築の際に jpeg のソースがソースの状態で存在することに依存しています。)</para>
- <para>また、便利に使うことができる<varname>BUILD_USES_MSGFMT</varname>および
+ <para>また、便利に使うことができる
<varname>BUILD_USES_GETTEXT_M4</varname>定
- 義にも注意してください。前者は、基本システムに &man.msgfmt.1; があるかどうか調べて、
- ない場合は<filename role="pkg">devel/gettext</filename>パッケージをインストールします。後者は、構築
+ 義にも注意してください。
+ これは、構築
の際に、旧バージョンのgettextパッケージがインストールされていることに依存す
- るようにし、これがインストールされていない場合は<filename role="pkg">devel/gettext-m4</filename>パッ
+ るようにし、これがインストールされていない場合は<filename
+ role="pkg">devel/gettext-m4</filename>パッ
ケージをインストールします。</para>
</sect2>
@@ -431,6 +434,15 @@
<varname>NOT_FOR_PLATFORM</varname> の値はいずれも、OS triples
(OS-version-platform) であり、
グロブ形式のワイルドカードを使うことができます。</para>
+ <para>パッケージのなかには、あるオペレーティングシステムの特定のバージョンに強く依存するものがあります。
+ たとえば、LKM や <filename
+ role="pkg">sysutils/lsof</filename> などです。
+ このようなバイナリーパッケージは、同じ OS の別バージョンと後方互換ではないので、
+ FTP サーバーでは対象バージョン専用のディレクトリーにアップロードするようにします。
+ <varname>OSVERSION_SPECIFIC</varname> を <quote>yes</quote> に設定して、
+ パッケージに印をつけてください。この変数は、現在のところ、
+ パッケージシステム内部のどこでも使われませんが、
+ 将来は使われることになるかもしれません。</para>
<para>パッケー
ジをとばすべき場合(たとえば、そのパッケージが提供する機能が、すでにシステム
で提供されている場合)は、
Index: fixes.xml
===================================================================
RCS file: /cvsroot/pkgsrc/doc/guide/files/fixes.xml,v
retrieving revision 1.72
retrieving revision 1.73
diff -u -r1.72 -r1.73
--- fixes.xml 10 Sep 2006 19:36:31 -0000 1.72
+++ fixes.xml 13 Sep 2006 23:38:21 -0000 1.73
@@ -1,4 +1,4 @@
-<!-- $NetBSD: fixes.xml,v 1.72 2006/09/10 19:36:31 wiz Exp $ -->
+<!-- $NetBSD: fixes.xml,v 1.73 2006/09/13 23:38:21 wiz Exp $ -->
<chapter id="fixes"> <?dbhtml filename="fixes.html"?>
<title>Making your package work</title>
@@ -14,7 +14,6 @@
where possible, that packages in pkgsrc are portable. This
chapter mentions some particular details you should pay
attention to while working on pkgsrc.</para>
-
</sect2>
<sect2 id="pulling-vars-from-etc-mk.conf">
@@ -42,14 +41,13 @@
<note><para>Currently there is no exhaustive list of all
variables that tells you whether they can be used at load time
or only at run time, but it is in preparation.</para></note>
-
</sect2>
<sect2 id="user-interaction">
<title>User interaction</title>
- <para>Occasionally, packages require interaction from the user, and this can be
- in a number of ways:</para>
+ <para>Occasionally, packages require interaction from the user,
+ and this can be in a number of ways:</para>
<itemizedlist>
@@ -60,7 +58,8 @@
</listitem>
<listitem>
- <para>When extracting the distfiles, some packages may ask for passwords.</para>
+ <para>When extracting the distfiles, some packages may ask for
+ passwords.</para>
</listitem>
<listitem>
@@ -76,9 +75,10 @@
</listitem>
</itemizedlist>
- <para>The <varname>INTERACTIVE_STAGE</varname> definition is provided to notify
- the pkgsrc mechanism of an interactive stage which will be needed, and
- this should be set in the package's <filename>Makefile</filename>, e.g.:</para>
+ <para>The <varname>INTERACTIVE_STAGE</varname> definition is
+ provided to notify the pkgsrc mechanism of an interactive stage
+ which will be needed, and this should be set in the package's
+ <filename>Makefile</filename>, e.g.:</para>
<programlisting>
INTERACTIVE_STAGE= build
@@ -90,6 +90,8 @@
INTERACTIVE_STAGE= configure install
</programlisting>
+ <para>The user can then decide to skip this package by setting the
+ <varname>BATCH</varname> variable.</para>
</sect2>
<sect2 id="handling-licenses">
@@ -238,14 +240,13 @@
<title>Handling dependencies</title>
<para>Your package may depend on some other package being present
- - and there are various ways of expressing this
- dependency. pkgsrc supports the <varname>BUILD_DEPENDS</varname>
- and <varname>DEPENDS</varname> definitions, the
- <varname>USE_TOOLS</varname> definition, as well as
- dependencies via <filename>buildlink3.mk</filename>, which is
- the preferred way to handle dependencies, and which uses the
- variables named above. See <xref linkend="buildlink"/> for more
- information.</para>
+ - and there are various ways of expressing this dependency.
+ pkgsrc supports the <varname>BUILD_DEPENDS</varname> and
+ <varname>DEPENDS</varname> definitions, the
+ <varname>USE_TOOLS</varname> definition, as well as dependencies
+ via <filename>buildlink3.mk</filename>, which is the preferred way
+ to handle dependencies, and which uses the variables named above.
+ See <xref linkend="buildlink"/> for more information.</para>
<para>The basic difference between the two variables is as
follows: The <varname>DEPENDS</varname> definition registers
@@ -398,14 +399,12 @@
(It relies on the jpeg sources being present in source form
during the build.)</para>
- <para>Please also note the <varname>BUILD_USES_MSGFMT</varname>
- and <varname>BUILD_USES_GETTEXT_M4</varname> definitions, which
- are provided as convenience definitions. The former works out
- whether &man.msgfmt.1; is part of the base system, and, if it isn't,
- installs the <filename role="pkg">devel/gettext</filename> package.
- The latter adds a build dependency on either an installed
- version of an older gettext package, or if it isn't, installs the
- <filename role="pkg">devel/gettext-m4</filename> package.</para>
+ <para>Please also note the
+ <varname>BUILD_USES_GETTEXT_M4</varname> definition, which is
+ provided as convenience definition. It adds a build dependency on
+ either an installed version of an older gettext package, or if it
+ isn't, installs the <filename
+ role="pkg">devel/gettext-m4</filename> package.</para>
</sect2>
@@ -414,8 +413,8 @@
<para>Your package may conflict with other packages a user might
already have installed on his system, e.g. if your package
- installs the same set of files like another package in our
- pkgsrc tree.</para>
+ installs the same set of files as another package in the pkgsrc
+ tree.</para>
<para>In this case you can set <varname>CONFLICTS</varname> to a
space-separated list of packages (including version string) your
@@ -447,7 +446,7 @@
<title>Packages that cannot or should not be built</title>
<para>There are several reasons why a package might be
- instructed to not build under certain circumstances. If the
+ instructed to not build under certain circumstances. If the
package builds and runs on most platforms, the exceptions
should be noted with <varname>NOT_FOR_PLATFORM</varname>. If
the package builds and runs on a small handful of platforms,
@@ -456,11 +455,20 @@
<varname>NOT_FOR_PLATFORM</varname> are OS triples
(OS-version-platform) that can use glob-style
wildcards.</para>
+ <para>Some packages are tightly bound to a specific version of an
+ operating system, e.g. LKMs or <filename
+ role="pkg">sysutils/lsof</filename>. Such binary packages are not
+ backwards compatible with other versions of the OS, and should be
+ uploaded to a version specific directory on the FTP server. Mark
+ these packages by setting <varname>OSVERSION_SPECIFIC</varname> to
+ <quote>yes</quote>. This variable is not currently used by any of
+ the package system internals, but may be used in the
+ future.</para>
<para>If the package should be skipped (for example, because it
provides functionality already provided by the system), set
- <varname>PKG_SKIP_REASON</varname> to a descriptive message.
- If the package should fail because some preconditions are not
- met, set <varname>PKG_FAIL_REASON</varname> to a descriptive
+ <varname>PKG_SKIP_REASON</varname> to a descriptive message. If
+ the package should fail because some preconditions are not met,
+ set <varname>PKG_FAIL_REASON</varname> to a descriptive
message.</para>
</sect2>