[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
pkgsrc/doc/guide/files/binary.xml: 1.23 -> 1.24 ほか
以下のページの更新をしました。ツッコミをお願いします。
pkgsrc/doc/guide/files/binary.xml: 1.23 -> 1.24
pkgsrc/doc/guide/files/fixes.xml: 1.46 -> 1.47
> Fixed references to non-existent packages. When a package needs source
> files from another package, it should just add that other package to
> DISTFILES instead of (cd otherpackage && make extract).
月曜日までに異議がなければ、 commit します。
以下、訳と原文それぞれの新旧の差分です。
--- binary.xml.orig 2006-11-04 18:23:18.000000000 +0900
+++ binary.xml 2006-11-04 18:23:18.000000000 +0900
@@ -1,6 +1,6 @@
-<!-- $NetBSD: binary.xml,v 1.23 2006/03/03 22:22:07 wiz Exp $ -->
+<!-- $NetBSD: binary.xml,v 1.24 2006/03/12 11:34:09 rillig Exp $ -->
<!-- Based on english version: -->
-<!-- NetBSD: binary.xml,v 1.23 2006/03/03 22:22:07 wiz Exp -->
+<!-- NetBSD: binary.xml,v 1.24 2006/03/12 11:34:09 rillig Exp -->
<chapter id="binary">
<title>バイナリーパッケージを作る</title>
@@ -377,9 +377,10 @@
</step>
<step>
- <para><filename>/usr/src</filename> (<filename
- role="pkg">sysutils/aperture</filename>,
- <filename role="pkg">net/ppp-mppe</filename>用のシステムソース):</para>
+
+ <para><filename>/usr/src</filename> (たとえば
+ <filename
+ role="pkg">sysutils/aperture</filename> 用のシステムソース):</para>
<screen>&rprompt; <userinput>ln -s ../disk1/cvs .</userinput>
&rprompt; <userinput>ln -s cvs/src-2.0 src</userinput></screen>
--- fixes.xml.orig 2006-11-04 18:23:19.000000000 +0900
+++ fixes.xml 2006-11-04 18:23:19.000000000 +0900
@@ -1,6 +1,6 @@
-<!-- $NetBSD: fixes.xml,v 1.46 2006/03/09 16:34:08 rillig Exp $ -->
+<!-- $NetBSD: fixes.xml,v 1.47 2006/03/12 11:34:09 rillig Exp $ -->
<!-- Based on english version: -->
-<!-- NetBSD: fixes.xml,v 1.46 2006/03/09 16:34:08 rillig Exp -->
+<!-- NetBSD: fixes.xml,v 1.47 2006/03/12 11:34:09 rillig Exp -->
<chapter id="fixes"> <?dbhtml filename="fixes.html"?>
<title>パッケージを動くようにする</title>
@@ -162,11 +162,11 @@
</listitem>
<listitem>
- <para>パッケージがリンクのためのライブラリーを必要とし、
- そのパッケージにやはり <filename>buildlink3.mk</filename> ファイルがない場合は、
- <varname>DEPENDS</varname>定義を使ってください。たとえば、
- <filename role="pkg">print/lyx</filename>パッケージは、作成のためにxpm
- ライブラリーのバージョン3.4jを使用します。</para>
+
+ <para>パッケージがリンクのためのライブラリーを必要とし、
+ そのパッケージにやはり <filename>buildlink3.mk</filename> ファイルがない場合は、
+ <varname>DEPENDS</varname> 定義を使ってください。
+ たとえば以下のようにします。</para>
<programlisting>
DEPENDS+= xpm-3.4j:../../graphics/xpm
@@ -252,26 +252,13 @@
</listitem>
</orderedlist>
- <para>パッケージの構築用に別のパッケージに含まれるファイルが必要な場合は、
- <filename role="pkg">print/ghostscript5</filename>パッケージの<quote>do-configure</quote>ターゲットの最初の部分を
- ご覧ください(このパッケージは、構築の際にjpegのソースがソースの状態で存在す
- ることに依存しています)。</para>
-
-<programlisting>
- if [ ! -e ${_PKGSRCDIR}/graphics/jpeg/${WRKDIR:T}/jpeg-6b ]; then \
- cd ${_PKGSRCDIR}/../../graphics/jpeg && ${MAKE} extract; \
- fi
-</programlisting>
-
- <para>このように、別のパッケージの構築用にソースを展開する場合は、構築するパッケー
- ジの作業ファイルの削除時に、展開した依存先パッケージの作業ファイルも削除す
- るようにしてください。そうするための一番簡単な方法は、pre-cleanターゲットを
- 追加することです。</para>
-
-<programlisting>
- pre-clean:
- cd ${_PKGSRCDIR}/../../graphics/jpeg && ${MAKE} clean
-</programlisting>
+ <para>パッケージの構築用に別のパッケージに含まれるファイルが必要な場合は、
+ 関連する配布ファイルを
+ <varname>DISTFILES</varname> に追加して、
+ 必要なファイルが自動的に展開されるようにします。例としては <filename
+ role="pkg">print/ghostscript</filename> パッケージをご覧ください。
+ (このパッケージは、
+ 構築の際に jpeg のソースがソースの状態で存在することに依存しています。)</para>
<para>また、便利に使うことができる<varname>BUILD_USES_MSGFMT</varname>および
<varname>BUILD_USES_GETTEXT_M4</varname>定
@@ -459,22 +446,16 @@
この使い方の例となっています。
</para>
- <para>パスワード用に個人情報の登録が必要だったり、ソースに代金を払う必要があった
- り、その他もろもろの理由により、ダウンロードが自動化できない場合は、
- <varname>_FETCH_MESSAGE</varname>に、説明文を表示するマクロを設定することができます。
- <varname>_FETCH_MESSAGE</varname>は、説明文そのものではなく、実行可能なシェルコマンドである必
- 要があります。(一般的には、
- <varname>${ECHO}</varname>を実行します)。本稿執筆時点で、この方法を
- 使っているパッケージは、
- <filename role="pkg">cad/simian</filename>,
- <filename role="pkg">devel/ipv6socket</filename>,
- <filename role="pkg">emulators/vmware-module</filename>,
- <filename role="pkg">fonts/acroread-jpnfont</filename>,
- <filename role="pkg">multimedia/realplayer</filename>,
- <filename role="pkg">sysutils/storage-manager</filename>,
- <filename role="pkg">www/ap-aolserver</filename>,
- <filename role="pkg">www/openacs</filename> です。
- これらと一貫性のある使い方をしてください。</para>
+ <para>パスワード用に個人情報の登録が必要だったり、ソースに代金を払う必要があった
+ り、その他もろもろの理由により、ダウンロードが自動化できない場合は、
+ <varname>_FETCH_MESSAGE</varname>に、説明文を表示するマクロを設定することができます。
+ <varname>_FETCH_MESSAGE</varname>は、説明文そのものではなく、実行可能なシェルコマンドである必
+ 要があります。(一般的には、
+ <varname>${ECHO}</varname>を実行します)。例としては、
+ 以下のパッケージのいずれかをご覧ください:
+ <filename role="pkg">fonts/acroread-jpnfont</filename>,
+ <filename role="pkg">sysutils/storage-manager</filename>.</para>
+
</sect2>
Index: binary.xml
===================================================================
RCS file: /cvsroot/pkgsrc/doc/guide/files/binary.xml,v
retrieving revision 1.23
retrieving revision 1.24
diff -u -r1.23 -r1.24
--- binary.xml 3 Mar 2006 22:22:07 -0000 1.23
+++ binary.xml 12 Mar 2006 11:34:09 -0000 1.24
@@ -1,4 +1,4 @@
-<!-- $NetBSD: binary.xml,v 1.23 2006/03/03 22:22:07 wiz Exp $ -->
+<!-- $NetBSD: binary.xml,v 1.24 2006/03/12 11:34:09 rillig Exp $ -->
<chapter id="binary">
<title>Creating binary packages</title>
@@ -396,9 +396,10 @@
</step>
<step>
- <para><filename>/usr/src</filename> (system sources, for <filename
- role="pkg">sysutils/aperture</filename>,
- <filename role="pkg">net/ppp-mppe</filename>):</para>
+
+ <para><filename>/usr/src</filename> (system sources,
+ e. g. for <filename
+ role="pkg">sysutils/aperture</filename>):</para>
<screen>&rprompt; <userinput>ln -s ../disk1/cvs .</userinput>
&rprompt; <userinput>ln -s cvs/src-2.0 src</userinput></screen>
Index: fixes.xml
===================================================================
RCS file: /cvsroot/pkgsrc/doc/guide/files/fixes.xml,v
retrieving revision 1.46
retrieving revision 1.47
diff -u -r1.46 -r1.47
--- fixes.xml 9 Mar 2006 16:34:08 -0000 1.46
+++ fixes.xml 12 Mar 2006 11:34:09 -0000 1.47
@@ -1,4 +1,4 @@
-<!-- $NetBSD: fixes.xml,v 1.46 2006/03/09 16:34:08 rillig Exp $ -->
+<!-- $NetBSD: fixes.xml,v 1.47 2006/03/12 11:34:09 rillig Exp $ -->
<chapter id="fixes"> <?dbhtml filename="fixes.html"?>
<title>Making your package work</title>
@@ -178,12 +178,11 @@
</listitem>
<listitem>
- <para>If your package needs a library with which to link and
- again there is no <filename>buildlink3.mk</filename> file
- available, this is specified using the
- <varname>DEPENDS</varname> definition. An example of this
- is the <filename role="pkg">print/lyx</filename> package,
- which uses the xpm library, version 3.4j to build:</para>
+
+ <para>If your package needs a library with which to link and
+ again there is no <filename>buildlink3.mk</filename> file
+ available, this is specified using the
+ <varname>DEPENDS</varname> definition. For example:</para>
<programlisting>
DEPENDS+= xpm-3.4j:../../graphics/xpm
@@ -279,27 +278,13 @@
</listitem>
</orderedlist>
- <para>If your package needs files from another package to build,
- see the first part of the <quote>do-configure</quote> target
- <filename role="pkg">print/ghostscript5</filename> package
- (it relies on the jpeg sources being present in source form
- during the build):</para>
-
-<programlisting>
- if [ ! -e ${_PKGSRCDIR}/graphics/jpeg/${WRKDIR:T}/jpeg-6b ]; then \
- cd ${_PKGSRCDIR}/../../graphics/jpeg && ${MAKE} extract; \
- fi
-</programlisting>
-
- <para>If you build any other packages that way, please make sure
- the working files are deleted too when this package's working
- files are cleaned up. The easiest way to do so is by adding a
- pre-clean target:</para>
-
-<programlisting>
- pre-clean:
- cd ${_PKGSRCDIR}/../../graphics/jpeg && ${MAKE} clean
-</programlisting>
+ <para>If your package needs files from another package to build,
+ add the relevant distribution files to
+ <varname>DISTFILES</varname>, so they will be extracted
+ automatically. See the <filename
+ role="pkg">print/ghostscript</filename> package for an example.
+ (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
@@ -495,24 +480,18 @@
example of this usage.
</para>
- <para>If the download can't be automated, because the user must
- submit personal information to apply for a password, or must pay
- for the source, or whatever, you can set
- <varname>_FETCH_MESSAGE</varname> to a macro which displays a
- message explaining the
- situation. <varname>_FETCH_MESSAGE</varname> must be executable
- shell commands, not just a message. (Generally, it executes
- <varname>${ECHO}</varname>). As of this writing, the following
- packages use this:
- <filename role="pkg">cad/simian</filename>,
- <filename role="pkg">devel/ipv6socket</filename>,
- <filename role="pkg">emulators/vmware-module</filename>,
- <filename role="pkg">fonts/acroread-jpnfont</filename>,
- <filename role="pkg">multimedia/realplayer</filename>,
- <filename role="pkg">sysutils/storage-manager</filename>,
- <filename role="pkg">www/ap-aolserver</filename>,
- <filename role="pkg">www/openacs</filename>. Try to be
- consistent with them.</para>
+ <para>If the download can't be automated, because the user must
+ submit personal information to apply for a password, or must pay
+ for the source, or whatever, you can set
+ <varname>_FETCH_MESSAGE</varname> to a macro which displays a
+ message explaining the situation.
+ <varname>_FETCH_MESSAGE</varname> must be executable shell
+ commands, not just a message. (Generally, it executes
+ <varname>${ECHO}</varname>). See one of the following packages
+ for an example:
+ <filename role="pkg">fonts/acroread-jpnfont</filename>,
+ <filename role="pkg">sysutils/storage-manager</filename>.</para>
+
</sect2>