integrate changes#7205..7210,7212,7214..7219,7222,7223,7225,7226,

7228,7230..7241,7243,7346,7347,7350..7354,7356,7358..7360,7362,
7363,7365..7368,7370..7374,7376..7386,7391,7393..7399,7404..7408,
7410..7413 from mainline

Introduce the man[24-8] variables, from Andy Dougherty.

Upgrade to CPAN 1.58, from Andreas König.

An updated EBCDIC tr patch.
Subject: Re: [PATCH: perl@7181] op/tr tests on OS/390

Subject:  [PATCH] 5.6.0 & 5.7.1,  VMS fixes

Two thirds of
Subject: Proposed patches, Install.pm getopts.pl termcap.pl
The Install.pm changes will be submitted separately because
they need some work and discussion still.

The Install.pm third of
Subject: Proposed patches, Install.pm getopts.pl termcap.pl

Subject: [PATCH: perl@7181] was: Re: off to a bad start on fixing regression tests

Subject: [PATCH 5.7.0] IVs in mtats

Subject: [PATCH 5.7.0] Perl API for mstats

Ilya implemented the memory profiling API.

In Amdahl UTS "struct sv" is defined by a system header,
<ksync.h>.

Slight tweak of the code to appease Amdahl UTS cc.

Amdahl UTS doesn't seem to do dynaloading.

Use UTF8SKIP(), from Simon Cozens.

Thinko in #7222.

op/sprintf.t patch for OS/390 (and any other host with limited
floating-point exponent length)
Subject: Re: [ID 20001006.014] Not OK: perl v5.7.0 +DEVEL7158 on os390 05.00  (UNINSTALLED) [PATCH bleadperl]

Tweak #7225.
Subject: Re: [ID 20001006.014] Not OK: perl v5.7.0 +DEVEL7158 on os390 05.00 (UNINSTALLED) [PATCH bleadperl]

Subject: RFC: a (temporary?) way around utf8.pm for EBCDIC

Needs to be conditional on SunOS 4.
Subject: [Pach 5.7.0@7229] Removing -ldb from the core build

Test cases for bug id 20000323.056 (the bug seems to be fixed).

Add test for bug id 20000427.003 (which seems to have
been fixed) (also duplicate as 20000427.004, though
with a higher severity).  Move one utf8 from op/append
to pragma/utf8, tag the tests with bug ids.

Document FNCASE=y as discussed in the bug 20000902.009.

split() utf8 fixes.  Should fix both 20001014.001 and 20000426.003.
The problem was that rx->minlen was in chars while pp_split()
thought it would be in bytes. 

Make ~(chr(a).chr(b)) eq chr(~a).chr(~b) on utf8.
Subject: [PATCH] Re: [ID 20000918.005] ~ on wide chars

Fix few quad issues, which for example broke chr(~chr(~0)) for UTF8.

Fix a couple of compiler-noted nits in #7235.

Tweak the test of #7235.

One more ~utf8 tweak.

-w cleanup.
Subject: Re: Problems with bleadperl 

Subject: small pod patch

Subject: [PATCH perlguts.pod] Document offset hack

Add Charles Lane.

Add the capability to include/exclude branches.

Subject: [ID 20001016.012] [PATCHes Included]OK: perl v5.7.0 on dos-djgpp djgpp

Detect early whether the std streams have gone bad.
Subject: PATCH (was Re: [ID 20001016.007] Not OK: perl v5.7.0 +DEVEL7228 on i586-linux 2.2.16 (UNINSTALLED))

More IoTYPE sprinkling.

Workaround for a sfio bug where the stream error indicator
is not cleared as documented.
Subject: PATCH (was Re: [ID 20001016.007] Not OK: perl v5.7.0 +DEVEL7228 on i586-linux 2.2.16 (UNINSTALLED))

Clarify documentation on 'use bytes'.
Subject: Re: What does 'use bytes' "mean" ?

Show the failed remote port, instead of the failing line number.
Subject: [PATCH 5.6.1 Debugger] More diagnostics

Make Cwd more bulletproof in chrooted environments.
Subject: [ID 20001018.001] Fix for Cwd.pm (chroot)

Subject: Pod patch for Devel::Peek

Subject: Re: [ID 20001013.008] perl 5.6.0 on AIX 4.3.2 w/GCC 2.95.2

Borland C fstat() never saw the fd as writable.
Subject: fix for Borland's weak "stat" (perl@7211)

Missing change from #7362.

