\input amstexl
\input lamstex

\docstyle{paper}

\fancyfootnotes
\RefWarnings
\litdelimiter*
\litbackslash"

%%%%%%%%%%%%%%%%%%%%% Special stuff for this document %%%%%%%%%%%%%%%%%%%%%

%% Material before title (\pretitle):

\font\bigbf=cmbx10 scaled\magstep5
\redefine\pretitle{\centerline{\bigbf READ ME FIRST!}\vskip5pt}

%% Put headings on pages:

\headline={\ifnum\pageno=1 \hfil
 \else
  \tenpoint
  \leaders\hrule height.6pt\hfil\ %
  \LamSTeX\ \bf INSTALLATION MANUAL%
  \rm\ \leaders\hrule height.6pt \hfil
 \fi}

%% LaTeX logo:

\define\LaTeX{L\kern-.35em\raise.4ex\hbox{\sevenrm A}\kern-.15em\TeX}

%% TeXtures logo:

\define\TeXtures{\TeX {\smc tures}}

%% BibTeX logo:

\def\BibTeX{B{\eightrm IB}\kern-.1em\TeX}

%% For special `Mac' paragraphs

\define\Mac{%
 \medbreak\noindent
 \vtop{\offinterlineskip
       \vbox{\hrule
             \hbox{\vrule
                   \hskip1.5pt
                   \vbox{\vskip1.5pt
                         \hrule height 7pt width11pt depth0pt
                         \vskip2pt
                         \hbox{\hskip4pt
                               \vrule height.25pt depth.25pt width4pt
                               \vrule height.7pt depth.7pt width 3pt}%
                         \vskip3pt}%
                   \hskip1.5pt\vrule}%
             \hrule}%
       \vskip-.4pt
       \hbox to14.8pt{\hfil
                      \vbox{\hrule
                            \hbox to12pt{\vrule height2pt\hfil \vrule}%
                            \hrule}%
                      \hfil}%
      }\hskip5pt\relax}

\define\endMac{\medbreak}

%% \ character, when literal mode can't be used:

\define\bs{\char'134 }

% Prevent the hyphenation re-ally:

\hyphenation{real-ly}

%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%

\document

\title \rm\LamSTeX\\ INSTALLATION\\ MANUAL\endtitle

\author The \TeX plorators Corporation\endauthor

\abstract
This installation manual explains how to install \LamSTeX\ on MS-DOS machines
or on the Macintosh.

This manual was itself produced with the \lit*paper* style. 
Appendix~\ref{repro} explains how to use \LamSTeX@, together with some of the
text files supplied, to reproduce this manual.
\endabstract

\date\today

\thanks{Acknowledgements:

As always, my most sincere thanks go to Don Knuth, who made it all possible.

Thanks to all those who tried out \LamSTeX\ in its early stages, and to
Mike Downes and Barbara Beeton, for the interfacing with \AmSTeX.

Special thanks to Blue Sky Research, and Doug Henderson in particular, for
efforts beyond the call of duty, or even of reason.}

\keywords{\LamSTeX}
\subjclass{Typesetting}
\address{3701 W. Alabama, Suite 450-273. Houston, TX 77027 (U.S.A.)}

\maketitle

%\maketoc
\tocfile
\toclevel 1

\heading Introduction\endheading

The main Manual for \LamSTeX\ is {\it\LamSTeX@, The Synthesis}, together with
the \LamSTeX\ Version~\lit*2.0* Supplement, which notes various changes for
the latest version.  The most important changes are covered in sections~ 2.1,
4.1, 4.2, 5.1, and~ 5.2 of the Supplement.  Chapters~9 and ~10 of the
Supplement explain about the \lit*paper* and \lit*book* style (mentioned
below), and Chapter~13 explains about partitioned matrices, a new feature of
\LamSTeX@.  

\heading Cautions, Requirements, and Prerequisites\endheading

In addition to the \lit*.log* and \lit*.dvi* files that \TeX\ normally
writes, \LamSTeX\ also writes files with the extensions \lit*.lax*, 
\lit*.ndx*, and \lit*.toc*. Files with the extension \lit*.aux*,
\lit*.xdx*, and \lit*.bbl* may also be produced.

This naturally means that you should avoid these extensions for files that
you make yourself, and it also means that your operating system must allow
numerous files to be open at once; in MS-DOS systems your \lit*config.sys*
file should set the values \lit*FILES=20* and \lit*BUFFERS=16*, or higher.

To run \LamSTeX\ you will need an implementation of \TeX\ that allows the
maximum main memory size (\lit*65534* words); it must also allow at least
\lit*3000* control sequence names (as well as enough room for the
additional fonts that come with \LamSTeX).

In addition to macro packages, \LamSTeX\ also involves some programs. As
explained below, MS-DOS or Macintosh versions are supplied, as well as the
C~source code, for compilation on other machines.

The \LamSTeX~Manual assumes that you already know about, and are using, \TeX\
(the basic reference here is [1], though you might well be using a more
elementary introduction); for the installation, you will also need to have at
least some idea of where your implementation of \TeX\ keeps various types of
files.  A little familiarity with \AmSTeX\ is also assumed, the official
reference being [3]. You do not need to know \LaTeX\ (described in [2]),
except that you won't understand the name `\LamSTeX' unless you know that
\LaTeX\ exists also.

