dump-runlisp-image.1.in, runlisp.1.in: Document the `-o' option.

[runlisp] / dump-runlisp-image.1.in

diff --git a/dump-runlisp-image.1.in b/dump-runlisp-image.1.in
index 6c433f421fa951b1efb2629f47896d58d9db3b6a..8f2bcc8a6f27a7688d34f2a9050229753f0e2354 100644 (file)
--- a/dump-runlisp-image.1.in
+++ b/dump-runlisp-image.1.in
@@ -55,7 +55,7 @@ dump-runlisp-image \- dump Lisp images for faster script execution
 .RB [ \-O
 .IR output ]
 .br
 .RB [ \-O
 .IR output ]
 .br

-       \&
+       \c

 .RB [ \-c
 .IR conf ]
 .RB [ \-o
 .RB [ \-c
 .IR conf ]
 .RB [ \-o


@@ -103,27 +103,6 @@ to standard output
 and immediately exit with status 0.
 .
 .TP
 and immediately exit with status 0.
 .
 .TP

-.BR "\-R" ", " "\-\-remove-other"
-After processing the selected Lisp implementations,
-delete all of the image files corresponding to other Lisps
-defined in the configuration.
-Negate with
-.B +R
-or
-.BR \-\-no-remove-other .
-.
-.TP
-.BR "\-U" ", " "\-\-remove-unknown"
-After processing the selected Lisp implementations,
-delete all of the files in the image directory which
-.I aren't
-image files of a configured Lisp implementation.
-Negate with
-.B +U
-or
-.BR \-\-no-remove-unknown .
-.
-.TP

 .BI "\-O" "\fR, " "\-\-output=" output
 If
 .I output
 .BI "\-O" "\fR, " "\-\-output=" output
 If
 .I output


@@ -145,10 +124,31 @@ images are written to the directory in which
 .BR runlisp (1)
 will look in when checking for custom images:
 run
 .BR runlisp (1)
 will look in when checking for custom images:
 run

-.B query-runlisp-config -x@image-dir
+.B query-runlisp-config \-x@image-dir

 to see the default setting.
 .
 .TP
 to see the default setting.
 .
 .TP

+.BR "\-R" ", " "\-\-remove-other"
+After processing the selected Lisp implementations,
+delete all of the image files corresponding to other Lisps
+defined in the configuration.
+Negate with
+.B +R
+or
+.BR \-\-no-remove-other .
+.
+.TP
+.BR "\-U" ", " "\-\-remove-unknown"
+After processing the selected Lisp implementations,
+delete all of the files in the image directory which
+.I aren't
+image files of a configured Lisp implementation.
+Negate with
+.B +U
+or
+.BR \-\-no-remove-unknown .
+.
+.TP

 .BR "\-a" ", " "\-\-all-configured"
 Select all configured Lisp implementations.
 You must either list Lisp implementations explicitly on the command line
 .BR "\-a" ", " "\-\-all-configured"
 Select all configured Lisp implementations.
 You must either list Lisp implementations explicitly on the command line


@@ -170,7 +170,7 @@ are loaded, in ascending lexicographical order;
 otherwise,
 .I conf
 is opened as a file.
 otherwise,
 .I conf
 is opened as a file.

-All of the files are expected to as described in
+All of the files are expected to be as described in

 .BR runlisp.conf (5).
 .
 .TP
 .BR runlisp.conf (5).
 .
 .TP


@@ -218,7 +218,7 @@ Lisp implementations in parallel.
 The default is to run the jobs sequentially.
 .
 .TP
 The default is to run the jobs sequentially.
 .
 .TP

-.BR "\-n" ", " "-\-dry-run"
+.BR "\-n" ", " "\-\-dry-run"

 Don't actually run any commands to dump images.
 This may be helpful for the curious,
 in conjunction with
 Don't actually run any commands to dump images.
 This may be helpful for the curious,
 in conjunction with


@@ -230,6 +230,21 @@ or
 .BR "\-\-no-dry-run" .
 .
 .TP
 .BR "\-\-no-dry-run" .
 .
 .TP

+.BI "\-o" "\fR, " "\-\-set-option=\fR[" sect "\fR]\fB:" var = value
+Assign
+.I value
+to the variable
+.I var
+in configuration section
+.IR sect ,
+or
+.B @CONFIG
+if no section is specified.
+The value is unexpandable,
+and overrides any similarly named setting
+from the configuration file(s).
+.
+.TP

 .BR "\-q" ", " "\-\-quiet"
 Don't print warning messages.
 This option may be repeated:
 .BR "\-q" ", " "\-\-quiet"
 Don't print warning messages.
 This option may be repeated: