Bug#1016527: rst2man: --date should be used to form the .TH title heading

[Alejandro Colomar]

Package: python3-docutils
Version: 0.17.1+dfsg-2
Severity: normal
Tags: upstream
X-Debbugs-Cc: Alejandro Colomar <alx.manpages@gmail.com>, <groff@gnu.org>, 
Quentin Monnet <quentin@isovalent.com>

Hi,

The --date argument to rst2man(1) produces the following text:

    Generated on: YYYY-MM-DD

And that text is put in the NAME section of the manual page.  That
is incorrect.  The date should be put as the 3rd argument to the
.TH macro, preferably in ISO 8601 format (YYYY-MM-DD):

    .TH title section date source-and-version manual


Cheers,

Alex



-- System Information:
Debian Release: bookworm/sid
  APT prefers unstable
  APT policy: (500, 'unstable'), (1, 'experimental')
Architecture: amd64 (x86_64)

Kernel: Linux 5.18.0-2-amd64 (SMP w/4 CPU threads; PREEMPT)
Kernel taint flags: TAINT_OOT_MODULE, TAINT_UNSIGNED_MODULE
Locale: LANG=C.UTF-8, LC_CTYPE=C.UTF-8 (charmap=UTF-8), LANGUAGE not set
Shell: /bin/sh linked to /usr/bin/dash
Init: systemd (via /run/systemd/system)
LSM: AppArmor: enabled

Versions of packages python3-docutils depends on:
ii  docutils-common  0.17.1+dfsg-2
ii  python3          3.10.5-3
ii  python3-roman    3.3-1

Versions of packages python3-docutils recommends:
ii  libpaper-utils    1.1.28+b1
ii  python3-pil       9.2.0-1+b1
ii  python3-pygments  2.12.0+dfsg-2

Versions of packages python3-docutils suggests:
pn  docutils-doc                                <none>
pn  fonts-linuxlibertine | ttf-linux-libertine  <none>
pn  texlive-lang-french                         <none>
ii  texlive-latex-base                          2022.20220722-1
ii  texlive-latex-recommended                   2022.20220722-1

-- no debconf information