[issue40204] Docs build error with Sphinx 3.0 due to invalid C declaration

STINNER Victor added the comment: New changeset c0d5c131d9c1ac743058fae99f913b455fc90ac7 by Victor Stinner in branch 'master': bpo-40204: Update Sphinx to version 3.2.1 in Doc/Makefile (GH-22043) https://github.com/python/cpython/commit/c0d5c131d9c1ac743058fae99f913b455fc90ac7 --

[issue40204] Docs build error with Sphinx 3.0 due to invalid C declaration

Change by STINNER Victor : -- pull_requests: +21140 pull_request: https://github.com/python/cpython/pull/22043 ___ Python tracker ___

[issue40204] Docs build error with Sphinx 3.0 due to invalid C declaration

STINNER Victor added the comment: I merged my changes to add Sphinx 3.2 and newer support into 3.8, 3.9 and master branches. I close the issue. Sadly, it seems like it's not possible to keep Sphinx 2 support if we add Sphinx 3.0 and Sphinx 3.1 support. For now, only Sphinx 2 and Sphinx

[issue40204] Docs build error with Sphinx 3.0 due to invalid C declaration

STINNER Victor added the comment: New changeset 7d0fef56d8eaac6309a66cb8c6ba6fd96f8c8a94 by Victor Stinner in branch '3.8': bpo-40204: Allow pre-Sphinx 3 syntax in the doc (GH-21844) (GH-21901) (GH-21928) https://github.com/python/cpython/commit/7d0fef56d8eaac6309a66cb8c6ba6fd96f8c8a94

[issue40204] Docs build error with Sphinx 3.0 due to invalid C declaration

Change by STINNER Victor : -- pull_requests: +21041 pull_request: https://github.com/python/cpython/pull/21928 ___ Python tracker ___

[issue40204] Docs build error with Sphinx 3.0 due to invalid C declaration

Change by STINNER Victor : -- pull_requests: +21036 pull_request: https://github.com/python/cpython/pull/21924 ___ Python tracker ___

[issue40204] Docs build error with Sphinx 3.0 due to invalid C declaration

STINNER Victor added the comment: New changeset 8f88190af529543c84d5dc78f19abbfd73335cf4 by Victor Stinner in branch '3.9': [3.9] bpo-40204: Allow pre-Sphinx 3 syntax in the doc (GH-21844) (GH-21901) https://github.com/python/cpython/commit/8f88190af529543c84d5dc78f19abbfd73335cf4

[issue40204] Docs build error with Sphinx 3.0 due to invalid C declaration

STINNER Victor added the comment: I'm now able to build the Python documentation with Sphinx 3.2.1 without modifying the Doc/Makefile, so using -W option (treat warnings as errors): there are no more Sphinx 3 warnings. When Sphinx 3 will be more widely available (ex: in Linux

[issue40204] Docs build error with Sphinx 3.0 due to invalid C declaration

Change by STINNER Victor : -- pull_requests: +21019 pull_request: https://github.com/python/cpython/pull/21901 ___ Python tracker ___

[issue40204] Docs build error with Sphinx 3.0 due to invalid C declaration

STINNER Victor added the comment: New changeset 1abeda80f760134b4233608e2c288790f955b95a by Victor Stinner in branch 'master': bpo-40204: Fix duplicated productionlist names in the doc (GH-21900) https://github.com/python/cpython/commit/1abeda80f760134b4233608e2c288790f955b95a --

[issue40204] Docs build error with Sphinx 3.0 due to invalid C declaration

Change by STINNER Victor : -- pull_requests: +21018 pull_request: https://github.com/python/cpython/pull/21900 ___ Python tracker ___

[issue40204] Docs build error with Sphinx 3.0 due to invalid C declaration

STINNER Victor added the comment: New changeset bb0b08540cc93e56f3f1bde1b39ce086d9e35fe1 by Victor Stinner in branch 'master': bpo-40204: Fix reference to terms in the doc (GH-21865) https://github.com/python/cpython/commit/bb0b08540cc93e56f3f1bde1b39ce086d9e35fe1 --

