Update of /cvsroot/fink/scripts/installer/dmg/doc/packaging
In directory
sc8-pr-cvs5.sourceforge.net:/tmp/cvs-serv1939/scripts/installer/dmg/doc/packaging
Modified Files:
packaging.en.html
Log Message:
Document InfoTest.
Index: packaging.en.html
===================================================================
RCS file: /cvsroot/fink/scripts/installer/dmg/doc/packaging/packaging.en.html,v
retrieving revision 1.80
retrieving revision 1.81
diff -u -d -r1.80 -r1.81
--- packaging.en.html 26 Jun 2006 21:15:09 -0000 1.80
+++ packaging.en.html 18 Sep 2006 14:44:08 -0000 1.81
@@ -1,7 +1,7 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
"http://www.w3.org/TR/html4/loose.dtd";>
<html><head><meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<!--
-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 $
-->
<title>Fink Documentation - Creating Fink Packages</title></head><body>
<table width="100%" cellspacing="0">
@@ -1320,7 +1320,10 @@
<p>In the <b>compile phase</b> the source is configured and
compiled. Usually this means calling the <tt style="white-space:
nowrap;">configure</tt> script
with some parameters and then issuing a <tt style="white-space:
nowrap;">make</tt> 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, <tt style="white-space:
nowrap;">/sw/src/fink.build/root-gimp-1.2.1-1</tt> (= %d). (Note the "root-"
part.)
All files that would normally be installed to <tt style="white-space:
nowrap;">/sw</tt> are installed in
@@ -1706,7 +1709,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 <tt style="white-space:
nowrap;">TestDepends</tt>
+field will be added to this list.
</p>
</td></tr><tr valign="top"><td>Provides</td><td>
<p>
@@ -1749,7 +1754,9 @@
being compiled. This can be used to prevent <tt style="white-space:
nowrap;">./configure</tt>
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 <tt style="white-space:
nowrap;">TestConflicts</tt>
+field will be added to this list.
</p>
</td></tr><tr valign="top"><td>Replaces</td><td>
<p>
@@ -1860,6 +1867,10 @@
download).
This implicitly-defined <tt style="white-space: nowrap;">Source</tt> 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 <tt style="white-space: nowrap;">TestSource</tt> and related fields,
inside the
+<tt style="white-space: nowrap;">InfoTest</tt> block.
</p>
</td></tr><tr valign="top"><td>Source<b>N</b></td><td>
<p>
@@ -2153,7 +2164,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 <tt style="white-space:
nowrap;">TestConfigureParams</tt>
+field will be appended to this.
As of fink > 0.13.7, this parameter will also work with perl modules
<tt style="white-space: nowrap;">Type: Perl</tt>, and will append to the
default perl Makefile.PL
@@ -2273,6 +2286,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 <tt style="white-space:
nowrap;">TestScript</tt>.
+All other fields are optional. The following fields are allowed inside
+<tt style="white-space: nowrap;">InfoTest</tt>:
+</p><ul>
+<li><tt style="white-space: nowrap;">TestScript</tt>: 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, <tt style="white-space: nowrap;">make
check</tt> is a bad script,
+ since it will exit with status 1 if the check target doesn't exist.
+ <tt style="white-space: nowrap;">make check || exit 2</tt> would be a
better script.</li>
+<li><tt style="white-space: nowrap;">TestConfigureParams</tt>: A value which
will be appended to <tt style="white-space: nowrap;">ConfigureParams</tt>.</li>
+<li><tt style="white-space: nowrap;">TestDepends</tt> and <tt
style="white-space: nowrap;">TestConflicts</tt>: Lists of packages that will be
added to the <tt style="white-space: nowrap;">BuildDepends</tt> or <tt
style="white-space: nowrap;">BuildConflicts</tt> lists.</li>
+<li><tt style="white-space: nowrap;">TestSource</tt>: Extra sources necessary
to run the test suite. All of the
+ affiliated fields are also supported, so you <b>must</b> also specify
+ <tt style="white-space: nowrap;">TestSource-MD5</tt>, and you may also have
+ <tt style="white-space: nowrap;">TestSourceN</tt> and corresponding <tt
style="white-space: nowrap;">TestSourceN-MD5</tt>,
+ <tt style="white-space: nowrap;">TestTarFilesRename</tt>, etc.</li>
+<li><tt style="white-space: nowrap;">TestSuiteSize</tt>: Describes
approximately how long the test suite takes to
+ run. Valid values are <tt style="white-space: nowrap;">small</tt>, <tt
style="white-space: nowrap;">medium</tt>, and <tt style="white-space:
nowrap;">large</tt>.
+ This field is currently ignored.</li>
+<li>Any other standard field. If a field is specified both inside and outside
+<tt style="white-space: nowrap;">InfoTest</tt>, the value inside <tt
style="white-space: nowrap;">InfoTest</tt> 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>
@@ -2737,4 +2786,4 @@
provided the document and this copyright notice remain complete and
unmodified. Any commercial reproduction and any online publication
requires the explicit consent of the author.</p><hr>
-<p>Generated from <i>$Fink: packaging.en.xml,v 1.87 2006/02/22 06:31:55 dmacks
Exp $</i></p></body></html>
+<p>Generated from <i>$Fink: packaging.en.xml,v 1.88 2006/09/18 14:34:38 msachs
Exp $</i></p></body></html>
-------------------------------------------------------------------------
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
