From 8fbdb6bbae926adf4f42f5dab60f0ee0cbd04d0b Mon Sep 17 00:00:00 2001
From: Kaz Kylheku <kaz@kylheku.com>
Date: Mon, 2 Aug 2021 18:29:22 -0700
Subject: streams: document redundant close-stream.

* txr.1: Document that if close-stream is applied to a closed stream,
then nil is returned without throwing an exception.
---
 txr.1 | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/txr.1 b/txr.1
index 6bde1bbc..12b64512 100644
--- a/txr.1
+++ b/txr.1
@@ -56707,6 +56707,16 @@ function throws an exception if an error occurs during the close operation
 instead of returning
 .codn nil .
 
+If
+.code close-stream
+is applied to a
+.meta stream
+which is already closed, the operation returns
+.code nil
+regardless of the
+.meta throw-on-error-p
+argument's value.
+
 .coNP Macro @ with-stream
 .synb
 .mets (with-stream >> ( stream-var << init-form )
-- 
cgit v1.2.3