Table of contents

I want to use or install ACE 3.0

Without compiling it...

Under Windows

Under Ms-Dos

Under Unix

On a Macintosh

By compiling it...

Under Windows

Under Ms-Dos

Under Unix

On a Macintosh

Without compiling it...

The Cd-Rom and the Download site give some compiled versions of ACE 3.0 for several systems and releases of Maple V. This allows you to install ACE on your system by simply copying the "compiled" Maple files on your disk. These files are available as tar archive files, but also as extracted archive files (on the Cd-Rom up to release 4).

Under Windows

You can use the Cd-Rom directly. To use (and not install) ACE from the Cd-Rom under Windows, you should use the ACE Ms-Dos archive files. It is very simple for Maple V release 4 or Maple V release 5 because you just have to modify the Maple icon properties (click with the right button on it to get a menu and choose "properties"). Change the target program by adding some options to the MAPLE command. The aim is to specify the directories where the libraries are stored (the standard library and then the ACE one). It is done by adding the:

-b \MAPLEV\LIB -b E:\ACE\INSTALLED\3.0\DOS\MapleVR4

option to the command line to run Maple (the icon target) (in which \MAPLEV\LIB stands for the directory where Maple V release 4 (or 5) has been installed, and E: stands for the Cd-Rom drive on your system).

You can also decide to copy (install) the ACE libraries on your disk. Create for instance a directory ACE in the \MAPLEV directory. Then, from the Cd-Rom copy the three files (maple.lib, maple.hdb and maple.ind) from E:\ACE\INSTALLED\3.0\DOS\MapleVR4 to C:\MAPLEV\ACE\LIB4 for Maple V release 4. Then, the icon target for the Maple program should be:

..... -b \MAPLEV\LIB -b C:\MAPLEV\ACE\LIB4

and you do not need any more to have the ACE Cd-Rom inserted into your Cd-Rom drive (except to navigate on it...).

Because the Cd-Rom does not contain any file for Maple V release 5, you should only get the ACE archive for Maple V release 5 on the Download site in a sub-directory 3.0/INSTALLED. This is a gziped tar file in which you will find the three files maple.lib, maple.hdb and maple.ind for Maple V release 5.

Under Ms-Dos

You can use ACE from the Cd-Rom, for Maple V release 1, 2, 3 or 4. For that, you just have to modify the MAPLE.INI file in the LIB sub-directory of C:\MAPLEV. Everything is explained in the section Using the pre-installed Ms-Dos versions of ACE 3.0. It says that your MAPLE.INI file should contain some lines detailed in the model file for Maple V release 3. In fact, for Maple V release 4 and 5, not all lines are needed. You have just to add to the libname variable the directory where the three ACE files maple.lib, maple.hdb and maple.ind are located and that's all (for Maple V.4 and Maple V.5).

As previously, you can copy all the pre-installed files from the Cd-Rom (Maple V release 1,2,3,4) or from the Download site (Maple V release 1,2,3,4 and 5) on your disk, and set your MAPLE.INI as detailed in the model file but with a simpler ACELib variable set to the directory where you have copied ACE files.

Under Unix

For Unix systems, this is exactly the same thing as for Ms-Dos ones, except that the Ms-Dos MAPLE.INI file is the .mapleinit file in your HOME directory, and that the model file is a little bit different. Everything is explained in the section Using the pre-installed Unix versions of ACE 3.0.

On a Macintosh

I think, it is also possible to use the pre-installed version of ACE 3.0 on a Macintosh. This is detailed in the section Using the pre-installed Macintosh versions of ACE 3.0. You should have (create) a MAPLEINIT file in the Maple folder.

As previously, you can also copy all the pre-installed files from the Cd-Rom (Maple V release 1,2,3,4) or from the Download site (Maple V release 1,2,3,4 and 5) on your disk, and set your MAPLEINIT as detailed in the model file but with a simpler ACELib variable set to the directory where you have copied ACE files.

By compiling it...

The Cd-Rom and the Download site give the versions of ACE 3.0 for all systems and releases of Maple V that you can install on your disk to be compiled. These files are available as tar archive files, but also as extracted archive files (on the Cd-Rom, up to release 4).

