runlisp.c, eval.lisp, etc.: Add new `-p' option to `princ' expressions.

[runlisp] / runlisp.1.in

diff --git a/runlisp.1.in b/runlisp.1.in
index 35378d4..d262389 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 ]
+.RB [ \-p
+.IR form ]
+.if !t \{\
+.br
+       \c
+.\}
 .RB [ \-\- ]
 .RI [ arguments
 \*(..]
@@ -204,7 +210,9 @@ Evaluate the expression(s)
 .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,
@@ -216,6 +224,11 @@ This option causes
 to execute in
 .I eval
 mode.
+See also
+.RB ` \-p ',
+which prints with
+.B *print-escape*
+false.
 .
 .TP
 .BI "\-e" "\fR, " "\-\-evaluate-expression=" expr
@@ -266,6 +279,32 @@ 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
+(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:
@@ -292,8 +331,9 @@ Higher verbosity levels print informational and debugging messages.
 The
 .RB ` \-d ',
 .RB ` \-e ',
+.RB ` \-l ',
 and
-.RB ` \-l '
+.RB ` \-p '
 options may only be given on the command-line itself,
 not following a
 .RB `@ RUNLISP: '
@@ -325,8 +365,9 @@ if desired.
 If the command line contains any of
 .RB ` \-d ',
 .RB ` \-e ',
-or
 .RB ` \-l ',
+or
+.RB ` \-p ',
 then
 .B runlisp
 treats all of its positional arguments as
@@ -424,8 +465,9 @@ is now committed to
 mode, so it's too late for
 .RB ` \-d ',
 .RB ` \-e ',
+.RB ` \-l ',
 and
-.RB ` \-l '
+.RB ` \-p '
 too.
 .PP
 (This feature allows scripts to provide options even if they use