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

Subject: pkgsrc/doc/guide/files/build.xml: 1.25 -> 1.27
From: kano@na.rim.or.jp (OKANO Takayoshi)
To: www-changes-ja@jp.NetBSD.org
Date: Fri, 10 Nov 2006 22:32:11 +0900 (JST)
Message-Id: <200611101332.WAA59611@shell.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/build.xml: 1.25 -> 1.27

> revision 1.27
> date: 2006/04/21 07:54:12;  author: rillig;  state: Exp;  lines: +11 -8
> Specified the structure and interpretation of the WRAPPER_REORDER_CMDS
> variable.
> ----------------------------
> revision 1.26
> date: 2006/04/21 07:30:32;  author: rillig;  state: Exp;  lines: +46 -2
> Documented (parts of) the wrapper phase.

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

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

--- build.xml.orig	2006-11-10 22:31:26.000000000 +0900
+++ build.xml	2006-11-10 22:31:26.000000000 +0900
@@ -1,10 +1,6 @@
-<!-- $NetBSD: build.xml,v 1.25 2006/02/18 17:11:50 rillig Exp $ -->
+<!-- $NetBSD: build.xml,v 1.27 2006/04/21 07:54:12 rillig Exp $ -->
 <!-- Based on english version: -->
-<!-- NetBSD: build.xml,v 1.25 2006/02/18 17:11:50 rillig Exp   -->
-
-<!--
-	TODO: after 2006Q1, "SITES_" should be replaced with "SITES.".
--->
+<!-- NetBSD: build.xml,v 1.27 2006/04/21 07:54:12 rillig Exp   -->
 
 <chapter id="build">
 <title>構築の手順</title>
@@ -211,7 +207,7 @@
 </programlisting>
 
 	  <para>この${site}には、複数の候補が決まった順序で使われます: 最初に
-	    <varname>MASTER_SITE_OVERRIDE</varname>を試み、次に、<varname>SITES_file</varname>が定義されていればそれ
+	    <varname>MASTER_SITE_OVERRIDE</varname>を試み、次に、<varname>SITES.file</varname>が定義されていればそれ
 	    を、定義されていなければ、<varname>MASTER_SITES</varname>か<varname>PATCH_SITES</varname>のどちらかを試
 	    みます。そして、最後に<varname>MASTER_SITE_BACKUP</varname>の値を試みます。最初のもの以
 	    外の順序は、<varname>MASTER_SORT_AWK</varname>か<varname>MASTER_SORT_REGEX</varname>を設定して、ユーザー
@@ -307,8 +303,57 @@
 <sect1 id="build.wrapper">
 <title><emphasis>wrapper</emphasis> 相</title>
 
-<para>[TODO]</para>
+	<para>この相では、コンパイラーとリンカー用のラッパープログラムが作成されます。
+	以下の変数を使って、ラッパーに手を加えることができます。</para>
+
+	<variablelist>
+
+	<varlistentry><term><varname>ECHO_WRAPPER_MSG</varname></term>
+		<listitem><para>経過を表示するためのコマンドです。
+		標準状態では何もしません。
+		経過を見るには、この変数を <literal>${ECHO}</literal>
+		に設定します。</para></listitem></varlistentry>
+
+	<varlistentry><term><varname>WRAPPER_DEBUG</varname></term>
+		<listitem><para>この変数は、
+		ラッパーのログファイルにより詳しい情報が必要かどうかに応じて、
+		<literal>yes</literal> (標準状態の値) または
+		<literal>no</literal> に設定することができます。</para></listitem></varlistentry>
+
+	<varlistentry><term><varname>WRAPPER_UPDATE_CACHE</varname></term>
+		<listitem><para>この変数は、
+		ラッパーの速度を改善するためキャッシュを使わせるかどうかに応じて、
+		<literal>yes</literal> または <literal>no</literal>
+		に設定することができます。標準状態の値は
+		<literal>yes</literal> ですが、キャッシュに対応していないプラットフォームでは
+		強制的に <literal>no</literal>
+		になります。</para></listitem></varlistentry>
+
+	<varlistentry><term><varname>WRAPPER_REORDER_CMDS</varname></term>
+
+		<listitem><para>順序の並び替え用のコマンドを並べたリストです。
+		並び替え用のコマンドは、
+		<literal>reorder:l:<replaceable>lib1</replaceable>:<replaceable>lib2</replaceable></literal>
+		のような形式をしています。これを使うと
+		<literal>-l<replaceable>lib1</replaceable></literal>
+		が常に
+		<literal>-l<replaceable>lib2</replaceable></literal> より先に現れるようになります。
+		</para></listitem></varlistentry>
+
+	<varlistentry><term><varname>WRAPPER_TRANSFORM_CMDS</varname></term>
+		<listitem><para>変換用のコマンドを並べたリストです。 [TODO:
+		investigate further]</para></listitem></varlistentry>
+
+<!-- These should probably be internal variables
+	<varlistentry><term><varname>WRAPPEES</varname></term>
+		<listitem><para></para></listitem></varlistentry>
+	<varlistentry><term><varname>UNWRAP_PATTERNS</varname></term>
+		<listitem><para></para></listitem></varlistentry>
+	<varlistentry><term><varname>UNWRAP_FILES</varname></term>
+		<listitem><para></para></listitem></varlistentry>
+-->
 
