Compiling a Distribution¶
Due to the set of rules defined in build-setup.sh
and
Makefile.am
, making a release is pretty easy.
Prepare the Stage¶
The following should be called on a computer that has autoconf and
automake installed in a rather recent version. Use
mammoth.risc.jku.at
if you are unsure.
./build-setup.sh
The configure
script should be run on the actual computer that is
used to run make check
(see below), since it adjusts time
messurements.
./configure
Run the Testsuite¶
Then check if the testsuite passes as expected.
make check
If you work on a multi-processor machine, you can ask to run the tests in parallel. For example, allowing 8 concurrent processes, use:
make -j8 check
It is possible to run only a part of the tests. For each
(sub-)directory RISC/foo
one can use
make check-foo
to run only the tests from the .mt
files in this subdirectory.
Even finer control is achieved by using the variable TESTS
directly. If you want to test only the files RISC/foo/foo1.mt
and RISC/foo/foo2.mt
, you can start this with:
make checkfull TESTS='RISC/foo/foo1-test.run RISC/foo/foo2-test.run'
Each of the Test[...]
parts in a .mt
file will be aborted
after about 10 seconds. To increase this timeout to 200 seconds, add
TIMECONSTRAINT=200
to the make check
arguments list.
Make and Upload a Release¶
Make sure that the version number of each (sub-)package is set accordingly.
Update the version number in configure.ac
.
And now produce the release as follows.
make release
This will produce the files:
riscergosum-x.y.z.tgz
riscergosum-x.y.z.zip
which, have to be put into the $UserBaseDirectory
of Mathematica.
The x.y.z
is the actual version number that is given at the top of
the file configure.ac
.
With
make release-to-server
the release files will be put onto the server into a place which is linked from the website.
The website is updated on the server via the following command.
make update-website
See How to create this website for more detail.
Make (or update) a local Installation from the Sources¶
This kind of installation is currently only supported on a Linux machine.
make install
It will install (encrypted) versions of all package files into the
subdirectory Applications
of your $UserBaseDirectory
. Usually,
files will go into $HOME/.Mathematica/Applications
.
In case you want the installation files to go into directory
/my/installation/dir
, you should configure it accordingly.
Either say
./configure --prefix=/my/installation/dir
make install
or simply
make install localinstalldir=/my/installation/dir
In case you do not want to encrypt your installed packages (for example for code debugging), use the following additional parameter.
make install PREINSTALLEXT=mma