[issue40204] Docs build error with Sphinx 3.0 due to invalid C declaration

STINNER Victor added the comment: With PR 21865, there are only two remaining warnings: Doc/library/string.rst:311: WARNING: duplicate token description of sf:format_spec, other instance in library/string Doc/reference/introduction.rst:96: WARNING: duplicate token description of *:name,

[issue40204] Docs build error with Sphinx 3.0 due to invalid C declaration

Change by STINNER Victor : -- pull_requests: +20992 pull_request: https://github.com/python/cpython/pull/21865 ___ Python tracker ___

[issue40204] Docs build error with Sphinx 3.0 due to invalid C declaration

STINNER Victor added the comment: New changeset 474652fe9346382dbf793f20b671eb74668bebde by Victor Stinner in branch 'master': bpo-40204, doc: Fix syntax of C variables (GH-21846) https://github.com/python/cpython/commit/474652fe9346382dbf793f20b671eb74668bebde --

[issue40204] Docs build error with Sphinx 3.0 due to invalid C declaration

STINNER Victor added the comment: New changeset d3ded080482beae578faa704b13534a62d066f9f by Victor Stinner in branch 'master': bpo-40204: Add :noindex: in the documentation (GH-21859) https://github.com/python/cpython/commit/d3ded080482beae578faa704b13534a62d066f9f --

[issue40204] Docs build error with Sphinx 3.0 due to invalid C declaration

STINNER Victor added the comment: New changeset 46d10b1237c67ff8347f533eda6a5468d098f7eb by Victor Stinner in branch 'master': bpo-40204: Fix duplicates in the documentation (GH-21857) https://github.com/python/cpython/commit/46d10b1237c67ff8347f533eda6a5468d098f7eb --

[issue40204] Docs build error with Sphinx 3.0 due to invalid C declaration

STINNER Victor added the comment: New changeset 43577c01a2ab49122db696e9eaec6cb31d11cc81 by Victor Stinner in branch 'master': bpo-40204: Fix Sphinx sytanx in howto/instrumentation.rst (GH-21858) https://github.com/python/cpython/commit/43577c01a2ab49122db696e9eaec6cb31d11cc81 --

[issue40204] Docs build error with Sphinx 3.0 due to invalid C declaration

Change by STINNER Victor : -- pull_requests: +20986 pull_request: https://github.com/python/cpython/pull/21859 ___ Python tracker ___

[issue40204] Docs build error with Sphinx 3.0 due to invalid C declaration

Change by STINNER Victor : -- pull_requests: +20985 pull_request: https://github.com/python/cpython/pull/21858 ___ Python tracker ___

[issue40204] Docs build error with Sphinx 3.0 due to invalid C declaration

Change by STINNER Victor : -- pull_requests: +20984 pull_request: https://github.com/python/cpython/pull/21857 ___ Python tracker ___

[issue40204] Docs build error with Sphinx 3.0 due to invalid C declaration

STINNER Victor added the comment: New changeset 423e77d6de497931585d1883805a9e3fa4096b0b by Victor Stinner in branch 'master': bpo-40204: Allow pre-Sphinx 3 syntax in the doc (GH-21844) https://github.com/python/cpython/commit/423e77d6de497931585d1883805a9e3fa4096b0b --

[issue40204] Docs build error with Sphinx 3.0 due to invalid C declaration

Change by STINNER Victor : -- pull_requests: +20973 pull_request: https://github.com/python/cpython/pull/21846 ___ Python tracker ___

[issue40204] Docs build error with Sphinx 3.0 due to invalid C declaration

Change by STINNER Victor : -- pull_requests: +20971 pull_request: https://github.com/python/cpython/pull/21844 ___ Python tracker ___

[issue40204] Docs build error with Sphinx 3.0 due to invalid C declaration

Matthias Klose added the comment: 3.9.0 rc1 fails to build the docs with Sphinx 3.2.0, even with setting c_allow_pre_v3 = True c_warn_on_allowed_pre_v3 = False Warning, treated as error: /packages/python/3.9/python3.9-3.9.0~rc1/Doc/c-api/buffer.rst:92:Error in declarator or parameters

