readline() docs don’t describe setting $_

[p5pRT]

Migrated from rt.perl.org#125372 (status was 'rejected')

Searchable as RT125372$

[p5pRT]

From @FGasper

Created by @FGasper

�perldoc -f readline� doesn�t mention when readline() will and will not
set $_. Since this is widely used functionality (e.g., �print while <$fh>�),
the docs should probably describe this.

Perl Info

Flags:
    category=docs
    severity=low

Site configuration information for perl 5.16.3:

Configured by root at Thu Jan  8 17:51:46 PST 2015.

Summary of my perl5 (revision 5 version 16 subversion 3) configuration:
   
  Platform:
    osname=darwin, osvers=13.2.0, archname=darwin-thread-multi-2level
    uname='darwin tennine-slave.macports.org 13.2.0 darwin kernel version 13.2.0: thu apr 17 23:03:13 pdt 2014; root:xnu-2422.100.13~1release_x86_64 x86_64 '
    config_args='-Dinc_version_list=5.16.1/darwin-thread-multi-2level 5.16.1 5.16.0/darwin-thread-multi-2level 5.16.0 -des -Dprefix=/opt/local -Dscriptdir=/opt/local/bin -Dcppflags=-I/opt/local/include -Dccflags=-pipe -Os  -Dldflags=-L/opt/local/lib -Wl,-headerpad_max_install_names  -Dvendorprefix=/opt/local -Dusemultiplicity=y -Dusethreads -Duseshrplib -Dcc=/usr/bin/clang -Dld=env MACOSX_DEPLOYMENT_TARGET=10.9 /usr/bin/clang -Dman1ext=1pm -Dman3ext=3pm -Dman1dir=/opt/local/share/man/man1p -Dman3dir=/opt/local/share/man/man3p -Dsitebin=/opt/local/libexec/perl5.16/sitebin -Dsiteman1dir=/opt/local/share/perl5.16/siteman/man1 -Dsiteman3dir=/opt/local/share/perl5.16/siteman/man3 -Dvendorbin=/opt/local/libexec/perl5.16 -Dvendorman1dir=/opt/local/share/perl5.16/man/man1 -Dvendorman3dir=/opt/local/share/perl5.16/man/man3 -Dpager=/usr/bin/less -sR -Dperlpath=/opt/local/bin/perl5.16 -Dstartperl=#!/opt/local/bin/perl5.16'
    hint=recommended, useposix=true, d_sigaction=define
    useithreads=define, usemultiplicity=define
    useperlio=define, d_sfio=undef, uselargefiles=define, usesocks=undef
    use64bitint=define, use64bitall=define, uselongdouble=undef
    usemymalloc=n, bincompat5005=undef
  Compiler:
    cc='/usr/bin/clang', ccflags ='-pipe -Os  -fno-common -DPERL_DARWIN -I/opt/local/include -fno-strict-aliasing -fstack-protector -I/opt/local/include',
    optimize='-O3',
    cppflags='-I/opt/local/include -pipe -Os  -fno-common -DPERL_DARWIN -I/opt/local/include -fno-strict-aliasing -fstack-protector -I/opt/local/include'
    ccversion='', gccversion='4.2.1 Compatible Apple LLVM 5.1 (clang-503.0.40)', gccosandvers=''
    intsize=4, longsize=8, ptrsize=8, doublesize=8, byteorder=12345678
    d_longlong=define, longlongsize=8, d_longdbl=define, longdblsize=16
    ivtype='long', ivsize=8, nvtype='double', nvsize=8, Off_t='off_t', lseeksize=8
    alignbytes=8, prototype=define
  Linker and Libraries:
    ld='env MACOSX_DEPLOYMENT_TARGET=10.9 /usr/bin/clang', ldflags ='-L/opt/local/lib -Wl,-headerpad_max_install_names  -fstack-protector'
    libpth=/opt/local/lib /usr/lib
    libs=-lgdbm -ldbm -ldl -lm -lutil -lc
    perllibs=-ldl -lm -lutil -lc
    libc=, so=dylib, useshrplib=true, libperl=libperl.dylib
    gnulibc_version=''
  Dynamic Linking:
    dlsrc=dl_dlopen.xs, dlext=bundle, d_dlsymun=undef, ccdlflags=' '
    cccdlflags=' ', lddlflags='-L/opt/local/lib -Wl,-headerpad_max_install_names  -bundle -undefined dynamic_lookup -fstack-protector'

Locally applied patches:
    


@INC for perl 5.16.3:
    /opt/local/lib/perl5/site_perl/5.16.3/darwin-thread-multi-2level
    /opt/local/lib/perl5/site_perl/5.16.3
    /opt/local/lib/perl5/vendor_perl/5.16.3/darwin-thread-multi-2level
    /opt/local/lib/perl5/vendor_perl/5.16.3
    /opt/local/lib/perl5/5.16.3/darwin-thread-multi-2level
    /opt/local/lib/perl5/5.16.3
    /opt/local/lib/perl5/site_perl
    /opt/local/lib/perl5/vendor_perl/5.16.1/darwin-thread-multi-2level
    /opt/local/lib/perl5/vendor_perl/5.16.1
    /opt/local/lib/perl5/vendor_perl
    .


Environment for perl 5.16.3:
    DYLD_LIBRARY_PATH (unset)
    HOME=/Users/felipe
    LANG=en_US.UTF-8
    LANGUAGE (unset)
    LD_LIBRARY_PATH (unset)
    LOGDIR (unset)
    PATH=/Users/felipe/.opt/bin:/opt/local/bin:/opt/local/sbin:/usr/local/bin:/usr/bin:/bin:/usr/local/sbin:/usr/sbin:/sbin:/usr/X11/bin
    PERL_BADLANG (unset)
    SHELL=/bin/bash

[p5pRT]

From perl@profvince.com

Le 10/06/2015 04​:22, felipe@​felipegasper.com (via RT) a écrit :

# New Ticket Created by felipe@​felipegasper.com
# Please include the string​: [perl #125372]
# in the subject line of all future correspondence about this issue.
# <URL​: https://rt-archive.perl.org/perl5/Ticket/Display.html?id=125372 >

This is a bug report for perl from felipe@​felipegasper.com,
generated with the help of perlbug 1.39 running under perl 5.16.3.

-----------------------------------------------------------------
[Please describe your issue here]

�perldoc -f readline� doesn�t mention when readline() will and will not
set $_. Since this is widely used functionality (e.g., �print while <$fh>�),
the docs should probably describe this.

readline() never sets $_ : "while (<$fh>)" is turned at compile-time
into "while(defined($_ = <$fh>))". This is explained in the "I/O
operators" section of perlop and can be checked with B​::Deparse.

Vincent

[p5pRT]

The RT System itself - Status changed from 'new' to 'open'

[p5pRT]

From @jkeenan

Reviewing this ticket, it appears that no action is the best action. Closing.

--
James E Keenan (jkeenan@​cpan.org)

[p5pRT]

@jkeenan - Status changed from 'open' to 'rejected'