%%% ====================================================================
%%% @TeX-file{
%%%   filename  = "amstinst.tex",
%%%   version   = "2.1c",
%%%   date      = "1997/01/28",
%%%   time      = "21:45:55 EST",
%%%   checksum  = "37168 556 3418 25050",
%%%   filetype  = "AMS-TeX: user documentation",
%%%   author    = "American Mathematical Society",
%%%   copyright = "Copyright (C) American Mathematical Society,
%%%                all rights reserved.  Copying of this file is
%%%                authorized only if either:
%%%                (1) you make absolutely no changes to your copy,
%%%                including name; OR
%%%                (2) if you do make changes, you first rename it
%%%                to some other name.",
%%%   address   = "American Mathematical Society,
%%%                Technical Support,
%%%                Electronic Products and Services,
%%%                P. O. Box 6248,
%%%                Providence, RI 02940,
%%%                USA",
%%%   telephone = "401-455-4080 or (in the USA and Canada)
%%%                800-321-4AMS (321-4267)",
%%%   FAX       = "401-331-3842",
%%%   email     = "tech-support@ams.org (Internet)",
%%%   codetable  = "ISO/ASCII",
%%%   keywords  = "amstex, ams-tex",
%%%   supported = "yes",
%%%   abstract  = "This file is part of the AMS-TeX distribution,
%%%                version 2.1. It contains installation instructions.
%%%                The file amsguide.tex inputs this file, but this
%%%                file is also designed so that it can be processed
%%%                separately, using only Plain TeX.",
%%%   docstring = "The checksum field above contains a CRC-16 checksum
%%%                as the first value, followed by the equivalent of
%%%                the standard UNIX wc (word count) utility output of
%%%                lines, words, and characters.  This is produced by
%%%                Robert Solovay's checksum utility.",
%%%  }
%%% ====================================================================
%
%    This file is input by amsguide.tex, which requires AMS-TeX 2.1.
%    However it can also be typeset separately using Plain \TeX{}, by
%    means of the mechanism below: we check to see if amsppt.sty has
%    been loaded earlier; if so, we set the catcode of the ~ character
%    to 14 so that the following section of definitions will be ignored
%    (since the definitions would be redundant); otherwise we set the
%    catcode to 9 ("ignore") so that the definitions will be carried out.
%    Several definitions differ from the ones in amsguide.tex because
%    amsppt.sty is absent.
%
%    Enclosing the definitions section within the initial \if ...
%    \else ... \fi would be problematic because of the outerness of
%    \head and \subhead in the amsppt documentstyle.
%
%    Leave the definition of \head active; it is slightly different from
%    the one in amsppt.sty, and gives a different result in Appendix C.
%
\expandafter\ifx\csname amsppt.sty\endcsname\relax
  \catcode`\~=9 \else \catcode`\~=14 \let\BYE\relax \fi
~  \let\BYE\bye
~  \hsize=30pc \vsize=47pc
  \def\head#1\endhead{\bigskip{\sc\noindent
    \leftskip0pt plus.5\hsize \rightskip=\leftskip\parfillskip=0pt
    \def\\{\break}#1\par}\nobreak\smallskip}
  \font\sc=cmcsc10
