README.htm

Table of Contents

  1. Distribution Structure
  2. Source Code Distribution
  3. Linux Binary Distribution
  4. Linux RPM Distribution
  5. Environment Variables
  6. Known Bugs
  7. Troubleshooting
  8. Links for More Information



Distribution Structure



Return to Top




Source Code Distribution

  • Refining the Makefile


  • The GRAMMP source code requires the Motif and OpenGL libraries.  If your system does not have one or both of these libaries installed, you might consider downloading open-source versions of both libaries.

    Necessary Libraries Alternative Shareware Website
    Motif Lesstif www.lesstif.org
    OpenGL Mesa www.mesa3d.org



    Compiling Options

    Many of the parameters defined in the Makefile within the src directory are architecture-dependent. The following list defines the list of parameters which must be correctly defined within this file:

    Architecture CFLAGS
    SGI (MIPS2 Processor) CFLAGS = -common -O2 -mips2 -DSGI
    Linux CFLAGS = -O3 -DSGI




  • Defining Source Code Dependencies

  • The Makefile uses the
    makedepend.pl utility developed by Rob Lowrie to define the dependency list. This perl script is included in the bin directory. Before compiling, type make depend within the AMMP root directory.

    Return to Top




  • Compiling the Source Code

  • To generate the AMMP, GRAMMP, and PREAMMP executables, run make all within the AMMP root directory.


    Return to Top




  • Global Installation (Optional)

  • Once the executables have been created using make, the AMMP, GRAMMP, and PREAMMP executables can be installed for all users. The Makefile within the AMMP root directory defines the target location for the executables. After defining this target location (default is /usr/local/bin), use the command make install to "install" the executables.

    Return to Top




    Linux Binary Distribution

    If you obtained the Linux binaries, you will probably have to indicate the location of the Motif library (LessTif library provided with Linux binary distribution). This can be done in two ways:
    1. Add an entry to /etc/ld.so.conf indicating the location of the Motif library and then run ldconfig - This should require root access.
    2. Define the environment variable LD_LIBRARY_PATH equal to the directory containing the Motif library


    Return to Top




    Linux RPM Distribution

    The fastest way to install AMMP/GRAMMP on a Linux machine is via RPM (see
    www.rpm.org for more information on RPM). Just type rpm -i ammp-2.0-1.rpm to install AMMP/GRAMMP.

    Return to Top




    Environment Variables

    There are two environment variables that GRAMMP utilizes for its on-line help. Best advice is to define these variables in one of your startup files (such as .cshrc or .login).
    1. AMMP_BROWSER: defines web browser executable (e.g. Netscape Navigator or Internet Explorer). If this environment variable is not set, then GRAMMP will prompt the you and allow you to search your file system for a web browser executable.
    2. AMMP_URL: defines url for help pages, currently defaults to http://asterix.jci.tju.edu/ammphelp/Index.htm. Once you have downloaded the distribution, you should set this equal to your local help pages (e.g. if your ammp distribution is located in /usr/local/ammp-2.0, then set the AMMP_URL to /usr/local/ammp-2.0/doc/Help/Index.htm).


    Return to Top




    Known Bugs

    Situation Bug Notes
    Running GRAMMP on SGI Warning:
    Name: menupane
    Class: XmRowColumn
    Attempt to add wrong type child to a menu (i.e. RowColumn) widget
    Warning appears harmless - program runs the same


    Return to Top




    Troubleshouting

    Error Situation Remedy
    grammp: error in loading shared libraries libXm.so.1: cannot open shared object file: No such file or directory Running grammp Make sure the environment variable LD_LIBRARY_PATH includes the directory with the libXm.so.1 (Motif library)
    cp: cannot create regular file `/usr/local/bin/ammp': Permission denied Installing the executables Installing the executables into /usr/local/bin requires root access


    Return to Top




    Links for More Information






























    Written by David S. Cavanaugh (4/99)