Merge dynamic perldelta from maint (22081)

So now perldelta.pod is copied at build time from perl591delta.pod
perl590delta.pod is as released to CPAN by Hugo
Regen lots of makefiles, pods and the MANIFEST

p4raw-id: //depot/perl@22221
p4raw-deleted: from //depot/maint-5.8/perl@22218 'delete in'
	pod/perldelta.pod (@22072..)
p4raw-edited: from //depot/maint-5.8/perl@22081 'edit in' Makefile.SH
	(@21777..) MANIFEST (@22072..) pod/perltoc.pod (@22073..)
	vms/descrip_mms.template (@22078..)

MANIFEST

@@ -671,10 +671,10 @@ ext/Storable/t/restrict.t	See if Storable works
 ext/Storable/t/retrieve.t	See if Storable works
 ext/Storable/t/st-dump.pl	See if Storable works
 ext/Storable/t/store.t		See if Storable works
+ext/Storable/t/threads.t	Does Storable work with threads?
 ext/Storable/t/tied_hook.t	See if Storable works
 ext/Storable/t/tied_items.t	See if Storable works
 ext/Storable/t/tied.t		See if Storable works
-ext/Storable/t/threads.t	Does Storable work with threads?
 ext/Storable/t/utf8hash.t	See if Storable works
 ext/Storable/t/utf8.t		See if Storable works
 ext/Sys/Hostname/Hostname.pm	Sys::Hostname extension Perl module
@@ -1083,14 +1083,12 @@ lib/CPAN/t/signature.t		CPAN signature test
 lib/CPAN/t/vcmp.t		See if CPAN the module works
 lib/ctime.pl			A ctime workalike
 lib/Cwd.pm			Various cwd routines (getcwd, fastcwd, chdir)
-lib/DB.pm			Debugger API (draft)
-lib/DB.t			See if DB works
-lib/DBM_Filter.pm		DBM Filter module
 lib/DBM_Filter/Changes    	DBM Filter Change history
 lib/DBM_Filter/compress.pm	DBM Filter to compress keys/values
 lib/DBM_Filter/encode.pm	DBM Filter for encoding
 lib/DBM_Filter/int32.pm		DBM Filter for creating int32 keys/values
 lib/DBM_Filter/null.pm		DBM Filter for null termination
+lib/DBM_Filter.pm		DBM Filter module
 lib/DBM_Filter/t/01error.t	test DBM_Filter::null
 lib/DBM_Filter/t/02core.t	test DBM_Filter::null
 lib/DBM_Filter/t/compress.t	test DBM_Filter::compress
@@ -1100,6 +1098,8 @@ lib/DBM_Filter/t/null.t		test DBM_Filter::null
 lib/DBM_Filter/t/utf8.t		test DBM_Filter::utf8
 lib/DBM_Filter/utf8.pm		DBM Filter for UTF-8 Encoding
 lib/dbm_filter_util.pl		Utility functions used by DBM Filter tests 
+lib/DB.pm			Debugger API (draft)
+lib/DB.t			See if DB works
 lib/Devel/SelfStubber.pm	Generate stubs for SelfLoader.pm
 lib/Devel/SelfStubber.t		See if Devel::SelfStubber works
 lib/diagnostics.pm		Print verbose diagnostics
@@ -2368,6 +2368,8 @@ pod/perl581delta.pod		Perl changes in version 5.8.1
 pod/perl582delta.pod		Perl changes in version 5.8.2
 pod/perl583delta.pod		Perl changes in version 5.8.3
 pod/perl58delta.pod		Perl changes in version 5.8.0
+pod/perl590delta.pod		Perl changes in version 5.9.0
+pod/perl591delta.pod		Perl changes in version 5.9.1
 pod/perlapio.pod		Perl internal IO abstraction interface
 pod/perlapi.pod			Perl API listing (autogenerated)
 pod/perlartistic.pod		Perl Artistic License
@@ -2383,7 +2385,6 @@ pod/perldbmfilter.pod		Perl DBM filters
 pod/perldebguts.pod		Perl debugging guts and tips
 pod/perldebtut.pod		Perl debugging tutorial
 pod/perldebug.pod		Perl debugging
-pod/perldelta.pod		Perl changes since previous version
 pod/perldiag.pod		Perl diagnostic messages
 pod/perldoc.pod			Look up Perl documentation in Pod format
 pod/perldsc.pod			Perl data structures intro

Makefile.SH

@@ -761,6 +761,8 @@ extra.pods: miniperl$(EXE_EXT)
 	done
 	-@rm -f pod/perlvms.pod
 	-@test -f vms/perlvms.pod && cd pod && $(LNS) ../vms/perlvms.pod perlvms.pod && cd .. && echo "pod/perlvms.pod" >> extra.pods
+	-@rm -f pod/perldelta.pod
+	-@test -f pod/perl591delta.pod && cd pod && $(LNS) perl591delta.pod perldelta.pod && cd .. && echo "pod/perldelta.pod" >> extra.pods
 
 extras.make: perl$(EXE_EXT)
 	-@test -s extras.lst && PATH="`pwd`:${PATH}" PERL5LIB="`pwd`/lib" $(LDLIBPTH) ./perl -Ilib -MCPAN -e '@ARGV&&make(@ARGV)' `cat extras.lst`

