[Reproducible-builds] Bug#791587: python-docutils: manpage contains misleading locale default

[Chris Lamb]

Source: python-docutils
Version: 0.12+dfsg-1
Severity: minor
User: reproducible-builds at lists.alioth.debian.org
Usertags: locale
X-Debbugs-Cc: reproducible-builds at lists.alioth.debian.org

Hi,

While working on the "reproducible builds" effort [1], we have noticed
that the python-docutils writes the build-time locale into manpages:

      --error-encoding=<name[:handler]>, -e <name[:handler]>
              Specify text encoding and error handler for error output. 
              Default: ascii:backslashreplace.

This is misleading and/or incorrect as the default ("ascii:") is
actually determined at run time (in frontend.py) based on the value of
sys.stderr.encoding, not at build time. I think this is the correct
behaviour, so I suggest that the default is removed from the manpage.

(This, incidentally, is causing the build to be unreproduble across
locales, hence the usertag.)

 [1]: https://wiki.debian.org/ReproducibleBuilds


Regards,

-- 
      ,''`.
     : :'  :     Chris Lamb
     `. `'`      lamby at debian.org / chris-lamb.co.uk
       `-