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

[perl #120406] [PATCH] Documentation Patches

Thread Previous | Thread Next
From:
James E Keenan via RT
Date:
October 30, 2013 22:54
Subject:
[perl #120406] [PATCH] Documentation Patches
Message ID:
rt-4.0.18-27397-1383173686-1771.120406-15-0@perl.org
On Tue Oct 29 03:25:21 2013, tomhukins wrote:
> 
> 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--
> 
> 

Tom:

Thanks for the patches.  However, would it be possible for you to re-post them as *attachments*, either to an email or to a new post to the RT #120406 GUI?  (And, preferably, one attachment for each patch.)

I tried copy-and-pasting the patches into a text editor and lost all the newlines.  Patches as attachments generally work better than patches inline.

Thank you very much.
Jim Keenan

> ---
> 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




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

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