Subject: [PATCH 5.7.0] Re: [ID 20001018.008] flip-flop bug when there's no <FH> 

Add the test case for the bug id 20000730.004 which seems
to have been fixed by now.

Fix of sorts for bug id 20000901.092.  There seems to be no trace
of a 'pmshort' anywhere in the B, so the offending line was simply
removed.

Subject: Re: [ID 20001013.008] perl 5.6.0 on AIX w/GCC

Subject: PATCH do_print has 2 PerlIO_error()s

NonStop-UX patches from Tom Bates <tom.bates@compaq.com>

Typo noted by Mark Lutz.

Subject: PATCH CR+LF should be "\cM\cJ" in perlop

In the latest compiler builds cccdlflags must not become -fpic,
from Wilfredo Sánchez.

Subject:  [PATCH] Perl 5.6.0/5.7.0, vms/gen_shrfls.pl update

Subject:  [PATCH] Perl 5.6.0/5.7.0 enable DProf test for VMS

SOCKS function redefinitions need prototypes, too, otherwise
for example 32 bit versus 64 bit differences cause a lot of
problems.  Part of
Subject: [ID 20001016.017] [jens: 5.7.0 Solaris 8, 64 Bit, Workshop 6.0 Compiler]

Portability tweak on #7377.
Subject:  Re: [nick@cow.org.uk: [ID 20001020.004] Not OK: perl v5.7.0 +DEVEL7368 on i386-freebsd-64all 4.1-stable (UNINSTALLED)]

Don't write double values through long double pointers,
based on a part of
Subject: [ID 20001016.017] [jens: 5.7.0 Solaris 8, 64 Bit, Workshop 6.0 Compiler]

Reëntrancy fix.
Subject: [PATCH perl@7229] Rentrant parser and yylex()

Make scan_num() reëntrant, as suggested in
Subject: [PATCH perl@7229] Rentrant parser and yylex()

Fix for ID 20001020.006, concatenating an unset submatch
with utf8 resulted in "Modification of a read-only value".

Fix for ID 20000915.011, IO::Select warning for an undefined fd.

The #7383 was right only in the context of the original bug report,
not in more general case.

Update Changes.

Testcases for a #7383,#7385 related bug.
Subject: PATCH Re: [ID 20001020.006] "$2$utf8" == modification of read-only-variable

Subject: [PATCH@blead Tie/Array.pm] Re: [ID 20001020.002] Tie::Array SPLICE method is buggy

Tweak the Is* definitions of Unicode character classes
to better match the official categorizations; embrace
the official categorizations; add the combining marks
as alpha (and -numeric); fix DCinital (a typo and edito)
to be DCmedial.

Hints tweak from Anton Berezin.

Subject: installman go-faster stripes
Subject: Re: installman go-faster stripes

Subject: [ID 20001021.003] updated hints/openbsd.sh

Subject: [PATCH bleadperl] -MO=C falls over on package <none>

Subject: PATCH $Config::Config{ldlibpthname} in ext/DynaLoader/DynaLoader_pm.PL

Subject: [PATCH] Re: [ID 20000121.007] XXX documentation in man ExtUtils::MakeMaker

Doc patch.
Subject: [ID 19991128.002] \&{'foo'} not caught by strict refs

Retract #7404 with a patch from Robin Barker, via Andy Dougherty.

Subject: Re: [ID 20001021.005] SEGV with regex match 

Subject: Re: [20000731.007] potential syntax error not detected [PATCH]

The change #7187 was not so good on VMS.
Subject: [PATCH perl@7369] VMS perldoc.PL fix for double quoted temp filename

Subject: [PATCH: perl@7386] miscellaneous typos in 3 pods

Miscellaneous MacOS Classic library updates from Matthias Neeracher.

Document PERL_INSTALL_ROOT of #7210.

p4raw-link: @7219 on //depot/perl: d67493ed56a1a4cbcbfc722e3d9ed0c4f29c3963
p4raw-link: @7214 on //depot/perl: 880b20b67e23950959b9017ea50a2f9fe4e915a4
p4raw-link: @7212 on //depot/perl: 2f2d036aac7a6d378d15faf96ae8ed621bef910c
p4raw-link: @7210 on //depot/perl: a9d83807f0f0b611a2eea3bda7bb80eac9d5b104
p4raw-link: @7205 on //depot/perl: 6f748670132fcfd6aa343cd6dd2a0b18fc867c63on //depot/metaconfig: a1829424efc881dd6263214c1b17e46de8ac69c8
p4raw-link: @7187 on //depot/perl: a79ff10558a3b8e128b0898794bddcf07255f408

