[PATCH] more pod patches

Yet more pod linting, this time on .pm files. I've touched things
without fear or favour mostly - I think probably a few of these changes
affect things that are also maintained outside the core.


diff -urN perl-current.orig/configpm perl-current/configpm
--- perl-current.orig/configpm	Thu Mar 15 20:33:42 2001
+++ perl-current/configpm	Thu Mar 15 21:10:59 2001
@@ -418,7 +418,7 @@
     print CONFIG <<EOF;
 =head2 $c
 
-=over
+=over 4
 
 EOF
     $text = 1;
diff -urN perl-current.orig/ext/B/B/Bytecode.pm perl-current/ext/B/B/Bytecode.pm
--- perl-current.orig/ext/B/B/Bytecode.pm	Thu Mar 15 20:33:17 2001
+++ perl-current/ext/B/B/Bytecode.pm	Thu Mar 15 20:36:28 2001
@@ -967,9 +967,9 @@
 through the assembler and outputting bytecode.
 
 =item B<-upackage>
-  
+
 Stores package in the output.
-  
+
 =back
 
 =head1 EXAMPLES
diff -urN perl-current.orig/ext/DB_File/DB_File.pm perl-current/ext/DB_File/DB_File.pm
--- perl-current.orig/ext/DB_File/DB_File.pm	Thu Mar 15 20:33:18 2001
+++ perl-current/ext/DB_File/DB_File.pm	Thu Mar 15 20:40:31 2001
@@ -388,8 +388,8 @@
 
 =head1 SYNOPSIS
 
- use DB_File ;
- 
+ use DB_File;
+
  [$X =] tie %hash,  'DB_File', [$filename, $flags, $mode, $DB_HASH] ;
  [$X =] tie %hash,  'DB_File', $filename, $flags, $mode, $DB_BTREE ;
  [$X =] tie @array, 'DB_File', $filename, $flags, $mode, $DB_RECNO ;
@@ -699,7 +699,7 @@
 here is the output:
 
     Banana Exists
- 
+
     orange -> orange
     tomato -> red
     banana -> yellow
@@ -797,13 +797,13 @@
 
     $filename = "tree" ;
     unlink $filename ;
- 
+
     # Enable duplicate records
     $DB_BTREE->{'flags'} = R_DUP ;
- 
+
     tie %h, "DB_File", $filename, O_RDWR|O_CREAT, 0640, $DB_BTREE 
 	or die "Cannot open $filename: $!\n";
- 
+
     # Add some key/value pairs to the file
     $h{'Wall'} = 'Larry' ;
     $h{'Wall'} = 'Brick' ; # Note the duplicate key
@@ -847,25 +847,25 @@
     use warnings ;
     use strict ;
     use DB_File ;
- 
+
     use vars qw($filename $x %h $status $key $value) ;
 
     $filename = "tree" ;
     unlink $filename ;
- 
+
     # Enable duplicate records
     $DB_BTREE->{'flags'} = R_DUP ;
- 
+
     $x = tie %h, "DB_File", $filename, O_RDWR|O_CREAT, 0640, $DB_BTREE 
 	or die "Cannot open $filename: $!\n";
- 
+
     # Add some key/value pairs to the file
     $h{'Wall'} = 'Larry' ;
     $h{'Wall'} = 'Brick' ; # Note the duplicate key
     $h{'Wall'} = 'Brick' ; # Note the duplicate key and value
     $h{'Smith'} = 'John' ;
     $h{'mouse'} = 'mickey' ;
- 
+
     # iterate through the btree using seq
     # and print each key/value pair.
     $key = $value = 0 ;
@@ -873,7 +873,7 @@
          $status == 0 ;
          $status = $x->seq($key, $value, R_NEXT) )
       {  print "$key -> $value\n" }
- 
+
     undef $x ;
     untie %h ;
 
@@ -919,14 +919,14 @@
     use warnings ;
     use strict ;
     use DB_File ;
- 
+
     use vars qw($filename $x %h ) ;
 
     $filename = "tree" ;
- 
+
     # Enable duplicate records
     $DB_BTREE->{'flags'} = R_DUP ;
- 
+
     $x = tie %h, "DB_File", $filename, O_RDWR|O_CREAT, 0640, $DB_BTREE 
 	or die "Cannot open $filename: $!\n";
 
@@ -942,7 +942,7 @@
 
     @list = $x->get_dup("Smith") ;
     print "Smith =>	[@list]\n" ;
- 
+
     @list = $x->get_dup("Dog") ;
     print "Dog =>	[@list]\n" ;
 
@@ -969,23 +969,23 @@
     use warnings ;
     use strict ;
     use DB_File ;
- 
+
     use vars qw($filename $x %h $found) ;
 
     my $filename = "tree" ;
- 
+
     # Enable duplicate records
     $DB_BTREE->{'flags'} = R_DUP ;
- 
+
     $x = tie %h, "DB_File", $filename, O_RDWR|O_CREAT, 0640, $DB_BTREE 
 	or die "Cannot open $filename: $!\n";
 
     $found = ( $x->find_dup("Wall", "Larry") == 0 ? "" : "not") ; 
     print "Larry Wall is $found there\n" ;
-    
+
     $found = ( $x->find_dup("Wall", "Harry") == 0 ? "" : "not") ; 
     print "Harry Wall is $found there\n" ;
-    
+
     undef $x ;
     untie %h ;
 
@@ -1008,14 +1008,14 @@
     use warnings ;
     use strict ;
     use DB_File ;
- 
+
     use vars qw($filename $x %h $found) ;
 
     my $filename = "tree" ;
- 
+
     # Enable duplicate records
     $DB_BTREE->{'flags'} = R_DUP ;
- 
+
     $x = tie %h, "DB_File", $filename, O_RDWR|O_CREAT, 0640, $DB_BTREE 
 	or die "Cannot open $filename: $!\n";
 
@@ -1023,7 +1023,7 @@
 
     $found = ( $x->find_dup("Wall", "Larry") == 0 ? "" : "not") ; 
     print "Larry Wall is $found there\n" ;
-    
+
     undef $x ;
     untie %h ;
 
@@ -1071,22 +1071,22 @@
 
     $x = tie %h, "DB_File", $filename, O_RDWR|O_CREAT, 0640, $DB_BTREE
         or die "Cannot open $filename: $!\n";
- 
+
     # Add some key/value pairs to the file
     $h{'mouse'} = 'mickey' ;
     $h{'Wall'} = 'Larry' ;
     $h{'Walls'} = 'Brick' ; 
     $h{'Smith'} = 'John' ;
- 
+
 
     $key = $value = 0 ;
     print "IN ORDER\n" ;
     for ($st = $x->seq($key, $value, R_FIRST) ;
 	 $st == 0 ;
          $st = $x->seq($key, $value, R_NEXT) )
-	
+
       {  print "$key	-> $value\n" }
- 
+
     print "\nPARTIAL MATCH\n" ;
 
     match "Wa" ;
@@ -1250,14 +1250,14 @@
     use vars qw(@h $H $file $i) ;
     use DB_File ;
     use Fcntl ;
-    
+
     $file = "text" ;
 
     unlink $file ;
 
     $H = tie @h, "DB_File", $file, O_RDWR|O_CREAT, 0640, $DB_RECNO 
         or die "Cannot open file $file: $!\n" ;
-    
+
     # first create a text file to play with
     $h[0] = "zero" ;
     $h[1] = "one" ;
@@ -1265,7 +1265,7 @@
     $h[3] = "three" ;
     $h[4] = "four" ;
 
-    
+
     # Print the records in order.
     #
     # The length method is needed here because evaluating a tied
diff -urN perl-current.orig/ext/Data/Dumper/Dumper.pm perl-current/ext/Data/Dumper/Dumper.pm
--- perl-current.orig/ext/Data/Dumper/Dumper.pm	Thu Mar 15 20:33:18 2001
+++ perl-current/ext/Data/Dumper/Dumper.pm	Thu Mar 15 20:41:41 2001
@@ -592,7 +592,6 @@
 
 Data::Dumper - stringified perl data structures, suitable for both printing and C<eval>
 
