Re: [PATCH] Final Draft - pod/perlcommunity.pod - (was [PATCH] Draft - pod/perlcommunity.pod - Patches welcome)

From: "Edgar Bering" <trizor@gmail.com>
Message-ID: <e54ba1c30707040251o6814c0e4r64929702dc3b0eb7@mail.gmail.com>

p4raw-id: //depot/perl@31551

8 files changed, 282 insertions, 62 deletions

diff --git a/MANIFEST b/MANIFEST
index 062c0288a9..87d2ade9d2 100644
--- a/MANIFEST
+++ b/MANIFEST
@@ -1455,8 +1455,8 @@ lib/AutoSplit.pm		Split up autoload functions
 lib/AutoSplit.t			See if AutoSplit works
 lib/autouse.pm			Load and call a function only when it's used
 lib/autouse.t			See if autouse works
-lib/base.pm			Establish IS-A relationship at compile time
 lib/base/Changes		base.pm changelog
+lib/base.pm			Establish IS-A relationship at compile time
 lib/base/t/base.t		See if base works
 lib/base/t/fields-base.t	See if fields work
 lib/base/t/fields.t		See if fields work
@@ -1471,14 +1471,14 @@ lib/bigint.pl			An arbitrary precision integer arithmetic package
 lib/bigintpl.t			See if bigint.pl works
 lib/bigint.pm			bigint
 lib/bignum.pm			bignum
+lib/bignum/t/big_e_pi.t		See if bignum exports e() and PI()
 lib/bignum/t/bigexp.t		See if bignum works
 lib/bignum/t/bigint.t		See if bigint works
 lib/bignum/t/bignum.t		See if bignum works
 lib/bignum/t/bigrat.t		See if bigrat works
 lib/bignum/t/bii_e_pi.t		See if bigint exports e() and PI()
-lib/bignum/t/bir_e_pi.t		See if bigrat exports e() and PI()
-lib/bignum/t/big_e_pi.t		See if bignum exports e() and PI()
 lib/bignum/t/biinfnan.t		See if bignum works
+lib/bignum/t/bir_e_pi.t		See if bigrat exports e() and PI()
 lib/bignum/t/bninfnan.t		See if bignum works
 lib/bignum/t/bn_lite.t		See if bignum with Math::BigInt::Lite works
 lib/bignum/t/brinfnan.t		See if bignum works
@@ -1825,8 +1825,8 @@ lib/ExtUtils/t/PL_FILES.t	Test PL_FILES in MakeMaker
 lib/ExtUtils/t/pm.t		See if Makemaker can handle PM
 lib/ExtUtils/t/postamble.t	See if postamble works
 lib/ExtUtils/t/prefixify.t	See if MakeMaker can apply a PREFIX
-lib/ExtUtils/t/prereq.t		See if MakeMaker works
 lib/ExtUtils/t/prereq_print.t	See if PREREQ_PRINT works
+lib/ExtUtils/t/prereq.t		See if MakeMaker works
 lib/ExtUtils/t/problems.t	How MakeMaker reacts to build problems
 lib/ExtUtils/t/prompt.t		See if E::MM::prompt() works
 lib/ExtUtils/t/recurs.t		See if recursive builds work
@@ -2034,7 +2034,6 @@ lib/Math/BigInt/t/alias.inc	Support for BigInt tests
 lib/Math/BigInt/t/bare_mbf.t	Test MBF under Math::BigInt::BareCalc
 lib/Math/BigInt/t/bare_mbi.t	Test MBI under Math::BigInt::BareCalc
 lib/Math/BigInt/t/bare_mif.t	Rounding tests under BareCalc
-lib/Math/BigInt/t/big_pi_e.t	test bpi() and bexp()
 lib/Math/BigInt/t/bigfltpm.inc	Shared tests for bigfltpm.t and sub_mbf.t
 lib/Math/BigInt/t/bigfltpm.t	See if BigFloat.pm works
 lib/Math/BigInt/t/bigintc.t	See if BigInt/Calc.pm works
@@ -2042,6 +2041,7 @@ lib/Math/BigInt/t/bigintpm.inc	Shared tests for bigintpm.t and sub_mbi.t
 lib/Math/BigInt/t/bigintpm.t	See if BigInt.pm works
 lib/Math/BigInt/t/bigints.t	See if BigInt.pm works
 lib/Math/BigInt/t/biglog.t	Test the log function
+lib/Math/BigInt/t/big_pi_e.t	test bpi() and bexp()
 lib/Math/BigInt/t/bigroot.t	Test the broot function
 lib/Math/BigInt/t/calling.t	Test calling conventions
 lib/Math/BigInt/t/config.t	Test Math::BigInt->config()
@@ -3108,6 +3108,7 @@ pod/perlbot.pod			Perl OO tricks and examples
 pod/perlcall.pod		Perl calling conventions from C
 pod/perlcheat.pod		Perl cheat sheet
 pod/perlclib.pod		Internal replacements for standard C library functions
+pod/perlcommunity.pod		Perl community information
 pod/perlcompile.pod		Perl compiler suite intro
 pod/perldata.pod		Perl data structures
 pod/perldbmfilter.pod		Perl DBM filters
