develooper Front page | perl.perl5.porters | Postings from October 2013

[perl #120406] [PATCH] Documentation Patches

Thread Previous
From:
Tom Hukins
Date:
October 29, 2013 10:25
Subject:
[perl #120406] [PATCH] Documentation Patches
Message ID:
rt-4.0.18-24532-1383042321-423.120406-75-0@perl.org
# New Ticket Created by  Tom Hukins 
# Please include the string:  [perl #120406]
# in the subject line of all future correspondence about this issue. 
# <URL: https://rt.perl.org/Ticket/Display.html?id=120406 >



This is a bug report for perl from tom@eborcom.com,
generated with the help of perlbug 1.39 running under perl 5.19.2.

>From 0241cb62e771daf48d93a4a7c992c5e37c508115 Mon Sep 17 00:00:00 2001
From: Tom Hukins <tom@eborcom.com>
Date: Thu, 18 Apr 2013 18:41:51 +0100
Subject: [PATCH 1/2] Refer to the correct section
MIME-Version: 1.0
Content-Type: multipart/mixed; boundary="------------1.7.7"

This is a multi-part message in MIME format.
--------------1.7.7
Content-Type: text/plain; charset=UTF-8; format=fixed
Content-Transfer-Encoding: 8bit


tr is documented in perlop's "Quote-Like Operators" section, not its
"Quote and Quote-like Operators" section.
---
 pod/perlfunc.pod |    4 ++--
 1 files changed, 2 insertions(+), 2 deletions(-)


--------------1.7.7
Content-Type: text/x-patch; name="0001-Refer-to-the-correct-section.patch"
Content-Transfer-Encoding: 8bit
Content-Disposition: attachment; filename="0001-Refer-to-the-correct-section.patch"

diff --git a/pod/perlfunc.pod b/pod/perlfunc.pod
index 79a0b6a..2434f89 100644
--- a/pod/perlfunc.pod
+++ b/pod/perlfunc.pod
@@ -8253,7 +8253,7 @@ Portability issues: L<perlport/times>.
 =for Pod::Functions transliterate a string
 
 The transliteration operator.  Same as C<y///>.  See
-L<perlop/"Quote and Quote-like Operators">.
+L<perlop/"Quote-Like Operators">.
 
 =item truncate FILEHANDLE,LENGTH
 X<truncate>
@@ -9137,7 +9137,7 @@ Note that write is I<not> the opposite of C<read>.  Unfortunately.
 =for Pod::Functions transliterate a string
 
 The transliteration operator.  Same as C<tr///>.  See
-L<perlop/"Quote and Quote-like Operators">.
+L<perlop/"Quote-Like Operators">.
 
 =back
 

--------------1.7.7--



>From 6d22a4703fe634828651ab4ad9803d783f359cc9 Mon Sep 17 00:00:00 2001
From: Tom Hukins <tom@eborcom.com>
Date: Mon, 28 Oct 2013 18:43:51 +0000
Subject: [PATCH 2/2] Don't describe PerlIO as "new"
MIME-Version: 1.0
Content-Type: multipart/mixed; boundary="------------1.7.7"

This is a multi-part message in MIME format.
--------------1.7.7
Content-Type: text/plain; charset=UTF-8; format=fixed
Content-Transfer-Encoding: 8bit

---
 pod/perluniintro.pod |    4 ++--
 1 files changed, 2 insertions(+), 2 deletions(-)


--------------1.7.7
Content-Type: text/x-patch; name="0002-Don-t-describe-PerlIO-as-new.patch"
Content-Transfer-Encoding: 8bit
Content-Disposition: attachment; filename="0002-Don-t-describe-PerlIO-as-new.patch"

diff --git a/pod/perluniintro.pod b/pod/perluniintro.pod
index 762b2c6..c5b0a15 100644
--- a/pod/perluniintro.pod
+++ b/pod/perluniintro.pod
@@ -461,8 +461,8 @@ UTF-8 encoded.  A C<use open ':encoding(utf8)'> would have avoided the
 bug, or explicitly opening also the F<file> for input as UTF-8.
 
 B<NOTE>: the C<:utf8> and C<:encoding> features work only if your
-Perl has been built with the new PerlIO feature (which is the default
-on most systems).
+Perl has been built with L<PerlIO>, which is the default
+on most systems.
 
 =head2 Displaying Unicode As Text
 

--------------1.7.7--


---
Flags:
    category=docs
    severity=low
---
Site configuration information for perl 5.19.2:

Configured by tom at Wed Jul 17 19:39:10 UTC 2013.

Summary of my perl5 (revision 5 version 19 subversion 2) configuration:
  Commit id: dd686e5619f8ad9e1e46ec0e80539edbcb73c8ea
  Platform:
    osname=freebsd, osvers=8.2-release, archname=amd64-freebsd
    uname='freebsd agde.scrubhole.org 8.2-release freebsd 8.2-release #1: sun mar 20 09:12:44 utc 2011 root@spey.exonetric.net:usrobjusrsrcsysgeneric amd64 '
    config_args='-Dusedevel -des -Dprefix=/home/tom/perl-inst/perl-5.19_20130717 -Uversiononly -Doptimize=-O2 -Accflags=-DPERL_DISABLE_PMC -DNO_MATHOMS'
    hint=recommended, useposix=true, d_sigaction=define
    useithreads=undef, usemultiplicity=undef
    useperlio=define, d_sfio=undef, uselargefiles=define, usesocks=undef
    use64bitint=define, use64bitall=define, uselongdouble=undef
    usemymalloc=n, bincompat5005=undef
  Compiler:
    cc='cc', ccflags ='-DHAS_FPSETMASK -DHAS_FLOATINGPOINT_H -DPERL_DISABLE_PMC -DNO_MATHOMS -fno-strict-aliasing -pipe -fstack-protector -I/usr/local/include',
    optimize='-O2',
    cppflags='-DHAS_FPSETMASK -DHAS_FLOATINGPOINT_H -DPERL_DISABLE_PMC -DNO_MATHOMS -fno-strict-aliasing -pipe -fstack-protector -I/usr/local/include'
    ccversion='', gccversion='4.2.1 20070719  [FreeBSD]', 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='cc', ldflags ='-Wl,-E  -fstack-protector -L/usr/local/lib'
    libpth=/usr/lib /usr/local/lib
    libs=-lm -lcrypt -lutil -lc
    perllibs=-lm -lcrypt -lutil -lc
    libc=, so=so, useshrplib=false, libperl=libperl.a
    gnulibc_version=''
  Dynamic Linking:
    dlsrc=dl_dlopen.xs, dlext=so, d_dlsymun=undef, ccdlflags=' '
    cccdlflags='-DPIC -fPIC', lddlflags='-shared  -L/usr/local/lib -fstack-protector'


---
@INC for perl 5.19.2:
    /home/tom/perl-inst/perl-5.19_20130717/lib/site_perl/5.19.2/amd64-freebsd
    /home/tom/perl-inst/perl-5.19_20130717/lib/site_perl/5.19.2
    /home/tom/perl-inst/perl-5.19_20130717/lib/5.19.2/amd64-freebsd
    /home/tom/perl-inst/perl-5.19_20130717/lib/5.19.2
    .

---
Environment for perl 5.19.2:
    HOME=/home/tom
    LANG=en_GB.UTF-8
    LANGUAGE (unset)
    LD_LIBRARY_PATH (unset)
    LOGDIR (unset)
    PATH=/sbin:/bin:/usr/sbin:/usr/bin:/usr/games:/usr/local/sbin:/usr/local/bin:/home/tom/bin
    PERL_BADLANG (unset)
    SHELL=/usr/local/bin/zsh


Thread Previous


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