Integrate mainline.

p4raw-id: //depot/perlio@10154

7 files changed, 470 insertions, 259 deletions

diff --git a/pod/buildtoc.PL b/pod/buildtoc.PL
index 26be6e854b..6c43035889 100644
--- a/pod/buildtoc.PL
+++ b/pod/buildtoc.PL
@@ -148,6 +148,7 @@ if (-d "pod") {
 
     perlhist           
     perldelta           
+    perl572delta         
     perl571delta         
     perl570delta         
     perl56delta         
@@ -158,6 +159,7 @@ if (-d "pod") {
     perlamiga          
     perlbs2000
     perlcygwin          
+    perldgux             
     perldos             
     perlepoc             
     perlhpux            
@@ -178,6 +180,7 @@ if (-d "pod") {
     perlamiga          
     perlbs2000
     perlcygwin          
+    perldgux             
     perldos             
     perlepoc             
     perlhpux            
diff --git a/pod/perl.pod b/pod/perl.pod
index a1bc034142..c047d347d5 100644
--- a/pod/perl.pod
+++ b/pod/perl.pod
@@ -102,6 +102,7 @@ For ease of access, the Perl manual has been split up into several sections:
 
     perlhist		Perl history records
     perldelta		Perl changes since previous version
+    perl572delta	Perl changes in version 5.7.2
     perl571delta	Perl changes in version 5.7.1
     perl570delta	Perl changes in version 5.7.0
     perl56delta		Perl changes in version 5.6
@@ -112,6 +113,7 @@ For ease of access, the Perl manual has been split up into several sections:
     perlamiga		Perl notes for Amiga
     perlbs2000		Perl notes for POSIX-BC BS2000
     perlcygwin		Perl notes for Cygwin
+    perldgux		Perl notes for DG/UX
     perldos		Perl notes for DOS
     perlepoc		Perl notes for EPOC
     perlhpux		Perl notes for HP-UX
diff --git a/pod/perl572delta.pod b/pod/perl572delta.pod
index bce73285c8..fe1eed0d4f 100644
--- a/pod/perl572delta.pod
+++ b/pod/perl572delta.pod
@@ -27,6 +27,15 @@ for more information.
 
 =head1 Incompatible Changes
 
+=head1 Future Deprecations
+
+The current user-visible implementation of pseudo-hashes (the weird
+use of the first array element) is deprecated starting from Perl 5.8.0
+and will be removed in Perl 5.10.0, and the feature will be implemented
+differently.  Not only is the current interface rather ugly, but the
+current implementation slows down normal array and hash use quite
+noticeably. The 'fields' pragma interface will remain available.
+
 =head1 Core Enhancements
 
 =head1 Modules and Pragmata
diff --git a/pod/perldiag.pod b/pod/perldiag.pod
index 7b69b63e89..19ac8f31b4 100644
--- a/pod/perldiag.pod
+++ b/pod/perldiag.pod
@@ -567,10 +567,10 @@ C<-i.bak>, or some such.
 characters and Perl was unable to create a unique filename during
 inplace editing with the B<-i> switch.  The file was ignored.
 
-=item Can't do {n,m} with n > m before << HERE in regex m/%s/
+=item Can't do {n,m} with n > m in regex; marked by <-- HERE in m/%s/
 
 (F) Minima must be less than or equal to maxima. If you really want your
-regexp to match something 0 times, just put {0}. The << HERE shows in the
+regexp to match something 0 times, just put {0}. The <-- HERE shows in the
 regular expression about where the problem was discovered. See L<perlre>.
 
 =item Can't do setegid!
@@ -1363,12 +1363,13 @@ Check the #! line, or manually feed your script into Perl yourself.
 END subroutine.  Processing of the remainder of the queue of such
 routines has been prematurely ended.
 
-=item false [] range "%s" in regexp
+=item False [] range "%s" in regex; marked by <-- HERE in m/%s/
 
 (W regexp) A character class range must start and end at a literal
-character, not another character class like C<\d> or C<[:alpha:]>.  The
-"-" in your false range is interpreted as a literal "-".  Consider
-quoting the "-",  "\-".  See L<perlre>.
+character, not another character class like C<\d> or C<[:alpha:]>.  The "-"
+in your false range is interpreted as a literal "-".  Consider quoting the
+"-", "\-".  The <-- HERE shows in the regular expression about where the
+problem was discovered.  See L<perlre>.
 
 =item Fatal VMS error at %s, line %d
 
@@ -1417,11 +1418,11 @@ some time before now.  Check your control flow.  flock() operates on
 filehandles.  Are you attempting to call flock() on a dirhandle by the
 same name?
 
-=item Quantifier follows nothing before << HERE in regex m/%s/
+=item Quantifier follows nothing in regex; marked by <-- HERE in m/%s/
 
 (F) You started a regular expression with a quantifier. Backslash it if you
-meant it literally. The << HERE shows in the regular expression about where the
-problem was discovered. See L<perlre>.
+meant it literally. The <-- HERE shows in the regular expression about
+where the problem was discovered. See L<perlre>.
 
 =item Format not terminated
 
@@ -1667,10 +1668,10 @@ transparently promotes all numbers to a floating point representation
 internally--subject to loss of precision errors in subsequent
 operations.
 
-=item Internal disaster before << HERE in regex m/%s/
+=item Internal disaster in regex; marked by <-- HERE in m/%s/
 
 (P) Something went badly wrong in the regular expression parser.
-The << HERE shows in the regular expression about where the problem was
+The <-- HERE shows in the regular expression about where the problem was
 discovered.
 
 
@@ -1683,10 +1684,11 @@ L<perlvms/"exec LIST">).  Somehow, this count has become scrambled, so
 Perl is making a guess and treating this C<exec> as a request to
 terminate the Perl script and execute the specified command.
 
-=item Internal urp before << HERE in regex m/%s/
+=item Internal urp in regex; marked by <-- HERE in m/%s/
 
-(P) Something went badly awry in the regular expression parser. The <<<HERE
-shows in the regular expression about where the problem was discovered.
+(P) Something went badly awry in the regular expression parser. The
+<-- HERE shows in the regular expression about where the problem was
+discovered.
 
 
 =item %s (...) interpreted as function
@@ -1711,14 +1713,15 @@ recognized by Perl or by a user-supplied handler.  See L<attributes>.
 (W printf) Perl does not understand the given format conversion.  See
 L<perlfunc/sprintf>.
 
-=item invalid [] range "%s" in regexp
+=item Invalid [] range "%s" in regex; marked by <-- HERE in m/%s/
 
 (F) The range specified in a character class had a minimum character
-greater than the maximum character.  One possibility is that you
-forgot the C<{}> from your ending C<\x{}> - C<\x> without the curly
-braces can go only up to C<ff>.  See L<perlre>.
+greater than the maximum character.  One possibility is that you forgot the
+C<{}> from your ending C<\x{}> - C<\x> without the curly braces can go only
+up to C<ff>.  The <-- HERE shows in the regular expression about where the
+problem was discovered.  See L<perlre>.
 
-=item invalid [] range "%s" in transliteration operator
+=item Invalid [] range "%s" in transliteration operator
 
 (F) The range specified in the tr/// or y/// operator had a minimum
 character greater than the maximum character.  See L<perlop>.
@@ -1813,11 +1816,11 @@ instead on the filehandle.)
 values cannot be returned in subroutines used in lvalue context.  See
 L<perlsub/"Lvalue subroutines">.
 
-=item Lookbehind longer than %d not implemented before << HERE %s
+=item Lookbehind longer than %d not implemented in regex; marked by <-- HERE in m/%s/
 
 (F) There is currently a limit on the length of string which lookbehind can
-handle. This restriction may be eased in a future release. The << HERE shows in
-the regular expression about where the problem was discovered.
+handle. This restriction may be eased in a future release. The <-- HERE
+shows in the regular expression about where the problem was discovered.
 
 =item Malformed PERLLIB_PREFIX
 
@@ -1843,11 +1846,12 @@ Perl detected something that didn't comply with UTF-8 encoding rules.
 Perl thought it was reading UTF-16 encoded character data but while
 doing it Perl met a malformed Unicode surrogate.
 
-=item %s matches null string many times
+=item %s matches null string many times in regex; marked by <-- HERE in m/%s/
 
 (W regexp) The pattern you've specified would be an infinite loop if the
-regular expression engine didn't specifically check for that.  See
-L<perlre>.
+regular expression engine didn't specifically check for that.  The <-- HERE
+shows in the regular expression about where the problem was discovered.
+See L<perlre>.
 
 =item % may only be used in unpack
 
@@ -2008,16 +2012,15 @@ provided for this purpose.
 (F) You tried to do a read/write/send/recv operation with a buffer
 length that is less than 0.  This is difficult to imagine.
 
-=item Nested quantifiers before << HERE in regex m/%s/
+=item Nested quantifiers in regex; marked by <-- HERE in m/%s/
 
 (F) You can't quantify a quantifier without intervening parentheses. So
-things like ** or +* or ?* are illegal. The << HERE shows in the regular
+things like ** or +* or ?* are illegal. The <-- HERE shows in the regular
 expression about where the problem was discovered.
 
-Note, however, that the minimal matching quantifiers, C<*?>, C<+?>, and
+Note that the minimal matching quantifiers, C<*?>, C<+?>, and
 C<??> appear to be nested quantifiers, but aren't.  See L<perlre>.
 
-
 =item %s never introduced
 
 (S internal) The symbol in question was declared but somehow went out of
@@ -2658,34 +2661,38 @@ value of the environment variable PERLIO.
 process which isn't a subprocess of the current process.  While this is
 fine from VMS' perspective, it's probably not what you intended.
 
-=item POSIX syntax [%s] belongs inside character classes
+=item POSIX syntax [%s] belongs inside character classes in regex; marked by <-- HERE in m/%s/
 
 (W unsafe) The character class constructs [: :], [= =], and [. .]  go
-I<inside> character classes, the [] are part of the construct, for
-example: /[012[:alpha:]345]/.  Note that [= =] and [. .] are not
-currently implemented; they are simply placeholders for future
-extensions and will cause fatal errors.
+I<inside> character classes, the [] are part of the construct, for example:
+/[012[:alpha:]345]/.  Note that [= =] and [. .] are not currently
+implemented; they are simply placeholders for future extensions and will
+cause fatal errors.  The <-- HERE shows in the regular expression about
+where the problem was discovered.  See L<perlre>.
 
-=item POSIX  syntax [. .] is reserved for future extensions
+=item POSIX syntax [. .] is reserved for future extensions in regex; marked by <-- HERE in m/%s/
 
 (F regexp) Within regular expression character classes ([]) the syntax
-beginning with "[." and ending with ".]" is reserved for future
-extensions.  If you need to represent those character sequences inside
-a regular expression character class, just quote the square brackets
-with the backslash: "\[." and ".\]".
+beginning with "[." and ending with ".]" is reserved for future extensions.
+If you need to represent those character sequences inside a regular
+expression character class, just quote the square brackets with the
+backslash: "\[." and ".\]".  The <-- HERE shows in the regular expression
+about where the problem was discovered.  See L<perlre>.
 
-=item POSIX syntax [= =] is reserved for future extensions
+=item POSIX syntax [= =] is reserved for future extensions in regex; marked by <-- HERE in m/%s/
 
-(F) Within regular expression character classes ([]) the syntax
-beginning with "[=" and ending with "=]" is reserved for future
-extensions.  If you need to represent those character sequences inside
-a regular expression character class, just quote the square brackets
-with the backslash: "\[=" and "=\]".
+(F) Within regular expression character classes ([]) the syntax beginning
+with "[=" and ending with "=]" is reserved for future extensions.  If you
+need to represent those character sequences inside a regular expression
+character class, just quote the square brackets with the backslash: "\[="
+and "=\]".  The <-- HERE shows in the regular expression about where the
+problem was discovered.  See L<perlre>.
 
-=item POSIX class [:%s:] unknown
+=item POSIX class [:%s:] unknown in regex; marked by <-- HERE in m/%s/
 
-(F) The class in the character class [: :] syntax is unknown.  See
-L<perlre>.
+(F) The class in the character class [: :] syntax is unknown.  The <-- HERE
+shows in the regular expression about where the problem was discovered.
+See L<perlre>.
 
 =item POSIX getpgrp can't take an argument
 
@@ -2809,13 +2816,13 @@ in L<perlos2>.
 (S unsafe) The subroutine being declared or defined had previously been
 declared or defined with a different function prototype.
 
-=item Quantifier in {,} bigger than %d before << HERE in regex m/%s/
+=item Quantifier in {,} bigger than %d in regex; marked by <-- HERE in m/%s/
 
 (F) There is currently a limit to the size of the min and max values of the
-{min,max} construct. The << HERE shows in the regular expression about where
+{min,max} construct. The <-- HERE shows in the regular expression about where
 the problem was discovered. See L<perlre>.
 
-=item Quantifier unexpected on zero-length expression before << HERE %s
+=item Quantifier unexpected on zero-length expression; marked by <-- HERE in m/%s/
 
 (W regexp) You applied a regular expression quantifier in a place where
 it makes no sense, such as on a zero-width assertion.  Try putting the
@@ -2823,6 +2830,9 @@ quantifier inside the assertion instead.  For example, the way to match
 "abc" provided that it is followed by three repetitions of "xyz" is
 C</abc(?=(?:xyz){3})/>, not C</abc(?=xyz){3}/>.
 
+The <-- HERE shows in the regular expression about where the problem was
+discovered.
+
 =item Range iterator outside integer range
 
 (F) One (or both) of the numeric arguments to the range operator ".."
@@ -2883,14 +2893,14 @@ Doing so has no effect.
 (W internal) The internal sv_replace() function was handed a new SV with
 a reference count of other than 1.
 
-=item Reference to nonexistent group before << HERE in regex m/%s/
+=item Reference to nonexistent group in regex; marked by <-- HERE in m/%s/
 
 (F) You used something like C<\7> in your regular expression, but there are
 not at least seven sets of capturing parentheses in the expression. If you
 wanted to have the character with value 7 inserted into the regular expression,
 prepend a zero to make the number at least two digits: C<\07>
 
-The << HERE shows in the regular expression about where the problem was
+The <-- HERE shows in the regular expression about where the problem was
 discovered.
 
 =item regexp memory corruption
@@ -3007,34 +3017,37 @@ scalar that had previously been marked as free.
 (W closed) The socket you're sending to got itself closed sometime
 before now.  Check your control flow.
 
-=item Sequence (? incomplete before << HERE mark in regex m/%s/
+=item Sequence (? incomplete in regex; marked by <-- HERE in m/%s/
 
-(F) A regular expression ended with an incomplete extension (?. The <<<HERE
+(F) A regular expression ended with an incomplete extension (?. The <-- HERE
 shows in the regular expression about where the problem was discovered. See
 L<perlre>.
 
-=item Sequence (?{...}) not terminated or not {}-balanced in %s
+=item Sequence (?{...}) not terminated or not {}-balanced in regex; marked by <-- HERE in m/%s/
 
 (F) If the contents of a (?{...}) clause contains braces, they must balance
-for Perl to properly detect the end of the clause. See L<perlre>.
+for Perl to properly detect the end of the clause. The <-- HERE shows in
+the regular expression about where the problem was discovered. See
+L<perlre>.
 
-=item Sequence (?%s...) not implemented before << HERE mark in %s
+=item Sequence (?%s...) not implemented in regex; marked by <-- HERE in m/%s/
 
 (F) A proposed regular expression extension has the character reserved but
-has not yet been written. The << HERE shows in the regular expression about
+has not yet been written. The <-- HERE shows in the regular expression about
 where the problem was discovered. See L<perlre>.
 
-=item Sequence (?%s...) not recognized before << HERE mark in %s
+=item Sequence (?%s...) not recognized in regex; marked by <-- HERE in m/%s/
 
-(F) You used a regular expression extension that doesn't make sense.
-The << HERE shows in the regular expression about
-where the problem was discovered.
-See L<perlre>.
+(F) You used a regular expression extension that doesn't make sense.  The
+<-- HERE shows in the regular expression about where the problem was
+discovered.  See L<perlre>.
 
-=item Sequence (?#... not terminated in regex m/%s/
+=item Sequence (?#... not terminated in regex; marked by <-- HERE in m/%s/
 
 (F) A regular expression comment must be terminated by a closing
-parenthesis.  Embedded parentheses aren't allowed.  See L<perlre>.
+parenthesis.  Embedded parentheses aren't allowed.  The <-- HERE shows in
+the regular expression about where the problem was discovered. See
+L<perlre>.
 
 =item 500 Server error
 
@@ -3215,7 +3228,7 @@ assignment or as a subroutine argument for example).
 (F) Your Perl was compiled with B<-D>SETUID_SCRIPTS_ARE_SECURE_NOW, but
 a version of the setuid emulator somehow got run anyway.
 
-=item Switch (?(condition)... contains too many branches before << HE%s
+=item Switch (?(condition)... contains too many branches in regex; marked by <-- HERE in m/%s/
 
 (F) A (?(condition)if-clause|else-clause) construct can have at most two
 branches (the if-clause and the else-clause). If you want one or both to
@@ -3224,13 +3237,13 @@ clustering parentheses:
 
     (?(condition)(?:this|that|other)|else-clause)
 
-The << HERE shows in the regular expression about where the problem was
+The <-- HERE shows in the regular expression about where the problem was
 discovered. See L<perlre>.
 
-=item Switch condition not recognized before << HERE in regex m/%s/
+=item Switch condition not recognized in regex; marked by <-- HERE in m/%s/
 
 (F) If the argument to the (?(...)if-clause|else-clause) construct is a
-number, it can be only a number. The << HERE shows in the regular expression
+number, it can be only a number. The <-- HERE shows in the regular expression
 about where the problem was discovered. See L<perlre>.
 
 =item switching effective %s is not implemented
@@ -3394,7 +3407,7 @@ Check the #! line, or manually feed your script into Perl yourself.
 
 =item Too many ('s
 
-=item trailing \ in regexp
+=item Trailing \ in regex m/%s/
 
 (F) The regular expression ends with an unbackslashed backslash.
 Backslash it.   See L<perlre>.
@@ -3508,15 +3521,16 @@ representative, who probably put it there in the first place.
 (F) There are no byte-swapping functions for a machine with this byte
 order.
 
-=item Unknown switch condition (?(%.2s before << HERE in regex m/%s/
+=item Unknown switch condition (?(%.2s in regex; marked by <-- HERE in m/%s/
 
-(F) The condition of a (?(condition)if-clause|else-clause) construct is not
-known. The condition may be lookaround (the condition is true if the
-lookaround is true), a (?{...}) construct (the condition is true if the
-code evaluates to a true value), or a number (the condition is true if the
-set of capturing parentheses named by the number is defined).
+(F) The condition part of a (?(condition)if-clause|else-clause) construct
+is not known. The condition may be lookahead or lookbehind (the condition
+is true if the lookahead or lookbehind is true), a (?{...})  construct (the
+condition is true if the code evaluates to a true value), or a number (the
+condition is true if the set of capturing parentheses named by the number
+matched).
 
-The << HERE shows in the regular expression about where the problem was
+The <-- HERE shows in the regular expression about where the problem was
 discovered.  See L<perlre>.
 
 =item Unknown open() mode '%s'
@@ -3532,18 +3546,19 @@ iterating over it, and someone else stuck a message in the stream of
 data Perl expected.  Someone's very confused, or perhaps trying to
 subvert Perl's population of %ENV for nefarious purposes.
 
-=item unmatched [ before << HERE mark in regex m/%s/
+=item unmatched [ in regex; marked by <-- HERE in m/%s/
 
 (F) The brackets around a character class must match. If you wish to
 include a closing bracket in a character class, backslash it or put it
-first. See L<perlre>. The << HERE shows in the regular expression about
-where the escape was discovered.
+first. The <-- HERE shows in the regular expression about where the problem
+was discovered. See L<perlre>.
 
-=item unmatched ( in regexp before << HERE mark in regex m/%s/
+=item unmatched ( in regex; marked by <-- HERE in m/%s/
 
 (F) Unbackslashed parentheses must always be balanced in regular
-expressions.  If you're a vi user, the % key is valuable for finding the
-matching parenthesis.  See L<perlre>.
+expressions. If you're a vi user, the % key is valuable for finding the
+matching parenthesis. The <-- HERE shows in the regular expression about
+where the problem was discovered. See L<perlre>.
 
 =item Unmatched right %s bracket
 
@@ -3571,14 +3586,13 @@ script, a binary program, or a directory as a Perl program.
 recognized by Perl inside character classes.  The character was
 understood literally.
 
-=item Unrecognized escape \\%c passed through before << HERE in m/%s/
+=item Unrecognized escape \\%c passed through in regex; marked by <-- HERE in m/%s/
 
 (W regexp) You used a backslash-character combination which is not
 recognized by Perl. This combination appears in an interpolated variable or
 a C<'>-delimited regular expression. The character was understood
-literally. The << HERE shows in the regular expression about where the escape
-was discovered.
-
+literally. The <-- HERE shows in the regular expression about where the
+escape was discovered.
 
 =item Unrecognized escape \\%c passed through
 
@@ -3905,11 +3919,11 @@ anonymous, using the C<sub {}> syntax.  When inner anonymous subs that
 reference variables in outer subroutines are called or referenced, they
 are automatically rebound to the current values of such variables.
 
-=item Variable length lookbehind not implemented before << HERE in %s
+=item Variable length lookbehind not implemented in regex; marked by <-- HERE in m/%s/
 
 (F) Lookbehind is allowed only for subexpressions whose length is fixed and
-known at compile time. The << HERE shows in the regular expression about where
-the problem was discovered.
+known at compile time. The <-- HERE shows in the regular expression about
+where the problem was discovered. See L<perlre>.
 
 =item Version number must be a constant number
 
diff --git a/pod/perlref.pod b/pod/perlref.pod
index 2727e95ae9..a62276b782 100644
--- a/pod/perlref.pod
+++ b/pod/perlref.pod
@@ -538,6 +538,13 @@ string is effectively quoted.
 B<WARNING>:  This section describes an experimental feature.  Details may
 change without notice in future versions.
 
+B<NOTE>: The current user-visible implementation of pseudo-hashes
+(the weird use of the first array element) is deprecated starting from
+Perl 5.8.0 and will be removed in Perl 5.10.0, and the feature will be
+implemented differently.  Not only is the current interface rather ugly,
+but the current implementation slows down normal array and hash use quite
+noticeably.  The 'fields' pragma interface will remain available.
+
 Beginning with release 5.005 of Perl, you may use an array reference
 in some contexts that would normally require a hash reference.  This
 allows you to access array elements using symbolic names, as if they
diff --git a/pod/perltoc.pod b/pod/perltoc.pod
index ccc4480079..a75f39ea1f 100644
--- a/pod/perltoc.pod
+++ b/pod/perltoc.pod
@@ -362,20 +362,21 @@ mkdir FILENAME,MASK, mkdir FILENAME, msgctl ID,CMD,ARG, msgget KEY,FLAGS,
 msgrcv ID,VAR,SIZE,TYPE,FLAGS, msgsnd ID,MSG,FLAGS, my EXPR, my EXPR :
 ATTRIBUTES, next LABEL, next, no Module LIST, oct EXPR, oct, open
 FILEHANDLE,MODE,LIST, open FILEHANDLE,EXPR, open FILEHANDLE, opendir
-DIRHANDLE,EXPR, ord EXPR, ord, our EXPR, pack TEMPLATE,LIST, package
-NAMESPACE, package, pipe READHANDLE,WRITEHANDLE, pop ARRAY, pop, pos
-SCALAR, pos, print FILEHANDLE LIST, print LIST, print, printf FILEHANDLE
-FORMAT, LIST, printf FORMAT, LIST, prototype FUNCTION, push ARRAY,LIST,
-q/STRING/, qq/STRING/, qr/STRING/, qx/STRING/, qw/STRING/, quotemeta EXPR,
-quotemeta, rand EXPR, rand, read FILEHANDLE,SCALAR,LENGTH,OFFSET, read
-FILEHANDLE,SCALAR,LENGTH, readdir DIRHANDLE, readline EXPR, readlink EXPR,
-readlink, readpipe EXPR, recv SOCKET,SCALAR,LENGTH,FLAGS, redo LABEL, redo,
-ref EXPR, ref, rename OLDNAME,NEWNAME, require VERSION, require EXPR,
-require, reset EXPR, reset, return EXPR, return, reverse LIST, rewinddir
-DIRHANDLE, rindex STR,SUBSTR,POSITION, rindex STR,SUBSTR, rmdir FILENAME,
-rmdir, s///, scalar EXPR, seek FILEHANDLE,POSITION,WHENCE, seekdir
-DIRHANDLE,POS, select FILEHANDLE, select, select RBITS,WBITS,EBITS,TIMEOUT,
-semctl ID,SEMNUM,CMD,ARG, semget KEY,NSEMS,FLAGS, semop KEY,OPSTRING, send
+DIRHANDLE,EXPR, ord EXPR, ord, our EXPR, our EXPR : ATTRIBUTES, pack
+TEMPLATE,LIST, package NAMESPACE, package, pipe READHANDLE,WRITEHANDLE, pop
+ARRAY, pop, pos SCALAR, pos, print FILEHANDLE LIST, print LIST, print,
+printf FILEHANDLE FORMAT, LIST, printf FORMAT, LIST, prototype FUNCTION,
+push ARRAY,LIST, q/STRING/, qq/STRING/, qr/STRING/, qx/STRING/, qw/STRING/,
+quotemeta EXPR, quotemeta, rand EXPR, rand, read
+FILEHANDLE,SCALAR,LENGTH,OFFSET, read FILEHANDLE,SCALAR,LENGTH, readdir
+DIRHANDLE, readline EXPR, readlink EXPR, readlink, readpipe EXPR, recv
+SOCKET,SCALAR,LENGTH,FLAGS, redo LABEL, redo, ref EXPR, ref, rename
+OLDNAME,NEWNAME, require VERSION, require EXPR, require, reset EXPR, reset,
+return EXPR, return, reverse LIST, rewinddir DIRHANDLE, rindex
+STR,SUBSTR,POSITION, rindex STR,SUBSTR, rmdir FILENAME, rmdir, s///, scalar
+EXPR, seek FILEHANDLE,POSITION,WHENCE, seekdir DIRHANDLE,POS, select
+FILEHANDLE, select, select RBITS,WBITS,EBITS,TIMEOUT, semctl
+ID,SEMNUM,CMD,ARG, semget KEY,NSEMS,FLAGS, semop KEY,OPSTRING, send
 SOCKET,MSG,FLAGS,TO, send SOCKET,MSG,FLAGS, setpgrp PID,PGRP, setpriority
 WHICH,WHO,PRIORITY, setsockopt SOCKET,LEVEL,OPTNAME,OPTVAL, shift ARRAY,
 shift, shmctl ID,CMD,ARG, shmget KEY,SIZE,FLAGS, shmread ID,VAR,POS,SIZE,
@@ -2459,8 +2460,8 @@ References, Tutorials, Task-Oriented, Special Topics
 
 =item Is there an IDE or Windows Perl Editor?
 
-CodeMagicCD, Komodo, The Object System, PerlBuilder, Perl code magic,
-visiPerl+, GNU Emacs, MicroEMACS, XEmacs, Elvis, Vile, Vim, Codewright,
+Komodo, The Object System, Open Perl IDE, PerlBuilder, visiPerl+,
+CodeMagicCD, GNU Emacs, MicroEMACS, XEmacs, Elvis, Vile, Vim, Codewright,
 MultiEdit, SlickEdit, Bash, Ksh, Tcsh, Zsh, BBEdit and BBEdit Lite, Alpha
 
 =item Where can I get Perl macros for vi?
@@ -4053,301 +4054,336 @@ PerlIO_apply_layers(f,mode,layers), PerlIO_binmode(f,ptype,imode,layers),
 
 =item DESCRIPTION
 
-=item Infrastructure
+=item To do during 5.6.x
 
 =over 4
 
-=item Mailing list archives
+=item Support for I/O disciplines
 
-=item Bug tracking system
+=item Eliminate need for "use utf8";
 
-=item Regression Tests
+=item Autoload byte.pm
 
-Coverage, Regression, __DIE__, suidperl, The 25% slowdown from perl4 to
-perl5
+=item Make "\u{XXXX}" et al work
 
-=back
+=item Overloadable regex assertions
 
-=item Configure
+=item Unicode collation and normalization
 
-=over 4
+=item Unicode case mappings 
 
-=item Install HTML
+=item Unicode regular expression character classes
 
-=back
+=item use Thread for iThreads
 
-=item Perl Language
+=item Work out exit/die semantics for threads
 
-=over 4
+=item Typed lexicals for compiler
 
-=item 64-bit Perl
+=item Compiler workarounds for Win32
 
-=item Prototypes
+=item AUTOLOADing in the compiler
 
-Named prototypes, Indirect objects, Method calls, Context, Scoped subs
+=item Fixing comppadlist when compiling
 
-=back
+=item Cleaning up exported namespace
 
-=item Perl Internals
+=item Complete signal handling
 
-=over 4
+=item Out-of-source builds
 
-=item magic_setisa
+=item POSIX realtime support
 
-=item Garbage Collection
+=item UNIX98 support
 
-=item Reliable signals
+=item IPv6 Support
 
-Alternate runops() for signal despatch, Figure out how to die() in delayed
-sighandler, Add tests for Thread::Signal, Automatic tests against CPAN
+=item Long double conversion
 
-=item Interpolated regex performance bugs
+=item Locales
 
-=item Memory leaks from failed eval/regcomp
+=item Thread-safe regexes
 
-=item Make XS easier to use
+=item Arithmetic on non-Arabic numerals
+
+=item POSIX Unicode character classes
+
+=item Factoring out common suffices/prefices in regexps (trie optimization)
+
+=item Security audit shipped utilities
+
+=item Custom opcodes
+
+=item spawnvp() on Win32
+
+=item DLL Versioning
+
+=item Introduce @( and @)
+
+=item Floating point handling
+
+=item IV/UV preservation
+
+=item Replace pod2html with something using Pod::Parser
+
+=item Automate module testing on CPAN
+
+=item sendmsg and recvmsg
+
+=item Rewrite perlre documentation
 
-=item Make embedded Perl easier to use
+=item Convert example code to IO::Handle filehandles
 
-=item Namespace cleanup
+=item Document Win32 choices
 
-=item MULTIPLICITY
+=item Check new modules
 
-=item MacPerl
+=item Make roffitall find pods and libs itself
 
 =back
 
-=item Documentation
+=item To do at some point
 
 =over 4
 
-=item A clear division into tutorial and reference
+=item Remove regular expression recursion
 
-=item Remove the artificial distinction between operators and functions
+=item Memory leaks after failed eval
 
-=item More tutorials
+=item pack "(stuff)*"
 
-Regular expressions, I/O, pack/unpack, Debugging
+=item bitfields in pack
 
-=item Include a search tool
+=item Cross compilation
 
-=item Include a locate tool
+=item Perl preprocessor / macros
 
-=item Separate function manpages by default
+=item Perl lexer in Perl
 
-=item Users can't find the manpages
+=item Using POSIX calls internally
 
-=item Install ALL Documentation
+=item -i rename file when changed
 
-=item Outstanding issues to be documented
+=item All ARGV input should act like E<lt>E<gt>
 
-=item Adapt www.linuxhq.com for Perl
+=item Support for rerunning debugger
 
-=item Replace man with a perl program
+=item my sub foo { }
 
-=item Unicode tutorial
+=item One-pass global destruction
 
-=back
+=item Rewrite regexp parser
 
-=item Modules
+=item Cache recently used regexps
 
-=over 4
+=item Re-entrant functions
 
-=item Update the POSIX extension to conform with the POSIX 1003.1 Edition 2
+=item Cross-compilation support
 
-=item Module versions
+=item Bit-shifting bitvectors
 
-=item New modules
+=item debugger pragma
 
-=item Profiler
+=item use less pragma
 
-=item Tie Modules
+=item switch structures
 
-VecArray, SubstrArray, VirtualArray, ShiftSplice
+=item Cache eval tree
 
-=item Procedural options
+=item rcatmaybe
 
-=item RPC
+=item Shrink opcode tables
 
-=item y2k localtime/gmtime
+=item Optimize away @_
 
-=item Export File::Find variables
+=item Prototypes versus indirect objects
 
-=item Ioctl
+=item Install HMTL
 
-=item Debugger attach/detach
+=item Prototype method calls
 
-=item Regular Expression debugger
+=item Return context prototype declarations
 
-=item Alternative RE Syntax
+=item magic_setisa
 
-=item Bundled modules
+=item Garbage collection
 
-=item Expect
+=item IO tutorial
 
-=item GUI::Native
+=item pack/unpack tutorial
 
-=item Update semibroken auxiliary tools; h2ph, a2p, etc.
+=item Rewrite perldoc
 
-=item pod2html
+=item Install .3p man pages
+
+=item Unicode tutorial
 
-=item Podchecker
+=item Update POSIX.pm for 1003.1-2
+=head2 Retargetable installation
+
+=item POSIX emulation on non-POSIX systems
+
+=item Rename Win32 headers
+
+=item Finish off lvalue functions
+
+=item Update sprintf documentation
+
+=item Use fchown/fchmod internally
 
 =back
 
-=item Tom's Wishes
+=item Vague ideas
 
 =over 4
 
-=item Webperl
+=item ref() in list context
 
-=item Mobile agents
+=item Make tr/// return histogram
 
-=item POSIX on non-POSIX
+=item Compile to real threaded code
+=head2 Structured types
+=head2 Modifiable $1 et al.
 
-=item Portable installations
+=item Procedural interfaces for IO::*, etc.
 
-=back
+=item RPC modules
 
-=item Win32 Stuff
+=item Attach/detach debugger from running program
 
-=over 4
+=item Alternative RE syntax module
 
-=item Rename new headers to be consistent with the rest
+=item GUI::Native
 
-=item Sort out the spawnvp() mess
+=item foreach(reverse ...)
 
-=item Work out DLL versioning
+=item Constant function cache
 
-=item Style-check
+=item Approximate regular expression matching
 
 =back
 
-=item Would be nice to have
+=item Ongoing
 
-C<pack "(stuff)*">, Contiguous bitfields in pack/unpack, lexperl, Bundled
-perl preprocessor, Use posix calls internally where possible, format
-BOTTOM, -i rename file only when successfully changed, All ARGV input
-should act like <>, report HANDLE [formats], support in perlmain to rerun
-debugger, lvalue functions
+=over 4
 
-=item Possible pragmas
+=item Update guts documentation
 
-=over 4
+=item Add more tests
 
-=item 'less'
+=item Update auxiliary tools
 
 =back
 
-=item Optimizations
+=item Recently done things
 
 =over 4
 
-=item constant function cache
+=item Safe signal handling
 
-=item foreach(reverse...)
+=item Tie Modules
 
-=item Cache eval tree
+=item gettimeofday
 
-=item rcatmaybe
+=item setitimer and getimiter
 
-=item Shrink opcode tables
+=item Testing __DIE__ hook
 
-=item Cache hash value
+=item CPP equivalent in Perl
 
-=item Optimize away @_ where possible
+=item Explicit switch statements
 
-=item Optimize sort by { $a <=> $b }
+=item autocroak
 
-=item Rewrite regexp parser for better integrated optimization
+=item UTF/EBCDIC
 
-=back
+=item UTF Regexes
 
-=item Vague possibilities
+=item perlcc to produce executable
 
-ref function in list context, make tr/// return histogram in list context?,
-Loop control on do{} et al, Explicit switch statements, compile to real
-threaded code, structured types, Modifiable $1 et al
+=item END blocks saved in compiled output
 
-=item To Do Or Not To Do
+=item Secure temporary file module
 
-=over 4
+=item Integrate Time::HiRes
 
-=item Making my() work on "package" variables
+=item Turn Cwd into XS
 
-=item "or" testing defined not truth
+=item Mmap for input
 
-=item "dynamic" lexicals
+=item Byte to/from UTF8 and UTF8 to/from local conversion
 
-=item "class"-based, rather than package-based "lexicals"
+=item Add sockatmark support
 
-=back
+=item Mailing list archives
 
-=item Threading
+=item Bug tracking
 
-=over 4
+=item Integrate MacPerl
 
-=item Modules
+=item Web "nerve center" for Perl
 
-=item Testing
+=item Regular expression tutorial
 
-=item $AUTOLOAD
+=item Debugging Tutorial
 
-=item exit/die
+=item Integrate new modules
 
-=item External threads
+=item Integrate profiler
 
-=item Thread::Pool
+=item Y2K error detection
 
-=item thread-safety
+=item Regular expression debugger
 
-=item Per-thread GVs
+=item POD checker
 
-=back
+=item "Dynamic" lexicals
 
-=item Compiler
+=item Cache precompiled modules
 
-=over 4
+=back
 
-=item Optimization
+=item Deprecated Wishes
 
-=item Byteperl
+=over 4
 
-=item Precompiled modules
+=item Loop control on do{}
 
-=item Executables
+=item Lexically scoped typeglobs
 
-=item Typed lexicals
+=item format BOTTOM
+=head2 report HANDLE
 
-=item Win32
+=item Generalised want()/caller())
+=head2 Named prototypes
 
-=item END blocks
+=item Built-in globbing
 
-=item _AUTOLOAD
+=item Regression tests for suidperl
 
-=item comppadlist
+=item Cached hash values
 
-=item Cached compilation
+=item Add compression modules
 
-=back
+=item Reorganise documentation into tutorials/references
 
-=item Recently Finished Tasks
+=item Remove distinction between functions and operators
 
-=over 4
+=item Make XS easier to use
 
-=item Figure a way out of $^(capital letter)
+=item Make embedding easier to use
 
-=item Filenames
+=item man for perl
 
-=item Foreign lines
+=item my $Package::variable
 
-=item Namespace cleanup
+=item "or" tests defined, not truth
 
-=item ISA.pm
+=item "class"-based lexicals
 
-=item gettimeofday
+=item byteperl
 
-=item autocroak?
+=item Lazy evaluation / tail recursion removal
 
 =back
 
@@ -4432,7 +4468,8 @@ DEFINES, USE_MULTI = define, #PERL_MALLOC = define, CFG = Debug
 
 =item Pixie Profiling
 
--h, -l, -p, -h, -i, -l, -testcoverage, -zero
+-h, -l, -p[rodecures], -h[eavy], -i[nvocations], -l[ines], -testcoverage,
+-z[ero]
 
 =item CONCLUSION
 
@@ -4488,6 +4525,104 @@ I<The Road goes ever on and on, down from the door where it began.>
 
 =back
 
+=head2 perl572delta, perl571delta - what's new for perl v5.7.2
+
+=over 4
+
+=item DESCRIPTION
+
+=item Security Vulnerability Closed
+
+=item Incompatible Changes
+
+=item Core Enhancements
+
+=item Modules and Pragmata
+
+=over 4
+
+=item New Modules
+
+=item Updated And Improved Modules and Pragmata
+
+=back
+
+=item Performance Enhancements
+
+=item Utility Changes
+
+=item New Documentation
+
+=item Installation and Configuration Improvements
+
+=over 4
+
+=item New Or Improved Platforms
+
+=item Generic Improvements
+
+=back
+
+=item Selected Bug Fixes
+
+=over 4
+
+=item Platform Specific Changes and Fixes
+
+=back
+
+=item New or Changed Diagnostics
+
+=item Changed Internals
+
+=over 4
+
+=item Regex pre-/post-compilation items matched up
+
+=back
+
+=item New Tests
+
+=item Known Problems
+
+=over 4
+
+=item AIX vac 5.0.0.0 May Produce Buggy Code For Perl
+
+=item lib/ftmp-security tests warn 'system possibly insecure'
+
+=item lib/io_multihomed Fails In LP64-Configured HP-UX
+
+=item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX
+
+=item lib/b test 19
+
+=item Linux With Sfio Fails op/misc Test 48
+
+=item sigaction test 13 in VMS
+
+=item sprintf tests 129 and 130
+
+=item  Failure of Thread tests
+
+=item Localising a Tied Variable Leaks Memory
+
+=item Self-tying of Arrays and Hashes Is Forbidden
+
+=item Building Extensions Can Fail Because Of Largefiles
+
+=item The Compiler Suite Is Still Experimental
+
+=back
+
+=item Reporting Bugs
+
+=item SEE ALSO
+
+=item HISTORY
+
+=back
+
 =head2 perl571delta - what's new for perl v5.7.1
 
 =over 4
@@ -4500,6 +4635,16 @@ I<The Road goes ever on and on, down from the door where it began.>
 
 =item Core Enhancements
 
+=item AUTOLOAD Is Now Lvaluable
+
+=over 4
+
+=item PerlIO is Now The Default
+
+=item Signals Are Now Safe
+
+=back
+
 =item Modules and Pragmata
 
 =over 4
@@ -5680,6 +5825,38 @@ Source, Compiled Module Source, Perl Modules/Scripts
 
 =back
 
+=head2 perldgux - Perl under DG/UX.
+
+=over 4
+
+=item SYNOPSIS
+
+=back
+
+=over 4
+
+=item DESCRIPTION
+
+=item BUILD
+
+=over 4
+
+=item Non-threaded Case
+
+=item Threaded Case
+
+=item Testing
+
+=item Installing the built perl
+
+=back
+
+=item AUTHOR
+
+=item SEE ALSO
+
+=back
+
 =head2 perlepoc, README.epoc - Perl for EPOC
 
 =over 4
@@ -8934,8 +9111,6 @@ reference, e.g.:
 
 =item Encoding and IO
 
-=item Encode and PerlIO
-
 =item Encoding How to ...
 
 IO with mixed content (faking iso-2020-*), MIME's Content-Length:, UTF-8
@@ -13896,15 +14071,16 @@ TIESCALAR classname, LIST, FETCH this, STORE this, value, DESTROY this
 =item DESCRIPTION
 
 gettimeofday (), usleep ( $useconds ), ualarm ( $useconds [,
-$interval_useconds ] ), tv_interval ( $ref_to_gettimeofday [,
-$ref_to_later_gettimeofday] ), time (), sleep ( $floating_seconds ), alarm
-( $floating_seconds [, $interval_floating_seconds ] ), setitimer ( $which,
-$floating_seconds [, $interval_floating_seconds ] ), getitimer ( $which )
+$interval_useconds ] ), tv_interval, time (), sleep ( $floating_seconds ),
+alarm ( $floating_seconds [, $interval_floating_seconds ] ), setitimer,
+getitimer ( $which )
 
 =item EXAMPLES
 
 =item C API
 
+=item CAVEATS
+
 =item AUTHORS
 
 =item REVISION
diff --git a/pod/perltodo.pod b/pod/perltodo.pod
index 39aa37f35c..8c94a29c9a 100644
--- a/pod/perltodo.pod
+++ b/pod/perltodo.pod
@@ -747,7 +747,7 @@ Suggesting this on P5P B<will> cause a boring and interminable flamewar.
 
 =head2 "class"-based lexicals
 
-Use flyweight objects, secure hashes or, dare I say it, pseudohashes instead.
+Use flyweight objects, secure hashes or, dare I say it, pseudo-hashes instead.
 
 =head2 byteperl