p4raw-id: //depot/maint-5.6/perl@8159
p4raw-branched: from //depot/perl@8156 'branch in'
	lib/unicode/Is/DCmedial.pl t/lib/tie-splice.t
p4raw-deleted: from //depot/perl@8156 'delete in'
	lib/unicode/Is/DCinital.pl (@6930..)
p4raw-integrated: from //depot/perl@8156 'copy in' t/op/flip.t (@536..)
	t/lib/dprof/V.pm (@3710..) lib/getopts.pl lib/termcap.pl
	(@3759..) perly.y (@5009..) hints/darwin.sh (@5266..) dosish.h
	(@5628..) lib/ExtUtils/Mksymlists.pm (@5769..)
	vms/ext/Stdio/Stdio.pm (@5823..) lib/strict.pm (@5843..) Todo
	(@5897..) t/op/oct.t (@6044..) perly.c (@6194..)
	ext/IO/lib/IO/Select.pm (@6586..) hints/freebsd.sh (@6894..)
	lib/unicode/Is/Alnum.pl lib/unicode/Is/Alpha.pl
	lib/unicode/Is/Graph.pl lib/unicode/Is/Print.pl
	lib/unicode/Is/Punct.pl lib/unicode/Is/Space.pl
	lib/unicode/Is/Word.pl (@6930..) t/pod/find.t (@6978..)
	t/pod/testp2pt.pl (@7048..) t/op/64bitint.t (@7057..)
	myconfig.SH (@7060..) pod/perlmod.pod (@7097..) t/op/append.t
	(@7100..) hints/openbsd.sh (@7122..) ext/B/B/Debug.pm (@7134..)
	installman (@7140..) lib/Tie/Array.pm (@7151..)
	utils/perldoc.PL (@7187..) pod/perlebcdic.pod (@7191..)
	t/op/tr.t (@7193..) lib/ExtUtils/Install.pm (@7210..)
	ext/Devel/Peek/Peek.pm (@7215..) t/lib/dprof.t (@7377..)
p4raw-integrated: from //depot/perl@7412 'copy in' lib/Term/ReadLine.pm
	(@3601..) lib/File/Basename.pm (@5296..) lib/File/Path.pm
	(@5592..) lib/perl5db.pl (@7356..)
p4raw-integrated: from //depot/perl@7408 'copy in' lib/vars.pm
	(@5948..)
p4raw-integrated: from //depot/perl@7407 'copy in' t/op/pat.t (@6874..)
	regexec.c (@7115..)
p4raw-integrated: from //depot/perl@7406 'copy in'
	lib/ExtUtils/MakeMaker.pm (@7404..)
p4raw-integrated: from //depot/perl@7399 'copy in'
	ext/DynaLoader/DynaLoader_pm.PL (@6359..)
p4raw-integrated: from //depot/perl@7398 'copy in' ext/B/B/C.pm
	(@5593..) ext/B/B.pm (@6763..)
p4raw-integrated: from //depot/perl@7396 'copy in' pod/pod2man.PL
	(@7047..)
p4raw-integrated: from //depot/perl@7394 'copy in'
	lib/unicode/mktables.PL (@7030..) 'edit in' MANIFEST (@7393..)
p4raw-integrated: from //depot/perl@7391 'copy in' t/pragma/utf8.t
	(@7383..)
p4raw-integrated: from //depot/perl@7385 'edit in' pp_hot.c (@7383..)
p4raw-integrated: from //depot/perl@7382 'edit in' embed.h embed.pl
	proto.h toke.c (@7381..) 'ignore' objXSUB.h (@7096..) 'merge
	in' perlapi.c (@7096..)
p4raw-integrated: from //depot/perl@7381 'ignore' perl.h (@7380..)
p4raw-integrated: from //depot/perl@7380 'edit in' pp.c (@7364..)
p4raw-integrated: from //depot/perl@7378 'edit in' doio.c (@7370..)
	'merge in' pp_sys.c (@7213..)
p4raw-integrated: from //depot/perl@7377 'copy in' vms/test.com
	(@7053..) configure.com (@7376..)
p4raw-integrated: from //depot/perl@7376 'copy in' vms/gen_shrfls.pl
	(@7208..)
p4raw-integrated: from //depot/perl@7373 'copy in' pod/perlop.pod
	(@7121..)