pod.lst

@@ -119,7 +119,9 @@ h Miscellaneous
   perldoc		Look up Perl documentation in Pod format
 
   perlhist		Perl history records
-  perldelta		Perl changes since previous version
+d perldelta		Perl changes since previous version
+D perl591delta		Perl changes in version 5.9.1
+  perl590delta		Perl changes in version 5.9.0
   perl583delta		Perl changes in version 5.8.3
   perl582delta		Perl changes in version 5.8.2
   perl581delta		Perl changes in version 5.8.1

pod/perl.pod

@@ -132,6 +132,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
+    perl590delta	Perl changes in version 5.9.0
     perl583delta	Perl changes in version 5.8.3
     perl582delta	Perl changes in version 5.8.2
     perl581delta	Perl changes in version 5.8.1

pod/perldelta.pod → pod/perl590delta.pod

@@ -216,22 +216,6 @@ contains a package variable named C<$NEGATIVE_INDICES> which is set to
 a true value, negative values will be passed to C<FETCH>, C<STORE>,
 C<EXISTS>, and C<DELETE> unchanged.
 
-=head2 Tied hashes in scalar context
-
-As of perl 5.8.2, tied hashes did not return anything useful in scalar
-context, for example when used as boolean tests:
-
-	if (%tied_hash) { ... }
-
-The old nonsensical behaviour was always to return false,
-regardless of whether the hash is empty or has elements.
-
-There is now an interface for the implementors of tied hashes to implement
-the behaviour of a hash in scalar context, via the SCALAR method (see
-L<perltie>).  Without a SCALAR method, perl will try to guess whether
-the hash is empty, by testing if it's inside an iteration (in this case
-it can't be empty) or by calling FIRSTKEY.
-
 =head2 local ${$x}
 
 The syntaxes
@@ -476,9 +460,6 @@ C<perlcc -B> works now at least somewhat better, while C<perlcc -c>
 is rather more broken.  (The Perl compiler suite as a whole continues
 to be experimental.)
 
-C<find2perl> now assumes C<-print> as a default action. It needed to be
-specified explicitly.
-
 =head1 New Documentation
 
 perl573delta has been added to list the differences between the
@@ -877,6 +858,19 @@ common Perl platforms (Unix and Unix-like, Microsoft platforms, and
 VMS) have large enough testing and expert population that they are
 doing well.
 
+=head2 Tied hashes in scalar context
+
+Tied hashes do not currently return anything useful in scalar context,
+for example when used as boolean tests:
+
+	if (%tied_hash) { ... }
+
+The current nonsensical behaviour is always to return false,
+regardless of whether the hash is empty or has elements.
+
+The root cause is that there is no interface for the implementors of
+tied hashes to implement the behaviour of a hash in scalar context.
+
 =head2 Net::Ping 450_service and 510_ping_udp failures
 
 The subtests 9 and 18 of lib/Net/Ping/t/450_service.t, and the

pod/perl591delta.pod

@@ -0,0 +1,78 @@
+=head1 NAME
+
+perldelta - what is new for perl v5.9.1
+
+=head1 DESCRIPTION
+
+This document describes differences between the 5.9.0 release and
+the 5.9.1 release.
+
+=head1 Incompatible Changes
+
+=head1 Core Enhancements
+
+=head2 Tied hashes in scalar context
+
+As of perl 5.8.2, tied hashes did not return anything useful in scalar
+context, for example when used as boolean tests:
+
+	if (%tied_hash) { ... }
+
+The old nonsensical behaviour was always to return false,
+regardless of whether the hash is empty or has elements.
+
+There is now an interface for the implementors of tied hashes to implement
+the behaviour of a hash in scalar context, via the SCALAR method (see
+L<perltie>).  Without a SCALAR method, perl will try to guess whether
+the hash is empty, by testing if it's inside an iteration (in this case
+it can't be empty) or by calling FIRSTKEY.
+
+=head1 Modules and Pragmata
+
+=head1 Utility Changes
+
+C<find2perl> now assumes C<-print> as a default action. Previously, it
+needed to be specified explicitly.
+
+=head1 New Documentation
+
+=head1 Performance Enhancements
+
+=head1 Installation and Configuration Improvements
+
+=head1 Selected Bug Fixes
+
+=head1 New or Changed Diagnostics
+
+=head1 Changed Internals
+
+=head1 New Tests
+
+=head1 Known Problems
+
+=head1 Platform Specific Problems
+
+=head1 Reporting Bugs
+
+If you find what you think is a bug, you might check the articles
+recently posted to the comp.lang.perl.misc newsgroup and the perl
+bug database at http://bugs.perl.org/ .  There may also be
+information at http://www.perl.com/ , the Perl Home Page.
+
+If you believe you have an unreported bug, please run the B<perlbug>
+program included with your release.  Be sure to trim your bug down
+to a tiny but sufficient test case.  Your bug report, along with the
+output of C<perl -V>, will be sent off to perlbug@perl.org to be
+analysed by the Perl porting team.
+
+=head1 SEE ALSO
+
+The F<Changes> file for exhaustive details on what changed.
+
+The F<INSTALL> file for how to build Perl.
+
+The F<README> file for general stuff.
+
+The F<Artistic> and F<Copying> files for copyright information.
+
+=cut