perlreapi.pod: Update RXf_SPLIT section

[perl5.git] / pod / perl.pod

diff --git a/pod/perl.pod b/pod/perl.pod
index 6321dee..fa0a7f9 100644 (file)
--- a/pod/perl.pod
+++ b/pod/perl.pod
@@ -15,6 +15,8 @@ B<perl>       S<[ B<-sTtuUWX> ]>
        S<[ B<-i>[I<extension>] ]>
        S<[ [B<-e>|B<-E>] I<'command'> ] [ B<--> ] [ I<programfile> ] [ I<argument> ]...>
 
+For more information on these options, you can run C<perldoc perlrun>.
+
 =head1 GETTING HELP
 
 The F<perldoc> program gives you access to all the documentation that comes
@@ -28,10 +30,29 @@ perldoc> to learn more things you can do with F<perldoc>.
 
 For ease of access, the Perl manual has been split up into several sections.
 
+=begin buildtoc
+
+# This section is parsed by Porting/pod_lib.pl for use by pod/buildtoc etc
+
+flag =g  perluniprops perlmodlib perlapi perlintern
+flag =go perltoc
+flag =ro perlcn perljp perlko perltw
+flag =   perlvms
+
+path perlfaq.*               cpan/perlfaq/lib/
+path perlglossary            cpan/perlfaq/lib/
+path perlxs(?:tut|typemap)?  dist/ExtUtils-ParseXS/lib/
+path perldoc                 cpan/Pod-Perldoc/lib/
+
+aux a2p c2ph h2ph h2xs perlbug pl2pm pod2html pod2man s2p splain xsubpp
+
+=end buildtoc
+
 =head2 Overview
 
     perl               Perl overview (this section)
     perlintro          Perl introduction for beginners
+    perlrun            Perl execution and options
     perltoc            Perl documentation table of contents
 
 =head2 Tutorials
@@ -76,7 +97,6 @@ For ease of access, the Perl manual has been split up into several sections.
     perlpod            Perl plain old documentation
     perlpodspec        Perl plain old documentation format specification
     perlpodstyle       Perl POD style guide
-    perlrun            Perl execution and options
     perldiag           Perl diagnostic messages
     perllexwarn        Perl warnings and their control
     perldebug          Perl debugging
@@ -102,7 +122,7 @@ For ease of access, the Perl manual has been split up into several sections.
     perluniintro       Perl Unicode introduction
     perlunicode        Perl Unicode support
     perlunifaq         Perl Unicode FAQ
-    perluniprops       Index of Unicode Version 6.0.0 properties in Perl
+    perluniprops       Index of Unicode properties in Perl
     perlunitut         Perl Unicode tutorial
     perlebcdic         Considerations for running Perl on EBCDIC platforms
 
@@ -129,6 +149,7 @@ For ease of access, the Perl manual has been split up into several sections.
     perldebguts        Perl debugging guts and tips
     perlxstut          Perl XS tutorial
     perlxs             Perl XS application programming interface
+    perlxstypemap      Perl XS C/Perl type conversion tools
     perlclib           Internal replacements for standard C library functions
     perlguts           Perl internal functions for those doing extensions
     perlcall           Perl calling conventions from C
@@ -153,18 +174,18 @@ For ease of access, the Perl manual has been split up into several sections.
 
     perlbook           Perl book information
     perlcommunity      Perl community information
-    perltodo           Perl things to do
 
     perldoc            Look up Perl documentation in Pod format
 
     perlhist           Perl history records
     perldelta          Perl changes since previous version
-    perl5155delta      Perl changes in version 5.15.5
-    perl5154delta      Perl changes in version 5.15.4
-    perl5153delta      Perl changes in version 5.15.3
-    perl5152delta      Perl changes in version 5.15.2
-    perl5151delta      Perl changes in version 5.15.1
-    perl5150delta      Perl changes in version 5.15.0
+    perl5174delta      Perl changes in version 5.17.4
+    perl5173delta      Perl changes in version 5.17.3
+    perl5172delta      Perl changes in version 5.17.2
+    perl5171delta      Perl changes in version 5.17.1
+    perl5170delta      Perl changes in version 5.17.0
+    perl5161delta      Perl changes in version 5.16.1
+    perl5160delta      Perl changes in version 5.16.0
     perl5142delta      Perl changes in version 5.14.2
     perl5141delta      Perl changes in version 5.14.1
     perl5140delta      Perl changes in version 5.14.0
@@ -197,6 +218,8 @@ For ease of access, the Perl manual has been split up into several sections.
 
 =head2 Language-Specific
 
+=for buildtoc flag +r
+
     perlcn             Perl for Simplified Chinese (in EUC-CN)
     perljp             Perl for Japanese (in EUC-JP)
     perlko             Perl for Korean (in EUC-KR)
@@ -221,7 +244,6 @@ For ease of access, the Perl manual has been split up into several sections.
     perllinux          Perl notes for Linux
     perlmacos          Perl notes for Mac OS (Classic)
     perlmacosx         Perl notes for Mac OS X
-    perlmpeix          Perl notes for MPE/iX
     perlnetware        Perl notes for NetWare
     perlopenbsd        Perl notes for OpenBSD
     perlos2            Perl notes for OS/2
@@ -233,19 +255,21 @@ For ease of access, the Perl manual has been split up into several sections.
     perlsolaris        Perl notes for Solaris
     perlsymbian        Perl notes for Symbian
     perltru64          Perl notes for Tru64
-    perluts            Perl notes for UTS
-    perlvmesa          Perl notes for VM/ESA
     perlvms            Perl notes for VMS
     perlvos            Perl notes for Stratus VOS
     perlwin32          Perl notes for Windows
 
+=for buildtoc flag -r
+
 =head2 Stubs for Deleted Documents
 
     perlboot           
     perlbot            
+    perltodo
     perltooc           
     perltoot           
 
+=for buildtoc __END__
 
 On a Unix-like system, these documentation files will usually also be
 available as manpages for use with the F<man> program.
@@ -301,8 +325,8 @@ Described in L<perlmod>, L<perlmodlib>, and L<perlmodinstall>.
 
 embeddable and extensible 
 
-Described in L<perlembed>, L<perlxstut>, L<perlxs>, L<perlcall>,
-L<perlguts>, and L<xsubpp>.
+Described in L<perlembed>, L<perlxstut>, L<perlxs>, L<perlxstypemap>,
+L<perlcall>, L<perlguts>, and L<xsubpp>.
 
 =item *