Skip to content

Commit 4a48a5c

Browse files
authored
Clarify IO::CatHandle.words/.lines
Even if :$close is false, the handle switching mechanism will still close consumed handles. Otherwise, we'd hit the open files limit fairly quickly.
1 parent 121795e commit 4a48a5c

File tree

1 file changed

+6
-0
lines changed

1 file changed

+6
-0
lines changed

doc/Type/IO/CatHandle.pod6

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -306,6 +306,9 @@ IO::CatHandle.new($f1, $f2).lines.perl.say;
306306
# OUTPUT: «("foo", "bar", "meow").Seq␤»
307307
=end code
308308
309+
Note: if C<:$close> is C<False>, fully-consumed handles are B<still> going
310+
to be closed.
311+
309312
=head2 method lock
310313
311314
Defined as:
@@ -736,6 +739,9 @@ IO::CatHandle.new($f1, $f2).words.perl.say;
736739
# OUTPUT: «("foo", "bar", "meow").Seq␤»
737740
=end code
738741
742+
Note: if C<:$close> is C<False>, fully-consumed handles are B<still> going
743+
to be closed.
744+
739745
=head1 NYI Methods
740746
741747
The L<IO::CatHandle> type overrides these methods to throw C<X::NYI>

0 commit comments

Comments
 (0)