[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
pkgsrc/doc/guide/files/components.xml: 1.1 -> 1.2
以下のページの更新をしました。
pkgsrc/doc/guide/files/components.xml: 1.1 -> 1.2
> revision 1.2
> date: 2004/11/19 18:42:39; author: peter; state: Exp; lines: +1 -40
> Remove the documentation for optional patch files, which was removed some
> time ago.
>
> ok wiz@
単純な削除だけなので、すぐに commit します。
以下、訳と原文それぞれの新旧の差分です。
--- components.xml.orig 2006-08-28 00:43:06.000000000 +0900
+++ components.xml 2006-08-28 00:43:06.000000000 +0900
@@ -1,6 +1,6 @@
-<!-- $NetBSD: components.xml,v 1.1 2004/10/21 14:27:38 grant Exp $ -->
+<!-- $NetBSD: components.xml,v 1.2 2004/11/19 18:42:39 peter Exp $ -->
<!-- Based on english version: -->
-<!-- NetBSD: components.xml,v 1.1 2004/10/21 14:27:38 grant Exp -->
+<!-- NetBSD: components.xml,v 1.2 2004/11/19 18:42:39 peter Exp -->
<chapter id="components"> <?dbhtml filename="components.html"?>
<title>パッケージコンポーネント - ファイル、ディレクトリー、およびコンテンツ</title>
@@ -173,45 +173,6 @@
展開順)で適用されます。つまり<filename>patch-aa</filename>は
<filename>patch-ab</filename>より前に適用されます。</para>
- <para> オプションのパッチファイルであってローカルサイトの構成に依存するものは、
- <filename>patches/patch-optional-*</filename> の形式の名前にして、
- パッケージに含めることができます。オプションのパッチファイルは、
- 適用するもののファイル名を <varname>OPTIONAL_PATCHFILES</varname>
- 変数に割り当てます。オプションのパッチファイルは、
- デフォルトでは適用されません。
- </para>
-
- <para> たとえば、パッケージのデータファイルに対して、
- <varname>$PAPERSIZE</varname> ファイルで指定される
- デフォルトのローカルプリンターの用紙サイズを示すために
- パッチを適用する必要があったとします。
- この場合、パッケージのデフォルトの設定値を置き換えるために、
- 考えられるすべての用紙サイズ用のパッチを含めることができます。
- この例では、
- "<filename>patch-optional-Letter-papersize</filename>"
- という名前のパッチや、さらに
- "<filename>patch-optional-A4-papersize</filename>"
- という名前で別のパッチも用意しておくことができます。
- <filename>Makefile</filename> で以下のようにして、
- これらのパッチを選択して適用するようにします。
- </para>
-
- <programlisting>
- PATCHDIR= ${.CURDIR}/patches
- .if exists(${PATCHDIR}/patch-optional-${PAPERSIZE}-papersize)
- OPTIONAL_PATCHFILES+= ${PATCHDIR}/patch-optional-${PAPERSIZE}-papersize
- .endif </programlisting>
-
- <para> なお、この例のように
- <quote><command>.if</command></quote> ステートメント内で
- <varname>PATCHDIR</varname> を使うためには、その値を定義しておく必要があります。
- 定義しておかないと、Makefile の処理において、
- 必要なときより後にならないと定義されないためです。
- 設定の対象 (この例では <varname>$PAPERSIZE</varname>)
- が予期しない値に設定されるような問題を避けるため、
- <quote><command>.if</command></quote> ステートメントを使うようにしてください。
- </para>
-
<para>問題を避けるため、<filename>patch-*</filename>ファイルは
<command>diff -bu</command>フォーマットとし、かつ、曖昧
さなしで適用できるようにします。(曖昧さがあっても強制的にパッチを適用させる
Index: components.xml
===================================================================
RCS file: /cvsroot/pkgsrc/doc/guide/files/components.xml,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- components.xml 21 Oct 2004 14:27:38 -0000 1.1
+++ components.xml 19 Nov 2004 18:42:39 -0000 1.2
@@ -1,4 +1,4 @@
-<!-- $NetBSD: components.xml,v 1.1 2004/10/21 14:27:38 grant Exp $ -->
+<!-- $NetBSD: components.xml,v 1.2 2004/11/19 18:42:39 peter Exp $ -->
<chapter id="components"> <?dbhtml filename="components.html"?>
<title>Package components - files, directories and contents</title>
@@ -183,45 +183,6 @@
<filename>patch-aa</filename> is applied before
<filename>patch-ab</filename>, etc.</para>
- <para> Patch files which are optional and will depend on local
- site configuration can be included with names matching the
- pattern <filename>patches/patch-optional-*</filename>. Their
- suffixes should match the configuration options. The selected
- optional patch file names should be assigned to the variable
- <varname>OPTIONAL_PATCHFILES</varname>. They will not be
- applied by default.
- </para>
-
- <para> For example if a package data file needs patching to
- indicate the default local printer paper size as specified in
- the <varname>$PAPERSIZE</varname> file you can include patches
- for all the possible paper sizes other than the one the package
- comes configured for by default. In this case you might have a
- patch called
- "<filename>patch-optional-Letter-papersize</filename>" and/or
- another patch called
- "<filename>patch-optional-A4-papersize</filename>". In your
- <filename>Makefile</filename> you would select between them with
- the following construct:
- </para>
-
- <programlisting>
- PATCHDIR= ${.CURDIR}/patches
- .if exists(${PATCHDIR}/patch-optional-${PAPERSIZE}-papersize)
- OPTIONAL_PATCHFILES+= ${PATCHDIR}/patch-optional-${PAPERSIZE}-papersize
- .endif </programlisting>
-
- <para> Note that you have to define the value of
- <varname>PATCHDIR</varname> in order to use it in a
- <quote><command>.if</command></quote> statement like this as
- otherwise it's not defined until too late during the processing
- of the Makefile. You should use a
- <quote><command>.if</command></quote> statement in order to
- avoid problems should the configuration item
- (<varname>$PAPERSIZE</varname> in this example) be set to an
- unexpected value.
- </para>
-
<para>The <filename>patch-*</filename> files should be in
<command>diff -bu</command> format, and apply without a fuzz to avoid
problems. (To force patches to apply