%
% splancs documentation
%
\documentstyle[12pt]{article}
\topmargin 0cm
\textheight 8.5in
\setlength{\parskip}{0.1in}
\setlength{\parindent}{0in}
\newcommand{\Splancs}{{\sf Splancs}}


\title{\Splancs: Installation Guide}

\author{B. S. Rowlingson \& P. J. Diggle \\Lancaster University, Lancaster, U.K.}

\begin{document}

\maketitle

\Splancs\ is supplied on one double-sided, double-density 3.5 inch disk.
This disk contains a compressed tar file, which has been uuencoded into
ascii. This tar file contains all the \Splancs\ code and
data files.

To extract the files from the archive, it must first be copied onto the
hard disk of your Unix machine. If you have a Sun workstation with a floppy
disk drive, it can be read from there. The disk can also be read by an
IBM PC or compatible, and transferred to the Unix machine with ftp,
or PC-NFS.

It is necessary to create a directory to hold the \Splancs\ functions.
The best place for this is in the library directory of Splus. To find
out where this is, issue the following commands at the Unix prompt:

\begin{verbatim}
% setenv SLIB `Splus SHOME`/library
% echo $SLIB
\end{verbatim}
Note the use of back-quotes in the first line.

 Now we need to make a subdirectory, called \verb|splancs| under the
library directory:

\begin{verbatim}
% mkdir $SLIB/splancs
\end{verbatim}

Now the \verb|uue| file on the disk should be copied to this directory.
On a Sun Sparcstation with a floppy disk drive, it is done with the
following commands:

\begin{verbatim}
% cd $SLIB/splancs
% mount /pcfs
% cp /pcfs/splancs.uue splancs.uue
\end{verbatim}

If you have the {\tt mtools} programs, the appropriate command is {\tt
  mcopy a:splancs.uue \$SLIB/splancs/}.

If tranferring from a PC, the file can be transferred as an ascii file.

Now the \verb|uue| file can be converted to a compressed tar file with the
following command:

\begin{verbatim}
% uudecode splancs.uue
\end{verbatim}

This should produce a file called \verb|splancs.tar.Z|. The files can be
extracted from this with the command:

\begin{verbatim}
% zcat splancs.tar.Z | tar xvf -
\end{verbatim}

This should create a whole lot of \verb|.S| files, and the \verb|.Data|
and \verb|.Data/.Help| directories. You can then delete the {\tt splancs.uue}
and {\tt splancs.tar.Z} files.

Now read the file \verb|README.FIRST| for the rest of the installation
instructions.

The file \verb|SHelp.ps| will contain the manual pages for the latest release
of \Splancs. This is a {\sc PostScript} source file.

Note that this release of \Splancs\ includes the space-time
and raised incidence modelling code as well as the first bug-fix
release.

If you have any problems with installation or use of \Splancs, you can
e-mail me on \verb|B.Rowlingson@lancs.ac.uk|. 

 Barry Rowlingson  \hfill  December 1991

  % end of document
\end{document}