[Python-modules-team] Bug#877444: python3-docutils: rst2man warning on multiparagraph copyright field that is correctly recognised

[Elena ``of Valhalla'']

Package: python3-docutils
Version: 0.14+dfsg-1
Severity: minor

Dear Maintainer,

Trying to convert the attached file to a manpage I get a warning:

   debdate.1.rst:11: (WARNING/2) Cannot extract compound bibliographic field "Copyright".

This probably comes from line 460 in the file:
/usr/lib/python3/dist-packages/docutils/transforms/frontmatter.py

>From the specs it isn't clear whether multiple paragraphs are supported
http://docutils.sourceforge.net/docs/ref/rst/restructuredtext.html#bibliographic-fields
so it could be an error in the source document.
The reason I'm opening this bug, however, is that in the resulting man
page the second paragraph is correctly recognised and rendered, so the
warning is somewhat misleading.

Since the generated manpage includes the warning, a workaround is to
build it with --report=error to silence warnings.

-- System Information:
Debian Release: buster/sid
  APT prefers testing
  APT policy: (500, 'testing')
Architecture: amd64 (x86_64)

Kernel: Linux 4.12.0-2-amd64 (SMP w/2 CPU cores)
Locale: LANG=en_IE.UTF-8, LC_CTYPE=en_IE.UTF-8 (charmap=UTF-8), LANGUAGE=en_IE:en (charmap=UTF-8)
Shell: /bin/sh linked to /bin/dash
Init: systemd (via /run/systemd/system)

Versions of packages python3-docutils depends on:
ii  docutils-common  0.14+dfsg-1
ii  python3          3.5.3-3
ii  python3-roman    2.0.0-2

Versions of packages python3-docutils recommends:
ii  libpaper-utils    1.1.24+nmu5
ii  python3-pil       4.2.1-1
ii  python3-pygments  2.2.0+dfsg-1

Versions of packages python3-docutils suggests:
ii  docutils-doc                                0.14+dfsg-1
ii  fonts-linuxlibertine [ttf-linux-libertine]  5.3.0-2
ii  texlive-lang-french                         2017.20170818-1
ii  texlive-latex-base                          2017.20170818-1
ii  texlive-latex-recommended                   2017.20170818-1

-- no debconf information
-------------- next part --------------
=========
 debdate
=========

------------------------------------------------
 Convert Gregorian dates to Debian Regnal dates
------------------------------------------------

:Author:         valhalla at trueelena.org
:Date:           2017-07-14
:Copyright:      2017 Elena Grandi

                 Released under the terms of the Do What The Fuck You
                 Want To Public License, Version 2, as published by Sam
                 Hocevar. http://www.wtfpl.net/
:Manual section: 1

SYNOPSIS
========

debdate [-h] [-d DATE | -s SECONDS] {test} ...

DESCRIPTION
===========

``debdate`` is a fundamental tool for anybody who follows the debian
calendar where the years are named after the current stable release.

OPTIONS
=======

  -h, --help                       show this help message and exit
  -d DATE, --date DATE             A gregorian date
  -s SECONDS, --seconds SECONDS    A date as seconds from the Unix Epoch

EXAMPLES
========

``debdate``

Print the debian regnal date for today.

``debdate -d 2017-06-18``

Print the debian regnal date for the day of the release of Stretch.

``debdate -s 1497736800``

Print the same date as above.

``debdate -d 'Jul 18 2017'``

Print again the same date as above, passed in an illogical format.
Any string that is recognised as a valid date by dateutil can be used.

SEE ALSO
========

* date(1)
* ddate(1)
* https://dateutil.readthedocs.io/en/stable/