+	</variablelist>
 </sect1>
 
 <sect1 id="build.configure">
Index: build.xml
===================================================================
RCS file: /cvsroot/pkgsrc/doc/guide/files/build.xml,v
retrieving revision 1.25
retrieving revision 1.27
diff -u -r1.25 -r1.27
--- build.xml	18 Feb 2006 17:11:50 -0000	1.25
+++ build.xml	21 Apr 2006 07:54:12 -0000	1.27
@@ -1,8 +1,4 @@
-<!-- $NetBSD: build.xml,v 1.25 2006/02/18 17:11:50 rillig Exp $ -->
-
-<!--
-	TODO: after 2006Q1, "SITES_" should be replaced with "SITES.".
--->
+<!-- $NetBSD: build.xml,v 1.27 2006/04/21 07:54:12 rillig Exp $ -->
 
 <chapter id="build">
 <title>The build process</title>
@@ -220,7 +216,7 @@
 
 	  <para>where ${site} varies through several possibilities in turn: first,
 	    <varname>MASTER_SITE_OVERRIDE</varname> is tried, then the sites
-	    specified in either <varname>SITES_file</varname> if defined, else
+	    specified in either <varname>SITES.file</varname> if defined, else
 	    <varname>MASTER_SITES</varname> or <varname>PATCH_SITES</varname>, as
 	    applies, then finally the value of
 	    <varname>MASTER_SITE_BACKUP</varname>. The order of all except the
@@ -325,8 +321,59 @@
 <sect1 id="build.wrapper">
 <title>The <emphasis>wrapper</emphasis> phase</title>
 
-<para>[TODO]</para>
+	<para>This phase creates wrapper programs for the compilers and
+	linkers. The following variables can be used to tweak the
+	wrappers.</para>
+
+	<variablelist>
+
+	<varlistentry><term><varname>ECHO_WRAPPER_MSG</varname></term>
+		<listitem><para>The command used to print progress
+		messages. Does nothing by default. Set to
+		<literal>${ECHO}</literal> to see the progress
+		messages.</para></listitem></varlistentry>
+
+	<varlistentry><term><varname>WRAPPER_DEBUG</varname></term>
+		<listitem><para>This variable can be set to
+		<literal>yes</literal> (default) or
+		<literal>no</literal>, depending on whether you want
+		additional information in the wrapper log
+		file.</para></listitem></varlistentry>
+
+	<varlistentry><term><varname>WRAPPER_UPDATE_CACHE</varname></term>
+		<listitem><para>This variable can be set to
+		<literal>yes</literal> or <literal>no</literal>,
+		depending on whether the wrapper should use its cache,
+		which will improve the speed. The default value is
+		<literal>yes</literal>, but is forced to
+		<literal>no</literal> if the platform does not support
+		it.</para></listitem></varlistentry>
+
+	<varlistentry><term><varname>WRAPPER_REORDER_CMDS</varname></term>
+
+		<listitem><para>A list of reordering commands. A
+		reordering command has the form
+		<literal>reorder:l:<replaceable>lib1</replaceable>:<replaceable>lib2</replaceable></literal>.
+		It ensures that that
+		<literal>-l<replaceable>lib1</replaceable></literal>
+		occurs before
+		<literal>-l<replaceable>lib2</replaceable></literal>.
+		</para></listitem></varlistentry>
+
+	<varlistentry><term><varname>WRAPPER_TRANSFORM_CMDS</varname></term>
+		<listitem><para>A list of transformation commands. [TODO:
+		investigate further]</para></listitem></varlistentry>
+
+<!-- These should probably be internal variables
+	<varlistentry><term><varname>WRAPPEES</varname></term>
+		<listitem><para></para></listitem></varlistentry>
+	<varlistentry><term><varname>UNWRAP_PATTERNS</varname></term>
+		<listitem><para></para></listitem></varlistentry>
+	<varlistentry><term><varname>UNWRAP_FILES</varname></term>
+		<listitem><para></para></listitem></varlistentry>
+-->
 
+	</variablelist>
 </sect1>
 
 <sect1 id="build.configure">
Prev by Date: Ports/xen/index.xml: 1.20 -> 1.21
Next by Date: pkgsrc/doc/guide/files/components.xml: 1.22 -> 1.23
Prev by thread: Ports/xen/index.xml: 1.20 -> 1.21
Next by thread: pkgsrc/doc/guide/files/components.xml: 1.22 -> 1.23
Index(es):
- Date
- Thread