develooper Front page | perl.perl5.porters | Postings from August 2014

[perl #121839] Outdated documentation in perlopentut

Thread Previous | Thread Next
From:
James E Keenan via RT
Date:
August 23, 2014 00:32
Subject:
[perl #121839] Outdated documentation in perlopentut
Message ID:
rt-4.0.18-11740-1408753926-1701.121839-15-0@perl.org
On Fri May 09 20:19:33 2014, the.rob.dixon@gmail.com wrote:
> This is a bug report for perl from the.rob.dixon@gmail.com,
> generated with the help of perlbug 1.39 running under perl 5.16.2.
> 
> 
> -----------------------------------------------------------------
> 
> The section in `perlopentut` titled "The Minus File" is simply wrong
> in the context of current best practice.
> 
> It says
> 
> ... Perl's "open" function treats a file whose name is a single minus,
> "-", in
> a special way. If you open minus for reading, it really means to
> access the
> standard input. If you open minus for writing, it really means to
> access the
> standard output.

Where is the text you are citing found?

I searched in both perl 5.16 -- the version you used to generate the bug report -- and in blead and I could not find these texts anywhere, much less in pod/perlopentut.pod.

#####
perl -v | head -2 | tail -1
This is perl 5, version 16, subversion 3 (v5.16.3) built for x86_64-linux

$ find . -type f | xargs grep -inE '(Minus File|function treats a file|open minus)'
./cpan/Pod-Perldoc/corpus/perlfunc.pod:351:    -M  Script start time minus file modification time, in days.
./pod/perlfunc.pod:396:    -M  Script start time minus file modification time, in days.
#####
$ ./perl -Ilib -v | head -2 | tail -1
This is perl 5, version 21, subversion 4 (v5.21.4 (v5.21.3-56-gf702f02*)) built for x86_64-linux
[
$ find . -type f | xargs grep -inE '(Minus File|function treats a file|open minus)'
./cpan/Pod-Perldoc/corpus/perlfunc.pod:351:    -M  Script start time minus file modification time, in days.
./pod/perlfunc.pod:396:    -M  Script start time minus file modification time, in days.
#####

Thank you very much.
Jim Keenan

---
via perlbug:  queue: perl5 status: open
https://rt.perl.org/Ticket/Display.html?id=121839

Thread Previous | Thread Next


nntp.perl.org: Perl Programming lists via nntp and http.
Comments to Ask Bjørn Hansen at ask@perl.org | Group listing | About