Under Windows

Never tried...I recommend to use pre-installed ACE versions as detailed in a previous section.

Under Ms-Dos

You should get the file from either the Cd-Rom (Maple V release 1,2,3,4) or from the Download site (Maple V release 1,2,3,4 and 5). Then, after having extracted the archive file (gziped tar file, the tar command for Ms-Dos is also given, and is able to extract gziped tar files) on your disk, go in the ACE_PACK/BIN directory. Then, use the MAPLE.MOD file to modify the MAPLE.INI file in the MAPLEV\LIB sub-directory (Maple V 1,2,3). This is explained in the 11 page postscript documentation.

For Maple V release 4 and 5, I have never tried to install on Ms-Dos. I don't know whether there is a MAPLE.INI in the LIB sub-directory, whether you should create the MAPLE.LIB, etc. files, and even whether Maple V release 4 and 5 do exist on Ms-Dos ?

Under Unix

For Unix systems, you should get the file from either the Cd-Rom (Maple V release 1,2,3,4) or from the Download site (Maple V release 1,2,3,4 and 5). Then, after having extracted the archive file on your disk, go in the ACE_PACK/BIN directory. Then, run INSTALL.ACE and that's all. After several questions, ACE will be installed. In particular, the installation process asks for the absolute path of the march command, for installation on Maple V release 4 or 5. However, on some computer sites, the march command is not available in a standard binary directory, which meant you will have to look for the Maple installation directory. It should be in the bin sub-directory. Furthermore, the installation process will, if you agree, automatically modify your .mapleinit file.

For Maple V release 1,2,3 and 4, all is explained in the 11 page postscript documentation. For Maple V release 5, it is really like Maple V release 4.

On a Macintosh

I never tried to install ACE 3.0, but someone did it for Maple V release 5. So, because he succeeded, it seems that it is possible to install ACE 3.0 on a Macintosh. Here is how to do the installation on Maple V release 5. First, you have to download the ACE5MAC.tgz from the Download site. You can do it with the Fetch utility because this program downloaded ACE5MAC.tgz and also used Stuffit expander in order to produce the folders ACE_PACK and ACE and the file MAPLEINIT. Bring these in the Maple folder. Within Maple V 5, give the command:

read `:ACE_PACK:BIN:INSTALL.ACE`;

and next enter the new commands from the output of this command, just as written in the instructions.

You may have a MAPLEINIT file for Maple V 5 or earlier versions on the Macintosh. Anyhow, it seems that this file should reside in the Maple folder (for Maple V release 5) but for other releases, I don't know. It was explained in the postscript documentation for installation on Macintosh, Maple V 1,2,3 and 4, that it should be in the lib folder. Was it exact ? Eventually, I am not sure where to put the MAPLEINIT file for all releases of Maple V...sorry!

The Maple V 5 installation wrote on the existing maple.lib and maple.ind files within the lib folder.

On higher versions of Maple there is no longer a maple.hlp file but a maple.hdb file. It seems that if Maple is not able to find the MAPLEINIT file, the ACELib won't be initialized so that the installation will try to write on the existing maple.hdb file within the lib folder: this will give an error, since this maple.hdb file turns out to be read-only.

Two solutions. The MAPLEINIT file is found by Maple. Thus the ACELib is set to `:ACE` which (I guess) denote the ACE folder we put previously in the Maple folder. Then:

read `:ACE_PACK:BIN:INSTALL.HL1`:
read `:ACE_PACK:BIN:INSTALL.HL2`:

should work. Otherwise, enter the next commands instead:

ACELib:=`:ACE`: read ``.libname.`:ACE_PACK:BIN:INSTALL.HL1`:
ACELib:=`:ACE`: read ``.libname.`:ACE_PACK:BIN:INSTALL.HL2`:

Then a maple.hdb file will be created within this ACE folder.

If the MAPLEINIT is found by Maple, then you should not have to modify the libname variable in order to get the help about ACE, because this is done in the MAPLEINIT file. Otherwise, you will have to do so.