[issue40204] Docs build error with Sphinx 3.0 due to invalid C declaration

STINNER Victor added the comment: https://github.com/sphinx-doc/sphinx/pull/7905 has been merged and will be part of the next Sphinx 3.2 release. -- ___ Python tracker ___

[issue40204] Docs build error with Sphinx 3.0 due to invalid C declaration

Matthias Klose added the comment: please note that pinning usually is not a solution for Linux distributions. Yes, the most wanted fix would be to fix sphinx 3.x not to break compatibility with 2.x. Or limit 3.9 to 2.x features for now. -- nosy: +doko

[issue40204] Docs build error with Sphinx 3.0 due to invalid C declaration

STINNER Victor added the comment: Using https://github.com/sphinx-doc/sphinx/pull/7905 but without -W, I'm able to build the unmodified Python documentation with Sphinx 3! I tried c_allow_pre_v3=1. The PR was updated to add a second c_warn_on_allowed_pre_v3=0 option so we can keep -W.

[issue40204] Docs build error with Sphinx 3.0 due to invalid C declaration

STINNER Victor added the comment: I reported the issue to Sphinx: "C domain changes of Sphinx 3 prevent to write doc compatible with Sphinx 2 and Sphinx 3" https://github.com/sphinx-doc/sphinx/issues/7899 -- ___ Python tracker

[issue40204] Docs build error with Sphinx 3.0 due to invalid C declaration

STINNER Victor added the comment: In short, the current status is that IMHO it is not acceptable to support Sphinx 3. We cannot afford to break support with Sphinx 2. -- ___ Python tracker

[issue40204] Docs build error with Sphinx 3.0 due to invalid C declaration

STINNER Victor added the comment: Making the Python documentation compatible with Sphinx 3.0 is causing multiple blocker issues. (*) The first major problem is that new C domain markup like :c:struct: and :expr: are not recognized by Sphinx 2.4.4, but Sphinx 3.0 requires them. For

[issue40204] Docs build error with Sphinx 3.0 due to invalid C declaration

STINNER Victor added the comment: This issue prevents to upgrade Sphinx to Sphinx 3 in Fedora Rawhide, at least it breaks the python3-docs package which is Python 3.9 documentation: https://bugzilla.redhat.com/show_bug.cgi?id=1823898 -- ___ Python

[issue40204] Docs build error with Sphinx 3.0 due to invalid C declaration

Ned Deily added the comment: New changeset 7318f0ab234e1c60a19eeea4e5968fb5d4fd70af by Ned Deily in branch '3.8': bpo-40204: Pin Sphinx version to 2.3.1 in ``Doc/Makefile``. (GH-21141) (GH-21147) https://github.com/python/cpython/commit/7318f0ab234e1c60a19eeea4e5968fb5d4fd70af --

[issue40204] Docs build error with Sphinx 3.0 due to invalid C declaration

Change by Ned Deily : -- pull_requests: +20306 pull_request: https://github.com/python/cpython/pull/21147 ___ Python tracker ___

[issue40204] Docs build error with Sphinx 3.0 due to invalid C declaration

miss-islington added the comment: New changeset 16e79a47ca3b4efb2300f24aa084c20bb5e8ae0d by Miss Islington (bot) in branch '3.9': bpo-40204: Pin Sphinx version to 2.3.1 in ``Doc/Makefile``. (GH-21141) https://github.com/python/cpython/commit/16e79a47ca3b4efb2300f24aa084c20bb5e8ae0d

[issue40204] Docs build error with Sphinx 3.0 due to invalid C declaration

Change by miss-islington : -- nosy: +miss-islington nosy_count: 16.0 -> 17.0 pull_requests: +20305 pull_request: https://github.com/python/cpython/pull/21146 ___ Python tracker

[issue40204] Docs build error with Sphinx 3.0 due to invalid C declaration

