1 |
%$Header: /cvsroot/esrg/sfesrg/esrgpcpj/doc/engman01/c_rsi0/c_rsi0.tex,v 1.2 2002/07/29 16:53:09 dtashley Exp $
|
2 |
%
|
3 |
\chapter{Required Software Installations}
|
4 |
\label{crsi0}
|
5 |
|
6 |
The build process for Windows executables, Linux executables,
|
7 |
Windows InstallShield Express installation executables,
|
8 |
and \LaTeX{} documents requires many pieces of software.
|
9 |
Some of this software is free, and some is commercial
|
10 |
(and quite expensive). In this chapter we describe
|
11 |
all software required \emph{The \tsname{}} and all supporting
|
12 |
documentation on both Windows and *Nix platforms. Note that
|
13 |
depending on what is being built, not all software may
|
14 |
be required.
|
15 |
|
16 |
|
17 |
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
18 |
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
19 |
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
20 |
\section{Windows Software}
|
21 |
\label{crsi0:swso0}
|
22 |
|
23 |
|
24 |
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
25 |
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
26 |
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
27 |
\subsection{Adobe Acrobat Version 4.0}
|
28 |
\label{crsi0:swso0:saaf0}
|
29 |
|
30 |
\index{Adobe!Acrobat}\index{Adobe!Acrobat Distiller}
|
31 |
\emph{Adobe Acrobat}, which costs abour \$250, contains a program
|
32 |
called \emph{Acrobat Distiller}.
|
33 |
Acrobat Distiller
|
34 |
is the best application
|
35 |
we've found for
|
36 |
creating \index{.PDF file@\texttt{.PDF} file}\texttt{.PDF} files from
|
37 |
\LaTeX{} source code. The most successful
|
38 |
conversion approach seems to be
|
39 |
to create an output file for a PostScript printer,
|
40 |
then to use Acrobat Distiller to convert it to
|
41 |
\texttt{.PDF}.
|
42 |
|
43 |
To the best of our knowledge, it is not possible to purchase
|
44 |
Acrobat Distiller separate from Adobe Acrobat---Adobe
|
45 |
Acrobat must be purchased in order to obtain Acrobat Distiller.
|
46 |
|
47 |
When Adobe Acrobat is installed, all of the installation defaults
|
48 |
should be accepted. \index{Tcl/Tk@\emph{Tcl/Tk}}Tcl/Tk
|
49 |
scripts and \index{.BAT file@\texttt{.BAT} file} \texttt{.BAT}
|
50 |
files used in building \emph{The \tsname{}} rely on the
|
51 |
executables being in the default locations.
|
52 |
|
53 |
|
54 |
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
55 |
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
56 |
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
57 |
\subsection{\tsname{} Version \tsversion{}}
|
58 |
\label{crsi0:swso0:sets0}
|
59 |
|
60 |
%Note: must hard code in the index entry below: reason is processing
|
61 |
% order of MAKEINDEX and LATEX. As it is below, a global name
|
62 |
% change will get correct
|
63 |
|
64 |
\index{ESRG Tool Set@\emph{\tsname{}}}
|
65 |
The \index{Tcl/Tk@\emph{Tcl/Tk}}Tcl/Tk interpreter
|
66 |
(\index{EsrgConsole@\emph{EsrgConsole}}\emph{EsrgConsole},
|
67 |
the statically linked version
|
68 |
of \index{Wish@\emph{Wish}}\emph{Wish}, with extensions)
|
69 |
from \emph{The \tsname{}} is necessary to build
|
70 |
\emph{The \tsname{}} on Windows platforms. Thus, \emph{The \tsname{}}
|
71 |
is necessary to build \emph{The \tsname{}}.
|
72 |
|
73 |
At the present time, EsrgConsole is used only in the production
|
74 |
of the companion book. However, in future revisions of
|
75 |
the tool set, the build complexity may become great enough that
|
76 |
it is used in the production of the Windows executables.
|
77 |
|
78 |
When installing \emph{The \tsname{}}, it is not necessary to
|
79 |
install the entire tool set---only the statically linked
|
80 |
Tcl/Tk interpreter (EsrgConsole) is required. Copying the executable
|
81 |
from one computer to another will usually be adequate. It is also not
|
82 |
necessary that the executable go in a certain place, since starting
|
83 |
the script interpreter is always a manual step in the build process.
|
84 |
No specific version of EsrgConsole relative to the version of the
|
85 |
tool set being built is \emph{actually} required; but
|
86 |
because it is not a good idea to allow freedom in the build process,
|
87 |
we canonically require that the version of EsrgConsole used for builds
|
88 |
should be the last stable release before the version being built.
|
89 |
|
90 |
|
91 |
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
92 |
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
93 |
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
94 |
\subsection{InstallShield Express Version 3.03}
|
95 |
\label{crsi0:swso0:sise0}
|
96 |
|
97 |
\index{InstallShield Express@\emph{InstallShield Express}}
|
98 |
\emph{InstallShield Express}, which costs about
|
99 |
\$200, is the program used to create
|
100 |
the installation executable for Windows platforms.
|
101 |
|
102 |
Version 3.00 of the program contained some serious bugs, which were
|
103 |
corrected in subsequent maintenance releases. At the time of this
|
104 |
writing, Version 3.03 is the most modern maintenance release.
|
105 |
|
106 |
When installing InstallShield Express, if the installation media
|
107 |
(typically a CD) are for a version earlier than version 3.03, it is
|
108 |
recommended to download maintenance release 3.03 from
|
109 |
Installshield's web site and to install the maintenance release
|
110 |
without first installing from the installation media (note that the
|
111 |
maintenance release will require the serial number from the installation
|
112 |
media). The reason for this recommendation is that the maintenance release
|
113 |
is standalone and just writes over earlier versions, anyway.
|
114 |
When installing InstallShield Express, it is not required that
|
115 |
installation defaults be accepted. The generation of
|
116 |
Windows installation executables is at this time a manual process,
|
117 |
and no \index{Tcl/Tk@\emph{Tcl/Tk}}Tcl/Tk
|
118 |
scripts or \index{.BAT file@\texttt{.BAT} file} \texttt{.BAT}
|
119 |
files rely on the location of the InstallShield Express executables.
|
120 |
|
121 |
|
122 |
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
123 |
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
124 |
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
125 |
\section{*Nix Software}
|
126 |
\label{crsi0:snix0}
|
127 |
|
128 |
|
129 |
|
130 |
|
131 |
|
132 |
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
133 |
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
134 |
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
135 |
\noindent\begin{figure}[!b]
|
136 |
\noindent\rule[-0.25in]{\textwidth}{1pt}
|
137 |
\begin{tiny}
|
138 |
\begin{verbatim}
|
139 |
$RCSfile: c_rsi0.tex,v $
|
140 |
$Source: /cvsroot/esrg/sfesrg/esrgpcpj/doc/engman01/c_rsi0/c_rsi0.tex,v $
|
141 |
$Revision: 1.2 $
|
142 |
$Author: dtashley $
|
143 |
$Date: 2002/07/29 16:53:09 $
|
144 |
\end{verbatim}
|
145 |
\end{tiny}
|
146 |
\noindent\rule[0.25in]{\textwidth}{1pt}
|
147 |
\end{figure}
|
148 |
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
149 |
%$Log: c_rsi0.tex,v $
|
150 |
%Revision 1.2 2002/07/29 16:53:09 dtashley
|
151 |
%Safety checkins before being moved to WSU server Kalman.
|
152 |
%
|
153 |
%Revision 1.1 2002/06/25 02:24:21 dtashley
|
154 |
%Initial checkin.
|
155 |
%
|
156 |
%End of C_RSI0.TEX.
|