\heading Installation\endheading

\LamSTeX\ consists of several macro packages to be used along with \TeX@,
a couple of programs to process various parts of the output, and 5~new
fonts, for producing commutative diagrams (see Part~II of the Manual,
{\it\LamSTeX@, The Synthesis}).

Since different implementations of \TeX\ keep files in different places,
it is not possible to provide an installation program to place all the
\LamSTeX\ files in the proper place; you will have to do that yourself,
although there are some aids for installing the fonts properly.

\section{Macro packages} You might want to make a special directory for
the \LamSTeX\ macro files, or you might want to put them in a directory
where your implementation of \TeX\ normally looks for input files.

As explained in the Manual, \LamSTeX\ must always be used with
\AmSTeX@, and in particular, with the file \lit*amstexl.tex*.

The files \lit*lamstex.tex* and \lit*lasmtbl.tex* are the main macro packages
for \LamSTeX@, while \lit*lamstex.stf*, \lit*lamstex.stb*, and
\lit*lamstex.stt* are subsidiary files used when producing tables of
contents, indexes and tables.

The file \lit*ptmatrix.tex* is used for partitioned matrices, as mentioned
above.  The file \lit*bibtex.tex* is needed when interfacing with \BibTeX\
(as explained in Chapter~7 of the Supplement). The file \lit*lithl.tex* has a
very specialized use, explained in Chapter~11 of the Supplement, and the
files \lit*pcompat.tex* and \lit*acompat.tex* are also quite specialized,
allowing compatibility with files originally produced with \lit*plain* \TeX@,
and \AmSTeX@, respectively; the use of these files is described at the
beginning of the files themselves.

Eleven pairs of files, \lit*alignat.tex*, \lit*alignat.tox*, \dots,
\lit*varref.tex*, \lit*varref.tox*, come next; their function is described
in Chapter~14 of the Manual.

Next come ``style files''.  As the Manual explains, \LamSTeX\ % automatically
comes with a default style, which is easy to use while you are still learning
about \text{\LamSTeX}@. There are also two ``generic'' \LamSTeX\ styles---for
papers and books---which comprise the files \lit*paper."1"1"1* and
\lit*book."1"1"1*.  (Eventually, many specialized style files should also be
available for \LamSTeX.) As mentioned in the Introduction, the \lit*paper*
and \lit*book* styles are described in Chapters~9 and~10 of the Supplement;
since most features of these styles are extensions of those for the default
style, you should be familiar with the default style, explained in the
Manual, before trying to learn about the specialized styles.

[Both the \lit*paper* and \lit*book* styles use 8~point type for various
constructions, and they both have the control sequence \lit*\LamSTeX* for
printing the `\text{\LamSTeX}' logo, which uses the Computer Modern symbol
font \lit*cmsy8*, normally loaded only for 8~point type. The file
\lit*lamslogo.tex* allows you to print the \LamSTeX\ logo even in the default
style: Type `\lit*\input lamslogo*' at the beginning of your file; this will
load \lit*cmsy8* if necessary, and then define the \lit*\LamSTeX* control
sequence.]

