[cvs] web/xml/packaging packaging.ja.xml, 1.39, 1.40 packaging.zh.xml, 1.27, 1.28

[BABA Yoshihiko]

Update of /cvsroot/fink/web/xml/packaging
In directory sc8-pr-cvs5.sourceforge.net:/tmp/cvs-serv5645

Modified Files:
        packaging.ja.xml packaging.zh.xml 
Log Message:
InfoTest (en 1.88)

Index: packaging.zh.xml
===================================================================
RCS file: /cvsroot/fink/web/xml/packaging/packaging.zh.xml,v
retrieving revision 1.27
retrieving revision 1.28
diff -u -d -r1.27 -r1.28
--- packaging.zh.xml    11 Apr 2006 23:52:29 -0000      1.27
+++ packaging.zh.xml    19 Sep 2006 05:54:30 -0000      1.28
@@ -1123,7 +1123,14 @@
 这三个字段来控制有关细节。</p>
 <p>在<em>补丁阶段</em>，源代码会被打上补丁，以使得可以在 
Darwin 下面编译。由 UpdateConfigGuess，UpdateLibtool，Patch 和 
PatchScrip 这几个字段所指明的操作将被按照顺序执行。</p>
 
<p>在<em>编译阶段</em>，源代码被配置和编译。通常这会以某些参数来调用
 <code>configure</code> 脚本，然后执行一个 <code>make</code> 命令。
-详细信息请查看 CompileScript 字段的描述。</p>
+详细信息请查看 CompileScript 字段的描述。
+<!-- start translation -->
+If test suites are enabled
+for the build (a new feature in fink 0.25, currently achieved by building in
+maintainer mode), the TestScript will be run immediately after the
+CompileScript.
+<!-- end translation -->
+</p>
 
<p>在<em>安装阶段</em>，软件包被安装到一个临时目录，<filename>/sw/src/fink.build/root-gimp-1.2.1-1</filename>
 (= %d)。(注意 &quot;root-&quot; 部分。)
 所有通常应该安装到 <filename>/sw</filename> 
的文件现在被安装在
 <filename>/sw/src/fink.build/root-gimp-1.2.1-1/sw</filename> (= %i = %d%p)。 
@@ -1469,6 +1476,11 @@
 <em>从 fink 0.9.0 开始。</em>
 只在编译时需要的依赖关系的清单。
 这可以用于列出构建软件包必须使用工具(比如 
flex)。它支持和 Depends 相同的语法。
+<!-- start translation -->
+If a build is being done
+with test suites enabled, the dependencies in the <code>TestDepends</code>
+field will be added to this list.
+<!-- end translation -->
 </p>
 </itemd></item>
 
@@ -1510,7 +1522,9 @@
 being compiled. This can be used to prevent <code>./configure</code>
 or the compiler from seeing undesired library headers or to avoid use
 of a version of a tool that is known to be broken (for example, a bug
-in a certain version of sed).
+in a certain version of sed).  If a build is being done
+with test suites enabled, the packages in the <code>TestConflicts</code>
+field will be added to this list.
 </p>
 </itemd></item>
 <!-- end translation -->
@@ -1622,6 +1636,10 @@
 <!-- start translation -->
 This implicitly-defined <code>Source</code> form is deprecated
 (explicitly-stated simple filename/manual download is still okay).
+</p><p>
+Sources that are only needed in order to run test suites should
+use <code>TestSource</code> and related fields, inside the
+<code>InfoTest</code> block.
 </p>
 <!-- end translation -->
 </itemd></item>
@@ -1929,6 +1947,9 @@
 <p>
 传递给 configure 脚本的额外参数(查阅
 CompileScript 字段的说明获取详细信息)。
+If a build is being done
+with test suites enabled, the value of the <code>TestConfigureParams</code>
+field will be appended to this.
 
 对于 &lt; 0.13.7 的 fink 版本，这个参数也对 perl 模块<code>Type: 
Perl</code>有效，并会添加到默认的 perl Makefile.PL
 字符串中。
@@ -2043,7 +2064,6 @@
 <p>where <code>$perlarchdir</code> is "darwin" for versions 5.8.0 and 
 earlier, and is 
 "darwin-thread-multi-2level" for versions 5.8.1 and later.</p>
-<!-- end translation -->
 </itemd></item>
 
 <item><itemt>NoPerlTests</itemt>
