runlisp.c, etc.: Rename `-p' to `-d'. COMPAT

[runlisp] / runlisp.1.in

diff --git a/runlisp.1.in b/runlisp.1.in
index 65c6543..35378d4 100644 (file)
--- a/runlisp.1.in
+++ b/runlisp.1.in
@@ -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 ]
 .br
 .B runlisp
 .RI [ options ]

+.RB [ \-d
+.IR form ]

 .RB [ \-e
 .RB [ \-e

-.IR form  ]
+.IR form ]

 .RB [ \-l
 .IR file ]
 .RB [ \-l
 .IR file ]

-.RB [ \-p
-.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


@@ -194,6 +199,25 @@ All of the files are expected to be as described in
 .BR runlisp.conf (5).
 .
 .TP
 .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
+(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.
+.
+.TP

 .BI "\-e" "\fR, " "\-\-evaluate-expression=" expr
 Evaluate the expression(s)
 .I expr
 .BI "\-e" "\fR, " "\-\-evaluate-expression=" expr
 Evaluate the expression(s)
 .I expr


@@ -227,23 +251,19 @@ or
 .BR "\-\-no-dry-run" .
 .
 .TP
 .BR "\-\-no-dry-run" .
 .
 .TP

-.BI "\-p" "\fR, " "\-\-print-expressin=" expr
-Evaluate the expression(s)
-.I expr
-and print the resulting value(s)
-to standard output
-(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.
+.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
 .BR "\-q" ", " "\-\-quiet"
 .
 .TP
 .BR "\-q" ", " "\-\-quiet"


@@ -270,10 +290,10 @@ Higher verbosity levels print informational and debugging messages.
 .
 .PP
 The
 .
 .PP
 The

+.RB ` \-d ',

 .RB ` \-e ',
 .RB ` \-e ',

-.RB ` \-l ',

 and
 and

-.RB ` \-p '
+.RB ` \-l '

 options may only be given on the command-line itself,
 not following a
 .RB `@ RUNLISP: '
 options may only be given on the command-line itself,
 not following a
 .RB `@ RUNLISP: '


@@ -303,10 +323,10 @@ though the boundary may be marked explicitly using
 .RB ` \-\- '
 if desired.
 If the command line contains any of
 .RB ` \-\- '
 if desired.
 If the command line contains any of

+.RB ` \-d ',

 .RB ` \-e ',
 .RB ` \-e ',

-.RB ` \-l ',

 or
 or

-.RB ` \-p ',
+.RB ` \-l ',

 then
 .B runlisp
 treats all of its positional arguments as
 then
 .B runlisp
 treats all of its positional arguments as


@@ -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.


@@ -402,10 +422,10 @@ and
 is now committed to
 .I script
 mode, so it's too late for
 is now committed to
 .I script
 mode, so it's too late for

+.RB ` \-d ',

 .RB ` \-e ',
 .RB ` \-e ',

-.RB ` \-l ',

 and
 and

-.RB ` \-p '
+.RB ` \-l '

 too.
 .PP
 (This feature allows scripts to provide options even if they use
 too.
 .PP
 (This feature allows scripts to provide options even if they use