@@ -3204,8 +3205,8 @@ pod/rofftoc			Generate a table of contents in troff format
 pod/splitman			Splits perlfunc into multiple man pages
 pod/splitpod			Splits perlfunc into multiple pod pages
 Policy_sh.SH		Hold site-wide preferences between Configure runs.
-Porting/apply		Apply patches sent by mail
 Porting/add-package.pl	Add/Update CPAN modules that are part of Core
+Porting/apply		Apply patches sent by mail
 Porting/check83.pl	Check whether we are 8.3-friendly
 Porting/checkAUTHORS.pl	Check that the AUTHORS file is complete
 Porting/checkcase.pl	Check whether we are case-insensitive-fs-friendly
@@ -3447,7 +3448,6 @@ t/lib/contains_pod.xr		Pod-Parser test file
 t/lib/cygwin.t			Builtin cygwin function tests
 t/lib/Devel/switchd.pm		Module for t/run/switchd.t
 t/lib/Dev/Null.pm		Module for testing Test::Harness
-t/lib/Dummy.pm			Module for testing base.pm
 t/lib/dprof/test1_t		Perl code profiler tests
 t/lib/dprof/test1_v		Perl code profiler tests
 t/lib/dprof/test2_t		Perl code profiler tests
@@ -3465,6 +3465,7 @@ t/lib/dprof/test7_v		Perl code profiler tests
 t/lib/dprof/test8_t		Perl code profiler tests
 t/lib/dprof/test8_v		Perl code profiler tests
 t/lib/dprof/V.pm		Perl code profiler tests
+t/lib/Dummy.pm			Module for testing base.pm
 t/lib/feature/err		Tests for enabling/disabling err feature
 t/lib/feature/implicit		Tests for implicit loading of feature.pm
 t/lib/feature/nonesuch		Tests for enabling/disabling nonexistent feature
@@ -3475,9 +3476,9 @@ t/lib/Filter/Simple/FilterOnlyTest.pm	Helper file for Filter::Simple tests
 t/lib/Filter/Simple/FilterTest.pm	Helper file for Filter::Simple tests
 t/lib/Filter/Simple/ImportTest.pm	Helper file for Filter::Simple tests
 t/lib/filter-util.pl		See if Filter::Util::Call works
-t/lib/HasSigDie.pm		Module for testing base.pm
 t/lib/h2ph.h			Test header file for h2ph
 t/lib/h2ph.pht			Generated output from h2ph.h by h2ph, for comparison
+t/lib/HasSigDie.pm		Module for testing base.pm
 t/lib/locale/latin1		Part of locale.t in Latin 1
 t/lib/locale/utf8		Part of locale.t in UTF8
 t/lib/MakeMaker/Test/Setup/BFD.pm	MakeMaker test utilities
@@ -3770,13 +3771,13 @@ t/op/readline.t			See if <> / readline / rcatline work
 t/op/read.t			See if read() works
 t/op/recurse.t			See if deep recursion works
 t/op/ref.t			See if refs and objects work
+t/op/reg_email.t		See if regex recursion works by parsing email addresses
 t/op/regexp_noamp.t		See if regular expressions work with optimizations
 t/op/regexp_notrie.t		See if regular expressions work without trie optimisation
 t/op/regexp_qr_embed.t		See if regular expressions work with embedded qr//
 t/op/regexp_qr.t		See if regular expressions work as qr//
 t/op/regexp.t			See if regular expressions work
 t/op/regexp_trielist.t		See if regular expressions work with trie optimisation
-t/op/reg_email.t		See if regex recursion works by parsing email addresses
 t/op/reg_mesg.t			See if one can get regular expression errors
 t/op/reg_namedcapture.t		Make sure glob assignment doesn't break named capture
 t/op/reg_nc_tie.t	        Test the tied methods of Tie::Hash::NamedCapture
diff --git a/pod.lst b/pod.lst
index 3b4f5399d0..a12d3a63fd 100644
--- a/pod.lst
+++ b/pod.lst
@@ -123,6 +123,7 @@ h Internals and C Language Interface
 h Miscellaneous
 
   perlbook		Perl book information
+  perlcommunity		Perl community information
   perltodo		Perl things to do
 
   perldoc		Look up Perl documentation in Pod format
diff --git a/pod/perl.pod b/pod/perl.pod
index 15b81067cc..80768fa962 100644
--- a/pod/perl.pod
+++ b/pod/perl.pod
@@ -139,6 +139,7 @@ For ease of access, the Perl manual has been split up into several sections.
 =head2 Miscellaneous
 
     perlbook		Perl book information
+    perlcommunity	Perl community information
     perltodo		Perl things to do
 
     perldoc		Look up Perl documentation in Pod format
