summaryrefslogtreecommitdiff
path: root/info/digests/texhax/txh/pavel2.txh
diff options
context:
space:
mode:
Diffstat (limited to 'info/digests/texhax/txh/pavel2.txh')
-rw-r--r--info/digests/texhax/txh/pavel2.txh2541
1 files changed, 2541 insertions, 0 deletions
diff --git a/info/digests/texhax/txh/pavel2.txh b/info/digests/texhax/txh/pavel2.txh
new file mode 100644
index 0000000000..271f832d51
--- /dev/null
+++ b/info/digests/texhax/txh/pavel2.txh
@@ -0,0 +1,2541 @@
+ 8-Apr-87 09:53:58-PDT,44327;000000000000
+Return-Path: <mcvax!nplpsg!jrp@seismo.CSS.GOV>
+To: texhax@score.stanford.edu
+Subject: LaTeX for the -ms macros user
+Date: Wed, 08 Apr 87 16:13:53 GMT
+From: John Pavel <mcvax!nplpsg!jrp@seismo.CSS.GOV>
+
+
+Sorry. These got bounced by seismo the first time.
+
+Let's hope that you get the two messages included below.
+
+John Pavel
+
+------- Forwarded Messages
+
+Date: Wed, 08 Apr 87 06:47:13 -0400
+Subject: Returned mail: Host unknown
+From: Mail Delivery Subsystem <Postmaster@seismo.uucp>
+To: jrp@psg.npl.co.uk
+
+ ----- Transcript of session follows -----
+550 su-score.arpa!texhax... Host unknown
+
+ ----- Unsent message follows -----
+Received: from mcvax.UUCP by seismo.CSS.GOV (5.54/1.14) with UUCP
+ id AA02322; Wed, 8 Apr 87 06:47:13 EDT
+Received: by mcvax.cwi.nl; Wed, 8 Apr 87 03:56:01 +0200 (MET)
+Received: from nplpsg.uucp by kestrel.Ukc.AC.UK with UUCP id aa05417;
+ 8 Apr 87 0:10 BST
+Received: from snow by snow.psg.npl.co.uk; Tue, 7 Apr 87 23:53:07 BST
+To: texhax@su-score.arpa
+Subject: LaTeX for the troff -ma macros user
+Return-Receipt-To: mcvax!psg.npl.co.uk!jrp
+Date: Tue, 07 Apr 87 22:53:07 GMT
+Message-Id: <6239.544834387@psg.npl.co.uk>
+From: John Pavel <mcvax!nplpsg!jrp>
+
+Here is a LaTeX version of the first cut on a paper that should
+help anyone trying to convert from the -ms macros to LaTeX.
+
+I would welcome any contributions to completing/correcting this paper.
+
+The extra style file is from Marshall Rose, slightly adapted.
+
+Thanks,
+
+John Pavel
+
+: Please feed me to /bin/sh
+: This is a shell archive, meaning:
+: 1. Remove everything above the : Please feed me to /bin/sh line.
+: 2. Save the resulting text in a file.
+: 3. Execute the file with /bin/sh -- not csh -- to create:
+: ms-latex.tex
+: sfwmac.sty
+: This archive created: Tue Apr 7 22:52:24 1987
+export PATH; PATH=/bin:/usr/bin:$PATH
+echo shar: "extracting 'ms-latex.tex'" '(17397 characters)'
+if test -f 'ms-latex.tex'
+then
+ echo shar: "will not over-write existing file 'ms-latex.tex'"
+else
+sed 's/^ X//' << \SHAR_EOF > 'ms-latex.tex'
+ X
+ X\documentstyle[12pt,a4,titlepage,sfwmac]{article}
+ X
+ X% Some local macros, mostly stolen from the scheme distribution
+ X
+ X% Same as \obeycr, but doesn't do a \@gobblecr.
+ X{\catcode`\^^M=13 \gdef\myobeycr{\catcode`\^^M=13 \def^^M{\\}}%
+ X\gdef\restorecr{\catcode`\^^M=5 }}
+ X
+ X{\catcode`\^^I=13 \gdef\obeytabs{\catcode`\^^I=13 \def^^I{\hbox{\hskip
+ 4em}}}}
+ X
+ X{\makeatletter \gdef\gobblecr{\@gobblecr}}
+ X
+ X\newenvironment{mstext}%
+ X {\obeyspaces \myobeycr \em
+ X \begin{tabbing}%
+ X \qquad\=\hspace*{5em}\=\hspace*{9em}\=\+\kill% was 16em
+ X \gobblecr}%
+ X {\unskip\end{tabbing}}
+ X
+ X\newenvironment{latextext}{
+ X\obeyspaces \myobeycr \em
+ X\begin{tabbing}%
+ X\qquad\=\hspace*{5em}\=\hspace*{9em}\=\+\kill% was 16em
+ X\gobblecr}{\unskip\end{tabbing}}
+ X
+ X\catcode`\"=\active
+ X{\makeatletter {\gdef"{\begingroup \catcode``=13
+ X \@noligs \tt \let\do\@makeother \dospecials \let"=\endg
+roup}}}
+ X
+ X\newcommand{\latex}[1]{\LaTeX}
+ X\newcommand{\ms}[1]{\mbox{\tt -ms}}
+ X\let\endverbatim=\endtrivlist
+ X
+ X\title{\latex/ for the \troff/ \ms/ Macros User}
+ X\author{John Pavel \\
+ XNational Physical Laboratory \\
+ XTeddington, UK\\[\bigskipamount]
+ X"jrp@nplpsg.UUCP"}
+ X
+ X\date{87/04/07 at 23:37:25%
+ X}
+ X
+ X\begin{document}
+ X
+ X \maketitle
+ X
+ X \begin{abstract}
+ X
+ X This document is intended to serve as a brief reference to \lat
+ex/ for
+ X those who are familiar with \troff/ and \ms/ macros. This vers
+ion
+ X is a draft for comment.
+ X
+ X \end{abstract}
+ X
+ X \tableofcontents
+ X
+ X\cleardoublepage
+ X
+ X\section{Introduction}
+ X
+ XThis document is intended to serve as a quick reference to those
+ Xconverting from \troff/ with the \ms/ macros~\cite{ms} to
+ X\latex/~\cite{LaTeX}. The reader is assumed to have a working knowled
+ge
+ Xof the \ms/ macros. Furthermore, the reader {\em must\/} have read at
+least
+ XChapter~2 of the \latex/ manual\cite{LaTeX}. That chapter covers the b
+asics of
+ X\latex/.
+ X
+ XThe default behaviour of \latex/ is described. With a certain amount
+of
+ Xconfiguring, \latex/ can be induced to produce almost any style of
+ Xoutput. Such configuring is, however, beyond the scope of this
+ Xdocument. Similarly, \latex/ has many features which are not describe
+d.
+ XThese include
+ X
+ X\begin{itemize}
+ X\item diagram production;
+ X\item mathematical typesetting;
+ X\item the typesetting of program sources;
+ X\item automatic cross-referencing and index production;
+ X\item the layout of tables;
+ X\end{itemize}
+ X
+ XThe \latex/\cite{LaTeX} and \TeX\cite{TeX} manuals
+ Xshould be consulted for the full story.
+ X
+ X\section{Getting Started with \latex/}
+ X
+ XTo run \latex/ on a file called either "file" or, more conventionally,
+ X"file.tex", type
+ X\begin{verbatim}
+ X % latex file
+ X\end{verbatim}
+ X
+ XBy default, the file will be taken from either your current
+ Xdirectory, or, if no such file appears there, the directory
+ X"/usr/lib/tex/macros" will be searched.
+ X
+ XRunning \latex/ produces a DVI file ("file.dvi" for the above example)
+.
+ XYou can send this to the {\sf Imagen} by using \pgm{iptex}(l):
+ X\begin{verbatim}
+ X % iptex file
+ X\end{verbatim}
+ X
+ XAlternatively, you may like to preview it on the {\sf Sun} screen by u
+sing
+ X\pgm{texview}(l):
+ X\begin{verbatim}
+ X % texview file
+ X\end{verbatim}
+ X
+ XThe \latex/ Manual\cite{LaTeX} will refer you to a {\sl Local Guide}.
+ XThis guide can be found in the file "/usr/lib/tex/macros/local.tex", a
+nd
+ Xso can be printed out by
+ X\begin{verbatim}
+ X % latex local
+ X % latex local
+ X % iptex local
+ X\end{verbatim}
+ X
+ XNo, that is not a mis-print. You will need to run \latex/ twice. It
+ Xneeds to make two passes to establish all the cross-references.
+ XNormally, you will do this only for a final copy.
+ XYou may now get rid of all the temporary files that \latex/ creates
+ Xwith
+ X\begin{verbatim}
+ X % texclean
+ X\end{verbatim}
+ X
+ XTwo other files that you might like to look at in the
+ X"/usr/lib/tex/macros" directory are "small.tex" and "sample.tex".
+ X
+ X\section{Document Structure}
+ X
+ XThe \ms/ macros assume a document structure of the following form:
+ X
+ X\begin{mstext}
+ X {[optional date specification: ".ND" a date]}
+ X {[optional overall format: ".RP"---see below]}
+ X ".TL"
+ X Title of document (one or more lines)
+ X ".AU"
+ X Author(s) (may also be several lines)
+ X ".AI"
+ X Author's institution(s)
+ X ".AB"
+ X Abstract; to be placed on the cover sheet of a paper.
+ X ".AE" (abstract end)
+ X text \ldots
+ X\end{mstext}
+ X
+ XA \latex/ document has an analogous structure:
+ X
+ X\begin{latextext}
+ X "\documentstyle[a4]{article}" \>\> \` Specifies the document
+style.
+ X \>\> \` {\tt a4} is for
+ A4 paper
+ X
+ X "\title{"Title of document %
+ X(each line of title separated by "\\")\/"}"
+ X "\author{"Author(s) (each author separated by "\and")\/"}"
+ X "\date{"a date"}"
+ X
+ X "\begin{document}" \>\> \` End of preamble
+ and beginning of text.
+ X
+ X \> "\maketitle" \> \` Produces the title.
+ X \> "\tableofcontents" \> \` Produces the table of con
+tents.
+ X
+ X \> "\begin{abstract}"
+ X \> Abstract; to be placed under the title
+ X \> "\end{abstract}"
+ X
+ X \> body of text \ldots
+ X
+ X "\end{document}"
+ X\end{latextext}
+ X
+ XIf a separate title page and abstract page are preferred,
+ Xthe "titlepage" style option should be used:
+ X
+ X\begin{latextext}
+ X "\documentstyle[titlepage,a4]{article}"
+ X \> \ldots
+ X\end{latextext}
+ X
+ X\section{Page Headings}
+ X
+ XThe \ms/ macros allow headings and footings to be set by means of stri
+ng
+ Xdefinitions:
+ X\begin{mstext}
+ X".ds LH" left header
+ X".ds CH" center header
+ X".ds RH" right header
+ X".ds LF" left footer
+ X".ds CF" center footer
+ X".ds RF" right footer
+ X\end{mstext}
+ X
+ XThe scheme in \latex/ is slightly different;
+ Xthere are four page styles: "plain" (the default), "empty", "headings"
+ and
+ X"myheadings". These are activated by a
+ X
+ X\begin{latextext}
+ X"\pagestyle{"style\/"}"
+ X\end{latextext}
+ X
+ Xcommand. To set your own headings, the commands "\markboth" (for two-s
+ided documents)
+ Xand "\markright" (for one-sided documents) are required in addition:
+ X
+ X\begin{latextext}
+ X"\markright{"heading\/"}" or "\markboth{"left head\/"}{"right head\/"}
+"
+ X"\pagestyle{myheadings}"
+ X\end{latextext}
+ X
+ X\section{Multi-column Formats}
+ X
+ X\begin{sloppypar}
+ XThe ".2C" and ".1C" \ms/ macros permit changing to
+ Xtwo-column and single-column format. The analagous \latex/ commands
+ Xare "\twocolumn" and "\onecolumn". Like their \ms/
+ Xcounterparts, they also skip to a new page. If a complete document is
+ Xto be produced in two-column format, the "twocolumn" style option
+ Xshould be used, since that alters various style parameters, such as
+ Xthe amount of paragraph indentation, while the
+ X"\twocolumn" command does not.
+ X\end{sloppypar}
+ X
+ X\section{Section Headings}
+ X
+ XThe \ms/ macros
+ X
+ X\begin{mstext}
+ X ".NH"
+ X numbered section heading
+ X may be several lines
+ X\end{mstext}
+ X
+ Xand
+ X
+ X\begin{mstext}
+ X ".SH"
+ X unnumbered section heading
+ X\end{mstext}
+ X
+ Xcorrespond to the \latex/ commands
+ X
+ X\begin{latextext}
+ X "\section{"numbered section heading
+ X \> may be several lines"}"
+ X\end{latextext}
+ X
+ X and
+ X
+ X\begin{latextext}
+ X "\section*{"section heading"}"
+ X\end{latextext}
+ X
+ XInstead of specifying depth of level number for sub-sections, as is do
+ne
+ Xwith the \ms/ macros, \latex/ provides specific "\subsection",
+ X"\subsubsection", "\paragraph" and "\subsubparagraph"
+ Xcommands.\footnote{Documents written in the "report" document style ma
+y also
+ Xbe divided into "chapter"s and "part"s.}
+ X
+ X\section{Paragraphs}
+ X
+ X\subsection{Standard and Left-Block Paragraphs}
+ X
+ XThe \ms/ macros provide two paragraphing macros. The ".PP" macro
+ Xintroduces indented paragraphs. The ".LP" introduces unindented
+ Xones. They both leave space between paragraphs. One, or more blank
+ Xlines, or the beginning of a section normally introduce a new paragrap
+h
+ Xwith \latex/. The default behaviour is to have the first paragraph of
+ Xeach section unindented, to indent all other paragraphs and to leave n
+o
+ Xgap between paragraphs.
+ X
+ X\subsection{Indented Paragraphs}
+ X
+ XThe \ms/ macros provide a fairly crude basis for producing indented or
+ Xhanging paragraphs in the form of the ".IP" macro. \latex/
+ Xprovides a number of different environments which accomplish the same
+ Xtask.
+ X
+ X\subsubsection{Numbered Paragraphs}
+ X
+ XThese are produced by giving a number argument to the ".IP" macro, as
+in the
+ Xfollowing example:
+ X
+ X\begin{mstext}
+ X ".IP 1."
+ X Text for first paragraph, typed
+ X normally for as long as you would
+ X like on as many lines as needed.
+ X ".IP 2."
+ X Text for second paragraph, \ldots
+ X\end{mstext}
+ X
+ XA similar result can be achieved using the enumerate environment of \l
+atex/:
+ X
+ X\begin{latextext}
+ X "\begin{enumerate}"
+ X \> "\item" \> Text for first paragraph, typed
+ X \> \> normally for as long as you would
+ X \> \> like on as many lines as needed.
+ X
+ X \> "\item" \> Text for second paragraph, \ldots
+ X "\end{enumerate}"
+ X\end{latextext}
+ X
+ X\subsubsection{Bulleted Paragraphs}
+ X
+ XBulleted paragraphs, produced using the \ms/ macro call
+ X
+ X\begin{mstext}
+ X ".IP \(bu"
+ X Text \ldots
+ X\end{mstext}
+ X
+ Xcan be produced in \latex/ by the sequence
+ X
+ X\begin{latextext}
+ X "\begin{itemize}"
+ X \> "\item" Text \ldots
+ X "\end{itemize}"
+ X\end{latextext}
+ X
+ X\subsubsection{Labelled Paragraphs}
+ X
+ XLabelled paragraphs are produced by the \ms/ macro call ".IP".
+ XFor example,
+ X
+ X\begin{mstext}
+ X ".IP first: 9"
+ X Notice the longer label, requiring larger
+ X indenting for these paragraphs.
+ X ".IP second:"
+ X And so forth.
+ X\end{mstext}
+ X
+ Xwill produce something like
+ X
+ X\begin{quote}
+ X\begin{description}
+ X \item[\rm first: 9] \mbox{}
+ X
+ X Notice the longer label, requiring larger
+ X indenting for these paragraphs.
+ X
+ X \item[\rm second:] \mbox{}
+ X
+ X And so forth.
+ X
+ X\end{description}
+ X\end{quote}
+ X
+ XThese are produced in \latex/ use of the "description" environment, wi
+th a
+ Xslightly different appearance:
+ X
+ X\begin{latextext}
+ X "\begin{description}"
+ X \> "\item[first: 9]" \> Notice the longer label, requir
+ing
+ X \> \> larger indenting for these paragraphs.
+ X \> \> Note the different paragraph shape
+ X \> \> and the embolding of the labels with
+ X \> \> \latex/.
+ X \> "\item[second:]" \> And so forth.
+ X "\end{description}"
+ X\end{latextext}
+ X
+ Xproduces
+ X\begin{quote}
+ X\begin{description}
+ X \item[first: 9]
+ X Notice the longer label, requiring larger
+ X indenting for these paragraphs. Note the
+ X different paragraph shape and the embolding
+ X of the labels with \latex/.
+ X \item[second:]
+ X And so forth.
+ X\end{description}
+ X\end{quote}
+ X
+ X\subsubsection{Nested Indented Paragraphs}
+ X
+ XNested indentation is provided by the ".RS" and ".RE" pair of \ms/
+ Xmacros. List environments may be nested freely with \latex/, resulting
+ in correct
+ Xindentation. Also, paragraphs without a leading "\item" will be indent
+ed
+ Xunderneath the most recent paragraph to have a leading "\item".
+ X
+ X
+ X\subsection{Quoted Paragraphs}
+ X
+ XThe direct counterpart of the ".QP" \ms/ macro is the "quote" environm
+ent.
+ XThe direct counterpart of the ".QS" and ".QE" pair of
+ X\ms/ macros is the "quotation" environment.
+ X
+ X\section{Footnotes}
+ X
+ XThe \ms/ macros provide the ".FS" and ".FE" macros pair for collecting
+ Xfootnotes. \latex/ provides the "\footnote" command,\footnote{Like thi
+s}.
+ XThat footnote was produced by writing
+ X
+ X\begin{latextext}
+ X\ldots command."\footnote{"Like this"}" That footnote \ldots
+ X\end{latextext}
+ X
+ X\section{Fonts}
+ X
+ X\subsection{Style}
+ X
+ XThe \ms/ macros allow font styles to be changed by use of one of the f
+ollowing
+ Xcommands:
+ X
+ X\begin{mstext}
+ X".R" {\rm Roman}
+ X".I" {\it Italic}
+ X".B" {\bf Bold}
+ X\end{mstext}
+ X
+ XFor example,
+ X
+ X\begin{mstext}
+ XThis text becomes
+ X".B" {\bf bolder}
+ Xand back again.
+ X\end{mstext}
+ X
+ Xor
+ X
+ X\begin{mstext}
+ XThis text becomes
+ X".B"
+ X{\bf bolder}
+ X".R"
+ Xand back again.
+ X\end{mstext}
+ X
+ Xproduces the word ``bolder'' in the bold font.
+ X
+ X\latex/ has a similar set of commands whose extent is limited by braci
+ng:
+ X
+ X\begin{quote}
+ X\begin{tabular}{ll}
+ X"\rm" & {\rm Roman} \\
+ X"\it" & {\it Italic} \\
+ X"\bf" & {\bf Bold} \\
+ X"\sl" & {\sl Slanted} \\
+ X"\sc" & {\sc Small Capitals} \\
+ X"\sf" & {\sf Sans Serif} \\
+ X"\tt" & {\tt Typewriter}
+ X\end{tabular}
+ X\end{quote}
+ X
+ XThe above example would be written
+ X
+ X\begin{latextext}
+ XThis text becomes "{\bf "{\bf bolder}"}" and back again.
+ X\end{latextext}
+ X
+ X\subsection{Size}
+ X
+ XThe \ms/ macros allow font sizes to be changed by use of one of the fo
+llowing
+ Xcommands:
+ X
+ X\begin{mstext}
+ X".SM" {\small smaller}
+ X".NL" {\normalsize normal size}
+ X".LG" {\large larger}
+ X\end{mstext}
+ X
+ XFor example,
+ X
+ X\begin{mstext}
+ XThis text becomes
+ X".LG"
+ X{\large larger}
+ X".SM"
+ Xand back again.
+ X\end{mstext}
+ X
+ XThe ".SM" an ".LG" macros may be repeated for greater effect.
+ X
+ X\latex/ has a similar set of commands whose extent is limited by braci
+ng.
+ X
+ X\begin{quote}
+ X\begin{tabular}{ll}
+ X"\tiny" & {\tiny tiny} \\
+ X"\scriptsize" & {\scriptsize scriptsize} \\
+ X"\footnotesize" & {\footnotesize footnotesize} \\
+ X"\small" & {\small small} \\
+ X"\normalsize" & {\normalsize normal size} \\
+ X"\large" & {\large large} \\
+ X"\Large" & {\Large Large} \\[\smallskipamount]
+ X"\LARGE" & {\LARGE LARGE} \\[\smallskipamount]
+ X"\huge" & {\huge huge} \\[\smallskipamount]
+ X"\Huge" & {\Huge Huge}
+ X\end{tabular}
+ X\end{quote}
+ X
+ XThe above example would be written
+ X
+ X\begin{latextext}
+ XThis text becomes "{\large "{\large larger}"}" and back again.
+ X\end{latextext}
+ X
+ XNotice that with \latex/ the sizes are absolutely specified and not
+ Xrelatively specified, as with \troff/.
+ X
+ X\cleardoublepage
+ X
+ X\appendix
+ X
+ X\section{Summary}
+ X
+ XThis Appendix provides a quick guide to the correspondences between th
+e \ms/
+ Xmacros (and some raw \troff/ commands) and \latex/ macros. Note that t
+he output
+ Xmay not have an identical appearance in all cases.
+ X
+ X\newenvironment{stack}{\begin{tabular}{l}}{\end{tabular}}
+ X\newcommand{\eoe}{\\[\bigskipamount]}
+ X
+ X\begin{em}
+ X\begin{tabular}{|p{0.2\textwidth}|l|l|}
+ X\hline
+ X\bf Purpose & \bf \ms/ macro call & \bf \latex/ equivalent
+\eoe
+ X\hline \hline
+ X\rm Date & ".ND" date & "\date{"date\/"}" \eoe
+ X\hline
+ X\rm Cover Page & ".RP" & "\titlepage" \eoe
+ X\hline
+ X\rm Author & \begin{stack}
+ X ".AU" \\
+ X author
+ X \end{stack} & "\author{"author\/"}" \
+eoe
+ X\hline
+ X\rm Affiliation & \begin{stack}
+ X ".AI" \\
+ X Institution
+ X \end{stack} & "\thanks{"Institution\/
+"}" \eoe
+ X\hline
+ X\rm Abstract & \begin{stack}
+ X ".AB" \\
+ X \ldots{} abstract \ldots \\
+ X ".AE"
+ X \end{stack} & \begin{stack}
+ X "\begin{abstract}" \\
+ X \ldots{} abstract \ldot
+s \\
+ X "\end{abstract}"
+ X \end{stack} \eoe
+ X\hline
+ X\rm Multi-column formats
+ X & ".2C" & "\twocolumn" \eoe
+ X & ".1C" & "\onecolumn" \eoe
+ X\hline
+ X\rm Section Headings & \begin{stack}
+ X ".SH" \\
+ X heading
+ X \end{stack} & "\section*{"heading\/"}
+" \eoe
+ X & \begin{stack}
+ X ".NH" \\
+ X heading
+ X \end{stack} & "\section{"heading\/"}"
+ \eoe
+ X & \begin{stack}
+ X ".NH 2" \\
+ X heading
+ X \end{stack} & "\subsection{"heading\/
+"}" \eoe
+ X & \begin{stack}
+ X ".NH 3" \\
+ X heading
+ X \end{stack} & "\subsubsection{"headin
+g\/"}" \eoe
+ X & \begin{stack}
+ X ".NH 4" \\
+ X heading
+ X \end{stack} & "\paragraph{"heading\/"
+}" \eoe
+ X & \begin{stack}
+ X ".NH 5" \\
+ X heading
+ X \end{stack} & "\subparagraph{"heading
+\/"}" \eoe
+ X\hline
+ X\end{tabular}
+ X
+ X\begin{tabular}{|p{0.2\textwidth}|l|l|}
+ X\hline
+ X\bf Purpose & \bf \ms/ macro call & \bf \latex/ equivalent
+ \eoe
+ X\hline \hline
+ X\rm Standard and Left-Block paragraphs
+ X & ".LP", ".PP" & one, or more blank line
+s \eoe
+ X\hline
+ X\rm Numbered paragraphs
+ X & \begin{stack}
+ X ".IP" n. \\
+ X Text \ldots \\
+ X \vdots
+ X \end{stack} & \begin{stack}
+ X "\begin{enumerate}" \\
+ X "\item" Text \ldots \\
+ X \vdots \\
+ X "\end{enumerate}"
+ X \end{stack} \eoe
+ X\hline
+ X\rm Bulleted paragraphs
+ X & \begin{stack}
+ X ".IP \(bu" \\
+ X Text \ldots \\
+ X \vdots
+ X \end{stack} & \begin{stack}
+ X "\begin{itemize}" \\
+ X "\item" Text \ldots \\
+ X \vdots \\
+ X "\end{itemize}"
+ X \end{stack} \eoe
+ X\hline
+ X\rm Labelled paragraphs
+ X & \begin{stack}
+ X ".IP" label \\
+ X Text \ldots \\
+ X \vdots
+ X \end{stack} & \begin{stack}
+ X "\begin{description}" \
+\
+ X "\item["label\/"]" Text
+ \ldots \\
+ X \vdots \\
+ X "\end{description}"
+ X \end{stack} \eoe
+ X\hline
+ X\rm Quoted paragraphs
+ X & \begin{stack}
+ X ".QP" \\
+ X Text \ldots \\
+ X \end{stack} & \begin{stack}
+ X "\begin{quote}" \\
+ X Text \ldots \\
+ X "\end{quote}"
+ X \end{stack} \eoe
+ X & \begin{stack}
+ X ".QS" \\
+ X Text \ldots \\
+ X ".QE"
+ X \end{stack} & \begin{stack}
+ X "\begin{quotation}" \\
+ X Text \ldots \\
+ X \vdots \\
+ X "\end{quotation}"
+ X \end{stack} \eoe
+ X\hline
+ X\rm Footnotes & \begin{stack}
+ X ".FS" \\
+ X Text \ldots \\
+ X ".FE"
+ X \end{stack} & "\footnote{"Text \ldots
+ "}" \eoe
+ X\hline
+ X\end{tabular}
+ X
+ X\begin{tabular}{|p{0.2\textwidth}|l|l|}
+ X\hline
+ X\bf Purpose & \bf \ms/ macro call & \bf \latex/ equivalent
+\eoe
+ X\hline \hline
+ X\rm Font Styles & \begin{stack}
+ X ".R" {\rm Roman} \\
+ X ".I" {\it Italic} \\
+ X ".B" {\bf Bold}
+ X \end{stack} &
+ X \begin{stack}
+ X "{\rm" {\rm Roman}"}" \
+\
+ X "{\it" {\it Italic\/}"}
+" \\
+ X "{\bf" {\bf Bold}"}" \\
+ X "{\sl" {\sl Slanted\/}"
+}" \\
+ X "{\sc" {\sc Small Capit
+als}"}" \\
+ X "{\sf" {\sf Sans Serif}
+"}" \\
+ X "{\tt" {\tt Typewriter}
+"}"
+ X \end{stack} \eoe
+ X\hline
+ X\rm Font Sizes &
+ X \begin{stack}
+ X ".SM" {\small smaller} \\
+ X ".NL" {\normalsize normal size} \\
+ X ".LG" {\large larger}
+ X \end{stack} &
+ X \begin{stack}
+ X "{\tiny" {\tiny tiny}"}" \\
+ X "{\scriptsize" {\scriptsize scriptsize}
+"}" \\
+ X "{\footnotesize" {\footnotesize footnot
+esize}"}" \\
+ X "{\small" {\small small}"}" \\
+ X "{\normalsize" {\normalsize normal size
+}"}" \\
+ X "{\large" {\large large}"}" \\
+ X "{\Large" {\Large Large}"}" \\[\smallsk
+ipamount]
+ X "{\LARGE" {\LARGE LARGE}"}" \\[\smallsk
+ipamount]
+ X "{\huge" {\huge huge}"}" \\[\smallskipa
+mount]
+ X "{\Huge" {\Huge Huge}"}"
+ X \end{stack} \eoe
+ X\hline
+ X\end{tabular}
+ X\end{em}
+ X
+ X\bibliographystyle{alpha}
+ X\bibliography{refs}
+ X
+ X\end{document}
+SHAR_EOF
+if test 17397 -ne "`wc -c < 'ms-latex.tex'`"
+then
+ echo shar: "error transmitting 'ms-latex.tex'" '(should have been 17397
+ characters)'
+fi
+fi
+echo shar: "extracting 'sfwmac.sty'" '(1626 characters)'
+if test -f 'sfwmac.sty'
+then
+ echo shar: "will not over-write existing file 'sfwmac.sty'"
+else
+sed 's/^ X//' << \SHAR_EOF > 'sfwmac.sty'
+ X% LaTeX support for writing UNIX-style documentation
+ X
+ X
+ X% UNIX-style references
+ X
+ X\def\sfwFILfont{\sl}
+ X
+ X\def\@egaux#1#2#3{%
+ X \def#1##1{%
+ X #2\begingroup \tt \let\do=\@makeother \dospecials
+ X \def\@tempa####1##1{####1\endgroup#3}\@tempa
+ X }%
+ X}
+ X
+ X\def\pgm#1{\mbox{\it#1}\index{#1}} % programs
+ X\def\xpgm#1#2{\mbox{\it#1}\index{\noexpand\noexpand\noexpand#2{}}}
+ X\def\man#1(#2){\xpgm{#1\/}{#1}(#2)} % manual entries
+ X\@egaux\arg{`{}}{'{}} % arguments to programs
+ X\@egaux\switch{`{}-}{'{}} % switches to programs
+ X\def\file#1{\mbox{\sfwFILfont#1}} % filename
+ X
+ X
+ X% Commonly used software systems
+ X
+ X\def\sfwPGMfont{\tt}
+ X
+ X\def\@sfwdef#1#2{\@sfwaux{#1/}{#2}}
+ X\def\@sfwaux#1#2{\def#1{\mbox{#2}\index{\noexpand\noexpand\noexpand#1{
+}}}}
+ X
+ X\@sfwdef\EMACS{\sfwPGMfont EMACS}
+ X\@sfwdef\INFO{\sfwPGMfont INFO}
+ X\@sfwdef\MLisp{\sfwPGMfont MLisp}
+ X
+ X\@sfwdef\SendMail{\sfwPGMfont SendMail}
+ X\@sfwdef\UUCP{\sfwPGMfont UUCP}
+ X
+ X\def\AmS{$\cal A$\kern-.1667em\lower.5ex\hbox{$\cal M$}\kern-.125em$\c
+al S$}
+ X\@sfwaux\AmSTeX{\rm \AmS-\TeX}
+ X
+ X\@sfwaux\PhDTeX{\rm P\kern-.05em{\sc h\kern-.025em D}\kern-0.08em\TeX}
+ X
+ X\@sfwaux\LaTeX{\rm L\kern-.36em\raise.3ex\hbox{\sc a}\kern-.15em\TeX}
+ X\@sfwaux\BibTeX{\rm B\kern-.05em{\sc i\kern-.025em b}\kern-.08em\TeX}
+ X\@sfwaux\SLiTeX{\rm S\kern-.06em{\sc l\kern-.035emi}\kern-.06em\TeX}
+ X
+ X
+ X\@sfwdef\WEB{\sfwPGMfont WEB}
+ X
+ X\@sfwdef\Prolog{\sfwPGMfont Prolog}
+ X\@sfwdef\Lisp{\sfwPGMfont Lisp}
+ X
+ X\@sfwdef\DBUG{\sfwPGMfont DBUG}
+ X
+ X\@sfwdef\troff{\sfwPGMfont troff}
+ X\@sfwdef\nroff{\sfwPGMfont nroff}
+ X\@sfwdef\Miranda{\sfwPGMfont Miranda}
+ X\@sfwdef\AiM{\sfwPGMfont AiM}
+ X\@sfwdef\ASN{\sfwPGMfont ASN.1}
+ X\@sfwdef\ISODE{\sfwPGMfont ISODE}
+ X
+SHAR_EOF
+if test 1626 -ne "`wc -c < 'sfwmac.sty'`"
+then
+ echo shar: "error transmitting 'sfwmac.sty'" '(should have been 1626 ch
+aracters)'
+fi
+fi
+exit 0
+: End of shell archive
+
+------- Message 2
+
+Date: Wed, 08 Apr 87 06:46:43 -0400
+Subject: Returned mail: Host unknown
+From: Mail Delivery Subsystem <Postmaster@seismo.uucp>
+To: jrp@psg.npl.co.uk
+
+ ----- Transcript of session follows -----
+550 su-score.arpa!texhax... Host unknown
+
+ ----- Unsent message follows -----
+Received: from mcvax.UUCP by seismo.CSS.GOV (5.54/1.14) with UUCP
+ id AA02312; Wed, 8 Apr 87 06:46:43 EDT
+Received: by mcvax.cwi.nl; Wed, 8 Apr 87 03:53:02 +0200 (MET)
+Received: from nplpsg.uucp by kestrel.Ukc.AC.UK with UUCP id aa05412;
+ 8 Apr 87 0:10 BST
+Received: from snow by snow.psg.npl.co.uk; Tue, 7 Apr 87 23:48:58 BST
+To: texhax@su-score.arpa
+Subject: LaTeX for the troff -ms Macros User
+Return-Receipt-To: mcvax!psg.npl.co.uk!jrp
+Date: Tue, 07 Apr 87 22:48:57 GMT
+Message-Id: <6189.544834137@psg.npl.co.uk>
+From: John Pavel <mcvax!nplpsg!jrp>
+
+
+Here is a textual version of the first cut on a paper that should
+help anyone trying to convert from the -ms macros to LaTeX.
+
+I would welcome any contributions to completing/correcting this paper.
+
+Thanks,
+
+John Pavel
+
+- --snip----snip----snip----snip----snip----snip----snip----snip--
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ LaTEX for the troff -ms Macros User
+
+
+ John Pavel
+ National Physical Laboratory
+ Teddington, UK
+
+
+ jrp@nplpsg.UUCP
+
+ 87/04/07 at 23:37:25
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ Abstract
+
+ This document is intended to serve as a brief
+ reference to aTEX for those who are familiar
+ with troff and -ms macros. This version is a
+ draft for comment.
+
+
+
+
+
+
+ Contents
+
+ 1Introduction 2
+
+ 2Getting Started with LaTX 2
+ 3Document Structure 3
+
+ 4Page Headings 4
+
+ 5Multi-column Formats 5
+ 6Section Headings 5
+
+ 7Paragraphs 6
+ 7.1Standard and Left-Block Paragraphs :::::: 6
+ 7.2Indented Paragraphs :::::::::: :::::::::: 7
+ 7.2Numbered Paragraphs ::::::: :::::::::: 7
+ 7.2Bulleted Paragraphs ::::::: :::::::::: 7
+ 7.2Labelled Paragraphs ::::::: :::::::::: 8
+ 7.2Nested Indented Paragraphs: :::::::::: 9
+ 7.3Quoted Paragraphs :::::::::::: :::::::::: 9
+ 8Footnotes 9
+
+ 9Fonts 9
+ 9.1Style :::::::::: ::::::::::::: :::::::::: 9
+ 9.2Size ::::::::::: ::::::::::::: :::::::::: 10
+
+ ASummary 12
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+ 1
+
+
+
+
+
+
+ 1 Introduction
+
+ This document is intended to serve as a quick
+ reference to those converting from troff with
+ the -ms macros [Les76] to aTEX [Lam86]. The
+ reader is assumed to have a working knowledge
+ of the -ms macros. Furthermore, the reader
+ must have read at least Chapter 2 of the LaTX
+
+ manual[Lam86]. That chapter covers the basics
+ of aTEX.
+ The default behaviour of LaTEX is described.
+ With a certain amount of configuring, LaTX
+ output.indSuch configuring ais,showever,tbeyond
+ the scope of this document. Similarly, LaTX
+ has many features which are not described.
+ These include
+
+ ?diagram production;
+
+ ?mathematical typesetting;
+
+ ?the typesetting of program sources;
+ ?automatic cross-referencing and index pro-
+ duction;
+
+ ?the layout of tables;
+
+ The LTEX[Lam86] and TEX[Knu86] manuals should
+ be consulted for the full story.
+
+
+ 2 Getting Started with aTEX
+
+ To run aTEX on a file called either file or,
+ more conventionally, file.tex, type
+
+ % latex file
+
+ By default, the file will be taken from
+ either your current directory, or, if no
+ such file appears there, the directory
+ /usr/lib/tex/macros will be searched.
+
+
+ 2
+
+
+
+
+
+
+ Running LaTEX produces a DVI file (file.dvi
+ for the above example). You can send this to
+ the Imagen by using iptex(l):
+
+ % iptex file
+
+ Alternatively, you may like to preview it on
+ the Sun screen by using texview(l):
+
+ % texview file
+ The LaTX Manual[Lam86] will refer you to a
+ Local Guide. This guide can be found in the
+
+ file /usr/lib/tex/macros/local.tex, and so can
+ be printed out by
+ % latex local
+ % latex local
+ % iptex local
+
+ No, that is not a mis-print. You will need
+ to run LaTX twice. It needs to make two
+ passes to establish all the cross-references.
+ Normally, you will do this only for a final
+ copy. You may now get rid of all the temporary
+ files that aTEX creates with
+
+ % texclean
+ Two other files that you might like to look
+
+ at in the /usr/lib/tex/macros directory are
+ small.tex and sample.tex.
+
+
+ 3 Document Structure
+
+ The -ms macros assume a document structure of
+ the following form:
+
+ [optional date specification: .ND a date]
+ [optional overall format: .RP---see below]
+ .TL
+ Title of document (one or more lines)
+ .AU
+ Author(s) (may also be several lines)
+
+ 3
+
+
+
+
+
+
+ .AI
+ Author's institution(s)
+ .AB
+ Abstract; to be placed on the cover sheet of a paper.
+ .AE (abstract end)
+ text .
+
+
+ A aTEX document has an analogous structure:
+
+ \documentstyle[aSpecifiesethe document style.
+ a4 is for A4 paper
+
+ \title{Title of document (each line of title separated by \\)}
+ \author{Author(s) (each author separated by \and)}
+ \date{a date}
+
+ \begin{documenEnd of preamble and beginning of text.
+
+ \maketitle Produces the title.
+ \tableofcProduces the table of contents.
+
+ \begin{abstract}
+ Abstract; to be placed under the title
+ \end{abstract}
+
+ body of text .
+
+ \end{document}
+
+
+ If a separate title page and abstract page
+ are preferred, the titlepage style option
+ should be used:
+
+ \documentstyle[titlepage,a4]{article}
+ .
+
+
+
+ 4 Page Headings
+
+ The -ms macros allow headings and footings to
+ be set by means of string definitions:
+
+ 4
+
+
+
+
+
+
+ .dsLH left header
+ .dsCH center header
+ .dsRH right header
+ .dsLF left footer
+ .dsCF center footer
+ .dsRF right footer
+
+
+ The scheme in LaTX is slightly different;
+ there are four page styles: plain (the
+ default), empty, headings and myheadings.
+ These are activated by a
+
+ \pagestyle{style}
+
+ command. To set your own headings, the
+ commands \markboth (for two-sided documents)
+ and \markright (for one-sided documents) are
+ required in addition:
+
+ \markright{heading} or \markboth{left head}{right head}
+ \pagestyle{myheadings}
+
+
+
+ 5 Multi-column Formats
+
+ The .2C and .1C -ms macros permit changing
+ to two-column and single-column format. The
+ analagous aTEX commands are \twocolumn and
+
+ \onecolumn. Like their -ms counterparts, they
+ also skip to a new page. If a complete
+ document is to be produced in two-column
+ format, the twocolumn style option should
+ be used, since that alters various style
+ parameters, such as the amount of paragraph
+ indentation, while the \twocolumn command does
+ not.
+
+
+ 6 Section Headings
+
+ The -ms macros
+
+ 5
+
+
+
+
+
+
+ .NH
+ numbered section heading
+ may be several lines
+
+
+ and
+ .SH
+ unnumbered section heading
+
+
+ correspond to the aTEX commands
+ \section{numbered section heading
+ may be several lines}
+
+
+ and
+
+ \section*{section heading}
+
+ Instead of specifying depth of level number
+ for sub-sections, as is done with the -ms
+ macros, LaTX provides specific \subsection,
+ \subsubsection, \paragraph and \subsubparagraph
+ commands.1
+
+
+ 7 Paragraphs
+
+
+ 7.1 Standard and Left-Block Paragraphs
+ The -ms macros provide two paragraphing macros.
+ The .PP macro introduces indented paragraphs.
+ The .LP introduces unindented ones. They
+ both leave space between paragraphs. One,
+ or more blank lines, or the beginning of a
+ section normally introduce a new paragraph with
+ aTEX. The default behaviour is to have the
+ first paragraph of each section unindented, to
+ indent all other paragraphs and to leave no gap
+ between paragraphs.
+ --------------------
+ 1Documents written in the report document
+ style may also be divided into chapters and
+ parts.
+
+ 6
+
+
+
+
+
+
+ 7.2 Indented Paragraphs
+
+ The -ms macros provide a fairly crude basis for
+ producing indented or hanging paragraphs in the
+ form of the .IP macro. aTEX provides a number
+ of different environments which accomplish the
+ same task.
+
+ 7.2.1 Numbered Paragraphs
+
+ These are produced by giving a number argument
+ to the .IP macro, as in the following example:
+
+ .IP1.
+ Text for first paragraph, typed
+ normally for as long as you would
+ like on as many lines as needed.
+ .IP2.
+ Text for second paragraph, .
+
+
+ A similar result can be achieved using the
+ enumerate environment of aTEX:
+
+ \begin{enumerate}
+ \item Text for first paragraph, typed
+ normally for as long as you would
+ like on as many lines as needed.
+
+ \item Text for second paragraph, .
+ \end{enumerate}
+
+
+
+ 7.2.2 Bulleted Paragraphs
+ Bulleted paragraphs, produced using the -ms
+ macro call
+
+ .IP\(bu
+ Text .
+
+
+ can be produced in aTEX by the sequence
+
+
+ 7
+
+
+
+
+
+
+ \begin{itemize}
+ \item Text .
+ \end{itemize}
+
+
+
+ 7.2.3 Labelled Paragraphs
+
+ Labelled paragraphs are produced by the -ms
+ macro call .IP. For example,
+
+ .IPfirst:9
+ Notice the longer label, requiring larger
+ indenting for these paragraphs.
+ .IPsecond:
+ And so forth.
+
+ will produce something like
+
+ first: 9
+ Notice the longer label, requiring
+ larger indenting for these para-
+ graphs.
+
+ second:
+ And so forth.
+
+ These are produced in aTEX use of the
+ description environment, with a slightly
+ different appearance:
+
+ \begin{description}
+ \item[firNotice the longer label, requiring
+ larger indenting for these paragraphs.
+ Note the different paragraph shape
+ and the embolding of the labels with
+ aTEX.
+ \item[secAnd:so forth.
+ \end{description}
+
+
+ produces
+
+
+
+ 8
+
+
+
+
+
+
+ first: 9 Notice the longer label, re-
+ quiring larger indenting for these
+ paragraphs. Note the different
+ paragraph shape and the embolding of
+ the labels with LaTX.
+ second: And so forth.
+
+
+ 7.2.4 Nested Indented Paragraphs
+
+ Nested indentation is provided by the .RS and
+ .RE pair of -ms macros. List environments
+ may be nested freely with LaTX, resulting in
+ correct indentation. Also, paragraphs without
+ a leading \item will be indented underneath the
+ most recent paragraph to have a leading \item.
+
+
+ 7.3 Quoted Paragraphs
+ The direct counterpart of the .QP -ms macro is
+ the quote environment. The direct counterpart
+ of the .QS and .QE pair of -ms macros is the
+ quotation environment.
+
+
+ 8 Footnotes
+
+
+ The -ms macros provide the .FS and .FE macros
+ pair for collecting footnotes. LTEX provides
+ the \footnote command,2. That footnote was
+ produced by writing
+ . command.\footnote{Like this} That footnote .
+
+
+
+ 9 Fonts
+
+
+ 9.1 Style
+ The -ms macros allow font styles to be changed
+ by use of one of the following commands:
+ --------------------
+ 2Like this
+
+ 9
+
+
+
+
+
+
+ .R Roman
+ .I Italic
+ .B Bold
+
+
+ For example,
+
+ This text becomes
+ .B bolder
+ and back again.
+
+
+ or
+
+ This text becomes
+ .B
+ bolder
+ .R
+ and back again.
+
+ produces the word "bolder" in the bold font.
+ aTEX has a similar set of commands whose
+ extent is limited by bracing:
+
+ \rm Roman
+ \it Italic
+
+ \bf Bold
+ \sl Slanted
+ \sc Small Capitals
+ \sf Sans Serif
+ \tt Typewriter
+
+ The above example would be written
+
+ This text becomes {\bf bolder} and back again.
+
+
+ 9.2 Size
+
+ The -ms macros allow font sizes to be changed
+ by use of one of the following commands:
+
+
+
+ 10
+
+
+
+
+
+
+ .SM smaller
+ .NL normal size
+ .LG larger
+
+
+ For example,
+
+ This text becomes
+ .LG
+ larger
+ .SM
+ and back again.
+
+
+ The .SM an .LG macros may be repeated for
+ greater effect.
+ aTEX has a similar set of commands whose
+ extent is limited by bracing.
+
+ \tiny tiny
+ \scriptsize scriptsize
+ \footnotesize footnotesize
+ \small small
+ \normalsize normal size
+ \large large
+ \Large Large
+
+ \LARGE LARGE
+ \huge huge
+ \Huge Huge
+
+ The above example would be written
+
+ This text becomes {\large larger} and back again.
+
+
+ Notice that with aTEX the sizes are abso-
+ lutely specified and not relatively specified,
+ as with troff.
+
+
+
+
+
+
+ 11
+
+
+
+
+
+
+ A Summary
+
+ This Appendix provides a quick guide to the
+ correspondences between the -ms macros (and
+
+ some raw troff commands) and LaTX macros. Note
+ that the output may not have an identical
+ ap-----------------------------------------------------
+ -Purpose --ms macro call -aTEX equivalent -
+ ------------------------------------------------------
+ -Date -.ND date -\date{date} -
+ ------------------------------------------------------
+ -Cover -.RP -\titlepage -
+ -Page - - -
+ -------------.AU--------------------------------------
+ -Author - author -\author{author} -
+ -------------.AI--------------------------------------
+ -Affiliatio- -\thanks{Institution} -
+ - - Institution - -
+ -------------.AB--------------\begin{abstract}--------
+ -Abstract - . abstract . - . abstract . -
+ - - .AE - -
+ ------------------------------------------------------
+ -Multi- -.2C -\twocolumn -
+ -column - - -
+ -formats - - -
+ - -.1C -\onecolumn -
+ -------------.SH--------------------------------------
+ -Section - -\section*{heading} -
+ -Headings - heading - -
+ - - .NH - -
+ - - -\section{heading} -
+ - - heading - -
+ - - .NH2 - -
+ - - heading -\subsection{heading} -
+ - - .NH3 - -
+ - - -\subsubsection{heading} -
+ - - heading - -
+ - - .NH4 - -
+ - - heading -\paragraph{heading} -
+ - - .NH5 - -
+ - - -\subparagraph{heading} -
+ ------------------------------------------------------
+
+
+ 12
+
+
+
+
+
+ -----------------------------------------------------
+ -Purpose --ms macro call LaTEX equivalent -
+ -----------------------------------------------------
+ -Standard -.LP, .PP one, or more blank lines -
+ -and Left- - - -
+ -Block - - -
+ -para- - - -
+ -graphs - - -
+ -----------------------------------------------------
+ - - .IP n. -\begin{enumerate} -
+ -Numbered - Text . -.item Text . -
+ -para- - . - -
+ -graphs - -\end{enumerate} -
+ -----------------------------------------------------
+ - - .IP\(bu -\begin{itemize} -
+ - - Text . -\item Text . -
+ -Bulleted - . -. -
+ -para- - - -
+ -----------------------------------------------------
+ - - -\begin{description} -
+ - - .IP label -\item[label] Text . -
+ -Labelled - .ext . -. -
+ -para- - - -
+ -----------------------------------------------------
+ - - .QP -\begin{quote} -
+ -Quoted - -Text . -
+ -para- - Text . -\end{quote} -
+ -graphs - - -
+ - - - -
+ - - .QS -\begin{quotation} -
+ - - Text . -.ext . -
+ - - .QE - -
+ - - -\end{quotation} -
+ -------------.FS-------------------------------------
+ -Footnotes - Text . \footnote{Text . } -
+ - - .FE - -
+ -----------------------------------------------------
+
+
+
+
+
+
+
+
+
+ 13
+
+
+
+
+
+ -------------------------------------------------------------
+ -Purpose --ms macro call -LaTX equivalent -
+ --------------------------------------------------------------
+ - - - {\rm Roman} -
+ - - - {\it Italic} -
+ - - - -
+ - - .R Roman - {\bf Bold} -
+ -Font - .I Italic - {\sl Slanted} -
+ -Styles - .B Bold - {\sc Small Capitals} -
+ - - - {\sf Sans Serif} -
+ --------------------------------------------------------------
+ - - - {\tiny tiny} -
+ - - - {\scriptsize scriptsize} -
+ - - - {\footnotesize footnotesize} -
+ - - - {\small small} -
+ - - .SM smaller - {\normalsize normal size} -
+ -Font - .NL normal size - -
+ -Sizes - .LG larger - {\large large} -
+ - - - {\Large Large} -
+ - - - {\LARGE LARGE} -
+ - - - {\huge huge} -
+ - - - -
+ --------------------------------------------------------------
+
+
+ References
+
+ [Knu86]Donald E. Knuth. The TEXbook. Volume A
+ of Computers and Typesetting Series,
+ Addison-Wesley, 1986.
+
+ [Lam86]Leslie Lamport. LaTEX: A Document
+ Preparation System. Addison-Wesley,
+ 1986.
+
+ [Les76]Mike E. Lesk. Using the -ms Macros with
+ troff and nroff. October 8 1976.
+
+
+
+
+
+
+
+
+
+ 14
+
+
+------- End of Forwarded Messages
+
+20-Apr-87 02:52:07-PDT,21714;000000000000
+Return-Path: <ken@rochester.arpa>
+To: texhax@score.stanford.edu
+Subject: John Pavel's message
+X-Uucp: ..!{allegra,decvax,seismo}!rochester!ken ARPA: ken@rochester.arpa
+X-Snail: CS Dept., U of Roch., NY 14627. Voice: Ken!
+X-Phone: (716) 275-2569 (office), (716) 244-3806 (home)
+Date: Mon, 20 Apr 87 04:54:38 -0500
+From: Ken Yap <ken@rochester.arpa>
+
+John Pavel's message seems to have been the victim of a nasty gateway
+that snips lines at column 72. I think I have put it back together OK.
+Here is a replacement shar file.
+
+ Ken
+
+#! /bin/sh
+# This is a shell archive, meaning:
+# 1. Remove everything above the #! /bin/sh line.
+# 2. Save the resulting text in a file.
+# 3. Execute the file with /bin/sh (not csh) to create:
+# ms-latex.tex
+# sfwmac.sty
+# This archive created: Mon Apr 20 04:53:57 1987
+# By: Ken Yap ()
+export PATH; PATH=/bin:/usr/bin:$PATH
+echo shar: "extracting 'ms-latex.tex'" '(17400 characters)'
+if test -f 'ms-latex.tex'
+then
+ echo shar: "will not over-write existing file 'ms-latex.tex'"
+else
+cat << \SHAR_EOF > 'ms-latex.tex'
+\documentstyle[12pt,a4,titlepage,sfwmac]{article}
+
+% Some local macros, mostly stolen from the scheme distribution
+
+% Same as \obeycr, but doesn't do a \@gobblecr.
+{\catcode`\^^M=13 \gdef\myobeycr{\catcode`\^^M=13 \def^^M{\\}}%
+\gdef\restorecr{\catcode`\^^M=5 }}
+
+{\catcode`\^^I=13 \gdef\obeytabs{\catcode`\^^I=13 \def^^I{\hbox{\hskip 4em}}}}
+
+{\makeatletter \gdef\gobblecr{\@gobblecr}}
+
+\newenvironment{mstext}%
+ {\obeyspaces \myobeycr \em
+ \begin{tabbing}%
+ \qquad\=\hspace*{5em}\=\hspace*{9em}\=\+\kill% was 16em
+ \gobblecr}%
+ {\unskip\end{tabbing}}
+
+\newenvironment{latextext}{
+\obeyspaces \myobeycr \em
+\begin{tabbing}%
+\qquad\=\hspace*{5em}\=\hspace*{9em}\=\+\kill% was 16em
+\gobblecr}{\unskip\end{tabbing}}
+
+\catcode`\"=\active
+{\makeatletter {\gdef"{\begingroup \catcode``=13
+ \@noligs \tt \let\do\@makeother \dospecials \let"=\endgroup}}}
+
+\newcommand{\latex}[1]{\LaTeX}
+\newcommand{\ms}[1]{\mbox{\tt -ms}}
+\let\endverbatim=\endtrivlist
+
+\title{\latex/ for the \troff/ \ms/ Macros User}
+\author{John Pavel \\
+National Physical Laboratory \\
+Teddington, UK\\[\bigskipamount]
+"jrp@nplpsg.UUCP"}
+
+\date{87/04/07 at 23:37:25%
+}
+
+\begin{document}
+
+ \maketitle
+
+ \begin{abstract}
+
+ This document is intended to serve as a brief reference to \latex/ for
+ those who are familiar with \troff/ and \ms/ macros. This version
+ is a draft for comment.
+
+ \end{abstract}
+
+ \tableofcontents
+
+\cleardoublepage
+
+\section{Introduction}
+
+This document is intended to serve as a quick reference to those
+converting from \troff/ with the \ms/ macros~\cite{ms} to
+\latex/~\cite{LaTeX}. The reader is assumed to have a working knowledge
+of the \ms/ macros. Furthermore, the reader {\em must\/} have read at least
+Chapter~2 of the \latex/ manual\cite{LaTeX}. That chapter covers the basics of
+\latex/.
+
+The default behaviour of \latex/ is described. With a certain amount of
+configuring, \latex/ can be induced to produce almost any style of
+output. Such configuring is, however, beyond the scope of this
+document. Similarly, \latex/ has many features which are not described.
+These include
+
+\begin{itemize}
+\item diagram production;
+\item mathematical typesetting;
+\item the typesetting of program sources;
+\item automatic cross-referencing and index production;
+\item the layout of tables;
+\end{itemize}
+
+The \latex/\cite{LaTeX} and \TeX\cite{TeX} manuals
+should be consulted for the full story.
+
+\section{Getting Started with \latex/}
+
+To run \latex/ on a file called either "file" or, more conventionally,
+"file.tex", type
+\begin{verbatim}
+ % latex file
+\end{verbatim}
+
+By default, the file will be taken from either your current
+directory, or, if no such file appears there, the directory
+"/usr/lib/tex/macros" will be searched.
+
+Running \latex/ produces a DVI file ("file.dvi" for the above example)
+.
+You can send this to the {\sf Imagen} by using \pgm{iptex}(l):
+\begin{verbatim}
+ % iptex file
+\end{verbatim}
+
+Alternatively, you may like to preview it on the {\sf Sun} screen by using
+\pgm{texview}(l):
+\begin{verbatim}
+ % texview file
+\end{verbatim}
+
+The \latex/ Manual\cite{LaTeX} will refer you to a {\sl Local Guide}.
+This guide can be found in the file "/usr/lib/tex/macros/local.tex", and
+so can be printed out by
+\begin{verbatim}
+ % latex local
+ % latex local
+ % iptex local
+\end{verbatim}
+
+No, that is not a mis-print. You will need to run \latex/ twice. It
+needs to make two passes to establish all the cross-references.
+Normally, you will do this only for a final copy.
+You may now get rid of all the temporary files that \latex/ creates with
+\begin{verbatim}
+ % texclean
+\end{verbatim}
+
+Two other files that you might like to look at in the
+"/usr/lib/tex/macros" directory are "small.tex" and "sample.tex".
+
+\section{Document Structure}
+
+The \ms/ macros assume a document structure of the following form:
+
+\begin{mstext}
+ {[optional date specification: ".ND" a date]}
+ {[optional overall format: ".RP"---see below]}
+ ".TL"
+ Title of document (one or more lines)
+ ".AU"
+ Author(s) (may also be several lines)
+ ".AI"
+ Author's institution(s)
+ ".AB"
+ Abstract; to be placed on the cover sheet of a paper.
+ ".AE" (abstract end)
+ text \ldots
+\end{mstext}
+
+A \latex/ document has an analogous structure:
+
+\begin{latextext}
+ "\documentstyle[a4]{article}" \>\> \` Specifies the document style.
+ \>\> \` {\tt a4} is for A4 paper
+
+ "\title{"Title of document %
+(each line of title separated by "\\")\/"}"
+ "\author{"Author(s) (each author separated by "\and")\/"}"
+ "\date{"a date"}"
+
+ "\begin{document}" \>\> \` End of preamble and beginning of text.
+
+ \> "\maketitle" \> \` Produces the title.
+ \> "\tableofcontents" \> \` Produces the table of contents.
+
+ \> "\begin{abstract}"
+ \> Abstract; to be placed under the title
+ \> "\end{abstract}"
+
+ \> body of text \ldots
+
+ "\end{document}"
+\end{latextext}
+
+If a separate title page and abstract page are preferred,
+the "titlepage" style option should be used:
+
+\begin{latextext}
+ "\documentstyle[titlepage,a4]{article}"
+ \> \ldots
+\end{latextext}
+
+\section{Page Headings}
+
+The \ms/ macros allow headings and footings to be set by means of string
+definitions:
+\begin{mstext}
+".ds LH" left header
+".ds CH" center header
+".ds RH" right header
+".ds LF" left footer
+".ds CF" center footer
+".ds RF" right footer
+\end{mstext}
+
+The scheme in \latex/ is slightly different;
+there are four page styles: "plain" (the default), "empty", "headings" and
+"myheadings". These are activated by a
+
+\begin{latextext}
+"\pagestyle{"style\/"}"
+\end{latextext}
+
+command. To set your own headings, the commands "\markboth" (for two-sided documents)
+and "\markright" (for one-sided documents) are required in addition:
+
+\begin{latextext}
+"\markright{"heading\/"}" or "\markboth{"left head\/"}{"right head\/"}"
+"\pagestyle{myheadings}"
+\end{latextext}
+
+\section{Multi-column Formats}
+
+\begin{sloppypar}
+The ".2C" and ".1C" \ms/ macros permit changing to
+two-column and single-column format. The analagous \latex/ commands
+are "\twocolumn" and "\onecolumn". Like their \ms/
+counterparts, they also skip to a new page. If a complete document is
+to be produced in two-column format, the "twocolumn" style option
+should be used, since that alters various style parameters, such as
+the amount of paragraph indentation, while the
+"\twocolumn" command does not.
+\end{sloppypar}
+
+\section{Section Headings}
+
+The \ms/ macros
+
+\begin{mstext}
+ ".NH"
+ numbered section heading
+ may be several lines
+\end{mstext}
+
+and
+
+\begin{mstext}
+ ".SH"
+ unnumbered section heading
+\end{mstext}
+
+correspond to the \latex/ commands
+
+\begin{latextext}
+ "\section{"numbered section heading
+ \> may be several lines"}"
+\end{latextext}
+
+ and
+
+\begin{latextext}
+ "\section*{"section heading"}"
+\end{latextext}
+
+Instead of specifying depth of level number for sub-sections, as is done
+with the \ms/ macros, \latex/ provides specific "\subsection",
+"\subsubsection", "\paragraph" and "\subsubparagraph"
+commands.\footnote{Documents written in the "report" document style may also
+be divided into "chapter"s and "part"s.}
+
+\section{Paragraphs}
+
+\subsection{Standard and Left-Block Paragraphs}
+
+The \ms/ macros provide two paragraphing macros. The ".PP" macro
+introduces indented paragraphs. The ".LP" introduces unindented
+ones. They both leave space between paragraphs. One, or more blank
+lines, or the beginning of a section normally introduce a new paragraph
+with \latex/. The default behaviour is to have the first paragraph of
+each section unindented, to indent all other paragraphs and to leave no
+gap between paragraphs.
+
+\subsection{Indented Paragraphs}
+
+The \ms/ macros provide a fairly crude basis for producing indented or
+hanging paragraphs in the form of the ".IP" macro. \latex/
+provides a number of different environments which accomplish the same
+task.
+
+\subsubsection{Numbered Paragraphs}
+
+These are produced by giving a number argument to the ".IP" macro, as in the
+following example:
+
+\begin{mstext}
+ ".IP 1."
+ Text for first paragraph, typed
+ normally for as long as you would
+ like on as many lines as needed.
+ ".IP 2."
+ Text for second paragraph, \ldots
+\end{mstext}
+
+A similar result can be achieved using the enumerate environment of \latex/:
+
+\begin{latextext}
+ "\begin{enumerate}"
+ \> "\item" \> Text for first paragraph, typed
+ \> \> normally for as long as you would
+ \> \> like on as many lines as needed.
+
+ \> "\item" \> Text for second paragraph, \ldots
+ "\end{enumerate}"
+\end{latextext}
+
+\subsubsection{Bulleted Paragraphs}
+
+Bulleted paragraphs, produced using the \ms/ macro call
+
+\begin{mstext}
+ ".IP \(bu"
+ Text \ldots
+\end{mstext}
+
+can be produced in \latex/ by the sequence
+
+\begin{latextext}
+ "\begin{itemize}"
+ \> "\item" Text \ldots
+ "\end{itemize}"
+\end{latextext}
+
+\subsubsection{Labelled Paragraphs}
+
+Labelled paragraphs are produced by the \ms/ macro call ".IP".
+For example,
+
+\begin{mstext}
+ ".IP first: 9"
+ Notice the longer label, requiring larger
+ indenting for these paragraphs.
+ ".IP second:"
+ And so forth.
+\end{mstext}
+
+will produce something like
+
+\begin{quote}
+\begin{description}
+ \item[\rm first: 9] \mbox{}
+
+ Notice the longer label, requiring larger
+ indenting for these paragraphs.
+
+ \item[\rm second:] \mbox{}
+
+ And so forth.
+
+\end{description}
+\end{quote}
+
+These are produced in \latex/ use of the "description" environment, with a
+slightly different appearance:
+
+\begin{latextext}
+ "\begin{description}"
+ \> "\item[first: 9]" \> Notice the longer label, requiring
+ \> \> larger indenting for these paragraphs.
+ \> \> Note the different paragraph shape
+ \> \> and the embolding of the labels with
+ \> \> \latex/.
+ \> "\item[second:]" \> And so forth.
+ "\end{description}"
+\end{latextext}
+
+produces
+\begin{quote}
+\begin{description}
+ \item[first: 9]
+ Notice the longer label, requiring larger
+ indenting for these paragraphs. Note the
+ different paragraph shape and the embolding
+ of the labels with \latex/.
+ \item[second:]
+ And so forth.
+\end{description}
+\end{quote}
+
+\subsubsection{Nested Indented Paragraphs}
+
+Nested indentation is provided by the ".RS" and ".RE" pair of \ms/
+macros. List environments may be nested freely with \latex/, resulting in correct
+indentation. Also, paragraphs without a leading "\item" will be indented
+underneath the most recent paragraph to have a leading "\item".
+
+
+\subsection{Quoted Paragraphs}
+
+The direct counterpart of the ".QP" \ms/ macro is the "quote" environment.
+The direct counterpart of the ".QS" and ".QE" pair of
+\ms/ macros is the "quotation" environment.
+
+\section{Footnotes}
+
+The \ms/ macros provide the ".FS" and ".FE" macros pair for collecting
+footnotes. \latex/ provides the "\footnote" command,\footnote{Like this}.
+That footnote was produced by writing
+
+\begin{latextext}
+\ldots command."\footnote{"Like this"}" That footnote \ldots
+\end{latextext}
+
+\section{Fonts}
+
+\subsection{Style}
+
+The \ms/ macros allow font styles to be changed by use of one of the following
+commands:
+
+\begin{mstext}
+".R" {\rm Roman}
+".I" {\it Italic}
+".B" {\bf Bold}
+\end{mstext}
+
+For example,
+
+\begin{mstext}
+This text becomes
+".B" {\bf bolder}
+and back again.
+\end{mstext}
+
+or
+
+\begin{mstext}
+This text becomes
+".B"
+{\bf bolder}
+".R"
+and back again.
+\end{mstext}
+
+produces the word ``bolder'' in the bold font.
+
+\latex/ has a similar set of commands whose extent is limited by bracing:
+
+\begin{quote}
+\begin{tabular}{ll}
+"\rm" & {\rm Roman} \\
+"\it" & {\it Italic} \\
+"\bf" & {\bf Bold} \\
+"\sl" & {\sl Slanted} \\
+"\sc" & {\sc Small Capitals} \\
+"\sf" & {\sf Sans Serif} \\
+"\tt" & {\tt Typewriter}
+\end{tabular}
+\end{quote}
+
+The above example would be written
+
+\begin{latextext}
+This text becomes "{\bf "{\bf bolder}"}" and back again.
+\end{latextext}
+
+\subsection{Size}
+
+The \ms/ macros allow font sizes to be changed by use of one of the fo
+llowing
+commands:
+
+\begin{mstext}
+".SM" {\small smaller}
+".NL" {\normalsize normal size}
+".LG" {\large larger}
+\end{mstext}
+
+For example,
+
+\begin{mstext}
+This text becomes
+".LG"
+{\large larger}
+".SM"
+and back again.
+\end{mstext}
+
+The ".SM" an ".LG" macros may be repeated for greater effect.
+
+\latex/ has a similar set of commands whose extent is limited by bracing.
+
+\begin{quote}
+\begin{tabular}{ll}
+"\tiny" & {\tiny tiny} \\
+"\scriptsize" & {\scriptsize scriptsize} \\
+"\footnotesize" & {\footnotesize footnotesize} \\
+"\small" & {\small small} \\
+"\normalsize" & {\normalsize normal size} \\
+"\large" & {\large large} \\
+"\Large" & {\Large Large} \\[\smallskipamount]
+"\LARGE" & {\LARGE LARGE} \\[\smallskipamount]
+"\huge" & {\huge huge} \\[\smallskipamount]
+"\Huge" & {\Huge Huge}
+\end{tabular}
+\end{quote}
+
+The above example would be written
+
+\begin{latextext}
+This text becomes "{\large "{\large larger}"}" and back again.
+\end{latextext}
+
+Notice that with \latex/ the sizes are absolutely specified and not
+relatively specified, as with \troff/.
+
+\cleardoublepage
+
+\appendix
+
+\section{Summary}
+
+This Appendix provides a quick guide to the correspondences between the \ms/
+macros (and some raw \troff/ commands) and \latex/ macros. Note that the output
+may not have an identical appearance in all cases.
+
+\newenvironment{stack}{\begin{tabular}{l}}{\end{tabular}}
+\newcommand{\eoe}{\\[\bigskipamount]}
+
+\begin{em}
+\begin{tabular}{|p{0.2\textwidth}|l|l|}
+\hline
+\bf Purpose & \bf \ms/ macro call & \bf \latex/ equivalent
+\eoe
+\hline \hline
+\rm Date & ".ND" date & "\date{"date\/"}" \eoe
+\hline
+\rm Cover Page & ".RP" & "\titlepage" \eoe
+\hline
+\rm Author & \begin{stack}
+ ".AU" \\
+ author
+ \end{stack} & "\author{"author\/"}" \eoe
+\hline
+\rm Affiliation & \begin{stack}
+ ".AI" \\
+ Institution
+ \end{stack} & "\thanks{"Institution\/"}" \eoe
+\hline
+\rm Abstract & \begin{stack}
+ ".AB" \\
+ \ldots{} abstract \ldots \\
+ ".AE"
+ \end{stack} & \begin{stack}
+ "\begin{abstract}" \\
+ \ldots{} abstract \ldots \\
+ "\end{abstract}"
+ \end{stack} \eoe
+\hline
+\rm Multi-column formats
+ & ".2C" & "\twocolumn" \eoe
+ & ".1C" & "\onecolumn" \eoe
+\hline
+\rm Section Headings & \begin{stack}
+ ".SH" \\
+ heading
+ \end{stack} & "\section*{"heading\/"} " \eoe
+ & \begin{stack}
+ ".NH" \\
+ heading
+ \end{stack} & "\section{"heading\/"}" \eoe
+ & \begin{stack}
+ ".NH 2" \\
+ heading
+ \end{stack} & "\subsection{"heading\/"}" \eoe
+ & \begin{stack}
+ ".NH 3" \\
+ heading
+ \end{stack} & "\subsubsection{"heading\/"}" \eoe
+ & \begin{stack}
+ ".NH 4" \\
+ heading
+ \end{stack} & "\paragraph{"heading\/"}" \eoe
+ & \begin{stack}
+ ".NH 5" \\
+ heading
+ \end{stack} & "\subparagraph{"heading\/"}" \eoe
+\hline
+\end{tabular}
+
+\begin{tabular}{|p{0.2\textwidth}|l|l|}
+\hline
+\bf Purpose & \bf \ms/ macro call & \bf \latex/ equivalent \eoe
+\hline \hline
+\rm Standard and Left-Block paragraphs
+ & ".LP", ".PP" & one, or more blank lines \eoe
+\hline
+\rm Numbered paragraphs
+ & \begin{stack}
+ ".IP" n. \\
+ Text \ldots \\
+ \vdots
+ \end{stack} & \begin{stack}
+ "\begin{enumerate}" \\
+ "\item" Text \ldots \\
+ \vdots \\
+ "\end{enumerate}"
+ \end{stack} \eoe
+\hline
+\rm Bulleted paragraphs
+ & \begin{stack}
+ ".IP \(bu" \\
+ Text \ldots \\
+ \vdots
+ \end{stack} & \begin{stack}
+ "\begin{itemize}" \\
+ "\item" Text \ldots \\
+ \vdots \\
+ "\end{itemize}"
+ \end{stack} \eoe
+\hline
+\rm Labelled paragraphs
+ & \begin{stack}
+ ".IP" label \\
+ Text \ldots \\
+ \vdots
+ \end{stack} & \begin{stack}
+ "\begin{description}" \
+\
+ "\item["label\/"]" Text\ldots \\
+ \vdots \\
+ "\end{description}"
+ \end{stack} \eoe
+\hline
+\rm Quoted paragraphs
+ & \begin{stack}
+ ".QP" \\
+ Text \ldots \\
+ \end{stack} & \begin{stack}
+ "\begin{quote}" \\
+ Text \ldots \\
+ "\end{quote}"
+ \end{stack} \eoe
+ & \begin{stack}
+ ".QS" \\
+ Text \ldots \\
+ ".QE"
+ \end{stack} & \begin{stack}
+ "\begin{quotation}" \\
+ Text \ldots \\
+ \vdots \\
+ "\end{quotation}"
+ \end{stack} \eoe
+\hline
+\rm Footnotes & \begin{stack}
+ ".FS" \\
+ Text \ldots \\
+ ".FE"
+ \end{stack} & "\footnote{"Text \ldots"}" \eoe
+\hline
+\end{tabular}
+
+\begin{tabular}{|p{0.2\textwidth}|l|l|}
+\hline
+\bf Purpose & \bf \ms/ macro call & \bf \latex/ equivalent
+\eoe
+\hline \hline
+\rm Font Styles & \begin{stack}
+ ".R" {\rm Roman} \\
+ ".I" {\it Italic} \\
+ ".B" {\bf Bold}
+ \end{stack} &
+ \begin{stack}
+ "{\rm" {\rm Roman}"}" \\
+ "{\it" {\it Italic\/}"}" \\
+ "{\bf" {\bf Bold}"}" \\
+ "{\sl" {\sl Slanted\/}"}" \\
+ "{\sc" {\sc Small Capitals}"}" \\
+ "{\sf" {\sf Sans Serif}"}" \\
+ "{\tt" {\tt Typewriter}"}"
+ \end{stack} \eoe
+\hline
+\rm Font Sizes &
+ \begin{stack}
+ ".SM" {\small smaller} \\
+ ".NL" {\normalsize normal size} \\
+ ".LG" {\large larger}
+ \end{stack} &
+ \begin{stack}
+ "{\tiny" {\tiny tiny}"}" \\
+ "{\scriptsize" {\scriptsize scriptsize}"}" \\
+ "{\footnotesize" {\footnotesize footnotesize}"}" \\
+ "{\small" {\small small}"}" \\
+ "{\normalsize" {\normalsize normal size}"}" \\
+ "{\large" {\large large}"}" \\
+ "{\Large" {\Large Large}"}" \\[\smallskipamount]
+ "{\LARGE" {\LARGE LARGE}"}" \\[\smallskipamount]
+ "{\huge" {\huge huge}"}" \\[\smallskipamount]
+ "{\Huge" {\Huge Huge}"}"
+ \end{stack} \eoe
+\hline
+\end{tabular}
+\end{em}
+
+\bibliographystyle{alpha}
+\bibliography{refs}
+
+\end{document}
+SHAR_EOF
+if test 17400 -ne "`wc -c < 'ms-latex.tex'`"
+then
+ echo shar: "error transmitting 'ms-latex.tex'" '(should have been 17400 characters)'
+fi
+fi
+echo shar: "extracting 'sfwmac.sty'" '(1626 characters)'
+if test -f 'sfwmac.sty'
+then
+ echo shar: "will not over-write existing file 'sfwmac.sty'"
+else
+cat << \SHAR_EOF > 'sfwmac.sty'
+% LaTeX support for writing UNIX-style documentation
+
+
+% UNIX-style references
+
+\def\sfwFILfont{\sl}
+
+\def\@egaux#1#2#3{%
+ \def#1##1{%
+ #2\begingroup \tt \let\do=\@makeother \dospecials
+ \def\@tempa####1##1{####1\endgroup#3}\@tempa
+ }%
+}
+
+\def\pgm#1{\mbox{\it#1}\index{#1}} % programs
+\def\xpgm#1#2{\mbox{\it#1}\index{\noexpand\noexpand\noexpand#2{}}}
+\def\man#1(#2){\xpgm{#1\/}{#1}(#2)} % manual entries
+\@egaux\arg{`{}}{'{}} % arguments to programs
+\@egaux\switch{`{}-}{'{}} % switches to programs
+\def\file#1{\mbox{\sfwFILfont#1}} % filename
+
+
+% Commonly used software systems
+
+\def\sfwPGMfont{\tt}
+
+\def\@sfwdef#1#2{\@sfwaux{#1/}{#2}}
+\def\@sfwaux#1#2{\def#1{\mbox{#2}\index{\noexpand\noexpand\noexpand#1{}}}}
+
+\@sfwdef\EMACS{\sfwPGMfont EMACS}
+\@sfwdef\INFO{\sfwPGMfont INFO}
+\@sfwdef\MLisp{\sfwPGMfont MLisp}
+
+\@sfwdef\SendMail{\sfwPGMfont SendMail}
+\@sfwdef\UUCP{\sfwPGMfont UUCP}
+
+\def\AmS{$\cal A$\kern-.1667em\lower.5ex\hbox{$\cal M$}\kern-.125em$\cal S$}
+\@sfwaux\AmSTeX{\rm \AmS-\TeX}
+
+\@sfwaux\PhDTeX{\rm P\kern-.05em{\sc h\kern-.025em D}\kern-0.08em\TeX}
+
+\@sfwaux\LaTeX{\rm L\kern-.36em\raise.3ex\hbox{\sc a}\kern-.15em\TeX}
+\@sfwaux\BibTeX{\rm B\kern-.05em{\sc i\kern-.025em b}\kern-.08em\TeX}
+\@sfwaux\SLiTeX{\rm S\kern-.06em{\sc l\kern-.035emi}\kern-.06em\TeX}
+
+
+\@sfwdef\WEB{\sfwPGMfont WEB}
+
+\@sfwdef\Prolog{\sfwPGMfont Prolog}
+\@sfwdef\Lisp{\sfwPGMfont Lisp}
+
+\@sfwdef\DBUG{\sfwPGMfont DBUG}
+
+\@sfwdef\troff{\sfwPGMfont troff}
+\@sfwdef\nroff{\sfwPGMfont nroff}
+\@sfwdef\Miranda{\sfwPGMfont Miranda}
+\@sfwdef\AiM{\sfwPGMfont AiM}
+\@sfwdef\ASN{\sfwPGMfont ASN.1}
+\@sfwdef\ISODE{\sfwPGMfont ISODE}
+
+SHAR_EOF
+if test 1626 -ne "`wc -c < 'sfwmac.sty'`"
+then
+ echo shar: "error transmitting 'sfwmac.sty'" '(should have been 1626 characters)'
+fi
+fi
+exit 0
+# End of shell archive
+-------