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