README.org: Clarify and fix the discussion of `-p', mentioning `-d'.
authorMark Wooding <mdw@distorted.org.uk>
Sun, 3 Mar 2024 16:27:32 +0000 (16:27 +0000)
committerMark Wooding <mdw@distorted.org.uk>
Sun, 3 Mar 2024 16:35:02 +0000 (16:35 +0000)
Also give an example of the difference.

README.org
doc/README.pdf

index 30aab1f..b59221a 100644 (file)
@@ -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
index 9c5e27d..c4dbc61 100644 (file)
Binary files a/doc/README.pdf and b/doc/README.pdf differ