Movatterモバイル変換


[0]ホーム

URL:


Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

gh-101100: Fix Sphinx warnings inwhatsnew/3.11.rst and related#114531

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to ourterms of service andprivacy statement. We’ll occasionally send you account related emails.

Already on GitHub?Sign in to your account

Merged

Conversation

hugovk
Copy link
Member

@hugovkhugovk commentedJan 24, 2024
edited by bedevere-appbot
Loading

Fix 51 warnings, mainly removals or renames.

Doc/whatsnew/2.7.rst:2129: WARNING: c:func reference target not found: PyCode_NewDoc/whatsnew/3.11.rst:673: WARNING: py:meth reference target not found: Enum.__str__Doc/whatsnew/3.11.rst:1280: WARNING: py:meth reference target not found: list.appendDoc/whatsnew/3.11.rst:1607: WARNING: 'opcode' reference target not found: ASYNC_GEN_WRAPDoc/whatsnew/3.11.rst:1618: WARNING: 'opcode' reference target not found: PREP_RERAISE_STARDoc/whatsnew/3.11.rst:1641: WARNING: 'opcode' reference target not found: KW_NAMESDoc/whatsnew/3.11.rst:1642: WARNING: 'opcode' reference target not found: PRECALLDoc/whatsnew/3.11.rst:1655: WARNING: 'opcode' reference target not found: POP_JUMP_BACKWARD_IF_TRUEDoc/whatsnew/3.11.rst:1657: WARNING: 'opcode' reference target not found: POP_JUMP_FORWARD_IF_TRUEDoc/whatsnew/3.11.rst:1663: WARNING: 'opcode' reference target not found: JUMP_IF_TRUE_OR_POPDoc/whatsnew/3.11.rst:1663: WARNING: 'opcode' reference target not found: JUMP_IF_FALSE_OR_POPDoc/whatsnew/3.11.rst:1792: WARNING: py:func reference target not found: importlib.resources.contentsDoc/whatsnew/3.11.rst:1793: WARNING: py:func reference target not found: importlib.resources.is_resourceDoc/whatsnew/3.11.rst:1794: WARNING: py:func reference target not found: importlib.resources.open_binaryDoc/whatsnew/3.11.rst:1795: WARNING: py:func reference target not found: importlib.resources.open_textDoc/whatsnew/3.11.rst:1796: WARNING: py:func reference target not found: importlib.resources.read_binaryDoc/whatsnew/3.11.rst:1797: WARNING: py:func reference target not found: importlib.resources.read_textDoc/whatsnew/3.11.rst:1798: WARNING: py:func reference target not found: importlib.resources.pathDoc/whatsnew/3.11.rst:1806: WARNING: py:func reference target not found: locale.resetlocaleDoc/whatsnew/3.11.rst:1970: WARNING: py:mod reference target not found: distutilsDoc/whatsnew/3.11.rst:2298: WARNING: c:func reference target not found: PyCode_NewDoc/whatsnew/3.11.rst:2298: WARNING: c:func reference target not found: PyCode_NewWithPosOnlyArgsDoc/whatsnew/3.11.rst:2405: WARNING: c:func reference target not found: PyUnicode_CHECK_INTERNEDDoc/whatsnew/3.11.rst:2466: WARNING: c:func reference target not found: PyFrame_FastToLocalsWithErrorDoc/whatsnew/3.11.rst:2466: WARNING: c:func reference target not found: PyFrame_LocalsToFastDoc/whatsnew/3.11.rst:2607: WARNING: c:func reference target not found: PyUnicode_IS_COMPACTDoc/whatsnew/3.11.rst:2608: WARNING: c:func reference target not found: PyUnicode_IS_READYDoc/whatsnew/3.11.rst:2662: WARNING: c:type reference target not found: PyWeakReferenceDoc/whatsnew/3.8.rst:1626: WARNING: c:func reference target not found: PyCode_NewWithPosOnlyArgsDoc/whatsnew/3.8.rst:1626: WARNING: c:func reference target not found: PyCode_Newbuild/NEWS:4617: WARNING: 'opcode' reference target not found: KW_NAMESbuild/NEWS:5158: WARNING: 'opcode' reference target not found: JUMP_IF_FALSE_OR_POPbuild/NEWS:5158: WARNING: 'opcode' reference target not found: JUMP_IF_TRUE_OR_POPbuild/NEWS:5508: WARNING: 'opcode' reference target not found: PREP_RERAISE_STARbuild/NEWS:6036: WARNING: 'opcode' reference target not found: UNARY_POSITIVEbuild/NEWS:6036: WARNING: 'opcode' reference target not found: ASYNC_GEN_WRAPbuild/NEWS:6036: WARNING: 'opcode' reference target not found: LIST_TO_TUPLEbuild/NEWS:9676: WARNING: 'opcode' reference target not found: JUMP_IF_TRUE_OR_POPbuild/NEWS:9676: WARNING: 'opcode' reference target not found: JUMP_IF_FALSE_OR_POPbuild/NEWS:10343: WARNING: c:func reference target not found: PyFrame_FastToLocalsWithErrorbuild/NEWS:10343: WARNING: c:func reference target not found: PyFrame_LocalsToFastbuild/NEWS:10396: WARNING: 'opcode' reference target not found: PRECALLbuild/NEWS:10968: WARNING: 'opcode' reference target not found: PRECALLbuild/NEWS:11773: WARNING: 'opcode' reference target not found: PREP_RERAISE_STARbuild/NEWS:11776: WARNING: 'opcode' reference target not found: POP_EXCEPT_AND_RERAISEbuild/NEWS:12139: WARNING: c:func reference target not found: PyUnicode_CHECK_INTERNEDbuild/NEWS:13083: WARNING: c:type reference target not found: PyWeakReferencebuild/NEWS:20372: WARNING: py:mod reference target not found: lib2to3.fixes.fix_urllibbuild/NEWS:23463: WARNING: c:func reference target not found: PyCode_NewWithPosOnlyArgsbuild/NEWS:23463: WARNING: c:func reference target not found: PyCode_Newbuild/NEWS:26488: WARNING: py:mod reference target not found: lib2to3.pgen2.tokenize

