This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
[perl #84942] perltie.pod READLINE list context
authorKevin Ryde <user42@zip.com.au>
Sat, 26 Feb 2011 05:50:50 +0000 (21:50 -0800)
committerFather Chrysostomos <sprout@cpan.org>
Sat, 26 Feb 2011 05:58:15 +0000 (21:58 -0800)
commit2207fa4e5a04c326c157fe8acb453ee4b447205a
tree9d2ceb6515454c58887c9dda6023e018fb0b9294
parent662ccb34c4d4ba5f4c287f08b854fc020ea25b20
[perl #84942] perltie.pod READLINE list context

In perltie.pod the handle READLINE says

    The method should return undef when there is no more data.

which made me think that's what it should always do, and didn't need to
pay attention to wantarray().

If I'm not mistaken in list context READLINE should return empty list
for no more data.  It'd be good if the docs noted that, and perhaps
cross referenced to perlfunc for the gory details of what readline
should do.

Maybe something like the following, unless someone can think of a better
contrivance for the sample.
pod/perltie.pod