[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
pkgsrc/doc/guide/files/buildlink.xml: 1.25 -> 1.26

Subject: pkgsrc/doc/guide/files/buildlink.xml: 1.25 -> 1.26
From: kano@na.rim.or.jp (OKANO Takayoshi)
To: www-changes-ja@jp.NetBSD.org
Date: Tue, 24 Mar 2009 22:48:17 +0900 (JST)
Message-Id: <20090324.224817.41626334.kano@na.rim.or.jp>
Delivered-To: mailing list www-changes-ja@jp.netbsd.org
Mailing-List: contact www-changes-ja-help@jp.netbsd.org; run by ezmlm-idx
以下のページの更新をしました。ツッコミをお願いします。

pkgsrc/doc/guide/files/buildlink.xml: 1.25 -> 1.26
> revision 1.26
> date: 2009/03/20 19:33:28;  author: joerg;  state: Exp;  lines: +17 -37
> Update buildlink3 section for the BUILDLINK_TREE changes.

水曜日までに異議がなければ、 commit します。

更新後の訳の全文は
  http://www.na.rim.or.jp/%7Ekano/tmp/docs/pkgsrc/buildlink.xml
  http://www.na.rim.or.jp/%7Ekano/tmp/docs/pkgsrc/buildlink.html
に置いてあります。

以下、訳と原文それぞれの新旧の差分です。

--- buildlink.xml.orig	2009-03-24 22:43:54.000000000 +0900
+++ buildlink.xml	2009-03-24 22:43:54.000000000 +0900
@@ -1,6 +1,6 @@
-<!-- $NetBSD: buildlink.xml,v 1.25 2007/10/01 22:38:42 rillig Exp $ -->
+<!-- $NetBSD: buildlink.xml,v 1.26 2009/03/20 19:33:28 joerg Exp $ -->
 <!-- Based on english version: -->
-<!-- NetBSD: buildlink.xml,v 1.25 2007/10/01 22:38:42 rillig Exp   -->
+<!-- NetBSD: buildlink.xml,v 1.26 2009/03/20 19:33:28 joerg Exp   -->
 
 <chapter id="buildlink">
   <title>buildlink 方法論</title>
@@ -193,51 +193,31 @@
       <filename>buildlink3.mk</filename> の実例です。</para>
 
 <programlisting>
-# &#36;NetBSD: buildlink3.mk,v 1.7 2004/03/18 09:12:12 jlam Exp &#36;
+# &#36;NetBSD: buildlink3.mk,v 1.16 2009/03/20 19:24:45 joerg Exp &#36;
 
-BUILDLINK_DEPTH:=       ${BUILDLINK_DEPTH}+
-TIFF_BUILDLINK3_MK:=    ${TIFF_BUILDLINK3_MK}+
+BUILDLINK_TREE+=	tiff
 
-.if ${BUILDLINK_DEPTH} == "+"
-BUILDLINK_DEPENDS+=     tiff
-.endif
-
-BUILDLINK_PACKAGES:=    ${BUILDLINK_PACKAGES:Ntiff}
-BUILDLINK_PACKAGES+=    tiff
-
-.if ${TIFF_BUILDLINK3_MK} == "+"
-BUILDLINK_API_DEPENDS.tiff+=        tiff>=3.6.1
-BUILDLINK_PKGSRCDIR.tiff?=      ../../graphics/tiff
-.endif  # TIFF_BUILDLINK3_MK
+.if !defined(TIFF_BUILDLINK3_MK)
+TIFF_BUILDLINK3_MK:=
+
+BUILDLINK_API_DEPENDS.tiff+=	tiff>=3.6.1
+BUILDLINK_ABI_DEPENDS.tiff+=	tiff>=3.7.2nb1
+BUILDLINK_PKGSRCDIR.tiff?=	../../graphics/tiff
 
 .include "../../devel/zlib/buildlink3.mk"
 .include "../../graphics/jpeg/buildlink3.mk"
+.endif # TIFF_BUILDLINK3_MK
 
-BUILDLINK_DEPTH:=       ${BUILDLINK_DEPTH:S/+$//}
+BUILDLINK_TREE+=	-tiff
 </programlisting>
 
       <para>ヘッダーとフッターで、
-      <varname>BUILDLINK_DEPTH</varname> の値を操作しています。
-      この変数は、<filename>buildlink3.mk</filename>
-      を何段階インクルードしているかを追跡するために、
+      <varname>BUILDLINK_TREE</varname> の値を操作しています。
+      この変数は、パッケージの依存関係を辿るために、
       すべての <filename>buildlink3.mk</filename> ファイルの間で、
       共通に使われます。</para>
 
-      <para>最初の節では、
-      <replaceable>pkg</replaceable>
-      への依存性が追加されるかどうかを制御しています。
-      <varname>BUILDLINK_DEPENDS</varname> は、
-      buildlink3 によって依存性が追加されるパッケージの大域的なリストです。</para>
-
-      <para>二つ目の節では、<replaceable>pkg</replaceable> の
-      <filename>buildlink3.mk</filename> ファイルがどこかでインクルードされていることを
-      pkgsrc に教えています。
-      <varname>BUILDLINK_PACKAGES</varname> は、<filename>buildlink3.mk</filename>
-      ファイルがインクルードされているパッケージの大域的なリストです。
-      <filename>buildlink3.mk</filename> ファイルでは、
-      この追加を<emphasis>必ず</emphasis>おこなう必要があります。</para>
-
-      <para>三つ目の節では、多重のインクルードを防いだうえで、
+      <para>本体の節では、多重のインクルードを防いだうえで、
       <replaceable>pkg</replaceable> への依存性をどのように追加するかを制御しています。
       いくつもの重要な変数がこの節で設定されます。</para>
 
@@ -344,15 +324,17 @@
 	</listitem>
       </itemizedlist>
 
-      <para>最後の節では、
+      <para>この節では、
       <replaceable>pkg</replaceable> のライブラリー依存性として必要な
-      <filename>buildlink3.mk</filename> をすべてインクルードしています。
+      <filename>buildlink3.mk</filename> をすべてインクルードすることができます。
       ここで <filename>buildlink3.mk</filename> ファイルをインクルードすると、
       <replaceable>pkg</replaceable> の
       <filename>buildlink3.mk</filename> ファイルがインクルードされる場合はいつも、
       これらへの依存性のためのヘッダーやライブラリーも、
       <filename>${BUILDLINK_DIR}</filename>
-      からシンボリックリンクされることになります。</para>
+      からシンボリックリンクされることになります。
+      依存性が追加されるのは、
+      <filename>buildlink3.mk</filename> ファイルを直接インクルードした場合だけです。</para>
     </sect2>
 
     <sect2 id="updating-buildlink-depends">
Index: buildlink.xml
===================================================================
RCS file: /cvsroot/pkgsrc/doc/guide/files/buildlink.xml,v
retrieving revision 1.25
retrieving revision 1.26
diff -u -r1.25 -r1.26
--- buildlink.xml	1 Oct 2007 22:38:42 -0000	1.25
+++ buildlink.xml	20 Mar 2009 19:33:28 -0000	1.26
@@ -1,4 +1,4 @@
-<!-- $NetBSD: buildlink.xml,v 1.25 2007/10/01 22:38:42 rillig Exp $ -->
+<!-- $NetBSD: buildlink.xml,v 1.26 2009/03/20 19:33:28 joerg Exp $ -->
 
 <chapter id="buildlink">
   <title>Buildlink methodology</title>
@@ -189,51 +189,30 @@
       from <filename>pkgsrc/graphics/tiff</filename>:</para>
 
 <programlisting>
-# &#36;NetBSD: buildlink3.mk,v 1.7 2004/03/18 09:12:12 jlam Exp &#36;
+# &#36;NetBSD: buildlink3.mk,v 1.16 2009/03/20 19:24:45 joerg Exp &#36;
 
-BUILDLINK_DEPTH:=       ${BUILDLINK_DEPTH}+
-TIFF_BUILDLINK3_MK:=    ${TIFF_BUILDLINK3_MK}+
+BUILDLINK_TREE+=	tiff
 
-.if ${BUILDLINK_DEPTH} == "+"
-BUILDLINK_DEPENDS+=     tiff
-.endif
-
-BUILDLINK_PACKAGES:=    ${BUILDLINK_PACKAGES:Ntiff}
-BUILDLINK_PACKAGES+=    tiff
-
-.if ${TIFF_BUILDLINK3_MK} == "+"
-BUILDLINK_API_DEPENDS.tiff+=        tiff>=3.6.1
-BUILDLINK_PKGSRCDIR.tiff?=      ../../graphics/tiff
-.endif  # TIFF_BUILDLINK3_MK
+.if !defined(TIFF_BUILDLINK3_MK)
+TIFF_BUILDLINK3_MK:=
+
+BUILDLINK_API_DEPENDS.tiff+=	tiff>=3.6.1
+BUILDLINK_ABI_DEPENDS.tiff+=	tiff>=3.7.2nb1
+BUILDLINK_PKGSRCDIR.tiff?=	../../graphics/tiff
 
 .include "../../devel/zlib/buildlink3.mk"
 .include "../../graphics/jpeg/buildlink3.mk"
+.endif # TIFF_BUILDLINK3_MK
 
-BUILDLINK_DEPTH:=       ${BUILDLINK_DEPTH:S/+$//}
+BUILDLINK_TREE+=	-tiff
 </programlisting>
 
       <para>The header and footer manipulate
-      <varname>BUILDLINK_DEPTH</varname>, which is common across all
+      <varname>BUILDLINK_TREE</varname>, which is common across all
       <filename>buildlink3.mk</filename> files and is used to track
-      at what depth we are including
-      <filename>buildlink3.mk</filename> files.</para>
-
-      <para>The first section controls if the dependency on
-      <replaceable>pkg</replaceable> is added.
-      <varname>BUILDLINK_DEPENDS</varname> is the global list of
-      packages for which dependencies are added by
-      buildlink3.</para>
-
-      <para>The second section advises pkgsrc that the
-      <filename>buildlink3.mk</filename> file for
-      <replaceable>pkg</replaceable> has been included at some point.
-      <varname>BUILDLINK_PACKAGES</varname> is the global list of
-      packages for which <filename>buildlink3.mk</filename> files
-      have been included.  It must <emphasis>always</emphasis> be
-      appended to within a <filename>buildlink3.mk</filename>
-      file.</para>
+      the dependency tree.</para>
 
-      <para>The third section is protected from multiple inclusion
+      <para>The main section is protected from multiple inclusion
       and controls how the dependency on <replaceable>pkg</replaceable> is
       added.  Several important variables are set in the section:</para>
 
@@ -341,7 +320,7 @@
 	</listitem>
       </itemizedlist>
 
-      <para>The last section includes any
+      <para>This section can additionally include any
       <filename>buildlink3.mk</filename> needed for
       <replaceable>pkg</replaceable>'s library dependencies.
       Including these <filename>buildlink3.mk</filename> files
@@ -350,7 +329,8 @@
       <filename>${BUILDLINK_DIR}</filename>
       whenever the <replaceable>pkg</replaceable>
       <filename>buildlink3.mk</filename>
-      file is included.</para>
+      file is included. Dependencies are only added for directly
+      include <filename>buildlink3.mk</filename> files.</para>
     </sect2>
 
     <sect2 id="updating-buildlink-depends">
Prev by Date: pkgsrc/doc/guide/files/plist.xml: 1.14 -> 1.16
Next by Date: CVS commit: htdocs
Prev by thread: pkgsrc/doc/guide/files/plist.xml: 1.14 -> 1.16
Index(es):
- Date
- Thread