[Date Prev][Date Next] [Thread Prev][Thread Next] [Date Index] [Thread Index]

Re: Sphinx 1.3 in Debian experimental


On Mon, 29 Jun 2015 16:14:02 -0400, Barry Warsaw wrote:
> Maybe upstream would accept a patch similar to what I've done before.  It
> could map |today| to the value of an environment variable, if it's set.
> E.g. something like SPHINX_TODAY.  Then pybuild, dh_python{2,3}, or some other
> infrastructure piece could set that to the parsed changelog value.  Generally
> it wouldn't be set, so |today| would have the normal semantics.

Looking at the source of Sphinx' distutils/setuptools command [1],
I see that pybuild can already help here by including something like this
in its generated setup.cfg:

  today = {date from debian/changelog} [2]

Piotr, do you think you can add this?

This will leave out projects not using the setup command (and calling
sphinx-build directly), but such projects are mostly non-Python and thus
don't use pybuild anyway.

I can't think of any other "infrastructure place" we can add this in
(we have dh_sphinxdoc, but it is run after the docs are built and
installed already).

Of course, if someone thinks this is not enough, I can write a patch for
Sphinx to use an env variable.

[1]: http://sources.debian.net/src/sphinx/1.2.3+dfsg-1/sphinx/setup_command.py/#L76
[2]: Sphinx uses "+%B %d, %Y" format for dates

Dmitry Shachnev

Attachment: signature.asc
Description: OpenPGP digital signature

Reply to: