Reverted '\var' in the "standard installation location" table to '\filevar'.

Reformatted wide paragraphs.

1 files changed, 51 insertions, 49 deletions

diff --git a/Doc/inst/inst.tex b/Doc/inst/inst.tex
index 9404cde..1ca4c1e 100644
--- a/Doc/inst/inst.tex
+++ b/Doc/inst/inst.tex
@@ -168,7 +168,7 @@ have to open a command prompt window and do it there; on Mac~OS ...
 You should always run the setup command from the distribution root
 directory, i.e. the top-level subdirectory that the module source
 distribution unpacks into.  For example, if you've just downloaded a
-module source distribution \file{foo-1.0.tar.gz} onto a Unix system, the 
+module source distribution \file{foo-1.0.tar.gz} onto a Unix system, the
 normal thing to do is:
 \begin{verbatim}
 gunzip -c foo-1.0.tar.gz | tar xf -    # unpacks into directory foo-1.0
@@ -177,10 +177,11 @@ python setup.py install
 \end{verbatim}
 
 On Windows, you'd probably unpack the archive before opening the command
-prompt.  If you downloaded the archive file to \file{C:\textbackslash{}Temp},
-then it probably unpacked (depending on your software) into
-\file{C:\textbackslash{}Temp\textbackslash{}foo-1.0}; from the command prompt window,
-you would then run
+prompt.  If you downloaded the archive file to
+\file{C:\textbackslash{}Temp}, then it probably unpacked (depending on
+your software) into
+\file{C:\textbackslash{}Temp\textbackslash{}foo-1.0}; from the command
+prompt window, you would then run
 \begin{verbatim}
 cd c:\temp\foo-1.0
 python setup.py install
@@ -219,8 +220,8 @@ As implied above, the \command{build} command is responsible for putting
 the files to install into a \emph{build directory}.  By default, this is
 \file{build} under the distribution root; if you're excessively
 concerned with speed, or want to keep the source tree pristine, you can
-change the build directory with the \longprogramopt{build-base} option.  For
-example:
+change the build directory with the \longprogramopt{build-base} option.
+For example:
 \begin{verbatim}
 python setup.py build --build-base=/tmp/pybuild/foo-1.0
 \end{verbatim}
@@ -269,23 +270,23 @@ being installed is pure Python or contains extensions (``non-pure''):
 \begin{tableiv}{l|l|l|c}{textrm}%
   {Platform}{Standard installation location}{Default value}{Notes}
   \lineiv{Unix (pure)}
-          {\filenq{\var{prefix}/lib/python1.6/site-packages}}
+          {\filenq{\filevar{prefix}/lib/python1.6/site-packages}}
           {\filenq{/usr/local/lib/python1.6/site-packages}}
           {(1)}
   \lineiv{Unix (non-pure)}
-          {\filenq{\var{exec-prefix}/lib/python1.6/site-packages}}
+          {\filenq{\filevar{exec-prefix}/lib/python1.6/site-packages}}
           {\filenq{/usr/local/lib/python1.6/site-packages}}
           {(1)}
   \lineiv{Windows}
-          {\filenq{\var{prefix}}}
+          {\filenq{\filevar{prefix}}}
           {\filenq{C:\textbackslash{}Python}}
           {(2)}
   \lineiv{Mac~OS (pure)}
-          {\filenq{\var{prefix}:Lib}}
+          {\filenq{\filevar{prefix}:Lib}}
           {\filenq{Python:Lib}  \XXX{???}}
           {}
   \lineiv{Mac~OS (non-pure)}
-          {\var{prefix}:Mac:PlugIns}
+          {\filevar{prefix}:Mac:PlugIns}
           {\filenq{Python:Mac:PlugIns}\XXX{???}}
           {}
 \end{tableiv}
@@ -298,8 +299,8 @@ being installed is pure Python or contains extensions (``non-pure''):
   any Unix-like system), the default \filevar{prefix} and
   \filevar{exec-prefix} are \file{/usr/local}.
 \item[(2)] The default installation directory on Windows was
-  \file{C:\textbackslash{}Program Files\textbackslash{}Python} under Python 1.6a1,
-  1.5.2, and earlier.
+  \file{C:\textbackslash{}Program Files\textbackslash{}Python} under
+  Python 1.6a1, 1.5.2, and earlier.
 \end{description}
 
 \filevar{prefix} and \filevar{exec-prefix} stand for the directories
@@ -397,9 +398,9 @@ option.  Lazy typists can just type a tilde (\code{\textasciitilde}); the
 python setup.py install --home=~
 \end{verbatim}
 
-The \longprogramopt{home} option defines the installation base directory.  Files
-are installed to the following directories under the installation base
-as follows:
+The \longprogramopt{home} option defines the installation base
+directory.  Files are installed to the following directories under the
+installation base as follows:
 \installscheme{home}{/lib/python}
               {home}{/lib/python}
               {home}{/bin}
@@ -438,30 +439,31 @@ could be done with
 /usr/local/bin/python setup.py install --prefix=/mnt/@server/export
 \end{verbatim}
 
