debian/: Add packaging support.

[runlisp] / runlisp.conf.5.in

diff --git a/runlisp.conf.5.in b/runlisp.conf.5.in
index 64cbe38..48b692f 100644 (file)
--- a/runlisp.conf.5.in
+++ b/runlisp.conf.5.in
@@ -39,7 +39,7 @@
 .IP
 \h'-\w'\fB\\$1\ \fP'u'\fB\\$1\ \fP\c
 ..
 .IP
 \h'-\w'\fB\\$1\ \fP'u'\fB\\$1\ \fP\c
 ..

-.ds , \h'.16667m'
+.ds .. \&.\|.\|.

 .
 .\"--------------------------------------------------------------------------
 .TH runlisp.conf 5 "27 August 2020" "Mark Wooding"
 .
 .\"--------------------------------------------------------------------------
 .TH runlisp.conf 5 "27 August 2020" "Mark Wooding"


@@ -227,7 +227,7 @@ together with the contents of the subsequent lines;
 initial and trailing whitespace is removed from each piece,
 and the (nonempty) pieces are joined,
 separated by single spaces.
 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.
 assigns a value to the variable
 in some section \(en
 namely, the section in which the assignment is applied.


@@ -359,7 +359,7 @@ takes the form
 .IB sect : \c
 .RI ] var \c
 .RB [ | \c
 .IB sect : \c
 .RI ] var \c
 .RB [ | \c

-.IR filter ]... \c
+.IR filter ]\*(.. \c

 .RB [ ? \c
 .IR alt ] \c
 .BR } .
 .RB [ ? \c
 .IR alt ] \c
 .BR } .


@@ -549,6 +549,19 @@ section,
 or a value determined at compile time.
 .
 .TP
 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
 .B @image-dir
 The directory in which
 .B runlisp


@@ -566,6 +579,13 @@ section,
 or a value determined at compile time.
 .
 .TP
 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)
 .B @image-new
 Set by
 .BR dump-runlisp-image (1)


@@ -577,6 +597,14 @@ will rename the image into place itself,
 if the command completes successfully.)
 .
 .TP
 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)
 .B @image-out
 Set by
 .BR dump-runlisp-image (1)