@@ -2055,6 +2075,48 @@
 </itemd></item>
 
 </itemtable>
+<p><em>Test Suites:</em></p>
+<itemtable>
+
+<item><itemt>InfoTest</itemt>
+<itemd>
+<p>
+<em>Introduced in fink 0.25.</em>
+This field encapsulates information that will only be used when performing
+a build with test suites enabled.  It contains other fields.
+If present, this field <em>must</em> contain a <code>TestScript</code>.
+All other fields are optional.  The following fields are allowed inside
+<code>InfoTest</code>:
+</p><ul>
+<li><code>TestScript</code>: A script which runs the test suite.  This script 
should exit
+    with status 0 if the suite passes, 1 to indicate warnings, or any other
+    value to indicate failures serious enough to be considered fatal.
+    Because of this tri-state logic, you should explicitly set an exit value in
+    this script.  For instance, <code>make check</code> is a bad script,
+    since it will exit with status 1 if the check target doesn't exist.
+    <code>make check || exit 2</code> would be a better script.</li>
+<li><code>TestConfigureParams</code>: A value which will be appended to 
<code>ConfigureParams</code>.</li>
+<li><code>TestDepends</code> and <code>TestConflicts</code>: Lists of packages 
that will be added to the <code>BuildDepends</code> or 
<code>BuildConflicts</code> lists.</li>
+<li><code>TestSource</code>: Extra sources necessary to run the test suite.  
All of the
+    affiliated fields are also supported, so you <em>must</em> also specify
+    <code>TestSource-MD5</code>, and you may also have
+    <code>TestSourceN</code> and corresponding <code>TestSourceN-MD5</code>,
+    <code>TestTarFilesRename</code>, etc.</li>
+<li><code>TestSuiteSize</code>: Describes approximately how long the test 
suite takes to
+    run.  Valid values are <code>small</code>, <code>medium</code>, and 
<code>large</code>.
+    This field is currently ignored.</li>
+<li>Any other standard field.  If a field is specified both inside and outside
+<code>InfoTest</code>, the value inside <code>InfoTest</code> will replace
+the other value when test suites are active.</li>
+</ul><p>Here's an example:
+</p><codeblock>InfoTest: &lt;&lt;
+    TestScript: make check || exit 2
+    TestConfigureParams: --enable-tests
+&lt;&lt;</codeblock>
+</itemd></item>
+</itemtable>
+<!-- end translation -->
+
 <p><em>安装阶段：</em></p>
 <itemtable>
 

Index: packaging.ja.xml
===================================================================
RCS file: /cvsroot/fink/web/xml/packaging/packaging.ja.xml,v
retrieving revision 1.39
retrieving revision 1.40
diff -u -d -r1.39 -r1.40
--- packaging.ja.xml    11 Apr 2006 23:52:29 -0000      1.39
+++ packaging.ja.xml    19 Sep 2006 05:54:30 -0000      1.40
@@ -1394,6 +1394,8 @@
                                
<em>コンパイル段階</em>ではソースの configure 
とコンパイルが行われます．
                                普通はスクリプト <code>configure</code> 
を適切な引数で起動し，コマンド <code>make</code> 
を実行することになります．
                                詳細はフィールド CompileScript 
を参照して下さい．
+                               
ビルドに対しテストスイートが有効な場合 (fink 0.25 
の新しい機能で，現在メンテナモードでビルド中に適用される)，
+                               CompileScript の直後に TestScript 
が実行される．
                        </p>
                        <p>
                                
<em>インストール段階</em>では，パッケージは仮ディレクトリ
@@ -1786,6 +1788,9 @@
                                                        
ビルド時のみに適用される依存性のリスト．
                                                        
ビルド時には必要だが，実行時には使われないツール 
(flexなど) を示すのに使う．
                                                        書式は Depends 
と同じ．
+                                                       
ビルドされる際にテストスイートが有効であれば，
+                                                       <code>TestDepends</code>
+                                                       
がこのリストに追加される．
                                                </p>
                                        </itemd>
                                </item>
@@ -1834,6 +1839,7 @@
 
当該パッケージがコンパイル中にインストールされてはいけないパッケージの一覧．
 これは， <code>./configure</code> 
やコンパイラが，望ましくないライブラリヘッダを見たり，
 壊れることが分かっているツール 
