\section[lit-install]{Standalone installation of Glasgow literate programming}

NOT DONE PROPERLY YET.

Here are some short notes; they should work on a Sun4:
\begin{enumerate}
\item
If you don't have \tr{perl}, go get it.

\item
If you don't have \tr{makeindex} (normally with the TeX distribution)
and/or \tr{tgrind}, go get them, if you wish.  You can easily get by
without them, especially \tr{tgrind}.

\item
Customise for your local configuration, by creating a suitable
\tr{mkworld/site.jm} file.  We supply a \tr{site.dist} file that you
can copy and work from.

Setting \tr{PerlCmd} correctly is {\em vital}.

All the Haskell-compiler stuff isn't important for the
literate-programming system.

Setting \tr{TgrindHelperCmd} is important if you're going to try the
tgrind-ing stuff.

Setting the things for installation (near the end) is {\em vital}.
You will almost certainly need to set \tr{InstRootDir}, and perhaps
some others.  If you don't set anything, the literate-programming
system will be installed (on a Sun4) in...

\begin{tabular}{ll}
/usr/local/bin/sun4 &	things for the user to invoke (lit2mumble) \\
/usr/local/lib/literate/sun4 & machine-specific support stuff \\
/usr/local/lib/literate & machine-independent support stuff \\
\end{tabular}

\item
OK, you should be ready to go!  From the top of the distribution...
\begin{verbatim}
% cd lit2xxx-X.YY
% ./STARTUP-literate >& startup.log
\end{verbatim}
Everything should proceed to an obviously-successful conclusion (check
the log to see...).

\item
Test the system enough to see that it's not totally broken.
Invoke \tr{lit2pgm}, \tr{lit2latex}, or \tr{lit2texi} directly from
the \tr{literate/} directory, on some small test file of your choice,
even something as simple as...:
\begin{verbatim}
\section[test]{Test section}
This is a small test.
\end{verbatim}
Then try, perhaps:
\begin{verbatim}
% literate/lit2latex -v -c test.lit
\end{verbatim}

\item
If things seem basically happy, you can safely install the system.
\begin{verbatim}
% cd literate
% make -n install   # trial run, just to see if it looks "right"
% make install	    # for real!
\end{verbatim}

\item
To make the documentation (some pre-built stuff is in the distrib):
\begin{verbatim}
% cd literate
% make literate.dvi # or ...
% make literate.info	# or ...
% make docs		# to do both
\end{verbatim}

In the unlikely event you wanted to install it, continue with:
\begin{verbatim}
% make install-docs
\end{verbatim}

\item
You can now either delete the source or just clean up:
\begin{verbatim}
% make clean
\end{verbatim}

\item
Save a copy of your configuration file \tr{mkworld/site.jm} for next
time.
\end{enumerate}

If you have problems, please report them to me,
partain\@dcs.glasgow.ac.uk.