Ned Deily added the comment: New changeset 589e8fe07934a8585d6c5c31d12ae5f766b8fec7 by Ned Deily in branch 'master': bpo-40204: Pin Sphinx version to 2.3.1 in ``Doc/Makefile``. (GH-21141) https://github.com/python/cpython/commit/589e8fe07934a8585d6c5c31d12ae5f766b8fec7 --

[issue40204] Docs build error with Sphinx 3.0 due to invalid C declaration

Change by Ned Deily : -- pull_requests: +20300 pull_request: https://github.com/python/cpython/pull/21141 ___ Python tracker ___

[issue40204] Docs build error with Sphinx 3.0 due to invalid C declaration

Stefan Krah added the comment: """ * Doc/c-api/buffer.rst: the table with ".. c:macro:: PyBUF_INDIRECT" is wrong. Sphinx fails because PyBUF_SIMPLE is declared twice. => use ":c:macro:`PyBUF_INDIRECT`" instead """ Hmm, grep shows: c-api/buffer.rst:123: most cases such a request will

[issue40204] Docs build error with Sphinx 3.0 due to invalid C declaration

Georg Brandl added the comment: Don't hesitate to send requests back to the Sphinx tracker if any changes appear to be too restrictive to you. It is a documentation tool, not a compiler. -- nosy: +georg.brandl ___ Python tracker

[issue40204] Docs build error with Sphinx 3.0 due to invalid C declaration

STINNER Victor added the comment: Sphinx documentation of the C domain: https://www.sphinx-doc.org/en/master/usage/restructuredtext/domains.html#the-c-domain -- ___ Python tracker

[issue40204] Docs build error with Sphinx 3.0 due to invalid C declaration

STINNER Victor added the comment: I look into this issue. It's quite complicated :-( The Sphinx 3.0.0b1 changelog says: * The C domain has been rewritten, with additional directives and roles. The existing ones are now more strict, resulting in new warnings. * The C domain has been

[issue40204] Docs build error with Sphinx 3.0 due to invalid C declaration

Ned Deily added the comment: New changeset 0d70a98f449d58311aff3374ab5f203a401fc3bf by Ned Deily in branch '3.7': bpo-40204: Pin Sphinx version to 2.3.1 in Doc/Makefile https://github.com/python/cpython/commit/0d70a98f449d58311aff3374ab5f203a401fc3bf --

[issue40204] Docs build error with Sphinx 3.0 due to invalid C declaration

Change by STINNER Victor : -- nosy: -vstinner ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe:

[issue40204] Docs build error with Sphinx 3.0 due to invalid C declaration

Change by Karthikeyan Singaravelan : -- nosy: +benjamin.peterson ___ Python tracker ___ ___ Python-bugs-list mailing list

[issue40204] Docs build error with Sphinx 3.0 due to invalid C declaration

Terry J. Reedy added the comment: A few days ago, 3.8 backports failed while 3.7 backports merged. Thank you for the fix, even if temporary. I just noticed that the doc main page ends with "Created using Sphinx 2.3.1." I plan to switch my local sphinx to that version. -- nosy:

[issue40204] Docs build error with Sphinx 3.0 due to invalid C declaration

