summaryrefslogtreecommitdiffstats
path: root/txr.1
diff options
context:
space:
mode:
Diffstat (limited to 'txr.1')
-rw-r--r--txr.119
1 files changed, 18 insertions, 1 deletions
diff --git a/txr.1 b/txr.1
index f48f1360..87e0b624 100644
--- a/txr.1
+++ b/txr.1
@@ -11685,7 +11685,7 @@ finalized, so that further output is no longer possible.
.TP
Syntax:
- (close-stream <stream>)
+ (close-stream <stream> [<throw-on-error-p>])
.TP
Description:
@@ -11697,6 +11697,23 @@ to operating system files or devices, will perform a close of the underlying
file descriptor, and dissociate that descriptor from the stream. Any buffered
data is flushed first.
+The function returns a boolean true value if the close has occurred without
+errors, otherwise nil.
+
+For most streams, "without errors" means that any buffered output data is
+flushed successfully.
+
+For command and process pipes (see open-command and open-process), success also
+means that the process terminates normally, with a successful error code, or an
+unsuccessul one. An abnormal termination is considered an error, as
+as is the inability to retrieve the termination status, as well as the situation
+that the process continues running in spite of the close attempt.
+Detecting these situations is platform specific.
+
+If the <throw-on-error-p> argument is specified, and isn't nil, then the
+function throws an exception if an error occurs during the close operation
+instead of returning nil.
+
.SS Functions get-line, get-char and get-byte
.TP