diff --git a/pod/perlcommunity.pod b/pod/perlcommunity.pod
new file mode 100644
index 0000000000..bd31258dac
--- /dev/null
+++ b/pod/perlcommunity.pod
@@ -0,0 +1,155 @@
+=head1 NAME
+
+perlcommunity - a brief overview of the Perl community
+
+=head1 DESCRIPTION
+
+This document aims to provide an overview of the vast perl community, which is
+far too large and diverse to provide a detailed listing. If any specific niche
+has been forgotten, it is not meant as an insult but an omission for the sake
+of brevity.
+
+The Perl community is as diverse as Perl, and there is a large amount of
+evidence that the Perl users apply TMTOWTDI to all endeavors, not just
+programming. From websites, to IRC, to mailing lists, there is more than one
+way to get involved in the community.
+
+=head2 Where to find the community
+
+There is a central directory for the Perl community: L<http://perl.org>
+maintained by the Perl Foundation (L<http://www.perlfoundation.org/>),
+which tracks and provides services for a variety of other community sites.
+
+=head2 Mailing lists and Newsgroups
+
+Perl runs on e-mail, there is no doubt about it. The Camel book was originally
+written mostly over e-mail and today Perl's development is co-ordinated through
+mailing lists. The largest repository of Perl mailing lists is located at
+L<http://lists.perl.org>.
+
+Most Perl-related projects set up mailing lists for both users and
+contributors. If you don't see a certain project listed at
+L<http://lists.perl.org>, check the particular website for that project.
+Most mailing lists are archived at L<http://nntp.perl.org/>.
+
+There are also plenty of Perl related newsgroups located under
+C<comp.lang.perl.*>.
+
+=head2 IRC
+
+The Perl community has a rather large IRC presence. For starters, it has its
+own IRC network, L<irc://irc.perl.org>. General (not help-oriented) chat can be
+found at L<irc://irc.perl.org/#perl>. Many other more specific chats are also
+hosted on the network. Information about irc.perl.org is located on the
+network's website: L<http://www.irc.perl.org>. For a more help oriented #perl,
+check out L<irc://irc.freenode.net/#perl>. Perl6 development also has a
+presence in L<irc://irc.freenode.net/#perl6>. Most Perl-related channels will
+be kind enough to point you in the right direction if you ask nicely.
+
+Any large IRC network (Dalnet, EFnet) is also likely to have a #perl channel,
+with varying activity levels.
+
+=head2 Websites
+
+Perl websites come in a variety of forms, but they fit into two large
+categories: forums and news websites. There are many Perl related
+websites, so only a few of the community's largest are mentioned here.
+
+=head3 News sites
+
+=over 4
+
+=item L<http://perl.com/>
+
+Run by O'Reilly Media (The publisher of L<the Camel Book|perlbook> among other
+Perl-related literature), perl.com provides current Perl news, articles, and
+resources for Perl developers as well as a directory of other useful websites.
+
+=item L<http://use.perl.org/>
+
+use Perl; provides a slashdot-style Perl news website covering all things Perl,
+from minutes of the meetings of the Perl6 Design team to conference
+announcements with (ir)relevant discussion.
+
+=back
+
+=head3 Forums
+
+=over 4
+
+=item L<http://www.perlmonks.org/>
+
+PerlMonks is one of the largest Perl forums, and describes itself as "A place
+for individuals to polish, improve, and showcase their Perl skills." and "A
+community which allows everyone to grow and learn from each other."
+
+=back
+
+=head2 User Groups
+
+Many cities around the world have local PerlMongers chapters. A PerlMongers
+chapter is a local user group which typically holds regular in-person meetings,
+both social and technical; helps organize local conferences, workshops, and
+hackathons; and provides a mailing list or other continual contact method for
+its members to keep in touch.
+
+To find your local PerlMongers (or PM as they're commonly abbreviated) group
+check the international PerlMongers directory at L<http://www.pm.org/>.
+
+=head2 Workshops
+
+Perl workshops are, as the name might suggest, workshops where Perl is taught
+in a variety of ways. At the workshops, subjects range from a beginner's
+introduction (such as the Pittsburgh Perl Workshop's "Zero To Perl") to much
+more advanced subjects.
+
+There are several great resources for locating workshops: the
+L<websites|"Websites"> mentioned above, the
+L<calendar|"Calendar of Perl Events"> mentioned below, and the YAPC Europe
+website, L<http://www.yapceurope.org/>, which is probably the best resource for
+European Perl events.
+
+=head2 Hackathons
+
+Hackathons are a very different kind of gathering where Perl hackers gather to
+do just that, hack nonstop for an extended (several day) period on a specific
+project or projects. Information about hackathons can be located in the same
+place as information about L<workshops|"Workshops"> as well as in
+L<irc://irc.perl.org/#perl>.
+
+If you have never been to a hackathon, here are a few basic things you need to
+know before attending: have a working laptop and know how to use it; check out
+the involved projects before hand; have the necessary version control client;
+and bring backup equipment (an extra LAN cable, additional power strips, etc.)
+because someone will forget.
+
+=head2 Conventions
+
+Perl has two major annual conventions: The Perl Conference (now part of OSCON),
+put on by O'Reilly, and Yet Another Perl Conference or YAPC (pronounced
+yap-see), which is localized into several regional YAPCs (North America,
+Europe, Asia) in a stunning grassroots display by the Perl community. For more
+information about either conference, check out their respective web pages:
+OSCON L<http://conferences.oreillynet.com/>; YAPC L<http://www.yapc.org>.
+
+A relatively new conference franchize with a large Perl portion is the
+Open Source Developers Conference or OSDC. First held in Australia it has
+recently also spread to Israel. More information can be found at:
+L<http://www.osdc.com.au/> for Australia, and L<http://www.osdc.org.il>
+for Israel.
+
+=head2 Calendar of Perl Events
+
+The Perl Foundation maintains a website and Google calendar for tracking
+Workshops, Hackathons, Perl Mongers meetings, and the larger conventions
+mentioned above. The web page is located at
+L<http://www.perl.org/events.html>; the Google calendar is named
+I<Perl Events>. Disclaimer: not every Perl Mongers group is on that calendar,
+so don't lose heart if you don't see yours posted. Read the section above
+on L<"User Groups"> to find yours.
+
+=head1 AUTHOR
+
+Edgar "Trizor" Bering <trizor@gmail.com>
+
+=cut
diff --git a/pod/perlmodlib.pod b/pod/perlmodlib.pod
index ab47e2118d..450d36c16d 100644
--- a/pod/perlmodlib.pod
+++ b/pod/perlmodlib.pod
@@ -61,7 +61,7 @@ Postpone load of modules until a function is used
 
 =item base
 
-Establish IS-A relationship with base classes at compile time
+Establish an ISA relationship with base classes at compile time
 
 =item bigint
 
@@ -1849,6 +1849,10 @@ Interfaces to some Win32 API Functions
 
 Low-level access to Win32 system API calls for files/dirs.
 
+=item Win32CORE
+
+Win32 CORE function stubs
+
 =item XS::APItest
 
 Test the perl C API
diff --git a/pod/perltoc.pod b/pod/perltoc.pod
index fcd20473ef..a787b97650 100644
--- a/pod/perltoc.pod
+++ b/pod/perltoc.pod
@@ -885,7 +885,7 @@ Interaction, perlfaq9 - Networking
 
 =back
 
-=head2 perlfaq1 - General Questions About Perl ($Revision: 8539 $)
+=head2 perlfaq1 - General Questions About Perl ($Revision: 9671 $)
 
 =over 4
 
@@ -937,7 +937,7 @@ http://www.perl.org/advocacy/whyperl.html
 
 =back
 
-=head2 perlfaq2 - Obtaining and Learning about Perl ($Revision: 8539 $)
+=head2 perlfaq2 - Obtaining and Learning about Perl ($Revision: 9462 $)
 
 =over 4
 
@@ -1077,7 +1077,7 @@ program; what am I doing wrong?
 
 =back
 
-=head2 perlfaq4 - Data Manipulation ($Revision: 8539 $)
+=head2 perlfaq4 - Data Manipulation ($Revision: 9491 $)
 
 =over 4
 
@@ -1296,7 +1296,7 @@ array of hashes or arrays?
 
 =back
 
-=head2 perlfaq5 - Files and Formats ($Revision: 8579 $)
+=head2 perlfaq5 - Files and Formats ($Revision: 9576 $)
 
 =over 4
 
@@ -1527,7 +1527,7 @@ X<\E, regex>, X<qr//>
 
 =back
 
-=head2 perlfaq7 - General Perl Language Issues ($Revision: 9309 $)
+=head2 perlfaq7 - General Perl Language Issues ($Revision: 9620 $)
 
 =over 4
 
@@ -1610,7 +1610,7 @@ methods?
 
 =back
 
-=head2 perlfaq8 - System Interaction ($Revision: 8539 $)
+=head2 perlfaq8 - System Interaction ($Revision: 9667 $)
 
 =over 4
 
@@ -1731,6 +1731,9 @@ search path?
 
 =item How do I add a directory to my include path (@INC) at runtime?
 
+the PERLLIB environment variable, the PERL5LIB environment variable, the
+perl -Idir command line flag, the use lib pragma:
+
 =item What is socket.ph and where do I get it?
 
 =back
@@ -2871,7 +2874,7 @@ X<punct>, xdigit X<xdigit>
 
 =item Extended Patterns
 
-C<(?#text)> X<(?#)>, C<(?kimsx-imsx)> X<(?)>, C<(?:pattern)> X<(?:)>,
+C<(?#text)> X<(?#)>, C<(?pimsx-imsx)> X<(?)>, C<(?:pattern)> X<(?:)>,
 C<(?imsx-imsx:pattern)>, C<(?|pattern)> X<(?|)> X<Branch reset>,
 Look-Around Assertions X<look-around assertion> X<lookaround assertion>
 X<look-around> X<lookaround>, C<(?=pattern)> X<(?=)> X<look-ahead,
@@ -2895,10 +2898,10 @@ X<backtracking> X<atomic> X<possessive>
 =item Special Backtracking Control Verbs
 
 Verbs that take an argument, C<(*PRUNE)> C<(*PRUNE:NAME)> X<(*PRUNE)>
-X<(*PRUNE:NAME)> X<\v>, C<(*SKIP)> C<(*SKIP:NAME)> X<(*SKIP)>,
-C<(*MARK:NAME)> C<(*:NAME)> X<(*MARK)> C<(*MARK:NAME)> C<(*:NAME)>,
-C<(*THEN)> C<(*THEN:NAME)>, C<(*COMMIT)> X<(*COMMIT)>, Verbs without an
-argument, C<(*FAIL)> C<(*F)> X<(*FAIL)> X<(*F)>, C<(*ACCEPT)> X<(*ACCEPT)>
+X<(*PRUNE:NAME)>, C<(*SKIP)> C<(*SKIP:NAME)> X<(*SKIP)>, C<(*MARK:NAME)>
+C<(*:NAME)> X<(*MARK)> C<(*MARK:NAME)> C<(*:NAME)>, C<(*THEN)>
+C<(*THEN:NAME)>, C<(*COMMIT)> X<(*COMMIT)>, Verbs without an argument,
+C<(*FAIL)> C<(*F)> X<(*FAIL)> X<(*F)>, C<(*ACCEPT)> X<(*ACCEPT)>
 
 =item Backtracking
 X<backtrack> X<backtracking>
@@ -4362,7 +4365,8 @@ Tie::Hash, Tie::Hash::NamedCapture, Tie::Memoize, Tie::RefHash,
 Tie::Scalar, Tie::SubstrHash, Time::HiRes, Time::Local, Time::Piece,
 Time::Piece::Seconds, Time::gmtime, Time::localtime, Time::tm, UNIVERSAL,
 Unicode::Collate, Unicode::Normalize, Unicode::UCD, User::grent,
-User::pwent, Win32, Win32API::File, XS::APItest, XS::Typemap, XSLoader
+User::pwent, Win32, Win32API::File, Win32CORE, XS::APItest, XS::Typemap,
+XSLoader
 
 =item Extension Modules
 
@@ -5521,7 +5525,8 @@ callback
 
 C</m> - RXf_PMf_MULTILINE, C</s> - RXf_PMf_SINGLELINE, C</i> -
 RXf_PMf_FOLD, C</x> - RXf_PMf_EXTENDED, C</p> - RXf_PMf_KEEPCOPY,
-RXf_SKIPWHITE, RXf_PMf_LOCALE, RXf_UTF8, RXf_START_ONLY, RXf_WHITE
+RXf_PMf_LOCALE, RXf_UTF8, RXf_SPLIT, RXf_SKIPWHITE, RXf_START_ONLY,
+RXf_WHITE
 
 =item exec
 
@@ -5718,6 +5723,10 @@ X<sv_pvn>, sv_pvutf8 X<sv_pvutf8>, sv_pvutf8n X<sv_pvutf8n>, sv_taint
 X<sv_taint>, sv_unref X<sv_unref>, sv_usepvn X<sv_usepvn>, sv_usepvn_mg
 X<sv_usepvn_mg>, sv_uv X<sv_uv>, unpack_str X<unpack_str>
 
+=item Functions in file pp_ctl.c
+
+find_runcv X<find_runcv>
+
 =item Functions in file pp_pack.c
 
 packlist X<packlist>, unpackstring X<unpackstring>
@@ -5993,10 +6002,6 @@ PAD_SET_CUR X<PAD_SET_CUR>, PAD_SET_CUR_NOSAVE X<PAD_SET_CUR_NOSAVE>,
 PAD_SV X<PAD_SV>, PAD_SVl X<PAD_SVl>, SAVECLEARSV X<SAVECLEARSV>,
 SAVECOMPPAD X<SAVECOMPPAD>, SAVEPADSV X<SAVEPADSV>
 
-=item Functions in file pp_ctl.c
-
-find_runcv X<find_runcv>
-
 =item GV Functions
 
 is_gv_magical X<is_gv_magical>, is_gv_magical_sv X<is_gv_magical_sv>
@@ -6336,20 +6341,46 @@ I<The Road goes ever on and on, down from the door where it began.>
 
 =back
 
-=head2 perltodo - Perl TO-DO List
+=head2 perlcommunity - a brief overview of the Perl community
 
 =over 4
 
 =item DESCRIPTION
 
-=item The roadmap to 5.10
-
 =over 4
 
-=item Needed for the final 5.10.0 release
+=item Where to find the community
+
+=item Mailing lists and Newsgroups
+
+=item IRC
+
+=item Websites
+
+L<http://perl.com/>, L<http://use.perl.org/>, L<http://www.perlmonks.org/>
+
+=item User Groups
+
+=item Workshops
+
+=item Hackathons
+
+=item Conventions
+
+=item Calendar of Perl Events
 
 =back
 
+=item AUTHOR
+
+=back
+
+=head2 perltodo - Perl TO-DO List
+
+=over 4
+
+=item DESCRIPTION
+
 =item Tasks that only need Perl knowledge
 
 =over 4
@@ -11435,9 +11466,9 @@ signal name: ..
 
 =item BUGS AND LIMITATIONS
 
-Using non-threadsafe modules, Parent-child threads, Creating threads inside
-special blocks, Unsafe signals, Perl has been built with
-C<PERL_OLD_SIGNALS> (see C<perl -V>), The environment variable
+Threadsafe modules, Using non-threadsafe modules, Parent-child threads,
+Creating threads inside special blocks, Unsafe signals, Perl has been built
+with C<PERL_OLD_SIGNALS> (see C<perl -V>), The environment variable
 C<PERL_SIGNALS> is set to C<unsafe> (see L<perlrun/"PERL_SIGNALS">), The
 module L<Perl::Unsafe::Signals> is used, Returning closures from threads,
 Returning objects from threads, Perl Bugs and the CPAN Version of
@@ -11513,7 +11544,8 @@ FETCH_I<type>_ATTRIBUTES, MODIFY_I<type>_ATTRIBUTES
 
 =back
 
-=head2 base - Establish IS-A relationship with base classes at compile time
+=head2 base - Establish an ISA relationship with base classes at compile
+time
 
 =over 4
 
@@ -11523,7 +11555,7 @@ FETCH_I<type>_ATTRIBUTES, MODIFY_I<type>_ATTRIBUTES
 
 =item DIAGNOSTICS
 
-Base class package "%s" is empty
+Base class package "%s" is empty, Class 'Foo' tried to inherit from itself
 
 =item HISTORY
 
@@ -11558,7 +11590,7 @@ or version
 
 =item Methods
 
-inf(), NaN(), upgrade(), in_effect()
+inf(), NaN(), e, PI, bexp(), bpi(), upgrade(), in_effect()
 
 =item MATH LIBRARY
 
@@ -11600,7 +11632,7 @@ a or accuracy, p or precision, t or trace, l or lib, hex, oct, v or version
 
 =item Caveats
 
-inf(), NaN(), upgrade(), in_effect()
+inf(), NaN(), e, PI(), bexp(), bpi(), upgrade(), in_effect()
 
 =item Math Library
 
@@ -11644,7 +11676,7 @@ in_effect(), hex()/oct()
 
 =item Methods
 
-inf(), NaN(), upgrade(), in_effect()
+inf(), NaN(), e, PI, bexp(), bpi(), upgrade(), in_effect()
 
 =item MATH LIBRARY
 
@@ -12611,8 +12643,6 @@ $ae->extract_path, $ae->files
 
 =item File Extensions
 
-=item Bzip2 Support
-
 =back
 
 =item GLOBAL VARIABLES
@@ -13142,8 +13172,7 @@ FILL, MAX, KEYS, RITER, NAME, ARRAY, PMROOT
 
 =item B::OP Methods
 
-next, sibling, name, ppaddr, desc, targ, type, opt, static, flags, private,
-spare
+next, sibling, name, ppaddr, desc, targ, type, opt, flags, private, spare
 
 =item B::UNOP METHOD
 
@@ -13256,9 +13285,9 @@ B<#>I<var>, B<#>I<var>I<N>, B<#>I<Var>, B<#addr>, B<#arg>, B<#class>,
 B<#classsym>, B<#coplabel>, B<#exname>, B<#extarg>, B<#firstaddr>,
 B<#flags>, B<#flagval>, B<#hints>, B<#hintsval>, B<#hyphseq>, B<#label>,
 B<#lastaddr>, B<#name>, B<#NAME>, B<#next>, B<#nextaddr>, B<#noise>,
-B<#private>, B<#privval>, B<#seq>, B<#seqnum>, B<#opt>, B<#static>,
-B<#sibaddr>, B<#svaddr>, B<#svclass>, B<#svval>, B<#targ>, B<#targarg>,
-B<#targarglife>, B<#typenum>
+B<#private>, B<#privval>, B<#seq>, B<#seqnum>, B<#opt>, B<#sibaddr>,
+B<#svaddr>, B<#svclass>, B<#svval>, B<#targ>, B<#targarg>, B<#targarglife>,
+B<#typenum>
 
 =back
 
@@ -19715,7 +19744,8 @@ MakeMaker
 
 How do I install a module into my home directory?, How do I get MakeMaker
 and Module::Build to install to the same place?, How do I keep from
-installing man pages?, How do I use a module without installing it?
+installing man pages?, How do I use a module without installing it?, PREFIX
+vs INSTALL_BASE from Module::Build::Cookbook
 
 =item Philosophy and History
 
@@ -20361,6 +20391,8 @@ file_name_is_absolute
 
 tmpdir (override)
 
+case_tolerant
+
 =over 4
 
 =item COPYRIGHT
@@ -25267,6 +25299,14 @@ ffround ( +$scale ), ffround ( -$scale ), ffround ( 0 ), fround  ( +$scale
 
 =item bpi()
 
+=item bcos()
+
+=item bsin()
+
+=item batan2()
+
+=item batan()
+
 =item bmuladd()
 
 =back
@@ -25391,6 +25431,14 @@ Input, Output
 
 =item bpi()
 
+=item bcos()
+
+=item bsin()
+
+=item batan2()
+
+=item batan()
+
 =item blsft()
 
 =item brsft()
@@ -26875,11 +26923,11 @@ RECURSE ]), mkdir ( DIR [, RECURSE ]), alloc ( SIZE [, RECORD_SIZE] ), ls (
 put ( LOCAL_FILE [, REMOTE_FILE ] ), put_unique ( LOCAL_FILE [, REMOTE_FILE
 ] ), append ( LOCAL_FILE [, REMOTE_FILE ] ), unique_name (), mdtm ( FILE ),
 size ( FILE ), supported ( CMD ), hash ( [FILEHANDLE_GLOB_REF],[
-BYTES_PER_HASH_MARK] ), nlst ( [ DIR ] ), list ( [ DIR ] ), retr ( FILE ),
-stor ( FILE ), stou ( FILE ), appe ( FILE ), port ( [ PORT ] ), pasv (),
-pasv_xfer ( SRC_FILE, DEST_SERVER [, DEST_FILE ] ), pasv_xfer_unique (
-SRC_FILE, DEST_SERVER [, DEST_FILE ] ), pasv_wait ( NON_PASV_SERVER ),
-abort (), quit ()
+BYTES_PER_HASH_MARK] ), feature ( NAME ), nlst ( [ DIR ] ), list ( [ DIR ]
+), retr ( FILE ), stor ( FILE ), stou ( FILE ), appe ( FILE ), port ( [
+PORT ] ), pasv (), pasv_xfer ( SRC_FILE, DEST_SERVER [, DEST_FILE ] ),
+pasv_xfer_unique ( SRC_FILE, DEST_SERVER [, DEST_FILE ] ), pasv_wait (
+NON_PASV_SERVER ), abort (), quit ()
 
 =over 4
 
@@ -32286,6 +32334,8 @@ C<":SEM_">, C<":PARTITION_">, C<":ALL">
 
 =back
 
+=head2 Win32CORE - Win32 CORE function stubs
+
 =over 4
 
 =item DESCRIPTION
diff --git a/vms/descrip_mms.template b/vms/descrip_mms.template
index 2b66a74370..6772a27f46 100644
--- a/vms/descrip_mms.template
+++ b/vms/descrip_mms.template
@@ -394,16 +394,16 @@ pod3 = [.lib.pods]perl587delta.pod [.lib.pods]perl588delta.pod [.lib.pods]perl58
 pod4 = [.lib.pods]perl592delta.pod [.lib.pods]perl593delta.pod [.lib.pods]perl594delta.pod [.lib.pods]perl595delta.pod [.lib.pods]perlaix.pod
 pod5 = [.lib.pods]perlamiga.pod [.lib.pods]perlapi.pod [.lib.pods]perlapio.pod [.lib.pods]perlapollo.pod [.lib.pods]perlartistic.pod [.lib.pods]perlbeos.pod
 pod6 = [.lib.pods]perlbook.pod [.lib.pods]perlboot.pod [.lib.pods]perlbot.pod [.lib.pods]perlbs2000.pod [.lib.pods]perlcall.pod [.lib.pods]perlce.pod
-pod7 = [.lib.pods]perlcheat.pod [.lib.pods]perlclib.pod [.lib.pods]perlcn.pod [.lib.pods]perlcompile.pod [.lib.pods]perlcygwin.pod [.lib.pods]perldata.pod
-pod8 = [.lib.pods]perldbmfilter.pod [.lib.pods]perldebguts.pod [.lib.pods]perldebtut.pod [.lib.pods]perldebug.pod [.lib.pods]perldelta.pod
-pod9 = [.lib.pods]perldgux.pod [.lib.pods]perldiag.pod [.lib.pods]perldoc.pod [.lib.pods]perldos.pod [.lib.pods]perldsc.pod [.lib.pods]perlebcdic.pod
-pod10 = [.lib.pods]perlembed.pod [.lib.pods]perlepoc.pod [.lib.pods]perlfaq.pod [.lib.pods]perlfaq1.pod [.lib.pods]perlfaq2.pod [.lib.pods]perlfaq3.pod
-pod11 = [.lib.pods]perlfaq4.pod [.lib.pods]perlfaq5.pod [.lib.pods]perlfaq6.pod [.lib.pods]perlfaq7.pod [.lib.pods]perlfaq8.pod [.lib.pods]perlfaq9.pod
-pod12 = [.lib.pods]perlfilter.pod [.lib.pods]perlfork.pod [.lib.pods]perlform.pod [.lib.pods]perlfreebsd.pod [.lib.pods]perlfunc.pod
-pod13 = [.lib.pods]perlglossary.pod [.lib.pods]perlgpl.pod [.lib.pods]perlguts.pod [.lib.pods]perlhack.pod [.lib.pods]perlhist.pod [.lib.pods]perlhpux.pod
-pod14 = [.lib.pods]perlhurd.pod [.lib.pods]perlintern.pod [.lib.pods]perlintro.pod [.lib.pods]perliol.pod [.lib.pods]perlipc.pod [.lib.pods]perlirix.pod
-pod15 = [.lib.pods]perljp.pod [.lib.pods]perlko.pod [.lib.pods]perllexwarn.pod [.lib.pods]perllinux.pod [.lib.pods]perllocale.pod [.lib.pods]perllol.pod
-pod16 = [.lib.pods]perlmachten.pod [.lib.pods]perlmacos.pod [.lib.pods]perlmacosx.pod [.lib.pods]perlmint.pod [.lib.pods]perlmod.pod
+pod7 = [.lib.pods]perlcheat.pod [.lib.pods]perlclib.pod [.lib.pods]perlcn.pod [.lib.pods]perlcommunity.pod [.lib.pods]perlcompile.pod
+pod8 = [.lib.pods]perlcygwin.pod [.lib.pods]perldata.pod [.lib.pods]perldbmfilter.pod [.lib.pods]perldebguts.pod [.lib.pods]perldebtut.pod
+pod9 = [.lib.pods]perldebug.pod [.lib.pods]perldelta.pod [.lib.pods]perldgux.pod [.lib.pods]perldiag.pod [.lib.pods]perldoc.pod [.lib.pods]perldos.pod
+pod10 = [.lib.pods]perldsc.pod [.lib.pods]perlebcdic.pod [.lib.pods]perlembed.pod [.lib.pods]perlepoc.pod [.lib.pods]perlfaq.pod [.lib.pods]perlfaq1.pod
+pod11 = [.lib.pods]perlfaq2.pod [.lib.pods]perlfaq3.pod [.lib.pods]perlfaq4.pod [.lib.pods]perlfaq5.pod [.lib.pods]perlfaq6.pod [.lib.pods]perlfaq7.pod
+pod12 = [.lib.pods]perlfaq8.pod [.lib.pods]perlfaq9.pod [.lib.pods]perlfilter.pod [.lib.pods]perlfork.pod [.lib.pods]perlform.pod [.lib.pods]perlfreebsd.pod
+pod13 = [.lib.pods]perlfunc.pod [.lib.pods]perlglossary.pod [.lib.pods]perlgpl.pod [.lib.pods]perlguts.pod [.lib.pods]perlhack.pod [.lib.pods]perlhist.pod
+pod14 = [.lib.pods]perlhpux.pod [.lib.pods]perlhurd.pod [.lib.pods]perlintern.pod [.lib.pods]perlintro.pod [.lib.pods]perliol.pod [.lib.pods]perlipc.pod
+pod15 = [.lib.pods]perlirix.pod [.lib.pods]perljp.pod [.lib.pods]perlko.pod [.lib.pods]perllexwarn.pod [.lib.pods]perllinux.pod [.lib.pods]perllocale.pod
+pod16 = [.lib.pods]perllol.pod [.lib.pods]perlmachten.pod [.lib.pods]perlmacos.pod [.lib.pods]perlmacosx.pod [.lib.pods]perlmint.pod [.lib.pods]perlmod.pod
 pod17 = [.lib.pods]perlmodinstall.pod [.lib.pods]perlmodlib.pod [.lib.pods]perlmodstyle.pod [.lib.pods]perlmpeix.pod [.lib.pods]perlnetware.pod
 pod18 = [.lib.pods]perlnewmod.pod [.lib.pods]perlnumber.pod [.lib.pods]perlobj.pod [.lib.pods]perlop.pod [.lib.pods]perlopenbsd.pod
 pod19 = [.lib.pods]perlopentut.pod [.lib.pods]perlos2.pod [.lib.pods]perlos390.pod [.lib.pods]perlos400.pod [.lib.pods]perlothrtut.pod
@@ -874,6 +874,10 @@ makeppport : $(MINIPERL_EXE) $(ARCHDIR)Config.pm
 	@ If F$Search("[.lib]pods.dir").eqs."" Then Create/Directory [.lib.pods]
 	Copy/NoConfirm/Log $(MMS$SOURCE) [.lib.pods]
 
+[.lib.pods]perlcommunity.pod : [.pod]perlcommunity.pod
+	@ If F$Search("[.lib]pods.dir").eqs."" Then Create/Directory [.lib.pods]
+	Copy/NoConfirm/Log $(MMS$SOURCE) [.lib.pods]
+
 [.lib.pods]perlcompile.pod : [.pod]perlcompile.pod
 	@ If F$Search("[.lib]pods.dir").eqs."" Then Create/Directory [.lib.pods]
 	Copy/NoConfirm/Log $(MMS$SOURCE) [.lib.pods]
diff --git a/win32/pod.mak b/win32/pod.mak
index 3bcc27711c..e48d4e9160 100644
--- a/win32/pod.mak
+++ b/win32/pod.mak
@@ -48,6 +48,7 @@ POD = \
 	perlcall.pod	\
 	perlcheat.pod	\
 	perlclib.pod	\
+	perlcommunity.pod	\
 	perlcompile.pod	\
 	perldata.pod	\
 	perldbmfilter.pod	\
@@ -166,6 +167,7 @@ MAN = \
 	perlcall.man	\
 	perlcheat.man	\
 	perlclib.man	\
+	perlcommunity.man	\
 	perlcompile.man	\
 	perldata.man	\
 	perldbmfilter.man	\
@@ -284,6 +286,7 @@ HTML = \
 	perlcall.html	\
 	perlcheat.html	\
 	perlclib.html	\
+	perlcommunity.html	\
 	perlcompile.html	\
 	perldata.html	\
 	perldbmfilter.html	\
@@ -402,6 +405,7 @@ TEX = \
 	perlcall.tex	\
 	perlcheat.tex	\
 	perlclib.tex	\
+	perlcommunity.tex	\
 	perlcompile.tex	\
 	perldata.tex	\
 	perldbmfilter.tex	\