Home My Page Projects Code Snippets Project Openings SML/NJ
 Summary Activity Forums Tracker Lists Tasks Docs Surveys News SCM Files

SCM Repository

[smlnj] Diff of /sml/trunk/src/cm/Doc/D-envvar.tex
 [smlnj] / sml / trunk / src / cm / Doc / D-envvar.tex

Diff of /sml/trunk/src/cm/Doc/D-envvar.tex

revision 1211, Tue May 21 14:54:32 2002 UTC revision 1212, Tue May 21 16:34:29 2002 UTC
# Line 8  Line 8
8  Default settings are determined at bootstrap time, i.e., the time when  Default settings are determined at bootstrap time, i.e., the time when
9  the heap image for SML/NJ's interactive system is  the heap image for SML/NJ's interactive system is
10  built.\footnote{Normally this is the same as installation time, but  built.\footnote{Normally this is the same as installation time, but
11  for SML/NJ compiler hackers there is also a {\tt makeml} script for the  for SML/NJ compiler hackers there is also a {\tt makeml} script for
12  purpose of bootstrapping.}  At bootstrap time, it is possible to  the purpose of bootstrapping.}  At bootstrap time, it is possible to
13  adjust defaults by using a different set of environment variables  adjust defaults by using a set of environment variables $v_b$.  In the
14  $v_b$.  If neither $v_s$ nor $v_b$ were set, a hard-wired fallback  current version of CM it is always the case that $v_s = v_b$.  (In
15  value will be used.  older versions this was not the case.) If neither $v_s$ nor $v_b$ were
16    set, a hard-wired fallback value will be used.
17
18  The rule for constructing (the names of) $v_s$ and $v_b$ is the  The rule for constructing the name $v_s$ (and $v_b$) is the
19  following: For each adjustable parameter $x$ there is a {\em name  following: For each adjustable parameter $x$ there is a {\em name
20  stem}.  If the stem for $x$ is $s$, then $v_s = \mbox{\tt CM\_}s$ and  stem}.  If the stem for $x$ is $s$, then $v_s = v_b = \mbox{\tt CM\_}s$.
$v_b = v_s\mbox{\tt \_DEFAULT}$.
21
22  Since the normal installation procedure for SML/NJ sets some of the  Since the normal installation procedure for SML/NJ sets some of the
23  $v_b$ variables at bootstrap time, there are two columns with default  $v_b$ variables at bootstrap time, there are two columns with default
# Line 29  Line 29
29  To save space, the table lists the stem but not the names for its  To save space, the table lists the stem but not the names for its
30  associated (longer) $v_s$ and $v_b$.  For example, since the the table  associated (longer) $v_s$ and $v_b$.  For example, since the the table
31  shows {\tt VERBOSE} in the row for {\tt CM.Control.verbose}, CM's  shows {\tt VERBOSE} in the row for {\tt CM.Control.verbose}, CM's
32  per-session verbosity can be adjusted using {\tt CM\_VERBOSE} and the  per-session verbosity can be adjusted using {\tt CM\_VERBOSE}.
boot-time default can be set using {\tt CM\_VERBOSE\_DEFAULT}.
33
34  \begin{center}  \begin{center}
35  \begin{small}  \begin{small}
# Line 67  Line 66
66  The default for the local'' path configuration file is {\tt  The default for the local'' path configuration file is {\tt
67  .smlnj-pathconfig}. This file is located in the user's home directory  .smlnj-pathconfig}. This file is located in the user's home directory
68  (given by the environment variable {\tt \$HOME}). (given by the environment variable {\tt \$HOME}).
69
70    Control parameters can also be set using command-line parameters (see
71    section~\ref{sec:cmdline}).

Legend:
 Removed from v.1211 changed lines Added in v.1212