This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
[win32] merge changes#872,873 from maintbranch
[perl5.git] / pod / perl.pod
index fc41582..a7e02f6 100644 (file)
@@ -21,6 +21,7 @@ of sections:
     perl       Perl overview (this section)
     perldelta  Perl changes since previous version
     perlfaq    Perl frequently asked questions
+    perltoc    Perl documentation table of contents
 
     perldata   Perl data structures
     perlsyn    Perl syntax
@@ -30,7 +31,8 @@ of sections:
     perlfunc   Perl builtin functions
     perlvar    Perl predefined variables
     perlsub    Perl subroutines
-    perlmod    Perl modules
+    perlmod    Perl modules: how they work
+    perlmodlib Perl modules: how to write and use
     perlform   Perl formats
     perllocale Perl locale support
 
@@ -59,6 +61,8 @@ of sections:
     perlguts   Perl internal functions for those doing extensions
     perlcall   Perl calling conventions from C
 
+    perlhist   Perl history records
+
 (If you're intending to read these straight through for the first time,
 the suggested order will tend to reduce the number of forward references.)
 
@@ -219,9 +223,9 @@ all old regular expressions.
 
 =item * Innumerable Unbundled Modules
 
-The Comprehensive Perl Archive Network described in L<perlmod>
-contains hundreds of plug-and-play modules full of reusable
-code.  See F<http://www.perl.com/CPAN> for a site near you.
+The Comprehensive Perl Archive Network described in L<perlmodlib>
+contains hundreds of plug-and-play modules full of reusable code.
+See F<http://www.perl.com/CPAN> for a site near you.
 
 =item * Compilability
 
@@ -241,6 +245,11 @@ See L<perlrun>.
 
 Larry Wall <F<larry@wall.org>>, with the help of oodles of other folks.
 
+If your Perl success stories and testimonials may be of help to others 
+who wish to advocate the use of Perl in their applications, 
+or if you wish to simply express your gratitude to Larry and the 
+Perl developers, please write to <F<perl-thanks@perl.org>>.
+
 =head1 FILES
 
  "/tmp/perl-e$$"       temporary file for -e commands
@@ -274,8 +283,8 @@ switch?
 The B<-w> switch is not mandatory.
 
 Perl is at the mercy of your machine's definitions of various
-operations such as type casting, atof(), and sprintf().  The latter
-can even trigger a core dump when passed ludicrous input values.
+operations such as type casting, atof(), and floating-point
+output with sprintf().
 
 If your stdio requires a seek or eof between reads and writes on a
 particular stream, so does Perl.  (This doesn't apply to sysread()