setup.py keywords |version| & |today|

[jayvdb]

The setup.py template has function filter_out_test_code which filters out

• .. testcode:
• |version|
• |today|

Those last two are Sphinx substitutions, and are not 'test code', so the function should be given a more generic name, and/or a little code comment would be helpful as not everyone knows what those are. Also |release| should be added too I guess, just for completeness?

My guess is this function is actually a Sphinx->docutils RST conversion, removing stuff that wont render on PyPi.

[chfw]

these filters try to cleanse README.rst. pypi website cannot render those sphinx macros. Not sure if the update site would have the same problem or not.

[jayvdb]

Ok, so we need to check whether the new pypi site can handle/discard sphinx syntax.
If not, this function should be renamed to be sphinx_to_rst.