Ned Deily added the comment: I agree that it should be easier to keep them all in sync. But my point is that the on-going official doc builds (some multi[ple times per day) for all of the active versions (2.7 and 3.6 through 3.9) are using 2.3.1 so we should be doing CI against that

[issue40204] Docs build error with Sphinx 3.0 due to invalid C declaration

STINNER Victor added the comment: > Why are we pinning to 1.8.2 when the official docs builds for all releases > are currently using 2.3.1? (see, for example, https://docs.python.org/3.8/ > at bottom right corner) First of all, to repair the CI :-) Before my change, it was no longer

[issue40204] Docs build error with Sphinx 3.0 due to invalid C declaration

Ned Deily added the comment: Why are we pinning to 1.8.2 when the official docs builds for all releases are currently using 2.3.1? (see, for example, https://docs.python.org/3.8/ at bottom right corner) -- nosy: +ned.deily ___ Python tracker

[issue40204] Docs build error with Sphinx 3.0 due to invalid C declaration

STINNER Victor added the comment: New changeset 9e5f159d3279a6b476d588010d529cfdbb8c8803 by Victor Stinner in branch '3.7': bpo-40204: Pin Sphinx version to 1.8.2 in Doc/Makefile (GH-19442) (GH-19443) https://github.com/python/cpython/commit/9e5f159d3279a6b476d588010d529cfdbb8c8803

[issue40204] Docs build error with Sphinx 3.0 due to invalid C declaration

Karthikeyan Singaravelan added the comment: I have filed an issue upstream and it's fixed. The release of 3.0.1 is planned in few days and could help for other branches. But it would be nice to see the version pinned to avoid these problems in future. Upstream report :

[issue40204] Docs build error with Sphinx 3.0 due to invalid C declaration

Change by STINNER Victor : -- pull_requests: +18797 pull_request: https://github.com/python/cpython/pull/19443 ___ Python tracker ___

[issue40204] Docs build error with Sphinx 3.0 due to invalid C declaration

STINNER Victor added the comment: New changeset 37a257c0ae0d4ba746397ae7584db887b175ab24 by Victor Stinner in branch '3.8': bpo-40204: Pin Sphinx version to 1.8.2 in Doc/Makefile (GH-19442) https://github.com/python/cpython/commit/37a257c0ae0d4ba746397ae7584db887b175ab24 --

[issue40204] Docs build error with Sphinx 3.0 due to invalid C declaration

STINNER Victor added the comment: > I guess that you're talking about Doc/Makefile which uses "Sphinx" in 3.8 but > "Sphinx==2.2.0" in master. I wrote PR 19442 to pin Sphinx version to 1.8.2 in Doc/Makefile. -- ___ Python tracker

[issue40204] Docs build error with Sphinx 3.0 due to invalid C declaration

Change by STINNER Victor : -- pull_requests: +18796 pull_request: https://github.com/python/cpython/pull/19442 ___ Python tracker ___

[issue40204] Docs build error with Sphinx 3.0 due to invalid C declaration

STINNER Victor added the comment: > Python 3.8 and Python 3.7 doesn't have Sphinx pinned to 2.2.0 while master > does. In 3.8, .azure-pipelines/docs-steps.yml contains: - script: python -m pip install sphinx==1.8.2 blurb python-docs-theme and .travis.yml contains: - python -m pip install

[issue40204] Docs build error with Sphinx 3.0 due to invalid C declaration

Change by Maciej Olko : -- nosy: +Maciej Olko ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe:

[issue40204] Docs build error with Sphinx 3.0 due to invalid C declaration

Karthikeyan Singaravelan added the comment: The sphinx version is not pinned in 3.7, 3.6, 3.5 and 2.7 branches too for Doc/Makefile that can cause error on someone trying it out locally. They are pinned in .travis.yml and .azure-pipelines configurations. --

[issue40204] Docs build error with Sphinx 3.0 due to invalid C declaration

Serhiy Storchaka added the comment: Maybe copy the code for deprecated and removed features to Doc/tools/extensions? -- nosy: +serhiy.storchaka ___ Python tracker ___

[issue40204] Docs build error with Sphinx 3.0 due to invalid C declaration

Change by Roundup Robot : -- keywords: +patch nosy: +python-dev nosy_count: 8.0 -> 9.0 pull_requests: +18759 stage: -> patch review pull_request: https://github.com/python/cpython/pull/19397 ___ Python tracker

[issue40204] Docs build error with Sphinx 3.0 due to invalid C declaration

STINNER Victor added the comment: It sounds dangerous to not pin the Sphinx version in our CI :-/ Another issue caused by CI configuration stored at the same place than the code: https://mail.python.org/archives/list/python-committ...@python.org/thread/WEU5CQKIA4LIHWHT53YA7HHNUY5H2FUT/

[issue40204] Docs build error with Sphinx 3.0 due to invalid C declaration

New submission from Karthikeyan Singaravelan : The following error is caused in Docs build for a 3.8 backport since sphinx is ran with warnings. Sphinx released 3.0 on April 6. The last successful build on master uses Sphinx 2.2.0 [0]. My guess is sphinx new version possibly breaking the