<?xml version="1.0" ?>
<!--  vim: set sw=2 sts=2 et ft=docbk:

  Part of the A-A-P recipe executive: The main documentation

  Copyright (C) 2002-2003 Stichting NLnet Labs
  Permission to copy and use this file is specified in the file COPYING.
  If this file is missing you can find it here: http://www.a-a-p.org/COPYING

-->

<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" "docbookx.dtd"
[

    <!ENTITY % version SYSTEM "version.sgml">
    %version;

    <!ENTITY % aapmod SYSTEM "aap.mod">
    %aapmod;

    <!ENTITY tutor-start SYSTEM "tutor-start.sgml">
    <!ENTITY tutor-compile SYSTEM "tutor-compile.sgml">
    <!ENTITY tutor-website SYSTEM "tutor-website.sgml">
    <!ENTITY tutor-distribute SYSTEM "tutor-distribute.sgml">
    <!ENTITY tutor-variant SYSTEM "tutor-variant.sgml">
    <!ENTITY tutor-python SYSTEM "tutor-python.sgml">
    <!ENTITY tutor-cvs SYSTEM "tutor-cvs.sgml">
    <!ENTITY tutor-actions SYSTEM "tutor-actions.sgml">
    <!ENTITY tutor-include SYSTEM "tutor-include.sgml">
    <!ENTITY tutor-pipe SYSTEM "tutor-pipe.sgml">
    <!ENTITY tutor-port SYSTEM "tutor-port.sgml">

    <!ENTITY user-basics SYSTEM "user-basics.sgml">
    <!ENTITY user-depend SYSTEM "user-depend.sgml">
    <!ENTITY user-variant SYSTEM "user-variant.sgml">
    <!ENTITY user-publish SYSTEM "user-publish.sgml">
    <!ENTITY user-fetch SYSTEM "user-fetch.sgml">
    <!ENTITY user-install SYSTEM "user-install.sgml">
    <!ENTITY user-version SYSTEM "user-version.sgml">
    <!ENTITY user-cvs SYSTEM "user-cvs.sgml">
    <!ENTITY user-issue SYSTEM "user-issue.sgml">
    <!ENTITY user-python SYSTEM "user-python.sgml">
    <!ENTITY user-porting SYSTEM "user-porting.sgml">
    <!ENTITY user-configure SYSTEM "user-configure.sgml">
    <!ENTITY user-autoconf SYSTEM "user-autoconf.sgml">
    <!ENTITY user-package SYSTEM "user-package.sgml">
    <!ENTITY user-makedif SYSTEM "user-makedif.sgml">
    <!ENTITY user-debug SYSTEM "user-debug.sgml">
    <!ENTITY user-filetype SYSTEM "user-filetype.sgml">
    <!ENTITY user-autodep SYSTEM "user-autodep.sgml">
    <!ENTITY user-tools SYSTEM "user-tools.sgml">
    <!ENTITY user-language SYSTEM "user-language.sgml">

    <!ENTITY ref-arguments SYSTEM "ref-arguments.sgml">
    <!ENTITY ref-syntax SYSTEM "ref-syntax.sgml">
    <!ENTITY ref-varscope SYSTEM "ref-varscope.sgml">
    <!ENTITY ref-assign SYSTEM "ref-assign.sgml">
    <!ENTITY ref-commands SYSTEM "ref-commands.sgml">
    <!ENTITY ref-attributes SYSTEM "ref-attributes.sgml">
    <!ENTITY ref-filetype SYSTEM "ref-filetype.sgml">
    <!ENTITY ref-modules SYSTEM "ref-modules.sgml">
    <!ENTITY ref-tools SYSTEM "ref-tools.sgml">
    <!ENTITY ref-python SYSTEM "ref-python.sgml">
    <!ENTITY ref-variables SYSTEM "ref-variables.sgml">

    <!ENTITY license SYSTEM "license.sgml">

]>

