Integrate:

[ 21590]
Subject: [patch pod/perlfunc.pod] separate two unrelated notes in require
From: Stas Bekman <stas@stason.org>
Date: Wed, 29 Oct 2003 16:47:24 -0800
Message-ID: <3FA05F9C.2080304@stason.org>

[ 21592]
Subject: [PATCH] Document PERL_DL_NONLAZY
From: Gisle Aas <gisle@ActiveState.com>
Date: 31 Oct 2003 03:13:03 -0800
Message-ID: <lrn0bhbqyo.fsf@caliper.activestate.com>

[ 21596]
Subject: Re: [perl #24367] [PATCH] configure flag -Dextras="HTML::Parser" doesn't seem to do anything 
From: Andy Dougherty <doughera@lafayette.edu>
Date: Fri, 31 Oct 2003 15:32:35 -0500 (EST)
Message-ID: <Pine.SOL.4.53.0310311433440.8552@maxwell.phys.lafayette.edu>
(plus POD link fixes)
p4raw-link: @21596 on //depot/perl: a522f097125f62a186dbde9051ea046a7d916213
p4raw-link: @21592 on //depot/perl: 02c7413a561fd3e4b8c5a160aea7f78b8f9b4ebe
p4raw-link: @21590 on //depot/perl: a12755f08356686e8eba9b8e518360528f66abdc

p4raw-id: //depot/maint-5.8/perl@21600
p4raw-integrated: from //depot/perl@21597 'copy in' INSTALL (@21343..)
	'merge in' pod/perlrun.pod (@21437..) pod/perlfunc.pod
	(@21575..)

3 files changed, 19 insertions, 3 deletions

diff --git a/INSTALL b/INSTALL
index 1ea3e7b967..8fc3fe02b8 100644
--- a/INSTALL
+++ b/INSTALL
@@ -1084,7 +1084,7 @@ You can actually specify -g and -DDEBUGGING independently, but usually
 it's convenient to have both.
 
 If you are using a shared libperl, see the warnings about multiple
-versions of perl under L<Building a shared libperl.so Perl library>.
+versions of perl under L<Building a shared Perl library>.
 
 =head2 Extensions
 
@@ -1109,6 +1109,9 @@ convenient way to do that in one step.  (It is not necessary, however;
 you can build and install extensions just fine even if you don't have
 dynamic loading.  See lib/ExtUtils/MakeMaker.pm for more details.)
 
+If you have dynamic loading, another way of specifying extra modules
+is described in L<"Adding extra modules to the build"> below.
+
 You can learn more about each of the supplied extensions by consulting the
 documentation in the individual .pm modules, located under the
 ext/ subdirectory.
@@ -1471,6 +1474,9 @@ command line parameter to Configure, for example like this:
 or answer first 'y' to the question 'Install any extra modules?' and
 then answer "Compress::Zlib Bundle::LWP DBI" to the 'Extras?' question.
 The module or the bundle names are as for the CPAN module 'install' command.
+This will only work if those modules are to be built as dynamic
+extensions.  If you wish to include those extra modules as static
+extensions, see L<"Extensions"> above.
 
 Notice that because the CPAN module will be used to fetch the extra
 modules, you will need access to the CPAN, either via the Internet,
@@ -1790,7 +1796,7 @@ archive, please report it to the site's maintainer.
 =item invalid token: ##
 
 You are using a non-ANSI-compliant C compiler.  See L<WARNING:  This
-version requires a compiler that supports ANSI C>.
+version requires a compiler that supports ANSI C.>
 
 =item Miscellaneous
 
diff --git a/pod/perlfunc.pod b/pod/perlfunc.pod
index 27e21edad2..4f7b9a8e73 100644
--- a/pod/perlfunc.pod
+++ b/pod/perlfunc.pod
@@ -4090,7 +4090,9 @@ following subroutine:
     }
 
 Note that the file will not be included twice under the same specified
-name.  The file must return true as the last statement to indicate
+name.
+
+The file must return true as the last statement to indicate
 successful execution of any initialization code, so it's customary to
 end such a file with C<1;> unless you're sure it'll return true
 otherwise.  But it's better just to put the C<1;>, in case you add more
diff --git a/pod/perlrun.pod b/pod/perlrun.pod
index dcb23268f0..6447c7e155 100644
--- a/pod/perlrun.pod
+++ b/pod/perlrun.pod
@@ -1110,6 +1110,14 @@ Relevant only if your perl executable was built with B<-DDEBUGGING>,
 this controls the behavior of global destruction of objects and other
 references.  See L<perlhack/PERL_DESTRUCT_LEVEL> for more information.
 
+=item PERL_DL_NONLAZY
+
+Set to one to have perl resolve B<all> undefined symbols when it loads
+a dynamic library.  The default behaviour is to resolve symbols when
+they are used.  Setting this variable is useful during testing of
+extensions as it ensures that you get an error on misspelled function
+names even if the test suite doesn't call it.
+
 =item PERL_ENCODING
 
 If using the C<encoding> pragma without an explicit encoding name, the