doc: iter-begin copies iterators.

* txr.1: Revise text which claims that when iter-begin
is invoked on an existing iterator, the returned iterator
may share state it. We recently fixed that with the cloning.

1 files changed, 12 insertions, 11 deletions

diff --git a/txr.1 b/txr.1
index fde65f54..8562eabb 100644
--- a/txr.1
+++ b/txr.1
@@ -39623,17 +39623,6 @@ is a number.
 
 If
 .meta seq
-is an iterator produced by
-.code iter-begin
-then an iterator similar to that iterator is returned, which can continue
-iterating the same sequence. The iterator may be
-.meta seq
-itself or share state with
-.metn seq ,
-and thus may not be relied on to produce an independent, parallel iteration.
-
-If
-.meta seq
 is a structure which supports the
 .code iter-begin
 method, then that method is called and its return value is returned.
@@ -39647,6 +39636,18 @@ or
 methods. A struct object supporting none of these methods is deemed
 not iterable.
 
+Otherwise, if
+.meta seq
+is an iterator object of
+.code seq-iter
+type, such as one produced by
+.codn iter-begin ,
+then an iterator similar to that iterator is returned, as if produced
+by applying the
+.code copy-iter
+function to
+.metn seq .
+
 In all other cases, if
 .meta seq
 is iterable, an object of type