Installation Instructions for WIP Version 2.3

    0. It is assumed that you already have retrieved and built the
    PGPLOT (Version 5.1.0 or later) graphics library.  If not, it
    is pointless to continue.  For more information on PGPLOT, look
    at the WWW URL: "http://astro.caltech.edu/~tjp/pgplot/".  Be sure
    that, when building the PGPLOT library, that you also build the
    C-binding library.  When this is finished, you should check that
    there is a file called cpgplot.h in the same directory as the
    library archive and the two libraries (libcpgplot* libpgplot*) exist.

    1. Retrieve the compressed tar file.
    
    This can be done one of two ways.  You can grab it from the WIP WWW
    home page ("http://bima.astro.umd.edu/wip/") or manually from
    anonymous ftp (ftp.astro.umd.edu).

    To use the anonymous ftp method, access ftp.astro.umd.edu.  Login as:
      User: anonymous
      Password: your return e-mail address (username@machine)

    The following ftp commands will retrieve the compressed WIP tar file:

      cd progs/morgan
      binary
      get wip2p3.tar.gz

    Note that the file MUST be transferred in binary mode.

    2. Extract the source code from the tar archive, e.g.

      cd /home/xxx
      gunzip -c wip2p3.tar.gz | tar xvf -

    This will create the directory /home/xxx/wip and other subdirectories.

    NOTE:  Some systems have an 'o' option to tar which sets the user
    and group identifier to the user running tar, rather than those in
    the tar file (mine).  On some systems, this option is the default.
    If your system does not default this, then you might need to use it.

    3. Create the subroutine library and the executable.

    The file /home/xxx/wip/makewip is used to build WIP.  Make sure
    that you pass the proper arguments with the proper values.  This
    means that, in this example, the -wip argument should be set to
    /home/xxx/wip and -pgplot to the directory that holds the PGPLOT
    library (Version 5.0.0 or later).  A template script to illustrate
    how to call makewip is provided in the file /home/xxx/wip/domake.
    You may modify it accordingly and then use it to build WIP.

    NOTE:  If you get error messages when building the C-bindings for
    PGPLOT or when building WIP (complaints about cpgplot.h), then
    you need to read about installing PGPLOT.  The latest versions
    require the use of an ANSI C compiler in order to construct
    the C-bindings for PGPLOT (and hence, for WIP).  For a Sun-OS
    machine, for example, this should probably be acc in /usr/lang.
    If that is not available, then use gcc with the -ansi flag.

    Some gcc systems (earlier than 2.6.0?) have trouble with the
    standard varargs.h/stdarg.h declarations.  If this happens on your
    system you will usually see the complaint that looks something like
    the following:
       /home/xxx/wip/src/sysdepunix/inoutput.c: In function `wipoutput':
       /home/xxx/wip/src/sysdepunix/inoutput.c:105: `__builtin_va_alist'
       undeclared (first use this function)
    If this happens, change your compiler option (-cc) to include the
    following definition -DNOVARARGS.  For example, if you call makewip
    with -cc "gcc -ansi", then change it to -cc "gcc -ansi -DNOVARARGS".

    Also, some gcc versions have their libraries in non-standard
    locations.  PGPLOT (including and after version 5.0.2) comes with
    a nice shell script that will tell you what directory to use.  Execute
    the script /home/pgplot/cpg/libgcc_path.sh (change /home/pgplot to
    whatever directory holds your PGPLOT distribution).  This script will
    list the libraries needed by gcc.  What you need to do is look in
    each of these directories and find the one that has libgcc.a.  Add
    this directory to your path list for the PGPLOT distribution.  For
    example, if PGPLOT is in /home/pgplot and libgcc.a was found to be
    located in the directory /home/gcc/gcc-lib, then change the directive
    to '-pgplot "/home/pgplot /home/gcc/gcc-lib"'.

    To access the X-window server (used by the /xs and /xw driver), it
    must either be in a directory in your binary search path or you
    should add the environment variable PGPLOT_DIR to your ~/.cshrc and
    have it point to where the binary pgxwin_server (as well as grfont.dat
    and rgb.txt files) reside.

    4. Copy the file /home/xxx/wip/.wipinit to your $HOME area and
    modify it according to the instructions in the manual (see below).

    5. Build and print the manual.

    An HTML version of the manual is available at the WWW URL:
    "http://bima.astro.umd.edu/wip/manual/wip.html"

    However, if you want the printed version, move to the directory
    /home/xxx/wip/doc and read the instructions found in the README
    file there.

    6. A list of changes in the various versions is also available
    from links of the WIP WWW site.  The HTML files are kept in the
    log subdirectory.