.IP
\h'-\w'\fB\\$1\ \fP'u'\fB\\$1\ \fP\c
..
-.ds , \h'.16667m'
+.ds .. \&.\|.\|.
.
.\"--------------------------------------------------------------------------
.TH runlisp.conf 5 "27 August 2020" "Mark Wooding"
initial and trailing whitespace is removed from each piece,
and the (nonempty) pieces are joined,
separated by single spaces.
-We say that a assignment
+We say that an assignment
assigns a value to the variable
in some section \(en
namely, the section in which the assignment is applied.
is assigned the value
.RB ` "one two ; not a comment three" ',
and
-.B short is assigned
+.B short
+is assigned
.RB ` "just a quick note" '.
.PP
The assignments applied to a section
.B @ENV
sections have no parents.
The
-.B @CONFIG
+.B @COMMON
section has one parent, namely
.BR @BUILTIN .
.PP
If the variable
.B @parents
is set in a section other than one of those named above,
-then it must consist of a space- or comma-separated list
+then it must consist of a space- and/or comma-separated list
of names,
which name the section's parents.
Currently, the parents need not be distinct,
.IB sect : \c
.RI ] var \c
.RB [ | \c
-.IR filter ]... \c
+.IR filter ]\*(.. \c
.RB [ ? \c
.IR alt ] \c
.BR } .
is encountered,
then a word is started if there is none currently under construction.
Until the next double quote is encountered,
-whitespace and single quotes treated literally,
+whitespace and single quotes are treated literally,
and simply added to the current word;
backslashes can be used to escape characters,
such as double quotes,
so that the result is subject to word splitting,
then an error is reported if a new word is started
without there being whitespace between the closing brace of the
-.B $ -expansion
+.BR $ -expansion
and the character which started the new word.
For example,
.IP
.SS "Predefined variables in @BUILTIN"
The
.B @BULITIN
-Section has no parents.
+section has no parents.
You should not override its settings in configuration files.
-it holds a number of variables set by the
+It holds a number of variables set by the
.B runlisp
programs.
.
or a value determined at compile time.
.
.TP
+.B @hash
+Set by
+.BR dump-runlisp-image (1)
+to the hash
+(a string of hexadecimal digits)
+identifying the versions of the Lisp code included
+\(en or to be included \(en
+in a custom image.
+This is constructed by hashing the result of evaluating the
+.B lisp-version
+expression in the system definition.
+.
+.TP
.B @image-dir
The directory in which
.B runlisp
or a value determined at compile time.
.
.TP
+.B @image-link
+The well-known name of the image;
+actually a symbolic link to the `real' image file,
+whose name includes a hash
+which identifies the versions of the Lisp code included in the image.
+.
+.TP
.B @image-new
Set by
.BR dump-runlisp-image (1)
if the command completes successfully.)
.
.TP
+.B @image-newlink
+Set by
+.BR dump-runlisp-image (1)
+to the name to use for the updated symbolic link to the image file.
+This is used internally,
+and is not expected to be useful in Lisp system definitions.
+.
+.TP
.B @image-out
Set by
.BR dump-runlisp-image (1)
section instead.
.
.TP
-.B @image-dir
+.B image-dir
The directory in which
.B runlisp
looks for, and
.B @image-dir
is set in the
.B @BUILTIN
-section
-.RB ( @image-dir
-is set in the
-.N @BUILTIN
section \(en see above \(en and
.B image-file
must be set in this section