Fix pod2man documentation of --date and --release

Fix the documentation for the date and release options to Pod::Man
and the corresponding --date and --release options to pod2man. The
positions of the footers controlled by these options were reversed
in podlators 1.12 but the documentation was never updated.

Author: rra

Changes

@@ -19,6 +19,11 @@ v6.1.0 - Not Released
 - Fix Pod::Text quoting heuristics for C<> when the contents contains
   newlines. Thanks to van-de-bugger for the report. (GitHub #39)
 
+- Fix the documentation for the date and release options to Pod::Man and
+  the corresponding --date and --release options to pod2man. The positions
+  of the footers controlled by these options were reversed in podlators
+  1.12 but the documentation was never updated.
+
 v6.0.2 - 2024-07-14
 
  - Fix removal of scripts/pod2man and scripts/pod2text by make realclean,

lib/Pod/Man.pm

@@ -1764,15 +1764,18 @@ this option is not specified, is C<User Contributed Perl Documentation>.
 
 =item date
 
-[4.00] Sets the left-hand footer for the C<.TH> macro.  If this option is not
-set, the contents of the environment variable POD_MAN_DATE, if set, will be
-used.  Failing that, the value of SOURCE_DATE_EPOCH, the modification date of
-the input file, or the current time if stat() can't find that file (which will
-be the case if the input is from C<STDIN>) will be used.  If taken from any
-source other than POD_MAN_DATE (which is used verbatim), the date will be
+[4.00] Sets the centered page footer for the C<.TH> macro.  If this option is
+not set, the contents of the environment variable POD_MAN_DATE, if set, will
+be used.  Failing that, the value of SOURCE_DATE_EPOCH, the modification date
+of the input file, or the current time if stat() can't find that file (which
+will be the case if the input is from C<STDIN>) will be used.  If taken from
+any source other than POD_MAN_DATE (which is used verbatim), the date will be
 formatted as C<YYYY-MM-DD> and will be based on UTC (so that the output will
 be reproducible regardless of local time zone).
 
+Note that some system C<an> macro sets assume that the centered footer will be
+a modification date and will prepend something like C<Last modified: >.
+
 =item encoding
 
 [5.00] Specifies the encoding of the output.  The value must be an encoding
@@ -1975,14 +1978,10 @@ options is set, C<lquote> or C<rquote> overrides C<quotes>.
 
 =item release
 
-[1.00] Set the centered footer for the C<.TH> macro.  By default, this is set
-to the version of Perl you run Pod::Man under.  Setting this to the empty
-string will cause some *roff implementations to use the system default value.
-
-Note that some system C<an> macro sets assume that the centered footer will be
-a modification date and will prepend something like C<Last modified: >.  If
-this is the case for your target system, you may want to set C<release> to the
-last modified date and C<date> to the version number.
+[1.12] Set the left-hand page footer for the C<.TH> macro.  By default, this
+is set to the version of Perl you run Pod::Man under.  Setting this to the
+empty string will cause some *roff implementations to use the system default
+value.
 
 =item section
 

scripts/pod2man.PL

@@ -229,12 +229,15 @@ below.
 
 =item B<-d> I<string>, B<--date>=I<string>
 
-[4.00] Set the left-hand footer string for the C<.TH> macro to I<string>.  By
+[4.00] Set the centered page footer for the C<.TH> macro to I<string>.  By
 default, the first of POD_MAN_DATE, SOURCE_DATE_EPOCH, the modification date
 of the input file, or the current date (if input comes from C<STDIN>) will be
-used, and the date will be in UTC.  See L<Pod::Man/CLASS METHODS> for more
+used.  The default time zone is UTC.  See L<Pod::Man/CLASS METHODS> for more
 details.
 
+Note that some system C<an> macro sets assume that the centered footer will be
+a modification date and will prepend something like C<Last modified: >.
+
 =item B<-e> I<encoding>, B<--encoding>=I<encoding>
 
 [5.00] Specifies the encoding of the output.  I<encoding> must be an encoding
@@ -456,16 +459,11 @@ options is set, B<--lquote> or B<--rquote> overrides B<--quotes>.
 
 =item B<-r> I<version>, B<--release>=I<version>
 
-[1.00] Set the centered footer for the C<.TH> macro to I<version>.  By
+[1.12] Set the left-hand footer for the C<.TH> macro to I<version>.  By
 default, this is set to the version of Perl you run B<pod2man> under.  Setting
 this to the empty string will cause some *roff implementations to use the
 system default value.
 
-Note that some system C<an> macro sets assume that the centered footer will be
-a modification date and will prepend something like C<Last modified: >.  If
-this is the case for your target system, you may want to set B<--release> to
-the last modified date and B<--date> to the version number.
-
 =item B<-s> I<string>, B<--section>=I<string>
 
 [1.00] Set the section for the C<.TH> macro.  The standard section numbering
@@ -539,7 +537,7 @@ and Tom Christiansen.
 
 =head1 COPYRIGHT AND LICENSE
 
-Copyright 1999-2001, 2004, 2006, 2008, 2010, 2012-2019, 2022-2024 Russ Allbery
+Copyright 1999-2001, 2004, 2006, 2008, 2010, 2012-2019, 2022-2025 Russ Allbery
 <[email protected]>
 
 This program is free software; you may redistribute it and/or modify it