[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>