-
 =head1 SYNOPSIS
 
     use Data::Dumper;
diff -urN perl-current.orig/ext/Devel/Peek/Peek.pm perl-current/ext/Devel/Peek/Peek.pm
--- perl-current.orig/ext/Devel/Peek/Peek.pm	Thu Mar 15 20:33:18 2001
+++ perl-current/ext/Devel/Peek/Peek.pm	Thu Mar 15 20:42:19 2001
@@ -432,7 +432,7 @@
 
 This shows that 
 
-=over
+=over 4
 
 =item *
 
diff -urN perl-current.orig/ext/Filter/Util/Call/Call.pm perl-current/ext/Filter/Util/Call/Call.pm
--- perl-current.orig/ext/Filter/Util/Call/Call.pm	Thu Mar 15 20:33:19 2001
+++ perl-current/ext/Filter/Util/Call/Call.pm	Thu Mar 15 20:45:17 2001
@@ -58,7 +58,7 @@
 Filter::Util::Call - Perl Source Filter Utility Module
 
 =head1 SYNOPSIS
- 
+
     use Filter::Util::Call ;
 
 =head1 DESCRIPTION
@@ -74,7 +74,7 @@
 Here is a skeleton for the I<method filter>:
 
     package MyFilter ;
-    
+
     use Filter::Util::Call ;
 
     sub import
@@ -82,28 +82,28 @@
         my($type, @arguments) = @_ ;
         filter_add([]) ;
     }
-    
+
     sub filter
     {
         my($self) = @_ ;
         my($status) ;
-    
+
         $status = filter_read() ;
         $status ;
     }
-    
+
     1 ;
 
 and this is the equivalent skeleton for the I<closure filter>:
 
     package MyFilter ;
-    
+
     use Filter::Util::Call ;
 
     sub import
     {
         my($type, @arguments) = @_ ;
-    
+
         filter_add(
             sub 
             {
@@ -112,7 +112,7 @@
                 $status ;
             } )
     }
-    
+
     1 ;
 
 To make use of either of the two filter modules above, place the line
@@ -293,26 +293,26 @@
 Useful, but it is the first example and I wanted to keep it simple.
 
     package Joe2Jim ;
-    
+
     use Filter::Util::Call ;
 
     sub import
     {
         my($type) = @_ ;
-    
+
         filter_add(bless []) ;
     }
-    
+
     sub filter
     {
         my($self) = @_ ;
         my($status) ;
-    
+
         s/Joe/Jim/g
             if ($status = filter_read()) > 0 ;
         $status ;
     }
-    
+
     1 ;
 
 Here is an example of using the filter:
@@ -333,10 +333,10 @@
 C<Subst>.
 
     package Subst ;
- 
+
     use Filter::Util::Call ;
     use Carp ;
