summaryrefslogtreecommitdiffstats
path: root/txr.1
diff options
context:
space:
mode:
authorKaz Kylheku <kaz@kylheku.com>2015-01-21 20:38:52 -0800
committerKaz Kylheku <kaz@kylheku.com>2015-01-21 20:38:52 -0800
commitaa355befc89d94f3f43d3ae4124f7d048fb4e588 (patch)
treeecee6b6cde1f503ee165d0457d94a46256ee0ce5 /txr.1
parent11bd34ef3af16aae9bfb78a3bb46d8098cb3a15b (diff)
downloadtxr-aa355befc89d94f3f43d3ae4124f7d048fb4e588.tar.gz
txr-aa355befc89d94f3f43d3ae4124f7d048fb4e588.tar.bz2
txr-aa355befc89d94f3f43d3ae4124f7d048fb4e588.zip
* stream.c (get_string): New argument, close_after_p.
Close the stream unless close_after_p is specified and is nil, or when it is missing, an there is no compatibility or it's newer than version 102. * stream.h (get_string): Updated declartion. * txr.1: Documented default closing behavior of get-string and the new optional argument for overriding it.
Diffstat (limited to 'txr.1')
-rw-r--r--txr.114
1 files changed, 13 insertions, 1 deletions
diff --git a/txr.1 b/txr.1
index 505ded7c..328b4066 100644
--- a/txr.1
+++ b/txr.1
@@ -22055,7 +22055,7 @@ See also:
.coNP Function @ get-string
.synb
-.mets (get-string >> [ stream <> [ count ]])
+.mets (get-string >> [ stream >> [ count <> [ close-after-p ]]])
.syne
.desc
The
@@ -22067,6 +22067,13 @@ argument is omitted, then the
.code *stdin*
stream is used.
+The stream is closed after extracting the data, unless
+.meta close-after-p
+is specified as
+.codn nil .
+The default value of this argument is
+.codn t .
+
If the
.meta count
argument is missing, then all of the characters from the
@@ -26614,6 +26621,11 @@ can be emulated is \*(TX 97.
Here are values which have a special meaning as arguments to the
.code -C
option, along with a description of what behaviors are affected:
+.IP 102
+Up to \*(TX 102, the
+.code get-string
+function did not close the stream. This old behavior is emulated.
+
.IP 101
Up to \*(TX 101, the
.code make-like