[issue16471] upgrade to sphinx 1.1
New submission from Chris Jerdonek: This issue is to upgrade Python's Sphinx from version 1.0 to 1.1. I don't already see an issue for this, and I'm not sure what upgrading entails. Personally, I'm interested in the enhanced indexing capabilities, e.g. the "see" and "seealso" entry types, as well as marking main index entries: http://sphinx-doc.org/markup/misc.html#directive-index I'm sure other reasons for upgrading have been floated, though I don't know what they are. ---------- assignee: docs@python components: Documentation messages: 175560 nosy: chris.jerdonek, docs@python priority: normal severity: normal status: open title: upgrade to sphinx 1.1 type: enhancement _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue16471> _______________________________________
Changes by Ezio Melotti <ezio.melotti@gmail.com>: ---------- nosy: +eric.araujo, ezio.melotti, georg.brandl _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue16471> _______________________________________
STINNER Victor added the comment: According to the changelog, Sphinx 1.1 now supports Python 3. Cool! Doc/Makefile may be modified to use "PYTHON = python3". ---------- nosy: +haypo _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue16471> _______________________________________
Ezio Melotti added the comment: When this is done make.bat should be updated too. ---------- stage: -> needs patch _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue16471> _______________________________________
Terry J. Reedy added the comment: This duplicates a part of #10224, which proposes to upgrade all of Sphinx, Jinja2, and Pygments to Python 3 compatible versions (so we can build docs with Py3). In msg175768, Brett claims that all three have such versions. Chris, if you want to push to only upgrade Sphinx and not the other two, you can re-open. But I'd like to see a justification as I suspect that upgrading the other two will, if anything, be easier (assuming no breakage of current usage). ---------- nosy: +terry.reedy resolution: -> duplicate status: open -> closed superseder: -> Build 3.x documentation using python3.x _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue16471> _______________________________________
Changes by Ezio Melotti <ezio.melotti@gmail.com>: ---------- nosy: +eric.araujo, ezio.melotti, georg.brandl _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue16471> _______________________________________
STINNER Victor added the comment: According to the changelog, Sphinx 1.1 now supports Python 3. Cool! Doc/Makefile may be modified to use "PYTHON = python3". ---------- nosy: +haypo _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue16471> _______________________________________
Ezio Melotti added the comment: When this is done make.bat should be updated too. ---------- stage: -> needs patch _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue16471> _______________________________________
Terry J. Reedy added the comment: This duplicates a part of #10224, which proposes to upgrade all of Sphinx, Jinja2, and Pygments to Python 3 compatible versions (so we can build docs with Py3). In msg175768, Brett claims that all three have such versions. Chris, if you want to push to only upgrade Sphinx and not the other two, you can re-open. But I'd like to see a justification as I suspect that upgrading the other two will, if anything, be easier (assuming no breakage of current usage). ---------- nosy: +terry.reedy resolution: -> duplicate status: open -> closed superseder: -> Build 3.x documentation using python3.x _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue16471> _______________________________________
participants (4)
-
Chris Jerdonek -
Ezio Melotti
-
STINNER Victor
-
Terry J. Reedy