(例えば，特定のバージョンの sed にあるバグ) 
のバージョンを使用することを避けるために使います．
+ビルド時にテストスイートが有効な場合， 
<code>TestConflicts</code> 
フィールド内のパッケージはこのリストに追加されます．
 </p>
 </itemd></item>
                                <item>
@@ -1956,6 +1962,9 @@
                                                        <code>gnome</code> 
という値は <code>mirror:gnome:stable/sources/%n/%n-%v.tar.gz</code> 
の省略形．
                                                        デフォルト値は 
<code>%n-%v.tar.gz</code>  (すなわちマニュアル・ダウンロード) 
になっている．
                                                        暗示的に 
<code>Source</code> を指定するのは廃止予定である 
(明示的に簡単なファイル名指定/手動ダウンロードするのは可)．
+</p><p>
+テストスイートを実行するためだけに必要なソースは，<code>TestSource</code>
+および <code>InfoTest</code> 
内の関連フィールドを使ってください．
                                                </p>
                                        </itemd>
                                </item>
@@ -2316,6 +2325,8 @@
                                                <p>
                                                        configure 
スクリプトに渡す付加的なパラメータ．
                                                        (詳細は 
CompileScript を参照)
+                                                       
ビルド時にテストスイートが有効な場合，<code>TestConfigureParams</code>
+                                                       
の値がここに追加されます．
 
                                                        バージョン 0.13.7 
以降の Fink では，
                                                        
このパラメータは <code>Type: Perl</code> となっている perl 
モジュールにも使えます．
@@ -2442,6 +2453,52 @@
                                        </itemd>
                                </item>
                        </itemtable>
+                       
+<p><em>テストスイート:</em></p>
+<itemtable>
+
+<item><itemt>InfoTest</itemt>
+<itemd>
+<p>
+<em>fink 0.25 にて導入．</em>
+当フィールドは，テストスイートが有効な場合のビルド実行時にのみ使用される情報を包んだものです．
+ここには他のフィールドが含まれます．
+現在のところ，この中に  <code>TestScript</code> 
がなければ<em>なりません</em>．
+他のフィールドはオプションです．
+以下のフィールドが <code>InfoTest</code> 
にて許可されています:
+</p><ul>
+<li><code>TestScript</code>: 
+    テストスイートを実行するスクリプト．
+    このスクリプトは，スイートが終了するときは status 
を返します．
+    0 の場合は通ったことを示し，
+    1 の場合は警告があり，
+    
他の値の場合は致命的と考えられる重大な問題があったことを示します．
+    
この3状態のため，スクリプト内で終了値を明示的に設定しなければなりません．
+    例えば， <code>make check</code> は悪いスクリプトです．
+    これは終了時に，check のターゲットが存在しなければ 
status 1 を返すからです．
+    <code>make check || exit 2</code> 
は比較的良いスクリプトです．
+    </li>
+<li><code>TestConfigureParams</code>: 
+    
テストスイートを実行するために必要な追加ソースです．
+    関連する全てのフィールドもサポートされています．
+    
<code>TestSource-MD5</code>は指定されなければ<em>なりません</em>．
+    <code>TestSourceN</code> や対応する <code>TestSourceN-MD5</code> , 
<code>TestTarFilesRename</code> 
などを追加することも可能です．</li>
+<li><code>TestSuiteSize</code>: 
+    
テストスイートどの程度かかるかのおよその時間を示します．
+    値は，<code>small</code>, <code>medium</code>, と <code>large</code> 
です．
+    このフィールドは現在のところ無視されます．
+    </li>
+<li>
+その他のフィールド．<code>InfoTest</code> 
内と外で定義されるフィールドに関して，
+スイートが有効な場合，<code>InfoTest</code> 
内の値が他の値を書き換えます．</li>
+</ul><p>例:
+</p><codeblock>InfoTest: &lt;&lt;
+    TestScript: make check || exit 2
+    TestConfigureParams: --enable-tests
+&lt;&lt;</codeblock>
+</itemd></item>
+</itemtable>
+                       
                        <p>
                                <em>インストール段階関連:</em>
                        </p>



-------------------------------------------------------------------------
Take Surveys. Earn Cash. Influence the Future of IT
Join SourceForge.net's Techsay panel and you'll get the chance to share your
opinions on IT & business topics through brief surveys -- and earn cash
http://www.techsay.com/default.php?page=join.php&p=sourceforge&CID=DEVDEV
_______________________________________________
Fink-commits mailing list
Fink-commits@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/fink-commits