p4raw-branched: from //depot/perl@7371 'branch in' hints/nonstopux.sh
p4raw-integrated: from //depot/perl@7371 'edit in' Configure (@7230..)
	'ignore' config_h.SH (@7205..)
p4raw-integrated: from //depot/perl@7368 'copy in' hints/aix.sh
	(@6982..)
p4raw-integrated: from //depot/perl@7365 'copy in' t/pragma/warn/pp_hot
	(@6531..) 'merge in' pp_ctl.c (@7165..)
p4raw-integrated: from //depot/perl@7363 'copy in' win32/perlhost.h
	(@6662..)
p4raw-integrated: from //depot/perl@7362 'copy in' win32/win32.c
	(@7173..)
p4raw-integrated: from //depot/perl@7361 'copy in' pod/buildtoc.PL
	(@6844..) pod/perl.pod (@6894..) pod/perlport.pod (@7176..)
p4raw-branched: from //depot/perl@7360 'branch in' README.aix
p4raw-integrated: from //depot/perl@7358 'copy in' lib/Cwd.pm (@7124..)
p4raw-integrated: from //depot/perl@7354 'copy in' lib/bytes.pm
	(@5629..)
p4raw-integrated: from //depot/perl@7351 'copy in' t/op/misc.t
	(@6874..)
p4raw-integrated: from //depot/perl@7350 'copy in' djgpp/djgpp.c
	(@5288..) t/io/open.t (@6874..)
p4raw-integrated: from //depot/perl@7347 'copy in' Porting/genlog
	(@4604..)
p4raw-integrated: from //depot/perl@7346 'copy in' AUTHORS (@6961..)
p4raw-integrated: from //depot/perl@7243 'merge in' pod/perlguts.pod
	(@7001..)
p4raw-integrated: from //depot/perl@7241 'copy in' pod/perlfaq7.pod
	(@6344..)
p4raw-integrated: from //depot/perl@7240 'merge in' t/pragma/overload.t
	(@7104..)
p4raw-integrated: from //depot/perl@7239 'copy in' t/op/bop.t (@7238..)
p4raw-integrated: from //depot/perl@7235 'copy in' utf8.h (@7154..)
p4raw-integrated: from //depot/perl@7233 'copy in' README.dos (@5505..)
p4raw-integrated: from //depot/perl@7228 'copy in' lib/utf8.pm
	(@6593..)
p4raw-integrated: from //depot/perl@7226 'copy in' t/op/sprintf.t
	(@7225..)
p4raw-integrated: from //depot/perl@7223 'edit in' utf8.c (@7222..)
p4raw-integrated: from //depot/perl@7219 'copy in' hints/uts.sh
	(@1575..)
p4raw-integrated: from //depot/perl@7217 'copy in' sv.h (@7156..)
p4raw-integrated: from //depot/perl@7215 'copy in'
	ext/Devel/Peek/Peek.xs (@7081..)
p4raw-integrated: from //depot/perl@7214 'copy in' malloc.c (@7081..)
p4raw-integrated: from //depot/perl@7208 'copy in' lib/File/Temp.pm
	(@6964..)
p4raw-integrated: from //depot/perl@7206 'copy in' lib/CPAN.pm
	lib/CPAN/FirstTime.pm (@7046..)
p4raw-integrated: from //depot/perl@7205 'copy in' vos/config.pl
	(@6816..) vos/config.h vos/config_h.SH_orig (@6982..)
	Porting/config_H (@7195..) Porting/Glossary Porting/config.sh
	epoc/config.sh vos/config.def win32/config.bc win32/config.gc
	win32/config.vc (@7196..)

9 files changed, 69 insertions, 11 deletions

