develooper Front page | perl.perl5.porters | Postings from February 2006

[perl #38633] doc patch: perlfunc "new" section lacks lock and qr

Thread Next
From:
Zsban Ambrus
Date:
February 25, 2006 06:38
Subject:
[perl #38633] doc patch: perlfunc "new" section lacks lock and qr
Message ID:
rt-3.0.11-38633-130596.7.22367548359067@perl.org
# New Ticket Created by  Zsban Ambrus 
# Please include the string:  [perl #38633]
# in the subject line of all future correspondence about this issue. 
# <URL: https://rt.perl.org/rt3/Ticket/Display.html?id=38633 >


This is a bug report for perl from ambrus@math.bme.hu,
generated with the help of perlbug 1.35 running under perl v5.8.8.


-----------------------------------------------------------------
[Please enter your report here]


This is a documentation patch about the perlfunc pod.

This pod has a section called "Functions new in perl5". 
There are two builtins that were introduced between 5.004 and 5.8.8 
but are missing from this section.  (A third builtin, "our", is already in
the list.)  These are "lock" and "qr".  I know qr is really a quote operator, 
but it's still in perlfunc and "qw" is already on that list.

I added these two functions to the list and made a unified diff, which
should be applied to pod/perlfunc.pod.  Note that I've also swapped "qx" and
"qw" back to alphabetic order which somehow got reversed.

Thanks,

ambrus

--------------------- diff starts here ---------------------------
--- pod/perlfunc.pod	2006-01-31 16:35:12.000000000 +0100
+++ pod/perlfunc.pod	2006-02-25 13:48:34.000000000 +0100
@@ -220,11 +220,11 @@
  =item Functions new in perl5
  X<perl5>

  C<abs>, C<bless>, C<chomp>, C<chr>, C<exists>, C<formline>, C<glob>,
-C<import>, C<lc>, C<lcfirst>, C<map>, C<my>, C<no>, C<our>, C<prototype>,
-C<qx>, C<qw>, C<readline>, C<readpipe>, C<ref>, C<sub*>, C<sysopen>, C<tie>,
-C<tied>, C<uc>, C<ucfirst>, C<untie>, C<use>
+C<import>, C<lc>, C<lcfirst>, C<lock>, C<map>, C<my>, C<no>, C<our>,
+C<prototype>, C<qr>, C<qw>, C<qx>, C<readline>, C<readpipe>, C<ref>,
+C<sub*>, C<sysopen>, C<tie>, C<tied>, C<uc>, C<ucfirst>, C<untie>, C<use>

  * - C<sub> was a keyword in perl4, but in perl5 it is an
  operator, which can be used in expressions.

--------------------- diff ends here -----------------------------


[Please do not change anything below this line]
-----------------------------------------------------------------
---
Flags:
     category=docs
     severity=low
---
Site configuration information for perl v5.8.8:

Configured by ambrus at Sun Feb 19 14:25:24 CET 2006.

Summary of my perl5 (revision 5 version 8 subversion 8) configuration:
   Platform:
     osname=linux, osvers=2.4.32, archname=i686-linux
     uname='linux king 2.4.32 #4 sun jan 15 14:34:03 cet 2006 i686 intel(r) celeron(r) cpu 3.20ghz genuineintel gnulinux '
     config_args=''
     hint=recommended, useposix=true, d_sigaction=define
     usethreads=undef use5005threads=undef useithreads=undef usemultiplicity=undef
     useperlio=define d_sfio=undef uselargefiles=define usesocks=undef
     use64bitint=undef use64bitall=undef uselongdouble=undef
     usemymalloc=n, bincompat5005=undef
   Compiler:
     cc='gcc4', ccflags ='-fno-strict-aliasing -pipe -Wdeclaration-after-statement -I/usr/local/include -D_LARGEFILE_SOURCE -D_FILE_OFFSET_BITS=64',
     optimize='-O2',
     cppflags='-fno-strict-aliasing -pipe -Wdeclaration-after-statement -I/usr/local/include'
     ccversion='', gccversion='4.0.0', gccosandvers=''
     intsize=4, longsize=4, ptrsize=4, doublesize=8, byteorder=1234
     d_longlong=define, longlongsize=8, d_longdbl=define, longdblsize=12
     ivtype='long', ivsize=4, nvtype='double', nvsize=8, Off_t='off_t', lseeksize=8
     alignbytes=4, prototype=define
   Linker and Libraries:
     ld='gcc4', ldflags =' -L/usr/local/lib'
     libpth=/usr/local/lib /lib /usr/lib
     libs=-lnsl -lndbm -lgdbm -ldb -ldl -lm -lcrypt -lutil -lc
     perllibs=-lnsl -ldl -lm -lcrypt -lutil -lc
     libc=/lib/libc-2.3.5.so, so=so, useshrplib=false, libperl=libperl.a
     gnulibc_version='2.3.5'
   Dynamic Linking:
     dlsrc=dl_dlopen.xs, dlext=so, d_dlsymun=undef, ccdlflags='-Wl,-E'
     cccdlflags='-fpic', lddlflags='-shared -L/usr/local/lib'

Locally applied patches:


---
@INC for perl v5.8.8:
     /usr/local/lib/perl5/5.8.8/i686-linux
     /usr/local/lib/perl5/5.8.8
     /usr/local/lib/perl5/site_perl/5.8.8/i686-linux
     /usr/local/lib/perl5/site_perl/5.8.8
     /usr/local/lib/perl5/site_perl/5.8.5/i686-linux
     /usr/local/lib/perl5/site_perl/5.8.5
     /usr/local/lib/perl5/site_perl
     .

---
Environment for perl v5.8.8:
     HOME=/home/ambrus
     LANG (unset)
     LANGUAGE (unset)
     LC_CTYPE=hu_HU
     LD_LIBRARY_PATH (unset)
     LOGDIR (unset)
     PATH=/home/ambrus/local/bin:/usr/local/bin:/bin:/usr/bin:/usr/games/bin:/usr/X11R6/bin:/usr/qt/3/bin:/usr/kde/3.2/bin:/opt/Acrobat5:/opt/blackdown-jdk-1.4.1/bin:/opt/blackdown-jdk-1.4.1/jre/bin
     PERLDOC_PAGER=/usr/bin/less -R
     PERL_BADLANG (unset)
     SHELL=/bin/bash


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