Issue 30939: Sphinx 1.6.3 deprecation warning for sphinx.util.compat.Directive in docs builds (original) (raw)
Created on 2017-07-15 19:19 by ned.deily, last changed 2022-04-11 14:58 by admin. This issue is now closed.
Messages (8)
Author: Ned Deily (ned.deily) * 
Date: 2017-07-15 19:19
[..]/sphinx/util/compat.py:40: RemovedInSphinx17Warning: sphinx.util.compat.Directive is deprecated and will be removed in Sphinx 1.7, please use docutils' instead. RemovedInSphinx17Warning)
The solution is to import Directive directly from docutils. PR to follow for master, needs to be cherrypicked to all maintenance branches and, ideally, all current security-only branches.
Author: Ned Deily (ned.deily) *
Date: 2017-07-15 19:28
New changeset 50f58163a69abe2f35e91044d1df165ee7bdbb42 by Ned Deily in branch 'master': bpo-30939: Avoid Sphinx deprecation warning in docs build. (#2721) https://github.com/python/cpython/commit/50f58163a69abe2f35e91044d1df165ee7bdbb42
Author: Ned Deily (ned.deily) *
Date: 2017-07-15 20:56
New changeset bbd0f423d2a19c6a4a9cda6914fc60b87e17250b by Ned Deily in branch '3.6': bpo-30939: Avoid Sphinx deprecation warning in docs build. (#2721) (#2722) https://github.com/python/cpython/commit/bbd0f423d2a19c6a4a9cda6914fc60b87e17250b
Author: Ned Deily (ned.deily) *
Date: 2017-07-15 21:01
New changeset ada3f31365d0634d0cd8eeacfacd98291e34a8cc by Ned Deily in branch '3.5': bpo-30939: Avoid Sphinx deprecation warning in docs build. (#2721) (#2723) https://github.com/python/cpython/commit/ada3f31365d0634d0cd8eeacfacd98291e34a8cc
Author: Ned Deily (ned.deily) *
Date: 2017-07-16 03:06
New changeset 64a9f3d961084819335ea011063eb8cb41733882 by Ned Deily in branch '2.7': bpo-30939: Avoid Sphinx deprecation warning in docs build. (#2721) (#2725) https://github.com/python/cpython/commit/64a9f3d961084819335ea011063eb8cb41733882
Author: Brett Cannon (brett.cannon) *
Date: 2017-07-16 21:23
I wonder if we should pin sphinx directly instead of the approximate pin we have now to prevent this sort of thing in the future? I had figured they wouldn't introduce a new warning in a bugfix release but I was wrong in that assumption.
On Sat, Jul 15, 2017, 12:19 Ned Deily, <report@bugs.python.org> wrote:
New submission from Ned Deily:
[..]/sphinx/util/compat.py:40: RemovedInSphinx17Warning: sphinx.util.compat.Directive is deprecated and will be removed in Sphinx 1.7, please use docutils' instead. RemovedInSphinx17Warning)
The solution is to import Directive directly from docutils. PR to follow for master, needs to be cherrypicked to all maintenance branches and, ideally, all current security-only branches.
assignee: docs@python components: Documentation messages: 298401 nosy: brett.cannon, docs@python, larry, ned.deily priority: normal severity: normal stage: patch review status: open title: Sphinx 1.6.3 deprecation warning for sphinx.util.compat.Directive in docs builds versions: Python 2.7, Python 3.3, Python 3.4, Python 3.5, Python 3.6, Python 3.7
Python tracker <report@bugs.python.org> <http://bugs.python.org/issue30939>
Author: Ned Deily (ned.deily) *
Date: 2017-07-17 05:55
I wonder if we should pin sphinx directly instead of the approximate pin we have now to prevent this sort of thing in the future?
Perhaps. OTOH, we will find out about Sphinx incompatibilities pretty quickly that way, rather than having doc builds potentially silently fail or only finding out about the problem at release time.
Author: Larry Hastings (larry) *
Date: 2017-07-22 19:18
New changeset 3b3a5a5b70dc468dcfacb17a3d6b342820b480ff by larryhastings (Ned Deily) in branch '3.4': bpo-30939: Avoid Sphinx deprecation warning in docs build. (#2721) (#2724) https://github.com/python/cpython/commit/3b3a5a5b70dc468dcfacb17a3d6b342820b480ff
History
Date
User
Action
Args
2022-04-11 14:58:49
admin
set
github: 75122
2019-05-10 18:16:15
ned.deily
set
messages: -
2019-05-10 17:36:39
ned.deily
set
messages: +
2017-07-24 09:02:21
ned.deily
set
status: open -> closed
resolution: fixed
stage: patch review -> resolved
2017-07-22 19🔞47
larry
set
messages: +
2017-07-17 05:55:01
ned.deily
set
messages: +
2017-07-16 21:23:52
brett.cannon
set
messages: +
2017-07-16 03:06:59
ned.deily
set
messages: +
2017-07-16 03:04:09
ned.deily
set
pull_requests: + <pull%5Frequest2785>
2017-07-15 21:10:10
ned.deily
set
pull_requests: + <pull%5Frequest2784>
2017-07-15 21:01:58
ned.deily
set
messages: +
2017-07-15 20:57:59
ned.deily
set
pull_requests: + <pull%5Frequest2783>
2017-07-15 20:56:15
ned.deily
set
messages: +
2017-07-15 20:51:11
ned.deily
set
pull_requests: + <pull%5Frequest2782>
2017-07-15 19:28:04
ned.deily
set
messages: +
2017-07-15 19:25:59
larry
set
pull_requests: + <pull%5Frequest2781>
2017-07-15 19:22:43
ned.deily
set
pull_requests: + <pull%5Frequest2780>
2017-07-15 19:19:13
ned.deily
create