📚 Documentation preview 📚:https://cpython-previews--114531.org.readthedocs.build/

@bedevere-appbedevere-appbot added awaiting core review docsDocumentation in the Doc dir skip news labelsJan 24, 2024
@hugovkhugovk changed the titleFix Sphinx warnings inwhatsnew/3.11.rst and relatedgh-101100: Fix Sphinx warnings inwhatsnew/3.11.rst and relatedJan 24, 2024
@hugovkhugovk added needs backport to 3.11only security fixes needs backport to 3.12only security fixes labelsJan 24, 2024
Copy link
Member

@serhiy-storchakaserhiy-storchaka left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others.Learn more.

It LGTM for main, but most of the changes should not be backported to 3.11, and some should not be backported to 3.12 either.

It is safer to not use automation, but re-do this work for 3.12 and 3..11 separately, to be sure that you do not remove a working reference.

@@ -1278,7 +1278,7 @@ This section covers specific optimizations independent of the
(Contributed by Stefan Behnel in :gh:`68264`.)

* Resizing lists is streamlined for the common case,
speeding up :meth:`list.append` by ≈15%
speeding up :meth:`!list.append` by ≈15%

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others.Learn more.

I would left it as a reminder that we should add a reference to list.append, and not sweep it under cover.

hugovk reacted with thumbs up emoji
@@ -1604,7 +1604,7 @@ raw, adaptive bytecode containing quickened data.
New opcodes
-----------

* :opcode:`ASYNC_GEN_WRAP`, :opcode:`RETURN_GENERATOR` and :opcode:`SEND`,
* :opcode:`!ASYNC_GEN_WRAP`, :opcode:`RETURN_GENERATOR` and :opcode:`SEND`,

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others.Learn more.

It should not be backported to 3.11.

hugovk reacted with thumbs up emoji
Comment on lines +1792 to +1798
* :func:`!importlib.resources.contents`
* :func:`!importlib.resources.is_resource`
* :func:`!importlib.resources.open_binary`
* :func:`!importlib.resources.open_text`
* :func:`!importlib.resources.read_binary`
* :func:`!importlib.resources.read_text`
* :func:`!importlib.resources.path`

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others.Learn more.

It should not be backported to 3.12.

hugovk reacted with thumbs up emoji
@serhiy-storchakaserhiy-storchaka removed needs backport to 3.11only security fixes needs backport to 3.12only security fixes labelsJan 26, 2024
@serhiy-storchaka
Copy link
Member

It could be perhaps simpler to make a patch for 3.11, then apply it to 3.12, fix new warnings, apply the new patch to main and fix the remaining warnings. It is how we did before Git. You can still use this sequence for fixing What's New for older versions.

@hugovk
Copy link
MemberAuthor

It is safer to not use automation, but re-do this work for 3.12 and 3..11 separately, to be sure that you do not remove a working reference.

yep, good idea.

It could be perhaps simpler to make a patch for 3.11, then apply it to 3.12, fix new warnings, apply the new patch to main and fix the remaining warnings. It is how we did before Git. You can still use this sequence for fixing What's New for older versions.

Interesting, will try that for the next What's New. 👍

@hugovk
Copy link
MemberAuthor

I would left it as a reminder that we should add a reference to list.append, and not sweep it under cover.

Sure, we-added:meth:`list.append`, we can deal with it in a new PR.

For that PR,append is in this table of operations for mutable sequence types:

https://docs.python.org/3/library/stdtypes.html#mutable-sequence-types

Should we linklist.append to this table, via its existingtypesseq-mutable reference, or add new reference to it?

Or addappend tohttps://docs.python.org/3/library/stdtypes.html#lists?

Or somewhere else?

@bedevere-app
Copy link

GH-114649 is a backport of this pull request to the3.12 branch.

@bedevere-app
Copy link

GH-114650 is a backport of this pull request to the3.11 branch.

Sign up for freeto join this conversation on GitHub. Already have an account?Sign in to comment
Reviewers

@serhiy-storchakaserhiy-storchakaserhiy-storchaka approved these changes

Assignees
No one assigned
Labels
docsDocumentation in the Doc dirskip news
Projects
None yet
Milestone
No milestone
Development

Successfully merging this pull request may close these issues.

2 participants
@hugovk@serhiy-storchaka

[8]ページ先頭

©2009-2025 Movatter.jp