diff --git a/pod/buildtoc.PL b/pod/buildtoc.PL
index 55e39252d9..3819308031 100644
--- a/pod/buildtoc.PL
+++ b/pod/buildtoc.PL
@@ -150,6 +150,7 @@ if (-d "pod") {
     perl5005delta       
     perl5004delta       
 
+    perlaix
     perlamiga          
     perlcygwin          
     perldos             
@@ -163,6 +164,7 @@ if (-d "pod") {
 	  );
 
 @ARCHPODS = qw(
+    perlaix	
     perlamiga          
     perlcygwin          
     perldos             
diff --git a/pod/perl.pod b/pod/perl.pod
index fc40d3b33a..946d6f2927 100644
--- a/pod/perl.pod
+++ b/pod/perl.pod
@@ -104,6 +104,7 @@ For ease of access, the Perl manual has been split up into several sections:
     perl5005delta	Perl changes in version 5.005
     perl5004delta	Perl changes in version 5.004
 
+    perlaix		Perl notes for AIX
     perlamiga		Perl notes for Amiga
     perlcygwin		Perl notes for Cygwin
     perldos		Perl notes for DOS
diff --git a/pod/perlebcdic.pod b/pod/perlebcdic.pod
index 4ef5eca2d0..12ea2f3ef4 100644
--- a/pod/perlebcdic.pod
+++ b/pod/perlebcdic.pod
@@ -501,7 +501,8 @@ provide easy to use ASCII to EBCDIC operations that are also easily
 reversed.
 
 For example, to convert ASCII to code page 037 take the output of the second 
-column from the output of recipe 0 and use it in tr/// like so:
+column from the output of recipe 0 (modified to add \\ characters) and use 
+it in tr/// like so:
 
     $cp_037 = 
     '\000\001\002\003\234\011\206\177\227\215\216\013\014\015\016\017' .
@@ -524,15 +525,19 @@ column from the output of recipe 0 and use it in tr/// like so:
     my $ebcdic_string = $ascii_string;
     eval '$ebcdic_string =~ tr/\000-\377/' . $cp_037 . '/';
 
-To convert from EBCDIC to ASCII just reverse the order of the tr/// 
+To convert from EBCDIC 037 to ASCII just reverse the order of the tr/// 
 arguments like so:
 
     my $ascii_string = $ebcdic_string;
-    eval '$ascii_string = tr/' . $code_page_chrs . '/\000-\037/';
+    eval '$ascii_string = tr/' . $cp_037 . '/\000-\377/';
+
+Similarly one could take the output of the third column from recipe 0 to
+obtain a C<$cp_1047> table.  The fourth column of the output from recipe
+0 could provide a C<$cp_posix_bc> table suitable for transcoding as well.
 
 =head2 iconv
 
-XPG4 operability often implies the presence of an I<iconv> utility
+XPG operability often implies the presence of an I<iconv> utility
 available from the shell or from the C library.  Consult your system's
 documentation for information on iconv.
 
diff --git a/pod/perlfaq7.pod b/pod/perlfaq7.pod
index 1ca7893f13..0d4876fd68 100644
--- a/pod/perlfaq7.pod
+++ b/pod/perlfaq7.pod
@@ -196,6 +196,10 @@ own module.  Make sure to change the names appropriately.
     }
     our @EXPORT_OK;
 
+    # exported package globals go here
+    our $Var1;
+    our %Hashit;
+
     # non-exported package globals go here
     our @more;
     our $stuff;
diff --git a/pod/perlguts.pod b/pod/perlguts.pod
index da67c89d39..f525a070a5 100644
--- a/pod/perlguts.pod
+++ b/pod/perlguts.pod
@@ -210,6 +210,39 @@ line and all will be well.
 To free an SV that you've created, call C<SvREFCNT_dec(SV*)>.  Normally this
 call is not necessary (see L<Reference Counts and Mortality>).
 
+=head2 Offsets
+
+Perl provides the function C<sv_chop> to efficiently remove characters
+from the beginning of a string; you give it an SV and a pointer to
+somewhere inside the the PV, and it discards everything before the
+pointer. The efficiency comes by means of a little hack: instead of
+actually removing the characters, C<sv_chop> sets the flag C<OOK>
+(offset OK) to signal to other functions that the offset hack is in
+effect, and it puts the number of bytes chopped off into the IV field
+of the SV. It then moves the PV pointer (called C<SvPVX>) forward that
+many bytes, and adjusts C<SvCUR> and C<SvLEN>. 
+
+Hence, at this point, the start of the buffer that we allocated lives
+at C<SvPVX(sv) - SvIV(sv)> in memory and the PV pointer is pointing
+into the middle of this allocated storage.
+
+This is best demonstrated by example:
+
+  % ./perl -Ilib -MDevel::Peek -le '$a="12345"; $a=~s/.//; Dump($a)'
+  SV = PVIV(0x8128450) at 0x81340f0
+    REFCNT = 1
+    FLAGS = (POK,OOK,pPOK)
+    IV = 1  (OFFSET)
+    PV = 0x8135781 ( "1" . ) "2345"\0
+    CUR = 4
+    LEN = 5
+
+Here the number of bytes chopped off (1) is put into IV, and
+C<Devel::Peek::Dump> helpfully reminds us that this is an offset. The
+portion of the string between the "real" and the "fake" beginnings is
+shown in parentheses, and the values of C<SvCUR> and C<SvLEN> reflect
+the fake beginning, not the real one.
+
 =head2 What's Really Stored in an SV?
 
 Recall that the usual method of determining the type of scalar you have is
diff --git a/pod/perlmod.pod b/pod/perlmod.pod
index a9a87562a8..6f98cf6d99 100644
--- a/pod/perlmod.pod
+++ b/pod/perlmod.pod
@@ -310,6 +310,10 @@ create a file called F<Some/Module.pm> and start with this template:
     }
     our @EXPORT_OK;
 