~  \def\subhead#1\endsubhead{\removelastskip\medskip{\bf\noindent
~    #1\par}\nobreak\smallskip}
~  \def\AmSTeX{{\the\textfont2 A\kern-.1667em%
~    \lower.5ex\hbox{M}\kern-.125emS}-\TeX}
~  \long\def\usertype#1{\smallskip \moveright2pc\vbox{\def\par{\crcr}\halign{%
~     \setbox0\hbox{\tt##}%
~     \hbox\ifdim\wd0<10pc to10pc\fi{\unhbox0\hfil}%
~          \kern1pc \it $\langle$return$\rangle$\hss
~     \cr#1\crcr}}%
~    \smallskip}
~  \long\def\systype#1{{\rightskip=4pc\leftskip=4pc\noindent\tt #1\par}}
~  \hfuzz1pc % to suppress reporting of overfull boxes.
~  \hyphenation{amsppt}
~  \def\Textures{{\it Textures\/}}
~  \def\AMS{American Mathematical Society}
~  \def\filnam#1{{\tt\def\\{\char`\\}\ignorespaces#1\unskip}}
~  \hyphenchar\tentt=-1 % to prohibit hyphenation in tt text
~  \newdimen\exindent   \exindent=2\parindent
~  {\obeylines
~   \gdef^^M{\par\penalty9999}%
~   \gdef\beginexample#1{\medskip\bgroup %
~     \def\~{\char`\~}\def\\{\char`\\}\def\{{\char`\{}\def\}{\char`\}}%
~     \overfullrule0pt\tt\frenchspacing %
~     \parindent=0pt#1\leftskip=\exindent\obeylines}
~  }%  end \obeylines
~  \def\endexample{\endgraf\egroup\medskip}
~  \def\cs#1{\leavevmode
~    \skip0\lastskip\unskip\penalty0
~    \ifdim\skip0>0pt \hskip\skip0\fi
~    {\tt\def\{{\char`\{}\def\}{\char`\}}%
~      \def\\{\char`\\}\char`\\\ignorespaces#1\unskip}}
~  \newcount\rostercount
~  \def\roster{\par\smallskip\begingroup \rostercount=0
~    \def\par{{\endgraf}}\hangindent3pc
~    \def\item{\futurelet\next\iitem}%
~    \def\iitem{\ifx\next"\expandafter\iiitem
~      \else\advance\rostercount 1 \iiitem"(\the\rostercount)"\fi}%
~    \def\iiitem"##1"{\par \noindent\hbox to\hangindent{\hss##1\enspace}}%
~  }
~  \def\endroster{\par\smallskip\endgroup}
~  \def\newpage{\vfil\eject}
\catcode126=\active % restore ~ to normal; using `\~ here wouldn't work!

\head Appendix B\\ Installation Procedures -- PC and Generic\endhead

\subhead B.1. Introduction\endsubhead

The \AmSTeX{} software can be used with any full implementation of \TeX{}.
Sections B.2--B.5 of this appendix describe the installation of \AmSTeX{}
for DOS implementations of \TeX{} on an IBM PC or compatible machine from
a DOS diskette or diskettes provided by the \AMS{}.  PC\TeX{} (from
Personal \TeX{}, Inc.)\ and em\TeX{} are used as examples.  If your
operating system is not DOS, or if you obtained \AmSTeX{} through other
channels, you won't be able to use the \filnam{install} program that is
provided.  Instead, follow the generic installation instructions in
section B.6.  You will have to refer to the documentation for your
particular implementation of \TeX{} to work out the details of any
necessary variations. Users who encounter difficulties should seek help
from the manufacturer of their implementation of \TeX{}, or from the
\AMS{}'s technical support staff.

The TFM files for some of AMSFonts 2.2 (\filnam{msam*}, \filnam{msbm*},
and \filnam{eufm*}) are needed to run \AmSTeX{} with the AMSPPT
documentstyle, even if you don't plan to actually print anything using the
AMSFonts.  (These fonts are needed to process and print the User's Guide
of which this index is a part.)  In the diskette distribution TFM files
for all AMSFonts are provided in a directory named \filnam{\\tfm}. They
are also available from the AMS Internet archive, \filnam{e-math.ams.org},
by anonymous FTP.


\subhead B.2. Getting Started\endsubhead

The installation procedure consists of moving files to the proper
directories, and creating format files.  The first step is to determine
the names of the proper directories, which will vary with different
implementations of \TeX{}.  You need to know the name of your {\bf \TeX{}
inputs directory}, your {\bf \TeX{} TFM directory}, and your {\bf \TeX{}
formats directory}. Check your directory structure or  consult the
documentation for your implementation of \TeX{} to see what these names are.
If you have any difficulty determining these directories:
\roster
\item"(a)"Search for
the plain \TeX{} input file, \filnam{plain.tex}. The directory where it
is located will be your \TeX{} inputs directory.
\item"(b)"Search for the font
file \filnam{cmr10.tfm}. The directory where it is found will be your
\TeX{} TFM directory.
\item"(c)"Search for the plain \TeX{} format file,
\filnam{plain.fmt}. The directory where it is found will be your \TeX{}
formats directory.
\endroster
For example, for PC\TeX{} the directory names are  \filnam{\\pctex\\texinput},
\filnam{\\pctex\\textfms},  and
\filnam{\\pctex\\texfmts}.{\tolerance9999\hbadness\tolerance\par}


Note: If you currently have any  of the following files from earlier
releases of \AmSTeX{}, backup and delete them before installing the new
version.  They are either irrelevant or superseded in the new version of
\AmSTeX{}, and it is best to remove them to avoid confusion.  All of
them except for the last one would be found in your \TeX{} inputs
directory;  \filnam{amsplain.fmt} would be found in your \TeX{} formats
directory.

\settabs5\columns {\tt
\+\ \ amsfil.chg& amsplain.tex& amsppt.sty& amsppt.mor& amstex.tex\cr
\+\ \ amstex.chg& cyracc.def& cyrmemo.def& cyrmemo.tex& amsplain.fmt\cr
}

Users who did not receive \AmSTeX{} on diskette from the AMS, or those
using non-DOS implementations of \TeX{}, should  proceed now to section B.6.


\subhead B.3. Installing \AmSTeX{} (DOS/diskette)\endsubhead

The following files are used in the installation process
for DOS implementations of \TeX{}, for \AmSTeX{} 2.1:
\par\nobreak
\smallskip
\settabs3\columns
\setbox0\vbox{\tt\+install.exe& amsinst.bat& amstex.ini\cr}
\moveright\parindent\box0
\smallskip

For DOS installation, you need to know on which drive to install
\AmSTeX{}. This should be the drive on which you already have installed
\TeX{}.

{\bf For PC\TeX{},} you will
probably want to select the first choice for each of the questions which
the installation programs asks you. This will result in placing the
\AmSTeX{} files in the directory \filnam{\\pctex\\texinput} and the TFM
files in the directory \filnam{\\pctex\\textfms}.

{\bf For other DOS implementations of \TeX{},}  you will
need to know the names of your \TeX{} inputs directory and
\TeX{} TFM directory, as described earlier, so that you can
enter them when prompted.

\smallskip When you have the disk and directory information ready, place
the disk labeled ``\AmSTeX{} 2.1'' in your floppy disk drive  and type
the following commands (if the disk is in drive B, substitute ``b'' for
``a'' in the first line):

\usertype{a:

install }

\noindent
This will run the \filnam{install} program, which will ask you some
questions.  Enter the answers which you determined from reading the
above paragraphs.


\subhead B.4. Running INITEX to Create Format Files (DOS)\endsubhead

To complete the installation procedure, you should create a
format file.  This will enable you to run \TeX{} with \AmSTeX{}, or
\AmSTeX{} and the AMSPPT preprint style, preloaded. This preloading
will save quite a bit of startup time on slower systems.
Note: Each format file takes up 150K--300K of disk space
(depending on your implementation of \TeX{}).

\smallskip

{\bf Warning:} INITEX requires much more memory to run than
regular \TeX{}. The first time you try to run INITEX, you may get the
message ``{\tt Not enough memory to run TeX}'' or something similar
(with simpler implementations, it may just crash). If this happens, you
must remove as many memory-resident programs as possible (such as
communications software and memory-resident utilities [TSRs]) and reboot your
system to create enough memory to run INITEX\null. Consult the documentation
for your implementation of \TeX{} for more information on running INITEX.
\smallskip

%  The next paragraph is repeated for the generic case and also Textures
\def\WhatFormatFile{%
You are now ready to create a format file so that \AmSTeX{}, or \AmSTeX{} and
the AMSPPT preprint style, can be preloaded when you typeset a document. Before
creating your format file, you will want to consider whether you habitually use
the AMSPPT documentstyle. If you use other documentstyles rarely or never,
then you would benefit from the use of a format file with \filnam{amsppt.sty}
preloaded.  If you are likely to use other documentstyles periodically, then
you probably do not want to preload \filnam{amsppt.sty}. To make a simple
\AmSTeX{} format file, proceed with the next paragraph. To make a format file
with \filnam{amsppt.sty} preloaded, edit the file \filnam{amstex.ini} and
remove the percent sign (comment character) at the beginning of the line
\cs{documentstyle\{amsppt\}}, just before the \cs{dump} command.  If you
intend to use Type-1 outline versions of AMSFonts, read Appendix D before
proceeding.}

\WhatFormatFile{}

The \TeX{} file named \filnam{amstex.ini} should now be installed in your
\TeX{} inputs directory.  Once you have decided whether to create an \AmSTeX{}
or an AMSPPT format file (see previous paragraph), run INITEX on
\filnam{amstex.ini}:

\noindent {\bf For PC\TeX}, give the command

\usertype{tex amstex.ini -i}

\noindent {\bf For emtex}, give the command

\usertype{tex386 -i amstex.ini}

\noindent {\bf For other implementations} of \TeX{} the form of the INITEX
command may be different, e.g., {\tt tex/i amstex.ini}.

\noindent This creates an \AmSTeX{} format file named \filnam{amstex.fmt}.
If you included AMSPPT, you may wish to rename it \filnam{amsppt.fmt}.

{\bf Move the format files to the right directory.}
Some implementations of \TeX{}, including PC\TeX{}, will automatically
place the format file in the proper directory.  Otherwise you should now
move the file manually into your \TeX{} formats directory.


\subhead B.5. Using \AmSTeX{} 2.0+ (DOS)\endsubhead

On the distribution diskettes, or in a distribution obtained by FTP or from
a Web site, a DOS batch file \filnam{amstex.bat} is provided, to make use
of the format file more convenient.  If you received the distribution on
diskette, \filnam{amstex.bat} will have been placed by the installation
procedures in the root directory of the drive where \TeX{} is located;
otherwise, you should install it there manually.  Then, if you are
connected to that directory or if it is in your system path, you would
run \AmSTeX{} on a file called \filnam{filename.tex} by typing

\usertype{amstex filename}


\subhead B.6. Installing \AmSTeX{} (Generic)\endsubhead

Use these instructions if you didn't receive \AmSTeX{} on diskettes from
the AMS, but obtained it by other methods, or if you have a non-DOS
implementation of \TeX{}.  You will need to know the names of your
\TeX{} inputs directory, \TeX{} TFM directory, and \TeX{} formats
directory, as explained in section~B.2.
\roster
\item Copy the following files into your \TeX{} inputs directory:
\filnam{amstex.tex}, \filnam{amsppt.sty}, \filnam{amssym.tex},
\filnam{amstex.ini}, and \filnam{amsppt1.tex}.
{\tolerance9999\par}

\item There are three documentation files: \filnam{amsguide.tex},
\filnam{joyerr.tex}, and \filnam{amsppt.doc}. If you have a documentation
directory, or wish to create one, then put these files there; otherwise
they can be put in the \TeX{} inputs directory.
{\tolerance9999\par}

\item Copy the AMSFonts TFM files to your \TeX{} TFM directory. If
you don't plan to use any of the AMSFonts, you should still copy
\filnam{dummy.tfm}, which is needed for \AmSTeX{}'s syntax check option,
and \filnam{msam*.tfm}, \filnam{msbm*.tfm}, and \filnam{eufm*.tfm},
which are needed for typesetting the {\it User's Guide}.

\item \WhatFormatFile{}

\item  Check the documentation for your implementation of \TeX{} to find
out how to run INITEX and create format files.  Format files greatly
speed up processing when you are using a large macro package such as
\AmSTeX{}.  If your implementation of \TeX{} doesn't automatically place
format files in the \TeX{} formats directory (check your documentation), you
will have to either go to the \TeX{} formats directory before running
INITEX, or move the format files there after they are created.

If you are a PC user, return to section B.4, read the warning, then proceed
to the paragraph beginning ``The \TeX{} file named \filnam{amstex.ini}''.

Run the file \filnam{amstex.ini} through INITEX, to create the file
\filnam{amstex.fmt}, which is a preloaded form of \AmSTeX{}.  If you do not
have an executable program or symbol \filnam{initex}, a typical command
to perform this function is

\usertype{\qquad tex -i amstex.ini}

You will now have a file \filnam{amstex.fmt}.  If you included AMSPPT, you
may wish to rename it \filnam{amsppt.fmt}.

\item Move the format file that you just created into your
\TeX{} formats directory, if you didn't create it there.
\endroster

\medskip For details of how to use format files with your implementation of
\TeX{}, see your documentation.  Typically, you use a format file by
specifying it on the command line preceded by an ampersand, e.g., {\tt
tex \&amstex filename}.


\subhead B.7. Getting a printed copy of the User's Guide \endsubhead

If you did not receive a printed copy of this User's Guide with
your distribution, you can use your newly created \AmSTeX{} or AMSPPT
format file to typeset the file \filnam{amsguide.tex}.


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

\newpage
\csname firstpage\string @true\endcsname


\head Appendix C\\ Installation Procedures -- Macintosh (\Textures)\endhead

\subhead C.1. Introduction\endsubhead

These instructions describe the installation of \AmSTeX{} for use with
\Textures{}, on the Macintosh. There is one disk in the distribution.
The files \filnam{amstex.tex} and  \filnam{amsppt.sty} are \Textures{}
documents to be input by \Textures{}.  The file \filnam{amsppt.doc} is
technical documentation for the macros defined in  \filnam{amsppt.sty}.
The file \filnam{amstex.ini} is used in the installation to create
format files.  The files \filnam{amsguide.tex} and \filnam{amstinst.tex}
are the \Textures{} source for this User's Guide.{\tolerance9999\par}

The file \filnam{joyerr.tex} is a list of errata to the 1986 edition of
{\it The Joy of \TeX{}.} You may typeset it in \Textures{} using your
new \AmSTeX{} format file (once it has been created).
If you do not have AMSFonts 2.2, the
characters in this file which come from the AMS symbol fonts will appear
in the default system font.  The file \filnam{AMSFonts 2.2 metrics}
contains the \TeX{} metrics information for AMSFonts 2.2. This file is
required to use \filnam{amsppt.sty} even if you do not have AMSFonts
2.2. ({\bf Note: }Even if you currently have AMSFonts 2.0, we {\it strongly\/}
recommend that you obtain version 2.2, as the metrics have changed.)

\AmSTeX{} Versions 2.0+ can be used with \Textures{} without AMSFonts.
However,  \AmSTeX{} Versions 2.0+ will not work with releases of AMSFonts
previous to Version 2.0. Additionally, if AMSFonts 2.2 are to be used,
they require \Textures{} version 1.2 or higher. If you have an earlier
release of \Textures{}, you must upgrade before using these fonts. To
upgrade \Textures{}, contact the manufacturer: Blue Sky Research (see
below, {\bf Getting Help}).

\smallskip
{\bf Note:}
AMSFonts are available in Type-1 outline form from Blue Sky Research.
If you are using these fonts, read Appendix D before proceeding.


\subhead C.2. If You Have a Previous Version of \AmSTeX{}\endsubhead

Before installing the new version of \AmSTeX{}, you should backup and
delete from your hard disk any files which are related to previous releases
of \AmSTeX{}. In particular, you should remove the following files from
your \filnam{Textures} folder (or any folders contained in your
\filnam{Textures} folder):

\settabs5\columns {\tt
\+\ \ amsfil.chg&amsplain.tex&amsppt.sty&amsppt.mor&amstex.tex\cr
\+\ \ amstex.chg&cyracc.def&cyrmemo.def&cyrmemo.tex\cr }

\noindent
and you should remove any previous \AmSTeX{} format files from
your \filnam{TeX formats} folder.
These files are either irrelevant or superseded in the new version of
\AmSTeX{}, and it is best to remove them from your hard disk to avoid
confusion.


\subhead C.3. Installing \AmSTeX{}\endsubhead

If you do not have a folder named \filnam{TeX inputs} inside the
\filnam{Textures} folder on your hard disk, create a new folder inside
your \filnam{Textures} folder and name it \filnam{TeX inputs}. Also, if
you do not have a  \filnam{TeX formats} folder, create a new folder
inside your \filnam{Textures}  folder and name it \filnam{TeX formats}.
Likewise, create a \filnam{TeX fonts} folder if you do not already
have one.

To install the new version of \AmSTeX{} on your system, copy the
following files into the  \filnam{TeX inputs} folder inside the
\filnam{Textures} folder on your hard disk:

{\tt \quad amstex.tex\quad amssym.tex\quad amsppt.sty\quad
amsppt1.tex\quad amstex.ini}

\noindent
Then copy the file \filnam{amsfonts 2.2 metrics} into the \filnam{TeX
fonts} folder inside of the \filnam{Textures} folder on your hard disk.

\WhatFormatFile{}

Make sure that Flash mode is off.  You cannot create a format with Flash mode
enabled.

Open the \filnam{TeX inputs} folder (inside your \filnam{Textures} folder) and
double-click on the file \filnam{amstex.ini} to start running \Textures{}. Make
sure that the line \cs{input plain} is commented out (begins with a percent
sign). If there is not a percent sign at the beginning of this line, insert
one. Check under the Typeset menu to make sure that the Plain format is
selected (there is a check mark next to it). Select ``Typeset'' from the
Typeset menu. When the dialog box appears asking you what to name the format
file, go through the folder hierarchy to place yourself inside the \filnam{TeX
formats} folder inside your \filnam{Textures} folder. You may name the file
what you wish, but \filnam{2.1} is a good idea.  If you included
\filnam{amsppt.sty} in your format file, name the  format file
\filnam{AMS-TeX/AMSPPT} or something similarly descriptive.

For more information about using formats in \Textures{}, see the
\Textures{} {\it User's Guide\/}.

If you did not receive a printed copy of the {\it \AmSTeX{} User's Guide\/}
with your distribution, you can use your newly created \AmSTeX{} or AMSPPT
format file to typeset the file \filnam{amsguide.tex}.


\subhead C.4. Getting Help \endsubhead

Questions concerning \Textures{} should be directed to:
\smallskip

\begingroup
\obeylines\parindent1in \parskip0pt
Blue Sky Research
317 Southwest Alder, \#1200
Portland, OR 97204
Phone: 800-622-8398 \quad or\quad 503-222-9571
\endgroup


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

\newpage
\csname firstpage\string @true\endcsname

\head Appendix D\\ Before Installing \AmSTeX: Facts About Fonts\endhead

\subhead D.1. Using AMSFonts in PostScript Type-1 form\endsubhead

The AMSFonts Version~2.2 have been converted to PostScript Type-1 outlines
in two forms:

Blue Sky Research and Y\&Y have created a collection containing all the
typefaces, but only in 5, 7, and 10 point sizes; other sizes must be created
by scaling.  The \AmSTeX{} preprint style provides a way for authors to
indicate that fonts should be loaded under this alternative scaling
convention.  If you are using the Blue Sky/Y\&Y version of AMSFonts,
insert the line \cs{PSAMSFonts} in the preamble of your file, before
the \cs{topmatter} line.

Basil Malyshev has created a collection, called BaKoMa, containing the
Computer Modern fonts as well as all sizes of the AMSFonts used in
mathematics, but excluding the \filnam{wncy*} cyrillic fonts.
The BaKoMa fonts can be used with no special action.


\subhead D.2. Using AMS Symbol Fonts\endsubhead

The preprint style automatically loads the Fraktur font and both fonts of
extra symbols (\filnam{msam} and \filnam{msbm}), as well as all the symbol
names, as described in the sections {\bf Fonts} and {\bf Symbol Names}.
If these will not be used, and you want a version of \filnam{amsppt.sty}
that requires less memory than the default version, you can suppress the
loading of these resources.  If \filnam{amsppt.sty} is to be included in
your format file, you must make this change before creating the format file.

An ``initialization file'', \filnam{amsppt.sti}, contains settings for
some options that a user may wish to change locally.  The following two
lines appear in this file:
\beginexample{}
\\loadeufm \\loadmsam \\loadmsbm
\\message\{symbol names\}\\UseAMSsymbols\\message\{,\}
\endexample
To use \filnam{amsppt.sty} without AMSFonts, comment out both lines (place
a {\tt\char`\%} at the beginning of each line); to disable just the symbol
names, comment out the second line.  Extra math symbols can be loaded on
demand with \cs{newsymbol} or by including \cs{UseAMSsymbols} in the
preamble of a particular document.


\BYE % This is = \relax if this file is input by amsguide.tex
%% \CharacterTable
%%  {Upper-case    \A\B\C\D\E\F\G\H\I\J\K\L\M\N\O\P\Q\R\S\T\U\V\W\X\Y\Z
%%   Lower-case    \a\b\c\d\e\f\g\h\i\j\k\l\m\n\o\p\q\r\s\t\u\v\w\x\y\z
%%   Digits        \0\1\2\3\4\5\6\7\8\9
%%   Exclamation   \!     Double quote  \"     Hash (number) \#
%%   Dollar        \$     Percent       \%     Ampersand     \&
%%   Acute accent  \'     Left paren    \(     Right paren   \)
%%   Asterisk      \*     Plus          \+     Comma         \,
%%   Minus         \-     Point         \.     Solidus       \/
%%   Colon         \:     Semicolon     \;     Less than     \<
%%   Equals        \=     Greater than  \>     Question mark \?
%%   Commercial at \@     Left bracket  \[     Backslash     \\
%%   Right bracket \]     Circumflex    \^     Underscore    \_
%%   Grave accent  \`     Left brace    \{     Vertical bar  \|
%%   Right brace   \}     Tilde         \~}
