relax SVN archive

Added the API documentation creation (using Epydoc) to the Scons scripts.

The Scons target to create the HTML API documentation is called 'api_manual_html'. The
documentation can be created by typing:
$ scons api_manual_html

The function 'compile_api_manual_html()' was added to the 'scons/manuals.py' file. This function
runs the 'epydoc' command. All the Epydoc options are specified in that function.

Removed all traces of Adobe Acrobat Reader (deleted the acro() function, etc.).

Created a new standard manual target called 'user_manual_html_nofetch'.

Removed the Adobe Acrobat dependancy from the standard manual targets.

This allows for the removal of the target 'user_manual_pdf_dist' as the only difference between that
target and 'user_manual_pdf' was the launching of Acroreader!

Created a single custom builder (using the dummy function) for all the standard manual targets.

Complete overhaul of the relax manual targets.

The relax manual is now referred to as the user manaul (to allow a developers manual in the future).

The functions for compiling the manual have been renamed:
'user_manual_html()' to 'compile_user_manual_html()'.
'user_manual_pdf()' to 'compile_user_manual_pdf()'.

The header printed when compiling from the LaTeX sources has been updated.

Many target names have changes:
'manual_dist' to 'user_manual_pdf_dist'.
'manual' to 'user_manual_pdf'.
'manual_nofetch' to 'user_manual_pdf_nofetch'.
'manual_dist' to 'user_manual_pdf_dist'.
'user_manual_pdf' to 'compile_user_manual_pdf'.
'user_manual_html' to 'compile_user_manual_html'.

The HTML target has been split in two.

Improved the commenting of the 'self.__init__()' function which sets up the Scons environments, etc.

The different Environments have been grouped by type. The docstring has been expanded a little.

Fixed a bug in the 'self.package()' target function.

The variable 'file_name' was being accessed when the variable should have been called
env['DIST_FILE'].

A number of large changes to the Scons system.

The package initialisation file '__init__.py' has been added to the 'scons' directory.

The 'sconstruct' script has been split in half. The script was copied to 'scons/manuals.py' and
only the manual compilation functions remain in this file. The class structure has been eliminated
from 'scons/manuals.py' so 'sconstruct' now imports each function from this module. This means that
4 spaces have been removed from the indentation. All the manual compilation Environment setups,
custom BUILDERS actions, and Depends statements have been shifted to the 'self.__init__()' function
of the 'sconstruct' script.

The default values of None for the target functions have been removed as they are always passed to
the functions. For example
def dummy(self, target=None, source=None, env=None):
has been changed to
def dummy(self, target, source, env):

Environmental variables such as LATEX_DIR, SYSTEM, BIN_PATH, etc. (all the variables created in
'self.paths()') are now placed in the Scons Build Environments. The Environment is passed into each
function as 'env' so the variables are accessed by typing, for example, env['LATEX_DIR']. The
variable 'self.system' has been renamed to 'self.SYSTEM'.

The 'self.gpg_bin_sign()' and 'self.gpg_src_sign()' target functions have been merged into the
single function 'self.gpg_sign()'.

Ported r2616 from the 1.2 line.

The command used was:
$ svn merge -r2615:2616 svn+ssh://bugman@.../svn/relax/1.2

This removes the ancient unused file 'maths_fns/test.c_chi.py'.