+    # exported package globals go here
+    our $Var1;
+    our %Hashit;
+
     # non-exported package globals go here
     our @more;
     our $stuff;
diff --git a/pod/perlop.pod b/pod/perlop.pod
index 32eaa3c330..e97a25bc9b 100644
--- a/pod/perlop.pod
+++ b/pod/perlop.pod
@@ -710,7 +710,7 @@ on a Mac, these are reversed, and on systems without line terminator,
 printing C<"\n"> may emit no actual data.  In general, use C<"\n"> when
 you mean a "newline" for your system, but use the literal ASCII when you
 need an exact character.  For example, most networking protocols expect
-and prefer a CR+LF (C<"\012\015"> or C<"\cJ\cM">) for line terminators,
+and prefer a CR+LF (C<"\015\012"> or C<"\cM\cJ">) for line terminators,
 and although they often accept just C<"\012">, they seldom tolerate just
 C<"\015">.  If you get in the habit of using C<"\n"> for networking,
 you may be burned some day.
diff --git a/pod/perlport.pod b/pod/perlport.pod
index 25e1371808..0c3554686d 100644
--- a/pod/perlport.pod
+++ b/pod/perlport.pod
@@ -1995,8 +1995,9 @@ http://www.perl.com/CPAN/ports/index.html for binary distributions.
 
 =head1 SEE ALSO
 
-L<perlamiga>, L<perlcygwin>, L<perldos>, L<perlhpux>, L<perlos2>,
-L<perlos390>, L<perlwin32>, L<perlvms>, and L<Win32>.
+L<perlaix>, L<perlamiga>, L<perlcygwin>, L<perldos>, L<perlebcdic>,
+L<perlhpux>, L<perlos2>, L<perlos390>, L<perlposix-bc>, L<perlwin32>,
+L<perlvms>, and L<Win32>.
 
 =head1 AUTHORS / CONTRIBUTORS
 
diff --git a/pod/pod2man.PL b/pod/pod2man.PL
index 4c5831b90b..dd5bb634be 100644
--- a/pod/pod2man.PL
+++ b/pod/pod2man.PL
@@ -72,9 +72,14 @@ if ($options{official} && !defined $options{center}) {
     $options{center} = 'Perl Programmers Reference Guide';
 }
 
-# Initialize and run the formatter.
+# Initialize and run the formatter, pulling a pair of input and output off
+# at a time.
 my $parser = Pod::Man->new (%options);
-$parser->parse_from_file (@ARGV);
+my @files;
+do {
+    @files = splice (@ARGV, 0, 2);
+    $parser->parse_from_file (@files);
+} while (@ARGV);
 
 __END__
 
@@ -88,7 +93,7 @@ pod2man [B<--section>=I<manext>] [B<--release>=I<version>]
 [B<--center>=I<string>] [B<--date>=I<string>] [B<--fixed>=I<font>]
 [B<--fixedbold>=I<font>] [B<--fixeditalic>=I<font>]
 [B<--fixedbolditalic>=I<font>] [B<--official>] [B<--lax>]
-[B<--quotes>=I<quotes>] [I<input> [I<output>]]
+[B<--quotes>=I<quotes>] [I<input> [I<output>] ...]
 
 pod2man B<--help>
 
@@ -101,7 +106,10 @@ terminal using nroff(1), normally via man(1), or printing using troff(1).
 I<input> is the file to read for POD source (the POD can be embedded in
 code).  If I<input> isn't given, it defaults to STDIN.  I<output>, if given,
 is the file to which to write the formatted output.  If I<output> isn't
-given, the formatted output is written to STDOUT.
+given, the formatted output is written to STDOUT.  Several POD files can be
+processed in the same B<pod2man> invocation (saving module load and compile
+times) by providing multiple pairs of I<input> and I<output> files on the
+command line.
 
 B<--section>, B<--release>, B<--center>, B<--date>, and B<--official> can be
 used to set the headers and footers to use; if not given, Pod::Man will