X-Git-Url: https://git.distorted.org.uk/~mdw/runlisp/blobdiff_plain/10427eb21d77a0edeb2f17e434515b91b420cdfb..d586960a855552cb9c96cc5d670b123af82e7d05:/runlisp.1.in

diff --git a/runlisp.1.in b/runlisp.1.in
index 00b06fb..67baa5a 100644
--- a/runlisp.1.in
+++ b/runlisp.1.in
@@ -39,6 +39,7 @@
 .IP
 \h'-\w'\fB\\$1\ \fP'u'\fB\\$1\ \fP\c
 ..
+.ds .. \&.\|.\|.
 .
 .\"--------------------------------------------------------------------------
 .TH runlisp 1 "2 August 2020" "Mark Wooding"
@@ -53,29 +54,39 @@ runlisp \- run Common Lisp programs as scripts
 .RB [ \-\- ]
 .I script
 .RI [ arguments
-\&...]
+\*(..]
 .br
 .B runlisp
 .RI [ options ]
+.RB [ \-d
+.IR form ]
 .RB [ \-e
-.IR form  ]
+.IR form ]
 .RB [ \-l
 .IR file ]
 .RB [ \-p
-.IR form  ]
+.IR form ]
+.if !t \{\
+.br
+	\c
+.\}
 .RB [ \-\- ]
 .RI [ arguments
-\&...]
+\*(..]
 .PP
 where
 .I options
 is
 .br
-	\&
+	\c
 .RB [ \-CDEnqv ]
 .RB [ +DEn ]
 .RB [ \-L
-.IB sys , sys , \fR...]
+.IB sys , sys , \fR\*(..]
+.if !t \{\
+.br
+	\c
+.\}
 .RB [ \-c
 .IR conf ]
 .RB [ \-o
@@ -159,10 +170,9 @@ Negate with
 or
 .BR \-\-no-command-line-only .
 This has no effect in eval mode.
-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
@@ -190,10 +200,36 @@ are loaded, in ascending lexicographical order;
 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
+.BI "\-d" "\fR, " "\-\-dump-expression=" expr
+Evaluate the expression(s)
+.I expr
+and print the resulting value(s)
+to standard output
+(with
+.B *print-escape*
+true, as if by
+.BR prin1 ).
+If a form produces multiple values,
+they are printed on a single line,
+separated by a single space character;
+if a form produces no values at all,
+then nothing is printed \(en not even a newline character.
+This option causes
+.B runlisp
+to execute in
+.I eval
+mode.
+See also
+.RB ` \-p ',
+which prints with
+.B *print-escape*
+false.
+.
+.TP
 .BI "\-e" "\fR, " "\-\-evaluate-expression=" expr
 Evaluate the expression(s)
 .I expr
@@ -215,7 +251,7 @@ to execute in
 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
@@ -227,13 +263,30 @@ or
 .BR "\-\-no-dry-run" .
 .
 .TP
-.BI "\-p" "\fR, " "\-\-print-expressin=" expr
+.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-expression=" expr
 Evaluate the expression(s)
 .I expr
 and print the resulting value(s)
 to standard output
-(as if by
-.BR prin1 ).
+(with
+.B *print-escape*
+false, as if by
+.BR princ ).
 If a form produces multiple values,
 they are printed on a single line,
 separated by a single space character;
@@ -244,6 +297,11 @@ This option causes
 to execute in
 .I eval
 mode.
+See also
+.RB ` \-d ',
+which prints with
+.B *print-escape*
+true.
 .
 .TP
 .BR "\-q" ", " "\-\-quiet"
@@ -270,13 +328,14 @@ Higher verbosity levels print informational and debugging messages.
 .
 .PP
 The
+.RB ` \-d ',
 .RB ` \-e ',
 .RB ` \-l ',
 and
 .RB ` \-p '
 options may only be given on the command-line itself,
 not following a
-.RB `@ RUNLISP: '
+.RB ` @RUNLISP: '
 marker in a script.
 These options may be given multiple times:
 they will be processed in the order given.
@@ -288,7 +347,7 @@ instead, use
 to load code from files.
 The
 .IR arguments ,
-ppif any,
+if any,
 are still made available to the evaluated forms and loaded files.
 .
 .SS "Operation"
@@ -303,6 +362,7 @@ though the boundary may be marked explicitly using
 .RB ` \-\- '
 if desired.
 If the command line contains any of
+.RB ` \-d ',
 .RB ` \-e ',
 .RB ` \-l ',
 or
@@ -328,6 +388,9 @@ mode.
 In
 .I script
 mode,
+and if the
+.RB ` \-E '
+option was not given,
 .B runlisp
 reads the second line of the script file,
 and checks to see if it contains the string
@@ -347,10 +410,10 @@ can be included in a word by
 or
 .IR escaping .
 Text between single quotes
-.BR ' ... '
+.BR ' \*(.. '
 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.
@@ -402,6 +465,7 @@ and
 is now committed to
 .I script
 mode, so it's too late for
+.RB ` \-d ',
 .RB ` \-e ',
 .RB ` \-l ',
 and
@@ -447,7 +511,7 @@ If any
 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