tests.at: Add a test confirming that expressions are printed escapily.
[runlisp] / runlisp.1.in
index 00b06fb..119c4e0 100644 (file)
@@ -39,6 +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 .. \&.\|.\|.
 .
 .\"--------------------------------------------------------------------------
 .TH runlisp 1 "2 August 2020" "Mark Wooding"
 .
 .\"--------------------------------------------------------------------------
 .TH runlisp 1 "2 August 2020" "Mark Wooding"
@@ -53,29 +54,33 @@ runlisp \- run Common Lisp programs as scripts
 .RB [ \-\- ]
 .I script
 .RI [ arguments
 .RB [ \-\- ]
 .I script
 .RI [ arguments
-\&...]
+\*(..]
 .br
 .B runlisp
 .RI [ options ]
 .RB [ \-e
 .br
 .B runlisp
 .RI [ options ]
 .RB [ \-e
-.IR form  ]
+.IR form ]
 .RB [ \-l
 .IR file ]
 .RB [ \-p
 .RB [ \-l
 .IR file ]
 .RB [ \-p
-.IR form  ]
+.IR form ]
 .RB [ \-\- ]
 .RI [ arguments
 .RB [ \-\- ]
 .RI [ arguments
-\&...]
+\*(..]
 .PP
 where
 .I options
 is
 .br
 .PP
 where
 .I options
 is
 .br
-       \&
+       \c
 .RB [ \-CDEnqv ]
 .RB [ +DEn ]
 .RB [ \-L
 .RB [ \-CDEnqv ]
 .RB [ +DEn ]
 .RB [ \-L
-.IB sys , sys , \fR...]
+.IB sys , sys , \fR\*(..]
+.if !t \{\
+.br
+       \c
+.\}
 .RB [ \-c
 .IR conf ]
 .RB [ \-o
 .RB [ \-c
 .IR conf ]
 .RB [ \-o
@@ -162,7 +167,7 @@ This has no effect in eval mode.
 which is set at compile time.
 .
 .TP
 which is set at compile time.
 .
 .TP
-.BI "\-L" "\fR, " "\-\-accept-lisp=" sys , sys ,\fR...
+.BI "\-L" "\fR, " "\-\-accept-lisp=" sys , sys ,\fR\*(..
 Use one of the named Lisp systems.
 Each
 .I sys
 Use one of the named Lisp systems.
 Each
 .I sys
@@ -190,7 +195,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
@@ -215,7 +220,7 @@ to execute in
 mode.
 .
 .TP
 mode.
 .
 .TP
-.BR "\-n" ", " "-\-dry-run"
+.BR "\-n" ", " "\-\-dry-run"
 Don't actually start the Lisp environment.
 This may be helpful for the curious,
 in conjunction with
 Don't actually start the Lisp environment.
 This may be helpful for the curious,
 in conjunction with
@@ -227,6 +232,21 @@ or
 .BR "\-\-no-dry-run" .
 .
 .TP
 .BR "\-\-no-dry-run" .
 .
 .TP
+.BI "\-o" "\fR, " "\-\-set-option=\fR[" sect :\fR] 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
 .BI "\-p" "\fR, " "\-\-print-expressin=" expr
 Evaluate the expression(s)
 .I expr
 .BI "\-p" "\fR, " "\-\-print-expressin=" expr
 Evaluate the expression(s)
 .I expr
@@ -347,10 +367,10 @@ can be included in a word by
 or
 .IR escaping .
 Text between single quotes
 or
 .IR escaping .
 Text between single quotes
-.BR ' ... '
+.BR ' \*(.. '
 is included literally, without any further interpretation;
 text between double quotes
 is included literally, without any further interpretation;
 text between double quotes
-.BR """" ... """"
+.BR """" \*(.. """"
 is treated literally,
 except that escaping can still be used
 to escape (e.g.) double quotes and the escape character itself.
 is treated literally,
 except that escaping can still be used
 to escape (e.g.) double quotes and the escape character itself.
@@ -447,7 +467,7 @@ If any
 options have been found,
 then the list of acceptable implementations
 consists of all of the implementations mentioned in
 options have been found,
 then the list of acceptable implementations
 consists of all of the implementations mentioned in
-.RB ` -L '
+.RB ` \-L '
 options
 in any of the places
 .B runlisp
 options
 in any of the places
 .B runlisp