Update of /cvsroot/fink/web/doc/packaging
In directory sc8-pr-cvs5.sourceforge.net:/tmp/cvs-serv3303
Modified Files:
compilers.en.php format.en.php fslayout.en.php index.en.php
intro.en.php policy.en.php reference.en.php
Log Message:
Document InfoTest
Index: compilers.en.php
===================================================================
RCS file: /cvsroot/fink/web/doc/packaging/compilers.en.php,v
retrieving revision 1.17
retrieving revision 1.18
diff -u -d -r1.17 -r1.18
--- compilers.en.php 22 Feb 2006 06:33:11 -0000 1.17
+++ compilers.en.php 18 Sep 2006 14:47:46 -0000 1.18
@@ -1,7 +1,7 @@
<?
$title = "Packaging - Compilers";
-$cvs_author = 'Author: dmacks';
-$cvs_date = 'Date: 2006/02/22 06:31:55';
+$cvs_author = 'Author: msachs';
+$cvs_date = 'Date: 2006/09/18 14:34:38';
$metatags = '<link rel="contents" href="index.php?phpLang=en" title="Packaging
Contents"><link rel="next" href="reference.php?phpLang=en"
title="Reference"><link rel="prev" href="fslayout.php?phpLang=en"
title="Filesystem Layout">';
Index: intro.en.php
===================================================================
RCS file: /cvsroot/fink/web/doc/packaging/intro.en.php,v
retrieving revision 1.70
retrieving revision 1.71
diff -u -d -r1.70 -r1.71
--- intro.en.php 22 Feb 2006 06:33:11 -0000 1.70
+++ intro.en.php 18 Sep 2006 14:47:46 -0000 1.71
@@ -1,7 +1,7 @@
<?
$title = "Packaging - Intro";
-$cvs_author = 'Author: dmacks';
-$cvs_date = 'Date: 2006/02/22 06:31:55';
+$cvs_author = 'Author: msachs';
+$cvs_date = 'Date: 2006/09/18 14:34:38';
$metatags = '<link rel="contents" href="index.php?phpLang=en" title="Packaging
Contents"><link rel="next" href="format.php?phpLang=en" title="Package
Descriptions"><link rel="prev" href="index.php?phpLang=en" title="Packaging
Contents">';
Index: format.en.php
===================================================================
RCS file: /cvsroot/fink/web/doc/packaging/format.en.php,v
retrieving revision 1.71
retrieving revision 1.72
diff -u -d -r1.71 -r1.72
--- format.en.php 22 Feb 2006 06:33:11 -0000 1.71
+++ format.en.php 18 Sep 2006 14:47:46 -0000 1.72
@@ -1,7 +1,7 @@
<?
$title = "Packaging - Package Descriptions";
-$cvs_author = 'Author: dmacks';
-$cvs_date = 'Date: 2006/02/22 06:31:55';
+$cvs_author = 'Author: msachs';
+$cvs_date = 'Date: 2006/09/18 14:34:38';
$metatags = '<link rel="contents" href="index.php?phpLang=en" title="Packaging
Contents"><link rel="next" href="policy.php?phpLang=en" title="Packaging
Policy"><link rel="prev" href="intro.php?phpLang=en" title="Introduction">';
Index: policy.en.php
===================================================================
RCS file: /cvsroot/fink/web/doc/packaging/policy.en.php,v
retrieving revision 1.71
retrieving revision 1.72
diff -u -d -r1.71 -r1.72
--- policy.en.php 22 Feb 2006 06:33:11 -0000 1.71
+++ policy.en.php 18 Sep 2006 14:47:46 -0000 1.72
@@ -1,7 +1,7 @@
<?
$title = "Packaging - Policy";
-$cvs_author = 'Author: dmacks';
-$cvs_date = 'Date: 2006/02/22 06:31:55';
+$cvs_author = 'Author: msachs';
+$cvs_date = 'Date: 2006/09/18 14:34:38';
$metatags = '<link rel="contents" href="index.php?phpLang=en" title="Packaging
Contents"><link rel="next" href="fslayout.php?phpLang=en" title="Filesystem
Layout"><link rel="prev" href="format.php?phpLang=en" title="Package
Descriptions">';
Index: reference.en.php
===================================================================
RCS file: /cvsroot/fink/web/doc/packaging/reference.en.php,v
retrieving revision 1.73
retrieving revision 1.74
diff -u -d -r1.73 -r1.74
--- reference.en.php 22 Feb 2006 06:33:11 -0000 1.73
+++ reference.en.php 18 Sep 2006 14:47:46 -0000 1.74
@@ -1,7 +1,7 @@
<?
$title = "Packaging - Reference";
-$cvs_author = 'Author: dmacks';
-$cvs_date = 'Date: 2006/02/22 06:31:55';
+$cvs_author = 'Author: msachs';
+$cvs_date = 'Date: 2006/09/18 14:34:38';
$metatags = '<link rel="contents" href="index.php?phpLang=en" title="Packaging
Contents"><link rel="prev" href="compilers.php?phpLang=en" title="Compilers">';
@@ -32,7 +32,10 @@
<p>In the <b>compile phase</b> the source is configured and
compiled. Usually this means calling the <code>configure</code> script
with some parameters and then issuing a <code>make</code> command. See the
-CompileScript field description for details.</p>
+CompileScript field description for details. 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.</p>
<p>In the <b>install phase</b> the package is installed to a temporary
directory, <code>/sw/src/fink.build/root-gimp-1.2.1-1</code> (= %d). (Note the
"root-" part.)
All files that would normally be installed to <code>/sw</code> are installed in
@@ -418,7 +421,9 @@
A list of dependencies that is applied at build time only.
This can be used to list tools (e.g. flex) that must be present to
build the packages, but which are not used at run time.
-Supports the same syntax as Depends.
+Supports the same syntax as Depends. If a build is being done
+with test suites enabled, the dependencies in the <code>TestDepends</code>
+field will be added to this list.
</p>
</td></tr><tr valign="top"><td>Provides</td><td>
<p>
@@ -461,7 +466,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>
</td></tr><tr valign="top"><td>Replaces</td><td>
<p>
@@ -572,6 +579,10 @@
download).
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>
</td></tr><tr valign="top"><td>Source<b>N</b></td><td>
<p>
@@ -865,7 +876,9 @@
</td></tr><tr valign="top"><td>ConfigureParams</td><td>
<p>
Additional parameters to pass to the configure script. (See
-CompileScript for details.)
+CompileScript for details.) If a build is being done
+with test suites enabled, the value of the <code>TestConfigureParams</code>
+field will be appended to this.
As of fink > 0.13.7, this parameter will also work with perl modules
<code>Type: Perl</code>, and will append to the default perl Makefile.PL
@@ -985,6 +998,42 @@
for that specific perl module package.
</p>
</td></tr></table>
+<p><b>Test Suites:</b></p>
+<table border="0" cellpadding="0" cellspacing="10"><tr valign="bottom"><th
align="left">Field</th><th align="left">Value</th></tr><tr
valign="top"><td>InfoTest</td><td>
+<p>
+<b>Introduced in fink 0.25.</b>
+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 <b>must</b> 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 <b>must</b> 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><pre>InfoTest: <<
+ TestScript: make check || exit 2
+ TestConfigureParams: --enable-tests
+<<</pre>
+</td></tr></table>
<p><b>Install Phase:</b></p>
<table border="0" cellpadding="0" cellspacing="10"><tr valign="bottom"><th
align="left">Field</th><th align="left">Value</th></tr><tr
valign="top"><td>UpdatePOD</td><td>
<p>
Index: fslayout.en.php
===================================================================
RCS file: /cvsroot/fink/web/doc/packaging/fslayout.en.php,v
retrieving revision 1.70
retrieving revision 1.71
diff -u -d -r1.70 -r1.71
--- fslayout.en.php 22 Feb 2006 06:33:11 -0000 1.70
+++ fslayout.en.php 18 Sep 2006 14:47:46 -0000 1.71
@@ -1,7 +1,7 @@
<?
$title = "Packaging - FS Layout";
-$cvs_author = 'Author: dmacks';
-$cvs_date = 'Date: 2006/02/22 06:31:55';
+$cvs_author = 'Author: msachs';
+$cvs_date = 'Date: 2006/09/18 14:34:38';
$metatags = '<link rel="contents" href="index.php?phpLang=en" title="Packaging
Contents"><link rel="next" href="compilers.php?phpLang=en"
title="Compilers"><link rel="prev" href="policy.php?phpLang=en"
title="Packaging Policy">';
Index: index.en.php
===================================================================
RCS file: /cvsroot/fink/web/doc/packaging/index.en.php,v
retrieving revision 1.71
retrieving revision 1.72
diff -u -d -r1.71 -r1.72
--- index.en.php 22 Feb 2006 06:33:11 -0000 1.71
+++ index.en.php 18 Sep 2006 14:47:46 -0000 1.72
@@ -1,7 +1,7 @@
<?
$title = "Packaging";
-$cvs_author = 'Author: dmacks';
-$cvs_date = 'Date: 2006/02/22 06:31:55';
+$cvs_author = 'Author: msachs';
+$cvs_date = 'Date: 2006/09/18 14:34:38';
$metatags = '<link rel="contents" href="index.php?phpLang=en" title="Packaging
Contents"><link rel="next" href="intro.php?phpLang=en" title="Introduction">';
@@ -30,7 +30,7 @@
</p>
<h2><? echo FINK_CONTENTS ; ?></h2><ul>
<li><a href="intro.php?phpLang=en"><b>1 Introduction</b></a><ul><li><a
href="intro.php?phpLang=en#def1">1.1 What is a Package?</a></li><li><a
href="intro.php?phpLang=en#ident">1.2 Identifying a
Package</a></li></ul></li><li><a href="format.php?phpLang=en"><b>2 Package
Descriptions</b></a><ul><li><a href="format.php?phpLang=en#trees">2.1 Tree
Layout</a></li><li><a href="format.php?phpLang=en#format">2.2 File
Format</a></li><li><a href="format.php?phpLang=en#percent">2.3 Percent
Expansion</a></li></ul></li><li><a href="policy.php?phpLang=en"><b>3 Packaging
Policy</b></a><ul><li><a href="policy.php?phpLang=en#licenses">3.1 Package
Licenses</a></li><li><a href="policy.php?phpLang=en#openssl">3.2 The GPL and
OpenSSL</a></li><li><a href="policy.php?phpLang=en#prefix">3.3 Base System
Interference</a></li><li><a href="policy.php?phpLang=en#sharedlibs">3.4 Shared
Libraries</a></li><li><a href="policy.php?phpLang=en#perlmods">3.5 Perl
Modules</a></li><li><a href="policy.php?phpLang=e
n#emacs">3.6 Emacs Policy</a></li></ul></li><li><a
href="fslayout.php?phpLang=en"><b>4 Filesystem Layout</b></a><ul><li><a
href="fslayout.php?phpLang=en#fhs">4.1 The Filesystem Hierarchy
Standard</a></li><li><a href="fslayout.php?phpLang=en#dirs">4.2 The
Directories</a></li><li><a href="fslayout.php?phpLang=en#avoid">4.3 Things to
Avoid</a></li></ul></li><li><a href="compilers.php?phpLang=en"><b>5
Compilers</b></a><ul><li><a href="compilers.php?phpLang=en#versions">5.1
Compiler Versions</a></li><li><a href="compilers.php?phpLang=en#abi">5.2 The
g++ ABI</a></li></ul></li><li><a href="reference.php?phpLang=en"><b>6
Reference</b></a><ul><li><a href="reference.php?phpLang=en#build">6.1 The Build
Process</a></li><li><a href="reference.php?phpLang=en#fields">6.2
Fields</a></li><li><a href="reference.php?phpLang=en#splitoffs">6.3
SplitOffs</a></li><li><a href="reference.php?phpLang=en#scripts">6.4
Scripts</a></li><li><a href="reference.php?phpLang=en#patches">6.5
Patches</a></li><l
i><a href="reference.php?phpLang=en#profile.d">6.6 Profile.d
scripts</a></li></ul></li></ul>
-<!--Generated from $Fink: packaging.en.xml,v 1.87 2006/02/22 06:31:55 dmacks
Exp $-->
+<!--Generated from $Fink: packaging.en.xml,v 1.88 2006/09/18 14:34:38 msachs
Exp $-->
<? include_once "../../footer.inc"; ?>
-------------------------------------------------------------------------
Using Tomcat but need to do more? Need to support web services, security?
Get stuff done quickly with pre-integrated technology to make your job easier
Download IBM WebSphere Application Server v.1.0.1 based on Apache Geronimo
http://sel.as-us.falkag.net/sel?cmd=lnk&kid=120709&bid=263057&dat=121642
_______________________________________________
Fink-commits mailing list
Fink-commits@lists.sourceforge.net
https://lists.sourceforge.net/lists/listinfo/fink-commits
