runlisp.1.in: Fix a small formatting blunder.

[runlisp] / runlisp.1.in

diff --git a/runlisp.1.in b/runlisp.1.in
index 35378d4..67baa5a 100644 (file)
--- a/runlisp.1.in
+++ b/runlisp.1.in
@@ -64,6 +64,12 @@ runlisp \- run Common Lisp programs as scripts
 .IR form ]
 .RB [ \-l
 .IR file ]
 .IR form ]
 .RB [ \-l
 .IR file ]

+.RB [ \-p
+.IR form ]
+.if !t \{\
+.br
+       \c
+.\}

 .RB [ \-\- ]
 .RI [ arguments
 \*(..]
 .RB [ \-\- ]
 .RI [ arguments
 \*(..]


@@ -164,7 +170,6 @@ Negate with
 or
 .BR \-\-no-command-line-only .
 This has no effect in eval mode.
 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\*(..
 .
 .TP
 .BI "\-L" "\fR, " "\-\-accept-lisp=" sys , sys ,\fR\*(..


@@ -204,7 +209,9 @@ Evaluate the expression(s)
 .I expr
 and print the resulting value(s)
 to standard output
 .I expr
 and print the resulting value(s)
 to standard output

-(as if by
+(with
+.B *print-escape*
+true, as if by

 .BR prin1 ).
 If a form produces multiple values,
 they are printed on a single line,
 .BR prin1 ).
 If a form produces multiple values,
 they are printed on a single line,


@@ -216,6 +223,11 @@ This option causes
 to execute in
 .I eval
 mode.
 to execute in
 .I eval
 mode.

+See also
+.RB ` \-p ',
+which prints with
+.B *print-escape*
+false.

 .
 .TP
 .BI "\-e" "\fR, " "\-\-evaluate-expression=" expr
 .
 .TP
 .BI "\-e" "\fR, " "\-\-evaluate-expression=" expr


@@ -266,6 +278,32 @@ and overrides any similarly named setting
 from the configuration file(s).
 .
 .TP
 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
+(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;
+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 ` \-d ',
+which prints with
+.B *print-escape*
+true.
+.
+.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:


@@ -292,11 +330,12 @@ Higher verbosity levels print informational and debugging messages.
 The
 .RB ` \-d ',
 .RB ` \-e ',
 The
 .RB ` \-d ',
 .RB ` \-e ',

+.RB ` \-l ',

 and
 and

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

 options may only be given on the command-line itself,
 not following a
 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.
 marker in a script.
 These options may be given multiple times:
 they will be processed in the order given.


@@ -308,7 +347,7 @@ instead, use
 to load code from files.
 The
 .IR arguments ,
 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"
 are still made available to the evaluated forms and loaded files.
 .
 .SS "Operation"


@@ -325,8 +364,9 @@ if desired.
 If the command line contains any of
 .RB ` \-d ',
 .RB ` \-e ',
 If the command line contains any of
 .RB ` \-d ',
 .RB ` \-e ',

-or

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

+or
+.RB ` \-p ',

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


@@ -348,6 +388,9 @@ mode.
 In
 .I script
 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
 .B runlisp
 reads the second line of the script file,
 and checks to see if it contains the string


@@ -424,8 +467,9 @@ is now committed to
 mode, so it's too late for
 .RB ` \-d ',
 .RB ` \-e ',
 mode, so it's too late for
 .RB ` \-d ',
 .RB ` \-e ',

+.RB ` \-l ',

 and
 and

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

 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