<?xml version="1.0" encoding="UTF-8"?>
<?xml-model href="http://www.oasis-open.org/docbook/xml/5.0/rng/docbookxi.rng" 
            schematypens="http://relaxng.org/ns/structure/1.0"?>
<appendix xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude"
    xmlns:xlink="http://www.w3.org/1999/xlink" version="5.0" xml:id="app.factsheet">
    <title>Fact Sheet</title>
    <sect1 xml:id="sec.builtinprops">
        <title>Built-In Properties</title>
        <table>
            <title>Phing Built-In Properties</title>
            <tgroup cols="2">
                <colspec colname="c1" colnum="1" colwidth="1*"/>
                <colspec colname="c2" colnum="2" colwidth="3*"/>
                <thead>
                    <row>
                        <entry>Property</entry>
                        <entry>Contents</entry>
                    </row>
                </thead>
                <tbody>
                    <row>
                        <entry><literal>application.startdir</literal></entry>
                        <entry>Current work directory</entry>
                    </row>
                    <row>
                        <entry><literal>env.*</literal></entry>
                        <entry>Environment variables, extracted from <literal>$_SERVER</literal>.</entry>
                    </row>
                    <row>
                        <entry><literal>host.arch</literal></entry>
                        <entry>System architecture, i.e. i586. Not available on Windows machines.
                        </entry>
                    </row>
                    <row>
                        <entry><literal>host.domain</literal></entry>
                        <entry>DNS domain name, i.e. <literal>php.net</literal>. Not available on Windows machines.
                        </entry>
                    </row>
                    <row>
                        <entry><literal>host.fstype</literal></entry>
                        <entry>The type of the files ystem. Possible values are UNIX, WINNT and WIN32
                        </entry>
                    </row>
                    <row>
                        <entry><literal>host.name</literal></entry>
                        <entry>Operating System hostname as returned by <literal>posix_uname()</literal>. Not available
                            on Windows machines. </entry>
                    </row>
                    <row>
                        <entry><literal>host.os</literal></entry>
                        <entry>Operating System description as set in PHP_OS variable (see <link
                                xlink:href="http://www.php.net/manual/en/reserved.constants.core.php"
                                >PHP Manual</link>).</entry>
                    </row>
                    <row>
                        <entry><literal>host.os.release</literal></entry>
                        <entry>Operating version release, i.e. 2.2.10. Not available on Windows
                            machines. </entry>
                    </row>
                    <row>
                        <entry><literal>host.os.version</literal></entry>
                        <entry>Operating system version, i.e. #4 Tue Jul 20 17:01:36 MEST 1999. Not
                            available on Windows machines. </entry>
                    </row>
                    <row>
                        <entry><literal>line.separator</literal></entry>
                        <entry>Character(s) that signal the end of a line, "\n" for Linux, "\r\n"
                            for Windows system, "\r" for Macintosh.</entry>
                    </row>
                    <row>
                        <entry><literal>os.name</literal></entry>
                        <entry>Operating System description as set in PHP_OS variable.</entry>
                    </row>

                    <row>
                        <entry><literal>phing.file</literal></entry>
                        <entry>Full path to current buildfile.</entry>
                    </row>
                    <row>
                        <entry><literal>phing.dir</literal></entry>
                        <entry>Path that contains the current buildfile.</entry>
                    </row>
                    <row>
                        <entry><literal>phing.home</literal></entry>
                        <entry>Phing installation directory, not set in PEAR installations.</entry>
                    </row>
                    <row>
                        <entry><literal>phing.version</literal></entry>
                        <entry>Current Phing version.</entry>
                    </row>
                    <row>
                        <entry><literal>phing.project.name</literal></entry>
                        <entry>Name of the currently processed project.</entry>
                    </row>

                    <row>
                        <entry><literal>php.classpath</literal></entry>
                        <entry>The value of the environment variable <literal>PHP_CLASSPATH</literal>.</entry>
                    </row>
                    <row>
                        <entry><literal>php.version</literal></entry>
                        <entry>Version of the PHP interpreter. Same as PHP constant <literal>PHP_VERSION</literal> (see
                                <link
                                xlink:href="http://www.php.net/manual/en/reserved.constants.core.php"
                                >PHP Manual</link>).</entry>
                    </row>
                    <row>
                        <entry><literal>project.basedir</literal></entry>
                        <entry>The current project basedir.</entry>
                    </row>
                    <row>
                        <entry><literal>user.home</literal></entry>
                        <entry>Value of the environment variable <literal>HOME</literal>.</entry>
                    </row>
                </tbody>
            </tgroup>
        </table>
    </sect1>
    <sect1 xml:id="sec.commandlineargs">
        <title> Command Line Arguments </title>
        <para>The following table lists the command line arguments currently available.</para>
        <table>
            <title>Phing Command Line Arguments</title>
            <tgroup cols="2">
                <colspec colname="c1" colnum="1" colwidth="1*"/>
                <colspec colname="c2" colnum="2" colwidth="3*"/>
                <thead>
                    <row>
                        <entry>Parameter</entry>
                        <entry>Meaning</entry>
                    </row>
                </thead>
                <tbody>
                    <row>
                        <entry><literal>-h -help</literal></entry>
                        <entry>Display the help screen</entry>
                    </row>
                    <row>
                        <entry><literal>-v -version</literal></entry>
                        <entry>Print version information and exit</entry>
                    </row>
                    <row>
                        <entry><literal>-l -list</literal></entry>
                        <entry>List all available targets in buildfile
                        (excluding targets that have their
                        <literal>hidden</literal> attribute set to
                        <literal>true</literal>)</entry>
                    </row>
                    <row>
                        <entry><literal>-q -quiet</literal></entry>
                        <entry>Quiet operation, no output at all</entry>
                    </row>
                    <row>
                        <entry><literal>-verbose</literal></entry>
                        <entry>Verbose, give some more output</entry>
                    </row>
                    <row>
                        <entry><literal>-debu</literal>g</entry>
                        <entry>Output debug information</entry>
                    </row>
                    <row>
                        <entry><literal>-logfile &lt;file></literal></entry>
                        <entry>Use given file for log</entry>
                    </row>
                    <row>
                        <entry><literal>-D&lt;property>=&lt;value></literal></entry>
                        <entry>Set the property to the specified value to be used in the
                            buildfile</entry>
                    </row>
                    <row>
                        <entry><literal>-find &lt;file></literal></entry>
                        <entry/>
                    </row>
                    <row>
                        <entry><literal>-buildfile &lt;file></literal></entry>
                        <entry>Specify an alternate buildfile name. Default is build.xml </entry>
                    </row>
                    <row>
                        <entry><literal>-logger path.to.Logger</literal></entry>
                        <entry>Specify an alternate logger. Default is phing.listener.DefaultLogger.
                            Other options include phing.listener.NoBannerLogger,
                            phing.listener.AnsiColorLogger, phing.listener.XmlLogger and
                            phing.listener.HtmlColorLogger.</entry>
                    </row>
                    <row>
                        <entry><literal>-propertyfile &lt;file></literal></entry>
                        <entry>Load properties from the specified file</entry>
                    </row>
                </tbody>
            </tgroup>
        </table>
    </sect1>
    <sect1>
        <title> Distribution File Layout </title>
        <programlisting language="xml">$PHING_HOME
  |-- bin
  |-- classes
  |    `-- phing
  |         |-- filters
  |         |    `-- util
  |         |-- mappers
  |         |-- parser
  |         |-- tasks
  |         |    |-- ext
  |         |    |-- system
  |         |    |    `-- condition
  |         |    `-- user
  |         `-- types
  |-- docs
  |    `-- phing_guide
  `-- test
       |-- classes
	   `-- etc</programlisting>
    </sect1>
    <sect1 xml:id="sec.exitcodes">
        <title>Program Exit Codes</title>
        <para>Phing is script-safe - means that you can execute Phing and Configure within a
            automated script context. To check back the success of a Phing call it returns an exit
            code that can be captured by your calling script. The following list gives you details
            on the used exit codes and their meaning.</para>
        <table>
            <title>Program Exit Codes</title>
            <tgroup cols="2">
                <colspec colname="c1" colnum="1" colwidth="1*"/>
                <colspec colname="c2" colnum="2" colwidth="3*"/>
                <thead>
                    <row>
                        <entry>Exitcode</entry>
                        <entry>Description</entry>
                    </row>
                </thead>
                <tbody>
                    <row>
                        <entry><literal>-2</literal></entry>
                        <entry>Environment not properly defined</entry>
                    </row>
                    <row>
                        <entry><literal>-1</literal></entry>
                        <entry>Parameter or configuration error occurred</entry>
                    </row>
                    <row>
                        <entry><literal>0</literal></entry>
                        <entry>Successful execution (build succeeded), no
                        errors (there may be warnings)</entry>
                    </row>
                    <row>
                        <entry><literal>1</literal></entry>
                        <entry>Unsuccessful execution (build failed), errors
                        occurred</entry>
                    </row>
                </tbody>
            </tgroup>
        </table>
    </sect1>
    <sect1 xml:id="sec.lgpl">
        <title>The LGPL License</title>
        <para>Source <link xlink:href="http://www.gnu.org/licenses/lgpl.txt"
                >http://www.gnu.org/licenses/lgpl.txt</link></para>
        <programlisting language="xml"><xi:include href="glgpl.txt" parse="text"/></programlisting>
    </sect1>
    <sect1 xml:id="sec.gfdl">
        <title>The GFDL License</title>
        <para>Source <link xlink:href="http://www.gnu.org/licenses/fdl-1.3.txt"
                >http://www.gnu.org/licenses/fdl-1.3.txt</link></para>
        <programlisting language="xml"><xi:include href="gfdl.txt" parse="text"/></programlisting>
    </sect1>
</appendix>