<book>
  <bookinfo>
    <title>A-A-P Recipe Executive</title>

    <author>
      <firstname>Bram</firstname>
      <surname>Moolenaar</surname>
    </author>

    <edition>Revision &aapversion; (&builddate;)</edition>

    <pubdate>&builddate;</pubdate>

    <copyright>
      <year>2002-2003</year>
      <holder>Stichting NLnet Labs</holder>
    </copyright>

    <legalnotice>
      <para>
        The license for copying, using, modifying, distributing, etc this
        documentation and the A-A-P files can be found in
        <xref linkend="license"/>.
      </para>
    </legalnotice>

    <releaseinfo>For &Aap; version &aapversion;</releaseinfo>

    <abstract>
      <para>
        This is the documentation for version &aapversion; of the Recipe
        Executive, commonly known as the "aap" command.
        It is part of the A-A-P project.
      </para>

      <para>
      The web site of A-A-P can be found here:
      <ulink url="http://www.a-a-p.org/">http://www.a-a-p.org/</ulink>
      </para>

      <para>
      The HTML version of this manual can be read on-line:
      <ulink
      url="http://www.a-a-p.org/exec/index.html">http://www.a-a-p.org/exec/index.html</ulink>
      As a single file: <ulink
      url="http://www.a-a-p.org/exec/exec.html">http://www.a-a-p.org/exec/exec.html</ulink>.
      </para>

      <para>
      The PDF version of this manual can be found here:
      <ulink url="http://www.a-a-p.org/exec/exec.pdf">http://www.a-a-p.org/exec/exec.pdf</ulink>
      </para>

      <para>
      The plain text version of this manual: <ulink
      url="http://www.a-a-p.org/exec/exec.txt">http://www.a-a-p.org/exec/exec.txt</ulink>.
      </para>
    </abstract>

  </bookinfo>

  <part id="tutorial">
  <title>Tutorial</title>

    <chapter id="tutor-start">
      <title>Getting Started</title>
      &tutor-start;
    </chapter>

    <chapter id="tutor-compile">
      <title>Compiling a Program</title>
      &tutor-compile;
    </chapter>

    <chapter id="tutor-website">
      <title>Publishing a Web Site</title>
      &tutor-website;
    </chapter>

    <chapter id="tutor-distribute">
      <title>Distributing a Program</title>
      &tutor-distribute;
    </chapter>

    <chapter id="tutor-variant">
      <title>Building Variants</title>
      &tutor-variant;
    </chapter>

    <chapter id="tutor-python">
      <title>Using Python</title>
      &tutor-python;
    </chapter>

    <chapter id="tutor-cvs">
      <title>Version Control with CVS</title>
      &tutor-cvs;
    </chapter>

    <chapter id="tutor-actions">
      <title>Filetypes and Actions</title>
      &tutor-actions;
    </chapter>

    <chapter id="tutor-include">
      <title>More Than One Recipe</title>
      &tutor-include;
    </chapter>

    <chapter id="tutor-pipe">
      <title>Commands in a Pipe</title>
      &tutor-pipe;
    </chapter>

    <chapter id="tutor-port">
      <title>A Ported Application</title>
      &tutor-port;
    </chapter>

  </part>

  <part id="user">
  <title>User Manual</title>

    <chapter id="user-basics">
      <title>How it all works</title>
      &user-basics;
    </chapter>

    <chapter id="user-depend">
      <title>Dependencies, Rules and Actions</title>
      &user-depend;
    </chapter>

    <chapter id="user-variant">
      <title>Variants</title>
      &user-variant;
    </chapter>

    <chapter id="user-publish">
      <title>Publishing</title>
      &user-publish;
    </chapter>

    <chapter id="user-fetch">
      <title>Fetching</title>
      &user-fetch;
    </chapter>

    <chapter id="user-install">
      <title>Installing</title>
      &user-install;
    </chapter>

    <chapter id="user-version">
      <title>Version Control</title>
      &user-version;
    </chapter>

    <chapter id="user-cvs">
      <title>Using CVS</title>
      &user-cvs;
    </chapter>

    <chapter id="user-issue">
      <title>Issue Tracking</title>
      &user-issue;
    </chapter>

    <chapter id="user-python">
      <title>Using Python</title>
      &user-python;
    </chapter>

    <chapter id="user-porting">
      <title>Porting an Application</title>
      &user-porting;
    </chapter>

    <chapter id="user-configure">
      <title>Automatic Configuration</title>
      &user-configure;
    </chapter>

    <chapter id="user-autoconf">
      <title>Using Autoconf</title>
      &user-autoconf;
    </chapter>

    <chapter id="user-package">
      <title>Automatic Package Install</title>
      &user-package;
    </chapter>

    <chapter id="user-debug">
      <title>Debugging a Recipe</title>
      &user-debug;
    </chapter>

    <chapter id="user-makedif">
      <title>Differences from make</title>
      &user-makedif;
    </chapter>

    <chapter id="user-filetype">
      <title>Customizing Filetype Detection and Actions</title>
      &user-filetype;
    </chapter>

    <chapter id="user-autodep">
      <title>Customizing Automatic Depedencies</title>
      &user-autodep;
    </chapter>

    <chapter id="user-tools">
      <title>Customizing Default Tools</title>
      &user-tools;
    </chapter>

    <chapter id="user-language">
      <title>Adding A Language Module</title>
      &user-language;
    </chapter>

  </part>

  <part id="reference">
  <title>Reference Manual</title>

    <chapter id="ref-arguments">
      <title>Aap Command Line Arguments</title>
      &ref-arguments;
    </chapter>

    <chapter id="ref-syntax">
      <title>Recipe Syntax</title>
      &ref-syntax;
    </chapter>

    <chapter id="ref-varscope">
      <title>Variables and Scopes</title>
      &ref-varscope;
    </chapter>

    <chapter id="ref-variables">
      <title>Common Variables</title>
      &ref-variables;
    </chapter>

    <chapter id="ref-assign">
      <title>Assignments</title>
      &ref-assign;
    </chapter>

    <chapter id="ref-attributes">
      <title>Attributes</title>
      &ref-attributes;
    </chapter>

    <chapter id="ref-filetype">
      <title>Filetype Detection</title>
      &ref-filetype;
    </chapter>

    <chapter id="ref-modules">
      <title>Standard Modules</title>
      &ref-modules;
    </chapter>

    <chapter id="ref-tools">
      <title>Standard Tools</title>
      &ref-tools;
    </chapter>

    <chapter id="ref-python">
      <title>A-A-P Python functions</title>
      &ref-python;
    </chapter>

    <chapter id="ref-commands">
      <title>A-A-P Commands</title>
      &ref-commands;
    </chapter>

  </part>

  <part id="appendix">
  <title>Appendixes</title>

    <appendix id="license">
      <title>License</title>
      &license;
    </appendix>

  </part>

</book>
