------------------------------------------------------------------------
This directory contains the sample source code to accompany the
Maple Programming Guide.

This directory contains the following files.

    Interface.mpl       -- This file contains the source code for
                        -- the Interface package. This is a
                        -- a package for manipulating Maple
                        -- interfaces. It is described in
                        -- the Programming with Modules chapter.
    Interface.tst       -- This is a test file for the Interface
                        -- package.
    nQueens.mpl         -- This file contains the source code
                        -- for the example that solves the N queens
                        -- problem.  It is described in the
                        -- Parallel Programming chapter.
    RandomnessTests/    -- The RandomnessTests package is contained
                        -- in this directory. This is a package for
                        -- testing the randomness of binary sequences.
                        -- This package is described in the Writing
                        -- Packages chapter.
    shapes/             -- The Shapes package is contained in the
                        -- source code in this directory. This
                        -- package is described in the Writing
                        -- Packages chapter.
    SomeTools.mpl       -- This file contains the source code
                        -- for the SomeTools package. This is
                        -- a small package described in the Writing
                        -- Packages chapter.

The Maple code contained in the source files is explained in the related
chapters of the Programming Guide, but many files include comments, and
it should be possible to understand them independently of the manual.

To load a file into your private Maple library, you can use the
command line version of Maple with the preprocessor option
`-D LOAD_REPOSITORY'. For instance, to load the file `Interface.mpl',
use the UNIX shell command

	maple -D LOAD_REPOSITORY Interface.mpl

or, in a Windows command shell,

	cmaple -D LOAD_REPOSITORY Interface.mpl

The shell script `mload.sh' is provided for your convenience. It is
similar to one used at Maplesoft for Maple library development. On UNIX
systems, you can invoke it as

	./mload.sh Interface.mpl

to load the file `Interface.mpl' into your private Maple repository.
Alternatively, you can copy it to some directory searched by your shell 
for commands. For example, assuming that the directory $HOME/bin exists,
and is in your PATH environment variable, you could enter:

	cp mload.sh $HOME/bin/mload
	chmod +x $HOME/bin/mload

This allows you to use the script the same way as any other program. 
Depending on the shell you use, you may have to issue the command

	rehash

before your shell finds the new script. Once it has been installed
in this way, call it like any other command. For example,

	mload Interface.mpl

This script should also be usable by Windows users who have a POSIX
shell.

------------------------------------------------------------------------