Documentation Guide

• RDist 7.0 README - A guide to this product.
• RDist 7.0 Release Notes (doc/RELEASE_NOTES.html) - Supported platforms, platform specific notes, and new features.
• RDist 7.0 Installation (INSTALL.html) - Installation requirements and installation instructions including how to compile from source.

Installation of Source Distribution

Prerequisites

• Make sure you read the RELEASE_NOTES.html file before proceeding. This file contains valuable information on what system platforms are supported.

• Make sure you have a supported C compiler. We recommend a current version of GNU's GCC compiler.

• The yacc (or compatable) program is required. We recommend GNU's Bison program.

• You must use GNU make to build from source.

Compilation Notes

• Supported Platforms. RDist uses GNU autoconfigure (i.e. A "./configure" script) to configure system parameters before compilation. It should work on most any Unix or Linux based OS.

• Makefile:XXX: *.d: No such file or directory During initial compilation you may see error messages like this. The messages are perfectly normal and can be safely ignored. They are generated the first time make is run and indicate that a dependency file does not exist. It will be automatically generated by make and further such messages for the indicated file should not appear.

  Instructions

  1. Follow the instructions to Download the source distribution. You should have a file named rdist-7.0.tar.gz or something similiar.

  2. Unpack the distribution:

     gzip -d rdist-7.0.tar.gz | tar -xf -

  3. By default, configure will choose the name of the compiler which is correct for the system platform. However, if you have done things like make cc a link to gcc this may not work correctly in some cases.

     If you need to specify a compiler to use, then specify one now by setting the environment variable $CC to the name of the compiler to use. For csh users use:

     setenv CC compiler

     For sh/bash/ksh users use:

     CC=compiler export CC

     where compiler is the name of the compiler to use. i.e cc or gcc.

  4. Run the configure program to build configuration information for your system:

     ./configure

     Without any options configure will build RDist with an installation directory of /usr which will result in the replacement of any default version of RDist which came with your OS. If you wish to specify an installation directory, then use the --prefix=dir argument. For instance, to use /tools as the main directory, run:

     ./configure --prefix=/tools

  5. Now compile and build everything by running make (make sure to use GNU make):

     make

  6. To install everything, run the following:

     make install

  7. The installation is now complete.

  ---

  Mike Cooper
  Last modified: Tue Oct 9 18:31:22 PDT 2001