- 
+
     sub import
     {
         croak("usage: use Subst qw(from to)")
@@ -371,14 +371,14 @@
 Note that C<$status> is set to C<1> in this case.
 
     package Count ;
- 
+
     use Filter::Util::Call ;
- 
+
     sub filter
     {
         my ($self) = @_ ;
         my ($status) ;
- 
+
         if (($status = filter_read()) > 0 ) {
             s/Joe/Jim/g ;
 	    ++ $$self ;
@@ -391,14 +391,14 @@
 
         $status ;
     }
- 
+
     sub import
     {
         my ($self) = @_ ;
         my ($count) = 0 ;
         filter_add(\$count) ;
     }
- 
+
     1 ;
 
 Here is a script which uses it:
@@ -429,38 +429,38 @@
 Here is the module.
 
     package NewSubst ;
- 
+
     use Filter::Util::Call ;
     use Carp ;
- 
+
     sub import
     {
         my ($self, $start, $stop, $from, $to) = @_ ;
         my ($found) = 0 ;
         croak("usage: use Subst qw(start stop from to)")
             unless @_ == 5 ;
- 
+
         filter_add( 
             sub 
             {
                 my ($status) ;
-             
+
                 if (($status = filter_read()) > 0) {
-             
+
                     $found = 1
                         if $found == 0 and /$start/ ;
-             
+
                     if ($found) {
                         s/$from/$to/ ;
                         filter_del() if /$stop/ ;
                     }
-             
+
                 }
                 $status ;
             } )
-    
+
     }
-     
+
     1 ;
 
 =head1 AUTHOR
diff -urN perl-current.orig/ext/IO/lib/IO/Handle.pm perl-current/ext/IO/lib/IO/Handle.pm
--- perl-current.orig/ext/IO/lib/IO/Handle.pm	Thu Mar 15 20:33:19 2001
+++ perl-current/ext/IO/lib/IO/Handle.pm	Thu Mar 15 20:46:46 2001
@@ -100,7 +100,7 @@
 
 Furthermore, for doing normal I/O you might need these:
 
-=over 
+=over 4
 
 =item $io->fdopen ( FD, MODE )
 
@@ -206,7 +206,7 @@
 Lastly, there is a special method for working under B<-T> and setuid/gid
 scripts:
 
-=over
+=over 4
 
 =item $io->untaint
 
diff -urN perl-current.orig/ext/IO/lib/IO/Seekable.pm perl-current/ext/IO/lib/IO/Seekable.pm
--- perl-current.orig/ext/IO/lib/IO/Seekable.pm	Thu Mar 15 20:33:19 2001
+++ perl-current/ext/IO/lib/IO/Seekable.pm	Thu Mar 15 20:47:07 2001
@@ -34,7 +34,7 @@
 position. Returns "0 but true" on success, C<undef> on failure.
 
 =back
-  
+
 See L<perlfunc> for complete descriptions of each of the following
 supported C<IO::Seekable> methods, which are just front ends for the
 corresponding built-in functions:
@@ -80,7 +80,7 @@
 Returns the IO::File's current position, or -1 on error.
 
 =back
-  
+
 =head1 SEE ALSO
 
 L<perlfunc>, 
diff -urN perl-current.orig/ext/IO/lib/IO/Socket/UNIX.pm perl-current/ext/IO/lib/IO/Socket/UNIX.pm
--- perl-current.orig/ext/IO/lib/IO/Socket/UNIX.pm	Thu Mar 15 20:33:19 2001
+++ perl-current/ext/IO/lib/IO/Socket/UNIX.pm	Thu Mar 15 20:46:06 2001
@@ -103,7 +103,7 @@
 
 
  NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE NOTE
- 
+
 As of VERSION 1.18 all IO::Socket objects have autoflush turned on
 by default. This was not the case with earlier releases.
 
diff -urN perl-current.orig/ext/IPC/SysV/Msg.pm perl-current/ext/IPC/SysV/Msg.pm
--- perl-current.orig/ext/IPC/SysV/Msg.pm	Thu Mar 15 20:33:19 2001
+++ perl-current/ext/IPC/SysV/Msg.pm	Thu Mar 15 20:48:15 2001
@@ -126,6 +126,8 @@
 
 =head1 DESCRIPTION
 
+A class providing an object based interface to SysV IPC message queues.
+
 =head1 METHODS
 
 =over 4
diff -urN perl-current.orig/ext/IPC/SysV/Semaphore.pm perl-current/ext/IPC/SysV/Semaphore.pm
--- perl-current.orig/ext/IPC/SysV/Semaphore.pm	Thu Mar 15 20:33:19 2001
+++ perl-current/ext/IPC/SysV/Semaphore.pm	Thu Mar 15 20:48:45 2001
@@ -172,6 +172,8 @@
 
 =head1 DESCRIPTION
 
+A class providing an object based interface to SysV IPC semaphores.
+
 =head1 METHODS
 
 =over 4
diff -urN perl-current.orig/ext/IPC/SysV/SysV.pm perl-current/ext/IPC/SysV/SysV.pm
--- perl-current.orig/ext/IPC/SysV/SysV.pm	Thu Mar 15 20:33:19 2001
+++ perl-current/ext/IPC/SysV/SysV.pm	Thu Mar 15 20:48:57 2001
@@ -74,7 +74,7 @@
 defined in your system include files which are needed by the SysV
 IPC calls.
 
-=over
+=over 4
 
 =item ftok( PATH, ID )
 
diff -urN perl-current.orig/ext/NDBM_File/NDBM_File.pm perl-current/ext/NDBM_File/NDBM_File.pm
--- perl-current.orig/ext/NDBM_File/NDBM_File.pm	Thu Mar 15 20:33:19 2001
+++ perl-current/ext/NDBM_File/NDBM_File.pm	Thu Mar 15 20:49:35 2001
@@ -28,11 +28,11 @@
   $h{newkey} = newvalue;
   print $h{oldkey}; 
   ...
- 
+
   untie %h;
- 
+
 =head1 DESCRIPTION
- 
+
 C<NDBM_File> establishes a connection between a Perl hash variable and
 a file in NDBM_File format;.  You can manipulate the data in the file
 just as if it were in a Perl hash, but when your program exits, the
diff -urN perl-current.orig/ext/ODBM_File/ODBM_File.pm perl-current/ext/ODBM_File/ODBM_File.pm
--- perl-current.orig/ext/ODBM_File/ODBM_File.pm	Thu Mar 15 20:33:19 2001
+++ perl-current/ext/ODBM_File/ODBM_File.pm	Thu Mar 15 20:49:47 2001
@@ -28,11 +28,11 @@
   $h{newkey} = newvalue;
   print $h{oldkey}; 
   ...
- 
+
   untie %h;
- 
+
 =head1 DESCRIPTION
- 
+
 C<ODBM_File> establishes a connection between a Perl hash variable and
 a file in ODBM_File format;.  You can manipulate the data in the file
 just as if it were in a Perl hash, but when your program exits, the
diff -urN perl-current.orig/ext/Socket/Socket.pm perl-current/ext/Socket/Socket.pm
--- perl-current.orig/ext/Socket/Socket.pm	Thu Mar 15 20:33:19 2001
+++ perl-current/ext/Socket/Socket.pm	Thu Mar 15 20:50:02 2001
@@ -56,7 +56,7 @@
 
 In addition, some structure manipulation functions are available:
 
-=over
+=over 4
 
 =item inet_aton HOSTNAME
 
diff -urN perl-current.orig/ext/Storable/Storable.pm perl-current/ext/Storable/Storable.pm
--- perl-current.orig/ext/Storable/Storable.pm	Thu Mar 15 20:33:19 2001
+++ perl-current/ext/Storable/Storable.pm	Thu Mar 15 20:50:26 2001
@@ -527,7 +527,7 @@
 
 Here is the hooking interface:
 
-=over
+=over 4
 
 =item C<STORABLE_freeze> I<obj>, I<cloning>
 
@@ -596,7 +596,7 @@
 Predicates are not exportable.  They must be called by explicitely prefixing
 them with the Storable package name.
 
-=over
+=over 4
 
 =item C<Storable::last_op_in_netorder>
 
@@ -623,7 +623,7 @@
 
 There are a few things you need to know however:
 
-=over
+=over 4
 
 =item *
 
diff -urN perl-current.orig/ext/Sys/Syslog/Syslog.pm perl-current/ext/Sys/Syslog/Syslog.pm
--- perl-current.orig/ext/Sys/Syslog/Syslog.pm	Thu Mar 15 20:33:20 2001
+++ perl-current/ext/Sys/Syslog/Syslog.pm	Thu Mar 15 20:50:41 2001
@@ -46,7 +46,7 @@
 
 Syslog provides the functions:
 
-=over
+=over 4
 
 =item openlog $ident, $logopt, $facility
 
diff -urN perl-current.orig/ext/Thread/Thread/Queue.pm perl-current/ext/Thread/Thread/Queue.pm
--- perl-current.orig/ext/Thread/Thread/Queue.pm	Thu Mar 15 20:33:20 2001
+++ perl-current/ext/Thread/Thread/Queue.pm	Thu Mar 15 20:50:59 2001
@@ -59,7 +59,7 @@
 =head1 SEE ALSO
 
 L<Thread>
-  
+
 =cut
 
 sub new {
diff -urN perl-current.orig/ext/Thread/Thread.pm perl-current/ext/Thread/Thread.pm
--- perl-current.orig/ext/Thread/Thread.pm	Thu Mar 15 20:33:20 2001
+++ perl-current/ext/Thread/Thread.pm	Thu Mar 15 20:51:16 2001
@@ -22,7 +22,7 @@
     $result = $t->eval;
     $t->detach;
     $flags = $t->flags;
-    
+
     if ($t->done) {
         $t->join;
     }
diff -urN perl-current.orig/ext/attrs/attrs.pm perl-current/ext/attrs/attrs.pm
--- perl-current.orig/ext/attrs/attrs.pm	Thu Mar 15 20:33:20 2001
+++ perl-current/ext/attrs/attrs.pm	Thu Mar 15 20:51:29 2001
@@ -31,7 +31,7 @@
 of attribute names. Notice that C<attrs::get> is not exported.
 Valid attributes are as follows.
 
-=over
+=over 4
 
 =item method
 
diff -urN perl-current.orig/jpl/JNI/JNI.pm perl-current/jpl/JNI/JNI.pm
--- perl-current.orig/jpl/JNI/JNI.pm	Thu Mar 15 20:33:20 2001
+++ perl-current/jpl/JNI/JNI.pm	Thu Mar 15 20:52:05 2001
@@ -269,6 +269,8 @@
 
 =head1 DESCRIPTION
 
+This module provides an encapsulation in Perl of the Java Native Interface.
+
 =head1 Exported constants
 
   JNI_ABORT
diff -urN perl-current.orig/lib/CPAN.pm perl-current/lib/CPAN.pm
--- perl-current.orig/lib/CPAN.pm	Thu Mar 15 20:33:26 2001
+++ perl-current/lib/CPAN.pm	Thu Mar 15 21:06:06 2001
@@ -6181,7 +6181,7 @@
 methods are documented that have proven useful over a longer time and
 thus are unlikely to change.
 
-=over
+=over 4
 
 =item CPAN::Author::as_glimpse()
 
@@ -6746,7 +6746,7 @@
 
 Firewalls can be categorized into three basic types.
 
-=over
+=over 4
 
 =item http firewall
 
@@ -6780,7 +6780,7 @@
 
 There are two that I can think off.
 
-=over
+=over 4
 
 =item SOCKS
 
@@ -6819,7 +6819,7 @@
 
 =head1 FAQ
 
-=over
+=over 4
 
 =item 1)
 
diff -urN perl-current.orig/lib/Class/Struct.pm perl-current/lib/Class/Struct.pm
--- perl-current.orig/lib/Class/Struct.pm	Thu Mar 15 20:33:21 2001
+++ perl-current/lib/Class/Struct.pm	Thu Mar 15 20:54:10 2001
@@ -361,7 +361,7 @@
 The accessor method provided by C<struct> for an element depends
 on the declared type of the element.
 
-=over
+=over 4
 
 =item Scalar (C<'$'> or C<'*$'>)
 
@@ -437,7 +437,7 @@
 
 =head1 EXAMPLES
 
-=over
+=over 4
 
 =item Example 1
 
diff -urN perl-current.orig/lib/Dumpvalue.pm perl-current/lib/Dumpvalue.pm
--- perl-current.orig/lib/Dumpvalue.pm	Thu Mar 15 20:33:26 2001
+++ perl-current/lib/Dumpvalue.pm	Thu Mar 15 21:07:02 2001
@@ -495,7 +495,7 @@
 
 Recognized options:
 
-=over
+=over 4
 
 =item C<arrayDepth>, C<hashDepth>
 
@@ -563,7 +563,7 @@
 
 =head2 Methods
 
-=over
+=over 4
 
 =item dumpValue
 
diff -urN perl-current.orig/lib/ExtUtils/Embed.pm perl-current/lib/ExtUtils/Embed.pm
--- perl-current.orig/lib/ExtUtils/Embed.pm	Thu Mar 15 20:33:21 2001
+++ perl-current/lib/ExtUtils/Embed.pm	Thu Mar 15 20:54:24 2001
@@ -295,7 +295,7 @@
 
 =head1 FUNCTIONS
 
-=over
+=over 4
 
 =item xsinit()
 
diff -urN perl-current.orig/lib/ExtUtils/Installed.pm perl-current/lib/ExtUtils/Installed.pm
--- perl-current.orig/lib/ExtUtils/Installed.pm	Thu Mar 15 20:33:21 2001
+++ perl-current/lib/ExtUtils/Installed.pm	Thu Mar 15 20:54:37 2001
@@ -208,7 +208,7 @@
 
 =head1 FUNCTIONS
 
-=over
+=over 4
 
 =item new()
 
diff -urN perl-current.orig/lib/ExtUtils/MM_Cygwin.pm perl-current/lib/ExtUtils/MM_Cygwin.pm
--- perl-current.orig/lib/ExtUtils/MM_Cygwin.pm	Thu Mar 15 20:33:21 2001
+++ perl-current/lib/ExtUtils/MM_Cygwin.pm	Thu Mar 15 20:54:48 2001
@@ -103,7 +103,7 @@
 
 See ExtUtils::MM_Unix for a documentation of the methods provided there.
 
-=over
+=over 4
 
 =item canonpath
 
diff -urN perl-current.orig/lib/ExtUtils/MM_OS2.pm perl-current/lib/ExtUtils/MM_OS2.pm
--- perl-current.orig/lib/ExtUtils/MM_OS2.pm	Thu Mar 15 20:33:21 2001
+++ perl-current/lib/ExtUtils/MM_OS2.pm	Thu Mar 15 20:56:19 2001
@@ -14,6 +14,28 @@
 
 unshift @MM::ISA, 'ExtUtils::MM_OS2';
 
+=pod
+
+=head1 NAME
+
+ExtUtils::MM_OS2 - methods to override UN*X behaviour in ExtUtils::MakeMaker
+
+=head1 SYNOPSIS
+
+ use ExtUtils::MM_OS2; # Done internally by ExtUtils::MakeMaker if needed
+
+=head1 DESCRIPTION
+
+See ExtUtils::MM_Unix for a documentation of the methods provided
+there. This package overrides the implementation of these methods, not
+the semantics.
+
+=head1 METHODS
+
+=over 4
+
+=cut
+
 sub dlsyms {
     my($self,%attribs) = @_;
 
@@ -120,19 +142,11 @@
 }
 
 1;
-__END__
-
-=head1 NAME
-
-ExtUtils::MM_OS2 - methods to override UN*X behaviour in ExtUtils::MakeMaker
 
-=head1 SYNOPSIS
-
- use ExtUtils::MM_OS2; # Done internally by ExtUtils::MakeMaker if needed
+__END__
 
-=head1 DESCRIPTION
+=pod
 
-See ExtUtils::MM_Unix for a documentation of the methods provided
-there. This package overrides the implementation of these methods, not
-the semantics.
+=back
 
+=cut
diff -urN perl-current.orig/lib/ExtUtils/MM_VMS.pm perl-current/lib/ExtUtils/MM_VMS.pm
--- perl-current.orig/lib/ExtUtils/MM_VMS.pm	Thu Mar 15 20:33:21 2001
+++ perl-current/lib/ExtUtils/MM_VMS.pm	Thu Mar 15 20:57:30 2001
@@ -41,7 +41,7 @@
 
 =head2 Methods always loaded
 
-=over
+=over 4
 
 =item wraplist
 
@@ -173,7 +173,7 @@
 of why this method overrides the MM_Unix method; see the ExtUtils::MM_Unix
 documentation for more details.
 
-=over
+=over 4
 
 =item guess_name (override)
 
diff -urN perl-current.orig/lib/ExtUtils/MM_Win32.pm perl-current/lib/ExtUtils/MM_Win32.pm
--- perl-current.orig/lib/ExtUtils/MM_Win32.pm	Thu Mar 15 20:33:21 2001
+++ perl-current/lib/ExtUtils/MM_Win32.pm	Thu Mar 15 21:12:22 2001
@@ -16,7 +16,7 @@
 there. This package overrides the implementation of these methods, not
 the semantics.
 
-=over
+=over 4
 
 =cut 
 
diff -urN perl-current.orig/lib/ExtUtils/Manifest.pm perl-current/lib/ExtUtils/Manifest.pm
--- perl-current.orig/lib/ExtUtils/Manifest.pm	Thu Mar 15 20:33:21 2001
+++ perl-current/lib/ExtUtils/Manifest.pm	Thu Mar 15 21:13:45 2001
@@ -447,7 +447,7 @@
 
 All diagnostic output is sent to C<STDERR>.
 
-=over
+=over 4
 
 =item C<Not in MANIFEST:> I<file>
 
diff -urN perl-current.orig/lib/ExtUtils/Mksymlists.pm perl-current/lib/ExtUtils/Mksymlists.pm
--- perl-current.orig/lib/ExtUtils/Mksymlists.pm	Thu Mar 15 20:33:21 2001
+++ perl-current/lib/ExtUtils/Mksymlists.pm	Thu Mar 15 21:13:58 2001
@@ -217,7 +217,7 @@
 It takes one argument, a list of key-value pairs, in which the following
 keys are recognized:
 
-=over
+=over 4
 
 =item DLBASE
 
diff -urN perl-current.orig/lib/ExtUtils/Packlist.pm perl-current/lib/ExtUtils/Packlist.pm
--- perl-current.orig/lib/ExtUtils/Packlist.pm	Thu Mar 15 20:33:21 2001
+++ perl-current/lib/ExtUtils/Packlist.pm	Thu Mar 15 21:14:08 2001
@@ -200,7 +200,7 @@
 
 =head1 FUNCTIONS
 
-=over
+=over 4
 
 =item new()
 
diff -urN perl-current.orig/lib/File/Basename.pm perl-current/lib/File/Basename.pm
--- perl-current.orig/lib/File/Basename.pm	Thu Mar 15 20:33:21 2001
+++ perl-current/lib/File/Basename.pm	Thu Mar 15 20:58:20 2001
@@ -95,7 +95,7 @@
     $dir  eq 'Doc_Root:[Help]'
     $type eq '.Rnh'
 
-=over
+=over 4
 
 =item C<basename>
 
diff -urN perl-current.orig/lib/File/Spec/VMS.pm perl-current/lib/File/Spec/VMS.pm
--- perl-current.orig/lib/File/Spec/VMS.pm	Thu Mar 15 20:33:21 2001
+++ perl-current/lib/File/Spec/VMS.pm	Thu Mar 15 20:57:56 2001
@@ -26,7 +26,7 @@
 there. This package overrides the implementation of these methods, not
 the semantics.
 
-=over
+=over 4
 
 =item eliminate_macros
 
@@ -138,7 +138,7 @@
 
 =head2 Methods always loaded
 
-=over
+=over 4
 
 =item canonpath (override)
 
diff -urN perl-current.orig/lib/File/Spec/Win32.pm perl-current/lib/File/Spec/Win32.pm
--- perl-current.orig/lib/File/Spec/Win32.pm	Thu Mar 15 20:33:21 2001
+++ perl-current/lib/File/Spec/Win32.pm	Thu Mar 15 20:58:07 2001
@@ -23,7 +23,7 @@
 there. This package overrides the implementation of these methods, not
 the semantics.
 
-=over
+=over 4
 
 =item devnull
 
diff -urN perl-current.orig/lib/FileHandle.pm perl-current/lib/FileHandle.pm
--- perl-current.orig/lib/FileHandle.pm	Thu Mar 15 20:33:26 2001
+++ perl-current/lib/FileHandle.pm	Thu Mar 15 21:07:14 2001
@@ -225,7 +225,7 @@
 
 Furthermore, for doing normal I/O you might need these:
 
-=over 
+=over 4
 
 =item $fh->print
 
diff -urN perl-current.orig/lib/Filter/Simple.pm perl-current/lib/Filter/Simple.pm
--- perl-current.orig/lib/Filter/Simple.pm	Thu Mar 15 20:33:22 2001
+++ perl-current/lib/Filter/Simple.pm	Thu Mar 15 20:59:09 2001
@@ -52,7 +52,6 @@
 
 Filter::Simple - Simplified source filtering
 
-
 =head1 SYNOPSIS
 
  # in MyFilter.pm:
@@ -141,7 +140,7 @@
 C<use BANG;> statement (until the next C<no BANG;> statement, if any):
 
         package BANG;
- 
+
         use Filter::Util::Call ;
 
         sub import {
@@ -198,7 +197,7 @@
 In other words, the previous example, would become:
 
         package BANG;
- 
+
         use Filter::Simple sub {
             s/BANG\s+BANG/die 'BANG' if \$BANG/g;
         };
@@ -218,7 +217,7 @@
 be made parametric:
 
         package BANG;
- 
+
         use Filter::Simple sub {
             my ($die_msg, $var_name) = @_;
             s/BANG\s+BANG/die '$die_msg' if \${$var_name}/g;
diff -urN perl-current.orig/lib/Getopt/Long.pm perl-current/lib/Getopt/Long.pm
--- perl-current.orig/lib/Getopt/Long.pm	Thu Mar 15 20:33:22 2001
+++ perl-current/lib/Getopt/Long.pm	Thu Mar 15 20:59:33 2001
@@ -1326,7 +1326,7 @@
 
 The argument specification can be
 
-=over
+=over 4
 
 =item !
 
@@ -1352,7 +1352,7 @@
 The option requires an argument of the given type. Supported types
 are:
 
-=over
+=over 4
 
 =item s
 
diff -urN perl-current.orig/lib/Locale/Constants.pm perl-current/lib/Locale/Constants.pm
--- perl-current.orig/lib/Locale/Constants.pm	Thu Mar 15 20:33:26 2001
+++ perl-current/lib/Locale/Constants.pm	Thu Mar 15 21:04:13 2001
@@ -31,7 +31,7 @@
 =head1 SYNOPSIS
 
     use Locale::Constants;
-    
+
     $codeset = LOCALE_CODE_ALPHA_2;
 
 =head1 DESCRIPTION
diff -urN perl-current.orig/lib/Locale/Country.pm perl-current/lib/Locale/Country.pm
--- perl-current.orig/lib/Locale/Country.pm	Thu Mar 15 20:33:26 2001
+++ perl-current/lib/Locale/Country.pm	Thu Mar 15 21:04:40 2001
@@ -7,13 +7,13 @@
 =head1 SYNOPSIS
 
     use Locale::Country;
-    
+
     $country = code2country('jp');               # $country gets 'Japan'
     $code    = country2code('Norway');           # $code gets 'no'
-    
+
     @codes   = all_country_codes();
     @names   = all_country_names();
-    
+
     # add "uk" as a pseudo country code for United Kingdom
     Locale::Country::_alias_code('uk' => 'gb');
 
@@ -285,7 +285,7 @@
 code for United Kingdom, use the following:
 
     use Locale::Country;
-    
+
     Locale::Country::_alias_code('uk' => 'gb');
 
 With this code, both "uk" and "gb" are valid codes for United Kingdom,
@@ -325,7 +325,7 @@
 country name:
 
     $| = 1;   # turn off buffering
-    
+
     print "Enter country code: ";
     chop($code = <STDIN>);
     $country = code2country($code, LOCALE_CODE_ALPHA_2);
diff -urN perl-current.orig/lib/Locale/Language.pm perl-current/lib/Locale/Language.pm
--- perl-current.orig/lib/Locale/Language.pm	Thu Mar 15 20:33:26 2001
+++ perl-current/lib/Locale/Language.pm	Thu Mar 15 21:05:16 2001
@@ -7,10 +7,10 @@
 =head1 SYNOPSIS
 
     use Locale::Language;
-    
+
     $lang = code2language('en');        # $lang gets 'English'
     $code = language2code('French');    # $code gets 'fr'
-    
+
     @codes   = all_language_codes();
     @names   = all_language_names();
 
@@ -173,7 +173,7 @@
 language name:
 
     $| = 1;    # turn off buffering
-    
+
     print "Enter language code: ";
     chop($code = <STDIN>);
     $lang = code2language($code);
diff -urN perl-current.orig/lib/Term/ANSIColor.pm perl-current/lib/Term/ANSIColor.pm
--- perl-current.orig/lib/Term/ANSIColor.pm	Thu Mar 15 20:33:22 2001
+++ perl-current/lib/Term/ANSIColor.pm	Thu Mar 15 21:00:19 2001
@@ -187,7 +187,7 @@
 
 This module has two interfaces, one through color() and colored() and the
 other through constants.
-    
+
 color() takes any number of strings as arguments and considers them to be
 space-separated lists of attributes.  It then forms and returns the escape
 sequence to set those attributes.  It doesn't print it out, just returns
diff -urN perl-current.orig/lib/Test/Harness.pm perl-current/lib/Test/Harness.pm
--- perl-current.orig/lib/Test/Harness.pm	Thu Mar 15 20:33:22 2001
+++ perl-current/lib/Test/Harness.pm	Thu Mar 15 21:01:20 2001
@@ -650,7 +650,7 @@
 
 =over 4
 
-=item B<1..M>
+=item B<'1..M'>
 
 This header tells how many tests there will be.  It should be the
 first line output by your test program (but its okay if its preceded
diff -urN perl-current.orig/lib/Test.pm perl-current/lib/Test.pm
--- perl-current.orig/lib/Test.pm	Thu Mar 15 20:33:26 2001
+++ perl-current/lib/Test.pm	Thu Mar 15 21:07:42 2001
@@ -151,7 +151,7 @@
 
 =head1 NAME
 
-  Test - provides a simple framework for writing test scripts
+Test - provides a simple framework for writing test scripts
 
 =head1 SYNOPSIS
 
diff -urN perl-current.orig/lib/Text/Wrap.pm perl-current/lib/Text/Wrap.pm
--- perl-current.orig/lib/Text/Wrap.pm	Thu Mar 15 20:33:23 2001
+++ perl-current/lib/Text/Wrap.pm	Thu Mar 15 21:02:04 2001
@@ -120,7 +120,7 @@
 	$huge = 'overflow';
 
 B<Example 3>
-	
+
 	use Text::Wrap
 
 	$Text::Wrap::columns = 72;
diff -urN perl-current.orig/lib/Tie/Array.pm perl-current/lib/Tie/Array.pm
--- perl-current.orig/lib/Tie/Array.pm	Thu Mar 15 20:33:23 2001
+++ perl-current/lib/Tie/Array.pm	Thu Mar 15 21:02:25 2001
@@ -179,7 +179,7 @@
 are briefly defined below. See the L<perltie> section for more detailed
 descriptive, as well as example code:
 
-=over
+=over 4
 
 =item TIEARRAY classname, LIST
 
diff -urN perl-current.orig/lib/Tie/Handle.pm perl-current/lib/Tie/Handle.pm
--- perl-current.orig/lib/Tie/Handle.pm	Thu Mar 15 20:33:23 2001
+++ perl-current/lib/Tie/Handle.pm	Thu Mar 15 21:02:16 2001
@@ -33,7 +33,7 @@
 are summarized below. The L<perltie> section not only documents these, but
 has sample code as well:
 
-=over
+=over 4
 
 =item TIEHANDLE classname, LIST
 
diff -urN perl-current.orig/lib/Tie/Hash.pm perl-current/lib/Tie/Hash.pm
--- perl-current.orig/lib/Tie/Hash.pm	Thu Mar 15 20:33:23 2001
+++ perl-current/lib/Tie/Hash.pm	Thu Mar 15 21:03:31 2001
@@ -10,24 +10,24 @@
 
     package NewHash;
     require Tie::Hash;
-    
+
     @ISA = (Tie::Hash);
-    
+
     sub DELETE { ... }		# Provides needed method
     sub CLEAR { ... }		# Overrides inherited method
-    
-    
+
+
     package NewStdHash;
     require Tie::Hash;
-    
+
     @ISA = (Tie::StdHash);
-    
+
     # All methods provided by default, define only those needing overrides
     sub DELETE { ... }
-    
-    
+
+
     package main;
-    
+
     tie %new_hash, 'NewHash';
     tie %new_std_hash, 'NewStdHash';
 
@@ -46,7 +46,7 @@
 are briefly defined below. See the L<perltie> section for more detailed
 descriptive, as well as example code:
 
-=over
+=over 4
 
 =item TIEHASH classname, LIST
 
diff -urN perl-current.orig/lib/Tie/Scalar.pm perl-current/lib/Tie/Scalar.pm
--- perl-current.orig/lib/Tie/Scalar.pm	Thu Mar 15 20:33:23 2001
+++ perl-current/lib/Tie/Scalar.pm	Thu Mar 15 21:03:44 2001
@@ -47,7 +47,7 @@
 are summarized below. The L<perltie> section not only documents these, but
 has sample code as well:
 
-=over
+=over 4
 
 =item TIESCALAR classname, LIST
 
diff -urN perl-current.orig/lib/User/pwent.pm perl-current/lib/User/pwent.pm
--- perl-current.orig/lib/User/pwent.pm	Thu Mar 15 20:33:23 2001
+++ perl-current/lib/User/pwent.pm	Thu Mar 15 21:03:55 2001
@@ -287,7 +287,7 @@
 
 =head1 HISTORY
 
-=over
+=over 4
 
 =item March 18th, 2000
 
diff -urN perl-current.orig/lib/autouse.pm perl-current/lib/autouse.pm
--- perl-current.orig/lib/autouse.pm	Thu Mar 15 20:33:27 2001
+++ perl-current/lib/autouse.pm	Thu Mar 15 21:07:56 2001
@@ -116,7 +116,7 @@
 Using C<autouse> will move important steps of your program's execution
 from compile time to runtime.  This can
 
-=over
+=over 4
 
 =item *
 
diff -urN perl-current.orig/lib/overload.pm perl-current/lib/overload.pm
--- perl-current.orig/lib/overload.pm	Thu Mar 15 20:33:27 2001
+++ perl-current/lib/overload.pm	Thu Mar 15 21:08:28 2001
@@ -267,7 +267,7 @@
 
 Two types of mutators have different calling conventions:
 
-=over
+=over 4
 
 =item C<++> and C<-->
 
@@ -450,7 +450,7 @@
 
 Inheritance interacts with overloading in two ways.
 
-=over
+=over 4
 
 =item Strings as values of C<use overload> directive
 
@@ -1028,7 +1028,7 @@
 actual array, and the access hash.  The tie()ing object for the access
 hash is a reference to a reference to the actual array, so
 
-=over
+=over 4
 
 =item *
 
@@ -1058,8 +1058,8 @@
   }
 
 This module is very unusual as overloaded modules go: it does not
-provide any usual overloaded operators, instead it provides the L<Last
-Resort> operator C<nomethod>.  In this example the corresponding
+provide any usual overloaded operators, instead it provides the 
+L<Last Resort> operator C<nomethod>.  In this example the corresponding
 subroutine returns an object which encapsulates operations done over
 the objects: C<new symbolic 3> contains C<['n', 3]>, C<2 + new
 symbolic 3> contains C<['+', 2, ['n', 3]]>.
diff -urN perl-current.orig/os2/OS2/ExtAttr/ExtAttr.pm perl-current/os2/OS2/ExtAttr/ExtAttr.pm
--- perl-current.orig/os2/OS2/ExtAttr/ExtAttr.pm	Thu Mar 15 20:33:27 2001
+++ perl-current/os2/OS2/ExtAttr/ExtAttr.pm	Thu Mar 15 21:08:52 2001
@@ -133,7 +133,7 @@
   tie %ea, 'OS2::ExtAttr', 'my.file';
   print $ea{eaname};
   $ea{myfield} = 'value';
-  
+
   untie %ea;
 
 =head1 DESCRIPTION
diff -urN perl-current.orig/os2/OS2/Process/Process.pm perl-current/os2/OS2/Process/Process.pm
--- perl-current.orig/os2/OS2/Process/Process.pm	Thu Mar 15 20:33:27 2001
+++ perl-current/os2/OS2/Process/Process.pm	Thu Mar 15 21:10:12 2001
@@ -128,14 +128,14 @@
 my_type() returns the type of the current process (one of 
 "FS", "DOS", "VIO", "PM", "DETACH" and "UNKNOWN"), or C<undef> on error.
 
-=over
+=over 4
 
 =item C<file_type(file)> 
 
 returns the type of the executable file C<file>, or
 dies on error.  The bits 0-2 of the result contain one of the values
 
-=over
+=over 4
 
 =item C<T_NOTSPEC> (0)
 
@@ -158,7 +158,7 @@
 The remaining bits should be masked with the following values to
 determine the type of the executable:
 
-=over
+=over 4
 
 =item C<T_BOUND> (8)
 
@@ -204,46 +204,46 @@
 
 returns a list of the following data:
 
-=over
+=over 4
 
-=item 
+=item *
 
 Title of the process (in the C<Ctrl-Esc> list);
 
-=item 
+=item *
 
 window handle of switch entry of the process (in the C<Ctrl-Esc> list);
 
-=item 
+=item *
 
 window handle of the icon of the process;
 
-=item 
+=item *
 
 process handle of the owner of the entry in C<Ctrl-Esc> list;
 
-=item 
+=item *
 
 process id of the owner of the entry in C<Ctrl-Esc> list;
 
-=item 
+=item *
 
 session id of the owner of the entry in C<Ctrl-Esc> list;
 
-=item 
+=item *
 
 whether visible in C<Ctrl-Esc> list;
 
-=item
+=item *
 
 whether item cannot be switched to (note that it is not actually
 grayed in the C<Ctrl-Esc> list));
 
-=item 
+=item *
 
 whether participates in jump sequence;
 
-=item 
+=item *
 
 program type.  Possible values are: 
 
@@ -262,7 +262,6 @@
 is a windowed WIN-OS/2 program, it runs in a PROG_WINDOWEDVDM
 session. Likewise, if it's a full-screen WIN-OS/2 program, it runs in
 a PROG_VDM session.
-
 
 =back
 
0
michael
3/15/2001 9:25:18 PM
perl.perl5.porters 48287 articles. 1 followers. Follow

1 Replies
892 Views

Similar Articles

[PageSpeed] 58
Get it on Google Play
Get it on Apple App Store

On Thu, Mar 15, 2001 at 09:25:18PM +0000, Michael Stevens wrote:
> Yet more pod linting, this time on .pm files. I've touched things
> without fear or favour mostly - I think probably a few of these changes
> affect things that are also maintained outside the core.

Thanks, applied.  Will notify those extra-maintainers.

-- 
$jhi++; # http://www.iki.fi/jhi/
        # There is this special biologist word we use for 'stable'.
        # It is 'dead'. -- Jack Cohen
0
jhi
3/16/2001 2:58:45 AM
Reply:

Similar Artilces:

Patches, patches, patches...
To forestall potential incidents of Warnock's Dillemma... I'm about to apply a whole heap 'o patches to Parrot. (With appropriate [APPLIED] responses, I hope) If, at the end of the day, I have *not* applied or commented on a patch you've sent, it means I've Officially Missed It, so give another try. Sorry 'bout this. Too much mail in the mailbox, and going back in time is tricky, as it can miss subsequent discussions on patches 'n stuff. -- Dan --------------------------------------"it's like th...

[PATCH] Final Draft - pod/perlcommunity.pod - (was [PATCH] Draft - pod/perlcommunity.pod
On 6/29/07, Ren=E9e B=E4cker <renee.baecker@smart-websolutions.de> wrote: > I would also mention yapceurope.org as there are listed many workshops > (German Perl-Workshop, French Perl-Workshop, etc) that don't appear on > yapc.org. And one additional sentence about local workshops... > > Or you could add a new section "Workshops". I've split the Small Gatherings section into two sections: Hackathons and Workshops and moved the paragraph about the Calendar to its own section since it didn't really fit anywhere else. I feel that this draft is t...

Patches, patches, patches... #2
OK, this is advance warning that I'm about to be reposting a bunch of patches of mine which appear to have succumbed to Warnock's Dilemma. The first three should be uncontroversial: there's a documentation fix-up for core.ops, and new tests for strings and stacks. The last one is rather larger, and consists of a greatly expanded set of tests for PerlString's, plus a bunch of bug-fixes. I'd be grateful if Jeff or Dan could take a look at this, as I have the feeling that a lot of the scalar PMCs are going to need similar fixes. Simon ...

[PATCH] Re: [PATCH pod/perlsyn.pod pod/perltrap.pod] Unseding perlsyn
--wRRV7LY7NUeQGEoC Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Looking it over some more, I've put back in two references. The first is the reference to C & Pascal's blockless conditionals. Having it there better explains why we're talking about blockless conditionals and Perl not having them, a common enough question to make it worth discussing. The other is putting the direct link to the C preprocessor back into the discussion of the rather baroque line directives which do require some context. I reverse the sentence shifting the emp...

[PATCH Pod/Html.pm]; was Re: [PATCH perlfunc.pod perlop.pod] plain POD readability
> From tchrist@chthon.perl.com Tue Feb 29 12:39:33 2000 > > >I have removed E<...> from perlfunc.pod and perlop.pod > >using the C<< ... >> stuff. This should make the plain > >POD more readable. > > Have all translators been updated? > > --tom Good point. I think only pod2html and pod2latex don't use Pod::Parser. Here is a patch to Pod/Html.pm which should fix pod2html. I have tested it on my patched version of perlfunc.pod perlop.pod. Robin --- lib/Pod/Html.pm 2000/02/29 18:27:50 1.1 +++ lib/Pod/Html...

[PATCH] Draft - pod/perlcommunity.pod
This was an idea that came from the town hall meeting at YAPC::NA earlier today. I've been informed that Larry approved a similar idea previously but nothing came from it. This is a first draft to get things off the ground, and is by no means a finished copy. Here it is, before midnight as promised. Patches Welcome. -- And if I go insane, please don't put your wires in my brain. And if I go insane, will you still let me join in the game? pod/perlcommunity.pod: =head1 NAME perlcommunity - a brief overview of the Perl community =head1 DESCRIPTION This document...

[PATCH 0/2] A couple of patches to pod/perlbook.pod.
This patch series provides a couple of patches to add Ovid's Beginning Perl and chromatic's Modern Perl to the list of books in pod/perlbook.pod. These patches are being transferred over from the issues on perl-doc-cats/perl on github. If you have any questions or concerns with these patches please let me know how I can improve them (this is my first patch ever to perl). Thanks, Zachary Storer zacts on freenode Zachary Storer (2): Add Ovid's Beginning Perl to pod/perlbook.pod. Add chromatic's Modern Perl to pod/perlbook.pod. pod/perlbook.pod | 8 +++++...

[PATCH] Patch to patch for callbacks in core
I should have tested this better before submitting it. This patch is to Perl 11722 after applying my previous patch. Now callbacks will actually work. :-) - D <dmlloyd@tds.net> --- mg.c-old Tue Aug 21 13:26:52 2001 +++ perl-devel/mg.c Tue Aug 21 15:09:16 2001 @@ -1068,7 +1068,18 @@ void Perl_despatch_signals(pTHX) { - PL_event_pending = 0; + if (PL_callback_head != NULL) { + CALLBACK *cur, *next; + + for (cur = PL_callback_head; cur != NULL; cur = next) { + next = cur->next; + (*cur->callback)(cur->data); + ...

[PATCH pod/perlhack.pod] Yet another improvement to the patching example
This gives a simpler implementation of ok() that also includes descriptive names. --- pod/perlhack.pod 2001/08/28 13:54:34 1.1 +++ pod/perlhack.pod 2001/08/30 21:00:31 @@ -1481,13 +1481,12 @@ my $test = 1; sub ok { - my($ok) = @_; + my($ok, $name) = @_; # You have to do it this way or VMS will get confused. - my $out = ''; - $out = "not " unless $ok; - $out .= "ok $test\n"; - print $out; + print $ok ? "ok $test - $name\n" : "not ok $test - $name\n"; + +...

[PATCH] Small patch to perlport.pod
--Apple-Mail-4-1049174473 Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset=ISO-8859-1; format=flowed Hello, Here is small patch to perlport.pod (from 5.9.2) that corrects a few=20 typos and Pod errors, adds a link (where to find MPW) and adds a few=20 more information concerning Perl on Windows. Regards, S=E9bastien Aperghis-Tramoni -- - --- -- - -- - --- -- - --- -- - --[ http://maddingue.org ] Close the world, txEn eht nepO --Apple-Mail-4-1049174473 Content-Disposition: attachment; filename=perlport.patch Content-Transfer-Encoding...

[PATCH] perlfaq2.pod (with patch this time)
--Boundary-00=_yPo4GjTwFg9jXsN Content-Type: text/plain; charset="iso-8859-1" Content-Transfer-Encoding: 7bit Content-Disposition: inline Added a couple of books. I suppose it would help if I attached the patch... :-] -- Richard Foley Ciao - shorter than aufwiedersehen http://www.rfi.net/ --Boundary-00=_yPo4GjTwFg9jXsN Content-Type: text/x-diff; charset="iso-8859-1"; name="INSTALL.diff" Content-Transfer-Encoding: 7bit Content-Disposition: attachment; filename="INSTALL.diff" --- INSTALL.orig 2007-09-08 12:34:41.00...

[PATCH 5.5.650] Small patch to perldelta.pod, perlfunc.pod
Perldelta, perlfunc, state that arrays shrink by the number of elements deleted if deleting an array slice at the end of an array. This is a fib. The arrays shrink, quite sensibly, to the next initialized element. Thus: *[martyn]$ perl -le '$,="\t";@a=(0,undef,2);print $#a,@a;delete $a[1];print $#a,@a;delete $a[2];print $#a,@a;' 2 0 2 2 0 2 0 0 Mx. ======================================================================== *** perldelta.pod.orig Mon Feb 7 18:24:53 2000 --- perldelta.pod Mon Feb 14 14...

[PATCH pod/perlhack.pod] Sections on writing tests & patching core mods
This adds documentation describing the core tests, special considerations when writing core tests and special considerations when patching core modules. The most contentious bit is probably the recommendation that if core module has a CPAN version, patch the CPAN version instead of the core. I also fixed the =head3 tags on the way. --- pod/perlhack.pod 2001/07/15 05:49:27 1.1 +++ pod/perlhack.pod 2001/07/16 22:13:35 @@ -350,7 +350,7 @@ =back -=head3 Why rsync the source tree +=head2 Why rsync the source tree =over 4 @@ -378,7 +378,7 @@ =back -=head3 ...

[Resend] Patch to Get Rid of \t in perlipc.pod [was Re: [PATCH] Start revamping perlipc.pod]
I'm resending this patch because it was not applied yet. Please apply it,=20 because I'd like to further patch perlipc.pod. More details below. Regards, Shlomi Fish On Sunday 05 September 2010 08:13:02 Jesse Vincent wrote: > On Sun, Sep 05, 2010 at 08:03:41AM +0300, Shlomi Fish wrote: > > Hi all, > >=20 > > Inspired by a message ot the perl documentation proejct, I started > > working on revamping perlipc.pod here: > >=20 > > http://github.com/shlomif/perl/tree/perlipc-revamp > >=20 > > What I did so far is conve...

[PATCH] perlfaq2.pod (with correct patch this time...)
--Boundary-00=_GRo4G4GV7/LJ8eh Content-Type: text/plain; charset="iso-8859-1" Content-Transfer-Encoding: 7bit Content-Disposition: inline Added a couple of books. I suppose it would help if I attached the _correct_ patch... :-] -- Richard Foley Ciao - shorter than aufwiedersehen http://www.rfi.net/ --Boundary-00=_GRo4G4GV7/LJ8eh Content-Type: text/x-diff; charset="iso-8859-1"; name="perlfaq2.pod.diff" Content-Transfer-Encoding: 7bit Content-Disposition: attachment; filename="perlfaq2.pod.diff" --- perlfaq2.pod.or...

[PATCH] tiny patch for Hash::Util pod
--- bleedperl-amd64/ext/Hash/Util/lib/Hash/Util.pm Fri Jul 13 16:52:33 2007 +++ bleedperl2-amd64/ext/Hash/Util/lib/Hash/Util.pm Fri Oct 12 21:03:44 2007 @@ -370,7 +370,7 @@ sub all_keys{} sub legal_keys(\%) { legal_ref_keys(@_) } sub hidden_keys(\%){ hidden_ref_keys(@_) } -=item b<legal_keys> +=item B<legal_keys> my @keys = legal_keys(%hash); -- Slaven Rezic - slaven <at> rezic <dot> de Tk-AppMaster: a perl/Tk module launcher designed for handhelds http://tk-appmaster.sf.net On 12 Oct 2007 21:05:35 +0200, Slaven Rezic <slaven@rezic...

PATCH: clarify where to patch against
--envbJBWh7q8WU6mo Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Talking about Perl 5 git repo tonight, some questions came up about where development really happens. This patch is a bit of clarification about where/why patches go to blead/maint. -- rjbs --envbJBWh7q8WU6mo Content-Type: text/x-diff; charset=us-ascii Content-Disposition: attachment; filename="0001-very-minor-tweaks-to-description-of-maint-blead.patch" From 1b7ad6bc0c93abd2d9fad847e8449824e529ba24 Mon Sep 17 00:00:00 2001 From: Ricardo SIGNES <rjbs@cpan.org> Date:...

[PATCH] patching for sunos
Hi coders, greetings from the stone age: This is perl, v5.9.4 built for sun4-sunos-stdio SunOS Release 4.1.3 (GENERIC) #3: Mon Jul 27 16:44:16 PDT 1992 $ uname -a SunOS xxx 4.1.3 3 sun4m If anyone is interested in patches for SunOS yet, I have some. Some are harmless, some may not be optimal. Help/hints/tips are always nice and appreciated. 1. SunOS realloc() does not like NULL pointers as parameters. (buf?realloc((buf), (size)):malloc((size))) 2. There is no strtoul(), alas. Some older code correctly uses the Strtoul() macro (capital S). Newer additions don't...

[PATCH] installperl patch
------=_Part_72778_11907270.1186149310146 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: 7bit Content-Disposition: inline The attached patch modifies installperl as follows: 1. Don't install lib/CGI/eg/*. (These files aren't installed by the CPAN version of CGI either.) 2. Don't install lib/ExtUtils/NOTES, and lib/ExtUtils/PATCHING. (These files aren't installed by the CPAN version of ExtUtils::MakeMaker either.) ------=_Part_72778_11907270.1186149310146 Content-Type: application/octet-stream; name=installperl.patch Content-Transf...

[PATCH] perlhack on what to patch
--- pod/perlhack.pod.orig 2006-07-12 22:52:14.000000000 +0300 +++ pod/perlhack.pod 2006-07-12 23:05:40.000000000 +0300 @@ -598,14 +598,22 @@ =head2 Submitting patches but context diffs are accepted. Do not send RCS-style diffs or diffs without context lines. More information is given in the I<Porting/patching.pod> file in the Perl source distribution. Please -patch against the latest B<development> version (e.g., if you're -fixing a bug in the 5.005 track, patch against the latest 5.005_5x -version). Only patches that survive the heat of the development ...

[PATCH] cygwin070patches_4.patch
--------------030804070801060907040802 Content-Type: text/plain; charset=ISO-8859-1; format=flowed Content-Transfer-Encoding: 7bit My latest patch against the cygwin070patches branch r30596. * Finished implementation of the makefile expansion - "perl-style" * Changed all relevant makefile templates. make fulltest and make codetest has the same few mt-thread and resume errors as always. A new idea: =========== #IF(darwin): #ALSO:# MACOSX_DEPLOYMENT_TARGET must be defined for OS X #ALSO:export MACOSX_DEPLOYMENT_TARGET := @osx_version@ The POD for this change: ...

[PATCH] todo patch
--- perltodo.pod.old Wed May 16 17:51:45 2001 +++ perltodo.pod Mon May 28 16:56:29 2001 @@ -68,6 +68,10 @@ Artur Bergman's C<iThreads> module is a start on this, but needs to be more mature. +=head2 make perl_clone optionally clone ops + +So at pseduforking, mod_perl , iThreads and nvi will work properly (not as efficient) until regex engine is fixed + =head2 Work out exit/die semantics for threads =head2 Typed lexicals for compiler On Mon 28 May 2001 17:03, Artur Bergman <artur@contiller.se> wrote: > --- perltodo.pod.old Wed May 16 17:5...

[PATCH] Debian patches
--qDbXVdCdHGoSgWSk Content-Type: text/plain; charset=us-ascii Content-Disposition: inline Attached are the patches to Debian's 5.8.4 package not currently covered by my latest rsync of perl-5.8.x. The patches have been re-worked to apply cleanly to that branch, but all should be applicable to perl-current as well. 10_fix_file_path Rewrite of File::Path::rmtree. This is the most important patch, it replaces rmtree with a recursive function to remove a race condition which potentially allows an attacker to make files suid or to remove arbitrary files (CAN-2...

[PATCH] perldiag.pod: followup on the PerlIO::scalar patch
--------------000905080006040605010008 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 7bit --------------000905080006040605010008 Content-Type: text/plain; x-mac-type="0"; x-mac-creator="0"; name="seek3.pat" Content-Transfer-Encoding: base64 Content-Disposition: inline; filename="seek3.pat" LS0tIHBvZC9wZXJsZGlhZy5wb2QuZGlzdAkyMDA2LTEwLTAyIDEyOjQ1OjA3LjAwMDAwMDAw MCArMDMwMAorKysgcG9kL3BlcmxkaWFnLnBvZAkyMDA2LTEwLTAyIDEyOjQ4OjU2LjIzMTkw MjAwMCArMDMwMApAQCAtMjc2Niw4ICsyNzY2LDExIEBACiAKIChGLCBXIGxheWVyKSBZb3Ug dHJpZWQgd...

Web resources about - [PATCH] more pod patches - perl.perl5.porters

Patch Barracks - Wikipedia, the free encyclopedia
Patch Barracks was renamed from the German Kurmärker Kaserne in 1952; it was originally built for use by the German Army Wehrmacht in 1936/37. ...

Bradenton, FL Patch - News, Sports, Events, Businesses & Deals
Comprehensive and trusted local coverage of Bradenton, FL. Featuring news and events, business listings, discussions, announcements, photos and ...

Manassas, VA Patch - News, Sports, Events, Businesses & Deals
... your tip here and it will be sent straight to Jamie M. Rogers, James Cullum, Raytevia Evans, Greg Hambrick, and Todd Richissin,Manassas Patch's ...

Peachtree Corners, GA Patch - News, Sports, Events, Businesses & Deals
Comprehensive and trusted local coverage of Peachtree Corners and Berkeley Lake, GA. Featuring news and events, business listings, discussions, ...

Hey all. Some of you may learn in the... - Somerville Patch - Facebook
Hey all. Some of you may learn in the next hours and days that a number of colleagues and I were just laid off by Patch. That means I will no ...

ISG: Playdom Buys Green Patch and Trippert Labs — On the Way to IPO?
... ones on Facebook, has confirmed a couple purchases we’ve been hearing rumors about recently. It has bought Facebook game developer Green Patch, ...

Aliso Viejo Patch (@AlisoViejoPatch) on Twitter
Log in Sign up You are on Twitter Mobile because you are using an old version of Internet Explorer. Learn more here Aliso Viejo Patch @ AlisoViejoPatch ...

Lena Dunham withdraws from Girls publicity tour due to 'rough patch' in illness
Girls creator Lena Dunham has pulled out of publicity ahead of the season five premiere of her HBO show, citing an ongoing battle with endometriosis. ...

Lena Dunham withdraws from Girls publicity tour due to 'rough patch' in illness
Girls creator Lena Dunham has pulled out of publicity ahead of the season five premiere of her HBO show, citing an ongoing battle with endometriosis. ...

FishbowlNY Newsstand: Patch Job
FishbowlNY Newsstand: Patch Job

Resources last updated: 2/14/2016 11:59:10 PM