This is the README.txt file for the recipe executive of the A-A-P project.

The "recipe executive" executes recipes.  See the documentation in the "doc"
directory.  Also see http://www.a-a-p.org.  If you are still missing the
explanation you need, look at the Python source to find out how it really
works...


WARNING: This has not been properly tested yet.  USE WITH GREAT CARE!


Currently there is just one .zip file that you need to unpack in any directory
of your choice.  Alternatively, you may use CVS.  See http://www.a-a-p.org for
help.

To run Aap you need to have Python version 1.5 or later installed.


INSTALL

Installing isn't required, you can run "./aap" directly.  You may adjust your
$PATH, or do this to make a symbolic link:

	./aap install


RUN

Read the tutorial to see plenty of examples.  A quick overview of the command
line options is obtained with:

	./aap --help


KNOWN PROBLEMS

Aap works properly on Unix.  This is tested regularly.
Aap mostly works on MS-Windows NT, 2000 and XP.  On MS-Windows 95 and 98 the
failure of an external command is not detected (this is a problem with the
Python os.system() function).  MS-Windows it not tested often.
Aap has not been tested on other systems yet.

Cached remote files are never outdated, requires deleting them manually.

Python 2.2.1 has a bug in pre.py (version 2.2.2 is OK).  Either upgrade to a
newer version of Python or apply this patch (adjust the path for where your
python libraries are located):

*** /usr/local/lib/python2.2/pre.py~	Sat May 18 17:38:28 2002
--- /usr/local/lib/python2.2/pre.py	Mon Sep  2 18:36:37 2002
***************
*** 364,370 ****
              # See if repl contains group references
              try:
                  repl = pcre_expand(_Dummy, repl)
!             except error:
                  m = MatchObject(self, source, 0, end, [])
                  repl = lambda m, repl=repl, expand=pcre_expand: expand(m, repl)
              else:
--- 364,372 ----
              # See if repl contains group references
              try:
                  repl = pcre_expand(_Dummy, repl)
! 	    # Was: except error:
! 	    # Fixed according to 2.2.2 version of the library.
!             except (error, TypeError):
                  m = MatchObject(self, source, 0, end, [])
                  repl = lambda m, repl=repl, expand=pcre_expand: expand(m, repl)
              else:

After applying this patch run python twice to generate the pre.pyc and pre.pyo
files:
	python -c "import pre"
	python -O -c "import pre"
