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 inhowto/logging.rst#114846

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
hugovk merged 3 commits intopython:mainfromsobolevn:issue-101100-howto-logging
Feb 1, 2024

Conversation

sobolevn
Copy link
Member

@sobolevnsobolevn commentedFeb 1, 2024
edited by github-actionsbot
Loading

Before:

/Users/sobolev/Desktop/cpython2/Doc/howto/logging.rst:521: WARNING: py:func reference target not found: setLevel/Users/sobolev/Desktop/cpython2/Doc/howto/logging.rst:1000: WARNING: py:class reference target not found: handlers.BufferingFormatter/Users/sobolev/Desktop/cpython2/Doc/howto/logging.rst:1032: WARNING: py:data reference target not found: raiseExceptions/Users/sobolev/Desktop/cpython2/Doc/howto/logging.rst:1037: WARNING: py:data reference target not found: raiseExceptions/Users/sobolev/Desktop/cpython2/Doc/howto/logging.rst:1037: WARNING: py:data reference target not found: raiseExceptions/Users/sobolev/Desktop/cpython2/Doc/howto/logging.rst:1074: WARNING: py:func reference target not found: expensive_func1/Users/sobolev/Desktop/cpython2/Doc/howto/logging.rst:1074: WARNING: py:func reference target not found: expensive_func2

Changes:

  1. I remixed how pre-3.2 behaviour was specified using.. versionchanged in one place
  2. AddedraiseExceptions doc, using its docstring fromlogging/__init__.py

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


For versions of Python prior to 3.2, the behaviour is as follows:
The event is output using a 'handler of last resort', stored in
:data:`lastResort`. This internal handler is not associated with any
Copy link
Member

Choose a reason for hiding this comment

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

lastResort,raiseExceptions etc. are module-level attributes - how come we don't use the:attr: role for them? Is my understanding of that role outdated?

Copy link
MemberAuthor

@sobolevnsobolevnFeb 1, 2024
edited
Loading

Choose a reason for hiding this comment

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

Copy link
Member

Choose a reason for hiding this comment

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

Thanks for updating my knowledge.

sobolevn reacted with heart emoji
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
@hugovkhugovk merged commitdc01b91 intopython:mainFeb 1, 2024
@miss-islington-app
Copy link

Thanks@sobolevn for the PR, and@hugovk for merging it 🌮🎉.. I'm working now to backport this PR to: 3.11, 3.12.
🐍🍒⛏🤖

@miss-islington-app
Copy link

Sorry,@sobolevn and@hugovk, I could not cleanly backport this to3.12 due to a conflict.
Please backport usingcherry_picker on command line.

cherry_picker dc01b919c721f43ad024ba444a5d19541370e581 3.12

miss-islington pushed a commit to miss-islington/cpython that referenced this pull requestFeb 1, 2024
…-114846)(cherry picked from commitdc01b91)Co-authored-by: Nikita Sobolev <mail@sobolevn.me>Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
@bedevere-app
Copy link

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

@bedevere-appbedevere-appbot removed the needs backport to 3.11only security fixes labelFeb 1, 2024
@hugovk
Copy link
Member

Thanks! 🧹📖

hugovk added a commit that referenced this pull requestFeb 1, 2024
…) (#114872)gh-101100: Fix sphinx warnings in `howto/logging.rst` (GH-114846)(cherry picked from commitdc01b91)Co-authored-by: Nikita Sobolev <mail@sobolevn.me>Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
@bedevere-app
Copy link

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

@bedevere-appbedevere-appbot removed the needs backport to 3.12only security fixes labelFeb 1, 2024
hugovk added a commit to hugovk/cpython that referenced this pull requestFeb 1, 2024
…ythonGH-114846)(cherry picked from commitdc01b91)Co-authored-by: Nikita Sobolev <mail@sobolevn.me>Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
hugovk added a commit that referenced this pull requestFeb 1, 2024
…) (#114878)Co-authored-by: Nikita Sobolev <mail@sobolevn.me>
aisk pushed a commit to aisk/cpython that referenced this pull requestFeb 11, 2024
…14846)Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
Sign up for freeto join this conversation on GitHub. Already have an account?Sign in to comment
Reviewers

@hugovkhugovkhugovk left review comments

@vsajipvsajipvsajip approved these changes

@AA-TurnerAA-TurnerAwaiting requested review from AA-TurnerAA-Turner is a code owner

Assignees

@hugovkhugovk

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

Successfully merging this pull request may close these issues.

3 participants
@sobolevn@hugovk@vsajip

[8]ページ先頭

©2009-2025 Movatter.jp