From: Mark Wooding <mdw@distorted.org.uk>
Date: Sun, 3 Mar 2024 16:27:32 +0000 (+0000)
Subject: README.org: Clarify and fix the discussion of `-p', mentioning `-d'.
X-Git-Url: https://git.distorted.org.uk/~mdw/runlisp/commitdiff_plain/86ae6147fd72d40606ad3b46db133bfb73d7573d

README.org: Clarify and fix the discussion of `-p', mentioning `-d'.

Also give an example of the difference.
---

diff --git a/README.org b/README.org
index 30aab1f..b59221a 100644
--- a/README.org
+++ b/README.org
@@ -151,20 +151,28 @@ command-line interface for evaluating Lisp forms.  For example:
 : 3
 
 If your build script needs to get information out of Lisp, then wrapping
-~format~, or even ~prin1~, around forms is annoying; so ~runlisp~ has a
+~format~, or even ~princ~, around forms is annoying; so ~runlisp~ has a
 ~-p~ option which prints the values of the forms it evaluates.
 
 : $ runlisp -e '(+ 1 2)'
 : 3
 
-If a form produces multiple values, then ~-p~ will print all of them
-separated by spaces, on a single line:
+If a form produces multiple values, then ~-p~ will print all of them, as
+if by ~princ~, separated by spaces, on a single line:
 
 : $ runlisp -p '(floor 5 2)'
 : 2 1
 
+There's also a ~-d~ option, which does the same thing as ~-p~, only it
+prints values as if by ~prin1~.  For example,
+
+: $ runlisp -p '"Hello, world!"'
+: Hello, world!
+: runlisp -d '"Hello, world!"'
+: "Hello, world!"
+
 In addition to evaluating forms with ~-e~, and printing their values
-with ~-p~, you can also load a file of Lisp code using ~-l~.
+with ~-d~ and ~-p~, you can also load a file of Lisp code using ~-l~.
 
 When ~runlisp~ is acting on ~-e~, ~-p~, and/or ~-l~ options, it's said
 to be running in /eval/ mode, rather than its usual /script/ mode.  In
diff --git a/doc/README.pdf b/doc/README.pdf
index 9c5e27d..c4dbc61 100644
Binary files a/doc/README.pdf and b/doc/README.pdf differ