There is also a specialized \lit*letter.st* for letters; to find out about
it, \TeX\ the file \lit*letter.tex*, and print it out.  (The letter uses the
\lit*\LamSTeX* logo control sequence, so you will need to have the
\lit*cmsy8* font available. If you don't have this font, simply delete the
line \lit*\input lamslogo* from the file, and replace the occurrences of
\lit*{\LamSTeX}* with something you can print, for example, `\lit*LAMSTEX*'.)

\section{Programs\label{programs}} The \LamSTeX\ programs \lit*index* and
\lit*dvipaste* are used to process some of \LamSTeX's output: \lit*index*
turns the compact index files produced by \LamSTeX\ into sorted, extended,
files that can then be used to actually print an index (Chapter~13 of the
Manual), while \lit*dvipaste* is needed to implement \LamSTeX's approach to
tables (see Chapter~17).  These programs should be installed in the proper
place for them to work on the files that are produced by \LamSTeX@.  For
MS-DOS there are executable files \lit*index.exe* and
\lit*dvipaste.exe*.

\Mac
For
the Macintosh version of \LamSTeX\ there are \lit*dvipaste* and \lit*index*
applications. As explained in the Manual, \lit*dvipaste* combines
\lit*.dvi* files. If you are using \TeXtures, which normally doesn't
create \lit*.dvi* files, you will first have to use the \TeXtures\ DVItool
accessory, choosing `Export DVI' to create the \lit*.dvi* files that are
going to be combined; after using \lit*dvipaste* to create a (newly named)
\lit*.dvi* file, you will have to use the DVItool accessory again,
choosing `Import DVI' to convert this \lit*.dvi* file into a \TeXtures\ %
document. (Sigh.)  \endMac

If you have neither an MS-DOS machine nor a Macintosh, the necessary programs
can be compiled from the C~source code files \lit*dvipaste.c* and
\lit*index.c*.

\section{Fonts} Installation of \LamSTeX's fonts for commutative diagrams
is more complicated.

\subsection{The {\tt.tfm} files} Even if you aren't going to use
commutative diagrams, you will at least need the \lit*.tfm* files
\lit*lams1.tfm*, \dots, \lit*lams5.tfm*, since the \lit*lamstex.tex* macro
package uses them, and you will also need the \lit*dummy.tfm* file that is
used by \AmSTeX@.
\footnote{This font isn't all that important, but the \AmSTeX\ macro file
does load it; only the metrics for this font are needed, since it is used
only for ``syntax checking'', where no output is produced.} These \lit*.tfm*
files should simply be placed wherever your implementation of \TeX\ expects
to find \lit*.tfm* files.

\Mac
For versions of \TeX\ on the
Macintosh that do not use ordinary \lit*.tfm* and \lit*.pk* files,
  there are `\lit*lamsmetrics*' and `\lit*lamsfonts*'
suitcases for \TeXtures. Just copy these suitcases into the \TeXtures\ %
`\lit*TeX fonts*' folder, and you will be done.  The suitcases contain the
necessary font metrics, as well as the fonts for printing on the LaserWriter
or viewing with \TeXtures---these fonts are supplied at the standard
magnification, as well as the magnifications \lit*\magstephalf*,
\lit*\magstep1*, and \lit*\magstep2*.

In addition, there is a `\lit*dummy*' suitcase for the \lit*dummy* font used
in \AmSTeX@, which should also be transferred to the `\lit*TeX fonts*'
folder.


\subsection{The {\tt.pk} files} Installation of \lit*.pk* files is much
more complicated, not only because every implementation of \TeX\ seems to
arrange things differently, but also because different \lit*.pk* files are
required for different printers.  The
\lit*.pk* files are kept in separate directories (or folders)---\lit*300*,
\lit*240*, \lit*180*, and \lit*118*---where \lit*300* is for 300~dot/inch
printers, \lit*240* for 240~dot/inch printers, \lit*180* for 180~dot/inch
printers, and \lit*118* for ``printing'' on the screen (viewing) with
ArborText's~\lit*preview*.

\smallskip
The first thing to do is to change to the subdirectory where you want to
place the standard size (unmagnified) \lit*.pk* files.  The name of this
subdirectory probably ends with something like that shown in the table
below: \pagelabel{startpage}
\bigskip
\centerline{\paste{insttbls}1}
\bigskip
\flushpar (If you are lucky, you might have an implementation of \TeX\
that follows a more logical arrangement, like using \lit*\300\m1000* for
the unmagnified fonts for 300~dot/inch printers, \lit*\240\m1000* for the
unmagnified fonts for 240~dot/inch printers, etc.)

Each of the directories \lit*300*, \dots,
\lit*118*, has subdirectories \lit*0*, \lit*h*, \lit*1*, and \lit*2*,
where the subdirectory \lit*0* contains the unmagnified fonts for that
resolution. The five files {\it in subdirectory~\lit*0* of the appropriate
directory\/}  should be copied to the hard disk, {\it
assuming that you are in the proper subdirectory of the hard disk}.

For MS-DOS systems, there are batch files, \lit*300.bat*, \lit*240.bat*,
\lit*180.bat*, and \lit*118.bat*, to do this.  {\it Assuming that you are
in the proper subdirectory of the hard disk}, and that the diskette
containing the fonts is in drive \lit*a:*, you can simply type



\list
\item \lit*a:300* for 300 dot/inch printers;
\item \lit*a:240* for 240 dot/inch printers;
\item \lit*a:180* for 180 dot/inch printers;
\item \lit*a:118* for 118 dot/inch previewing.
\endlist
If, for some reason, the diskette has to be placed in the \lit*b:* drive,
then in the batch files all occurrences of \lit*a:* will have to be
changed to \lit*b:*.

\smallskip

The Manual was actually printed with somewhat preliminary versions of
these special fonts, and at certain places in the Manual, for example, on
page~139, it can be seen that different portions of horizontal arrows do
not align quite properly.  The arrow fonts that come with \LamSTeX\ have
corrected these deficiencies.

Nevertheless, at 300 dot/inch, or even lower resolution, it is inevitable
that there will be some jaggedness in the arrows---which are constructed
by juxtaposing smaller pieces---as in the diagram below:
$$
\cgaps{1;.5}
\CD
A @(1,0) @(0,-1) @(1,-1) & B @()\0t@(0,-1) @(1,0) @(1,-1)& C@(0,-1)\\
D @(1,0) @(1,1) & E @(1,1) @(1,0)& F
\endCD
$$

By the way, this diagram has no inherent interest, except that it happens
to use characters from all five of these fonts, so printing this manual
yourself, as described in Appendix~\ref{repro}, provides a check that the
fonts have been installed correctly.

\Mac
If you have a Macintosh Plus or SE@, things will be even worse when you
view such diagrams.  Because of a QuickDraw bug in the ROM@, horizontal
and vertical arrows usually won't have the proper heads; however, the
printed version will still be correct.
\endMac

\topic{Magnified fonts} You now have all the \lit*.pk* files necessary for
printing (or previewing) unmagnified documents.  But in case you want to
apply magnification to some documents, all the \lit*.pk* files are also
supplied at magnifications of \lit*\magstephalf*, \lit*\magstep1*, and
\lit*\magstep2*.

\subtopic{Fonts for {\tt\bs magstephalf}} To install all the \lit*.pk*
files used for magnification by\linebreak \lit*\magstephalf*, you must
first change to the subdirectory where the magnified files are supposed to
go.  The name of this subdirectory probably ends with something like that
shown in the table below
\bigskip
\centerline{\paste{insttbls}2}
\nopagebreak
\bigskip
\flushpar(or, more logically, with something like \lit*\m1095*.)

Now you should copy the files in subdirectory~\lit*h* of the appropriate
directory on the diskette to this directory of the hard disk.  For MS-DOS
systems, you can simply type
\list
\item \lit*a:300-h* for 300 dot/inch printers;
\item \lit*a:240-h* for 240 dot/inch printers;
\item \lit*a:180-h* for 180 dot/inch printers;
\item \lit*a:118-h* for 118 dot/inch previewing.
\endlist

\subtopic{Fonts for {\tt\bs magstep1}} The \lit*.pk* files for
magnification by \lit*\magstep1* are installed similarly, in a
subdirectory whose name probably ends with something like that shown in
the table below
\bigskip
\centerline{\paste{insttbls}3}
\nopagebreak
\bigskip
\flushpar (or, more logically, with something like \lit*\m1200*).

In this case, you should copy the files in subdirectory~\lit*1* of the
appropriate directory on the diskette to this subdirectory of the hard
disk. For MS-DOS systems, you can simply type \lit*a:300-1* or
\lit*a:240-1* or \lit*a:180-1* or \lit*a:118-1*.

\subtopic{Fonts for {\tt\bs magstep2}} Finally, the \lit*.pk* files for
magnification by \lit*\magstep2* can be installed in the same way, in a
subdirectory whose name probably ends with something like that shown in
the table below \pagelabel{endpage}
\bigskip
\centerline{\paste{insttbls}4}
\nopagebreak
\bigskip
\flushpar (or, more logically, with something like \lit*\m1440*).

In this case, you should copy the files in subdirectory~\lit*2* of the
appropriate directory on the diskette to this subdirectory of the hard
disk.  For MS-DOS systems, you can simply type \lit*a:300-2* or
\lit*a:240-2* or \lit*a:180-2* or \lit*a:118-2*.

\section{Sources} The final set of files are source-code for programs and
fonts.  In addition to the \lit*dvipaste.c* and \lit*index.c* source code,
discussed in section~\ref{programs}, there are the MetaFont source files
\lit*lams1.mf*, \dots, \lit*lams5.mf*, from which these fonts can be
produced at any size and resolution.

Although the \lit*dvipaste* program was written specifically for
\LamSTeX@, it can actually be used for numerous general \TeX\ purposes, in
conjunction with an extra macro package \lit*dvipaste.tex*.  The file
\lit*dvipaste.doc* describes such usage, which is further illustrated by
the files \lit*boxes1.tex*, \lit*boxes2.tex*, and \lit*join.tex*. (None of
these files are really part of \LamSTeX.)


\appendices
\appendix Reproduction\label{repro}\endappendix

The files \lit*insttbls.tex* and \lit*inst.tex* may be used to reproduce
this manual (with the current date). This provides a good test that
\LamSTeX\ is safely installed, since it uses so many \LamSTeX\ features,
but for this very reason you might want to wait until you are more
familiar with \LamSTeX\ before making the attempt.

Once you're ready, here's the recipe:
\list \advance\litindent30pt

\item First \TeX\ the file \lit*insttbls.tex*. (If you've already made a
\LamSTeX\ format file, {\it do not\/} use it for this file [see page~179
of the Manual], just \TeX\ the file directly.)  This will produce a
\lit*insttbls.dvi* file that you may or may not want to print, and a file
\lit*insttbls.dat*, both needed in the sequel.

\item Now \TeX\ the file \lit*inst.tex*. (If you've made a \LamSTeX\
format file, you can use it for this file---the first two lines of the
file will essentially be ignored.) Ignore \lit*Warning* 
 messages.  A \lit*inst.toc* file will be produced, along with the
\lit*inst.dvi* file (which isn't any good yet, since the Contents don't
appear).

\item Now use your text editor to remove the \lit*%* sign before the line
\lit*\maketoc* (you wouldn't want this line there the first time, because
\TeX\ would complain that it couldn't find the \lit*inst.toc* file), and
\TeX\ the file \lit*inst.tex* once again.  This time no \lit*Warning* 
 messages should appear.

{\newpost\list1{$'$} \Offset\list10
\item The new \lit*.dvi* file now has the Contents, but the page numbers
aren't correct, because inclusion of this Contents has moved some sections
to the next page. So you have to \TeX\ the file once again.
}

\item Finally, use the \lit*dvipaste* program,
\Lit*
dvipaste inst
*
to produce a new \lit*inst.dvi* file.  (With \TeXtures, you must first use
the DVItool accessory to produce the \lit*inst.dvi* and \lit*insttbls.dvi*
files, then use \lit*dvipaste*, and then use DVItool once again to create
a new \TeXtures\ document.)

\endlist

Once the ingredients are properly mixed, place in a moderate laser printer
for 10--20 seconds per page, allow to cool for a few seconds, and enjoy.
Makes 1~copy.

\makebib
\bib \no1 \by Knuth, Donald E. \book The \TeX book \publ
  Addison-Wesley Publishing Company, Inc\endbib
\bib \no2 \by Lamport, Leslie \book \LaTeX@: A Document Preparation
 System \publ Addison-Wesley Publishing Company, Inc\endbib
\bib \no3 \by Spivak, M.D., Ph.D. \book The Joy of \TeX \publ
 American Mathematical Society\endbib
\endmakebib

\enddocument
