This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Exporter.pm
[perl5.git] / pod / buildtoc.PL
index 94b2ed1..47972b7 100644 (file)
@@ -59,58 +59,105 @@ if (-d "pod") {
   die "$0: failed to chdir('pod'): $!\n" unless chdir("pod");
 }
 
-@pods = qw(
-    perl                
-    perlfaq             
-    perltoc             
-
-    perlsyn            
-    perldata            
-    perlop              
-    perlsub             
-    perlfunc            
-    perlreftut          
-    perldsc             
-    perllol             
-    perlrequick         
-    perlretut           
-
-    perlrun             
-    perllexwarn         
-    perldebug           
-
-    perlopentut         
-    perlvar             
-    perlmod             
-    perlpod             
-
-    perlstyle           
-    perlmodlib          
-    perlmodinstall      
-    perlnewmod          
-    perltrap            
-    perlport            
-    perlsec             
-
-    perlref             
-    perlre              
-    perlform            
-    perllocale          
-    perlunicode         
-
-    perlboot            
-    perltoot            
-    perltootc           
-    perlobj             
-    perlbot             
-    perltie             
-
-    perlipc             
-    perlnumber          
-    perlfork            
-    perlthrtut          
-
-    perldiag            
+@ARCHPODS = qw(
+    perlaix    
+    perlapollo
+    perlamiga          
+    perlbeos
+    perlbs2000
+    perlce
+    perlcygwin          
+    perldgux             
+    perldos             
+    perlepoc             
+    perlhpux            
+    perlhurd            
+    perlmachten         
+    perlmacos
+    perlmint
+    perlmpeix
+    perlnetware             
+    perlos2             
+    perlos390           
+    perlqnx
+    perlplan9
+    perlsolaris
+    perltru64
+    perluts
+    perlvmesa
+    perlvms             
+    perlvos             
+    perlwin32           
+          );
+
+@pods = 
+  (
+    qw(
+
+    perl
+    perlintro
+    perlfaq
+    perltoc
+    perlbook
+
+    perlsyn
+    perldata
+    perlop
+    perlsub
+    perlfunc
+    perlreftut
+    perldsc
+    perlrequick
+    perlpod
+    perlpodspec
+    perlstyle
+    perltrap
+
+    perlrun
+    perldiag
+    perllexwarn
+    perldebtut
+    perldebug
+
+    perlvar
+    perllol
+    perlopentut
+    perlpacktut
+    perlretut
+
+    perlre
+    perlref
+
+    perlform
+
+    perlboot
+    perltoot
+    perltooc
+    perlobj
+    perlbot
+    perltie
+
+    perlipc
+    perlfork
+    perlnumber
+
+    perlthrtut
+    perlothrtut
+
+    perlport
+    perllocale
+    perluniintro
+    perlunicode
+    perlebcdic
+
+    perlsec
+
+    perlmod
+    perlmodinstall
+    perlmodlib
+    perlmodstyle
+    perlnewmod
+
     perlfaq1            
     perlfaq2            
     perlfaq3            
@@ -127,6 +174,7 @@ if (-d "pod") {
     perldebguts         
     perlxstut           
     perlxs              
+    perlclib            
     perlguts            
     perlcall            
     perlutil            
@@ -134,38 +182,27 @@ if (-d "pod") {
     perldbmfilter       
     perlapi             
     perlintern          
+    perliol            
     perlapio            
     perltodo            
     perlhack            
 
     perlhist           
     perldelta           
+    perl572delta         
+    perl571delta         
+    perl570delta         
+    perl561delta         
     perl56delta         
     perl5005delta       
     perl5004delta       
 
-    perlamiga          
-    perlcygwin          
-    perldos             
-    perlhpux            
-    perlmachten         
-    perlos2             
-    perlos390           
-    perlvms             
-    perlwin32           
-         );
+    ),
+
+    @ARCHPODS
+
+  );
 
-@ARCHPODS = qw(
-    perlamiga          
-    perlcygwin          
-    perldos             
-    perlhpux            
-    perlmachten         
-    perlos2             
-    perlos390           
-    perlvms             
-    perlwin32           
-          );
 for (@ARCHPODS) { s/$/.pod/ }
 @ARCHPODS{@ARCHPODS} = ();
 
@@ -185,7 +222,7 @@ close(MANI);
 open(PERLPOD, "perl.pod") || die "$0: opening perl.pod failed: $!\n";
 while (<PERLPOD>) {
   if (/^For ease of access, /../^\(If you're intending /) {
-       if (/^\s+(perl\w*)\s+\w/) {
+       if (/^\s+(perl\S*)\s+\w/) {
                push @PERLPODS, "$1.pod";
        }
   }
@@ -253,7 +290,10 @@ sub getpods {
        return if /(.*)\.pm$/ && -f "$1.pod";
        my $file = $File::Find::name;
        return if $file eq '../lib/Pod/Functions.pm'; # Used only by pod itself
-
+        return if $file =~ m!lib/Attribute/Handlers/demo/!;
+       return if $file =~ m!lib/Net/FTP/.+\.pm!; # Hi, Graham! :-)
+        return if $file =~ m!lib/Math/BigInt/t/!;
+       return if $file =~ m!/Devel/PPPort/[Hh]arness|lib/Devel/Harness!i;
        die "tut $name" if $file =~ /TUT/;
        unless (open (F, "< $_\0")) {
            warn "bogus <$file>: $!";
@@ -318,7 +358,7 @@ podset( @modules[ sort { $modname[$a] cmp $modname[$b] } 0 .. $#modules ] );
        Here should be listed all the extra programs' documentation, but they
        don't all have manual pages yet:
 
-       =over
+       =over 4
 
        =item a2p
 
@@ -371,13 +411,13 @@ sub podset {
        }
        if (s/^=head1 (.*)/=item $1/) {
            unhead2();
-           output "=over\n\n" unless $inhead1;
+           output "=over 4\n\n" unless $inhead1;
            $inhead1 = 1;
            output $_; nl(); next;
        }
        if (s/^=head2 (.*)/=item $1/) {
            unitem();
-           output "=over\n\n" unless $inhead2;
+           output "=over 4\n\n" unless $inhead2;
            $inhead2 = 1;
            output $_; nl(); next;
        }
@@ -389,7 +429,7 @@ sub podset {
            s/\s+$//;
            next if /^[\d.]+$/;
            next if $pod eq 'perlmodlib' && /^ftp:/;
-           ##print "=over\n\n" unless $initem;
+           ##print "=over 4\n\n" unless $initem;
            output ", " if $initem;
            $initem = 1;
            s/\.$//;
@@ -464,3 +504,7 @@ sub output ($) {
 
 !NO!SUBS!
 
+close OUT or die "Can't close $file: $!";
+chmod 0755, $file or die "Can't reset permissions for $file: $!\n";
+exec("$Config{'eunicefix'} $file") if $Config{'eunicefix'} ne ':';
+chdir $origdir;