-In either case, the \longprogramopt{prefix} option defines the installation
-base, and the \longprogramopt{exec-prefix} option defines the platform-specific
-installation base, which is used for platform-specific files.
-(Currently, this just means non-pure module distributions, but could be
-expanded to C libraries, binary executables, etc.)  If
-\longprogramopt{exec-prefix} is not supplied, it defaults to \longprogramopt{prefix}.
-Files are installed as follows:
+In either case, the \longprogramopt{prefix} option defines the
+installation base, and the \longprogramopt{exec-prefix} option defines
+the platform-specific installation base, which is used for
+platform-specific files.  (Currently, this just means non-pure module
+distributions, but could be expanded to C libraries, binary executables,
+etc.)  If \longprogramopt{exec-prefix} is not supplied, it defaults to
+\longprogramopt{prefix}.  Files are installed as follows:
 
 \installscheme{prefix}{/lib/python1.\filevar{X}/site-packages}
               {exec-prefix}{/lib/python1.\filevar{X}/site-packages}
               {prefix}{/bin}
               {prefix}{/share}
 
-There is no requirement that \longprogramopt{prefix} or \longprogramopt{exec-prefix}
-actually point to an alternate Python installation; if the directories
-listed above do not already exist, they are created at installation
-time.
+There is no requirement that \longprogramopt{prefix} or
+\longprogramopt{exec-prefix} actually point to an alternate Python
+installation; if the directories listed above do not already exist, they
+are created at installation time.
 
 Incidentally, the real reason the prefix scheme is important is simply
 that a standard Unix installation uses the prefix scheme, but with
-\longprogramopt{prefix} and \longprogramopt{exec-prefix} supplied by Python itself (as
-\code{sys.prefix} and \code{sys.exec\_prefix}).  Thus, you might think
-you'll never use the prefix scheme, but every time you run \code{python
-  setup.py install} without any other options, you're using it.
+\longprogramopt{prefix} and \longprogramopt{exec-prefix} supplied by
+Python itself (as \code{sys.prefix} and \code{sys.exec\_prefix}).  Thus,
+you might think you'll never use the prefix scheme, but every time you
+run \code{python setup.py install} without any other options, you're
+using it.
 
 Note that installing extensions to an alternate Python installation has
 no effect on how those extensions are built: in particular, the Python
@@ -472,8 +474,8 @@ used to run extensions installed in this way is compatibile with the
 interpreter used to build them.  The best way to do this is to ensure
 that the two interpreters are the same version of Python (possibly
 different builds, or possibly copies of the same build).  (Of course, if
-your \longprogramopt{prefix} and \longprogramopt{exec-prefix} don't even point to an
-alternate Python installation, this is immaterial.)
+your \longprogramopt{prefix} and \longprogramopt{exec-prefix} don't even
+point to an alternate Python installation, this is immaterial.)
 
 
 \subsection{Alternate installation: Windows}
@@ -481,18 +483,18 @@ alternate Python installation, this is immaterial.)
 
 Since Windows has no conception of a user's home directory, and since
 the standard Python installation under Windows is simpler than that
-under Unix, there's no point in having separate \longprogramopt{prefix} and
-\longprogramopt{home} options.  Just use the \longprogramopt{prefix} option to specify
-a base directory, e.g.
+under Unix, there's no point in having separate \longprogramopt{prefix}
+and \longprogramopt{home} options.  Just use the \longprogramopt{prefix}
+option to specify a base directory, e.g.
 \begin{verbatim}
 python setup.py install --prefix="\Temp\Python"
 \end{verbatim}
 to install modules to the \file{\textbackslash{}Temp} directory on the current
 drive.
 
-The installation base is defined by the \longprogramopt{prefix} option; the
-\longprogramopt{exec-prefix} option is not supported under Windows.  Files are
-installed as follows:
+The installation base is defined by the \longprogramopt{prefix} option;
+the \longprogramopt{exec-prefix} option is not supported under Windows.
+Files are installed as follows:
 \installscheme{prefix}{}
               {prefix}{}
               {prefix}{\textbackslash{}Scripts}
@@ -504,8 +506,8 @@ installed as follows:
 
 Like Windows, Mac~OS has no notion of home directories (or even of
 users), and a fairly simple standard Python installation.  Thus, only a
-\longprogramopt{prefix} option is needed.  It defines the installation base, and 
-files are installed under it as follows:
+\longprogramopt{prefix} option is needed.  It defines the installation
+base, and files are installed under it as follows:
 
 \XXX{how do MacPython users run the interpreter with command-line args?}
 
@@ -541,16 +543,16 @@ how you define a custom installation scheme.  These override options can
 be relative, absolute, or explicitly defined in terms of one of the
 installation base directories.  (There are two installation base
 directories, and they are normally the same---they only differ when you
-use the Unix ``prefix scheme'' and supply different \longprogramopt{prefix} and
-\longprogramopt{exec-prefix} options.)
+use the Unix ``prefix scheme'' and supply different
+\longprogramopt{prefix} and \longprogramopt{exec-prefix} options.)
 
 For example, say you're installing a module distribution to your home
 directory under Unix---but you want scripts to go in
-\file{\textasciitilde/scripts} rather than \file{\textasciitilde/bin}.  As you might
-expect, you can override this directory with the
-\longprogramopt{install-scripts} option; in this case, it makes most sense to
-supply a relative path, which will be interpreted relative to the
-installation base directory (your home directory, in this case):
+\file{\textasciitilde/scripts} rather than \file{\textasciitilde/bin}.
+As you might expect, you can override this directory with the
+\longprogramopt{install-scripts} option; in this case, it makes most
+sense to supply a relative path, which will be interpreted relative to
+the installation base directory (your home directory, in this case):
 \begin{verbatim}
 python setup.py install --home --install-scripts=scripts
 \end{verbatim}