Instructions for installing REDUCE on Microsoft Windows

These instructions apply primarily to Windows XP and Vista. Similar procedures will probably work for other recent versions of Windows. There are two main ways to install REDUCE on Microsoft Windows:

Installing a pre-compiled binary version

We do not yet have an automatic installer, but installing by hand is easy, as follows.

Choose an installation folder. This can be almost anywhere, such as C:\, C:\REDUCE\ or D:\. Installing in "C:\Program Files\" is probably not a good idea on Vista or later versions of Windows.

Go to the SourceForge download area and select the Package reduce-algebra. Look for the latest Release that includes a Filename that contains "windows" and has extension ".zip". Note that clicking on a Package link or a Release link expands or collapses its contents. Let's assume that the filename is "reduce-windows-20090106.zip" (in the release "CSL-80020106-Windows", because at the time of writing this is the latest Windows binary distribution).

Click on the Filename link (e.g. "reduce-windows-20090106.zip") to download the file. Save it to your chosen installation folder, then open it and select "Extract all files" from "Folder Tasks" in the task bar or "Extract All..." from the File menu. This will extract the contents of the ZIP archive into a folder with the same name as the file, which you can change if you want but let's assume it is called "reduce-windows-20090106". (If you are running a version of Windows older than XP you will need to use a separate application to unpack the ZIP archive, such as 7-Zip, PeaZip, or Info-ZIP.) You can now delete the ZIP archive if you want.

The new folder ("reduce-windows-20090106") should contain two folders called reduce.doc and reduce.fonts, and three files called reduce.com, reduce.exe and reduce.img. There are two ways to run REDUCE:

(The executables reduce.exe and reduce.com are identical except that the first is linked as a "windows" application and the second as a "console"application. Running the command-line version as " reduce -l logfile.log" arranges to keep a transcript of your session in the given log file.)

Adding REDUCE to the Windows Start menu

Installation of Windows applications normally includes adding items (shortcuts) to the Windows Start menu, which you can easily do by hand as follows. Right-click on the Windows Start button. If you want to create Start menu items only for yourself select Open or Explore from the top of the menu; if you want to create Start menu items for all users select Open All Users or Explore All Users from the bottom of the menu. If you want the REDUCE menu items to appear in the main part of the All Programs menu, open the folder called Programs; if you create them in the root of the Start menu folder they will appear at the top of the All Programs menu. (You can move menu items around after you have created them, just like any other files and folders.)

Optionally, select File / New / Folder and type a name for a sub-menu, such as REDUCE, then open the new sub-menu folder. Right-click-and-drag the file reduce.exe to the appropriate Start menu folder and select the option Create Shortcuts Here from the resulting pop-up menu. Change the name of the shortcut to something sensible like REDUCE. Do the same for reduce.com and rename the shortcut to something like "Command-line REDUCE". Notice that Windows detects automatically that this is a different kind of shortcut. Right-click it, select Properties and then the Program tab. Add "-w" (without the quotes) to the end of the command line (Cmd line:). You can also change other properties, such as the working directory (Working:), if you want.

The windowed version of REDUCE has a Help menu (at the right-hand side of the menu bar), which displays HTML documents in your default web browser. You can also provide access to the same help from the Start menu by creating a shortcut to the file index.html in the reduce.doc folder, as described above for the program files, and renaming it to something helpful like Help.

Testing your REDUCE installation

For a very quick test that REDUCE is working, you might try typing the following lines of input to successive REDUCE input prompts in either the windowed or the command-line version:

x^x;
df(ws,x);
int(ws,x);

Finally, the command

bye;

should terminate any version of REDUCE.

Running REDUCE from a Command Prompt

To run REDUCE from a command shell (such as the default Windows command shell cmd.exe) it is best to add the directory containing reduce.com to your execution path. One way to do this is to right-click on My Computer, select Properties from the bottom of the pop-up menu, click on the Advanced tab and then click on the Environment Variables button at the bottom of the dialogue box. You will see two sets of variables: user variables for you alone and system variables for everyone. Both sets should contain a variable called PATH. Choose one of these PATH variables, double-click it, and edit the path of the REDUCE executable folder into the value, following the style of the other path elements. (Note that path elements in Windows are separated by semi-colons.)

Compiling from the source code

The build environment on Windows is currently assumed to be Cygwin, which provides a very similar environment to Linux: Linux consists of GNU software running on a Linux kernel, whereas Cygwin consists of GNU software running on a Windows kernel via a Unix emulation layer provided by the Cygwin dll. Red Hat, Inc. supports both Cygwin and its own distribution of Linux.

You need to have a sufficiently complete Cygwin installation, including the tools required to obtain and unpack the source code files and the tools required to build using the MinGW (Minimalist GNU for Windows) environment. If the build process fails in any non-obvious way then it probably means that you are missing some necessary build tool. Once you have a suitable Cygwin installation, building REDUCE is very similar to the procedure on other platforms. For the time being, please see the general guidance on Obtaining REDUCE from SourceForge.

Here is a tentative list of the Cygwin package you need to build REDUCE, but please note that we don't guarantee this list to be either sufficient or necessary!

Required Cygwin packages
Package Comment
autoconf  
automake  
(bash) installed anyway
bintools  
bison not used via regular makescripts
bzip2  
diffutils ?needed?
flex not used via regular makescripts
gcc-g++  
gcc-mingw-g++  
gzip probably!
libncurses-devel  
libtool  
make  
patch  
patchutils  
sed  
subversion  
tar  
tetex to process the documentation
unzip  

Project Web Hosted by SourceForge.net

This page was last edited by fjwright on 1 February, 2009