Uh oh!
There was an error while loading.Please reload this page.
- Notifications
You must be signed in to change notification settings - Fork32.1k
gh-104490: Consistently define phony make targets#104491
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
Merged
Uh oh!
There was an error while loading.Please reload this page.
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.Learn more about bidirectional Unicode characters
a52de5c to7c7a306CompareMisc/NEWS.d/next/Build/2023-05-14-19-00-19.gh-issue-104490.1tA4AF.rst OutdatedShow resolvedHide resolved
Uh oh!
There was an error while loading.Please reload this page.
By convention make targets that don't refer to a file have a dependencyon the fake `.PHONY` target/file. This ensures that these targets arealways evaluated because there is no rule to create a `.PHONY` fileand that will force make to think the rule is out of date and needsto be rebuilt.This commit consistently associates our virtual targets with `.PHONY`by declaring the `.PHONY` dependency immediately above the make rule.Before, some `.PHONY` associations were inline (as this patchestablishes). Others were defined in common blocks. Even others weredefined incorrectly, actually assigning a `.PHONY` variable insteadof operating on the make target!Before, not all virtual targets had `.PHONY` associations. And therewere some defined `.PHONY` associations in common blocks whose targetshad long been deleted.Hopefully the unified convention will prevent things from getting outof sync going forward.Why do this?First, consistency is good. Now people don't have to know to look fora separate block of `.PHONY` attribution. Hopefully this preventsmissing `.PHONY` annotations going forward.Second, there are some cases where virtual make targets are virtual/ phony when they shouldn't be. These are creating race conditions andavoidable rebuilds across multiple `make` invocations. e.g. a `make all`+ `make install` invocation will perform PGO+BOLT if BOLT is enabledbecause `profile-opt` and `bolt-opt` are phony and always invoked. Iplan follow-ups to this cleanup to fix some bugs I've run into.
7c7a306 toaafd614CompareThis is a very nice improvement; thanks! |
carljm added a commit to carljm/cpython that referenced this pull requestMay 15, 2023
* main: (29 commits)pythongh-101819: Fix _io clinic input for unused base class method stubs (python#104418)pythongh-101819: Isolate `_io` (python#101948) Bump mypy from 1.2.0 to 1.3.0 in /Tools/clinic (python#104501)pythongh-104494: Update certain Tkinter pack/place tests for Tk 8.7 errors (python#104495)pythongh-104050: Run mypy on `clinic.py` in CI (python#104421)pythongh-104490: Consistently define phony make targets (python#104491)pythongh-67056: document that registering/unregistering an atexit func from within an atexit func is undefined (python#104473)pythongh-104487: PYTHON_FOR_REGEN must be minimum Python 3.10 (python#104488)pythongh-101282: move BOLT config after PGO (pythongh-104493)pythongh-104469 Convert _testcapi/float.c to use AC (pythongh-104470)pythongh-104456: Fix ref leak in _ctypes.COMError (python#104457)pythongh-98539: Make _SSLTransportProtocol.abort() safe to call when closed (python#104474)pythongh-104337: Clarify random.gammavariate doc entry (python#104410) Minor improvements to typing docs (python#104465)pythongh-87092: avoid gcc warning on uninitialized struct field in assemble.c (python#104460)pythonGH-71383: IDLE - Document testing subsets of modules (python#104463)pythongh-104454: Fix refleak in AttributeError_reduce (python#104455)pythongh-75710: IDLE - add docstrings and comments to editor module (python#104446)pythongh-91896: Revert some very noisy DeprecationWarnings for `ByteString` (python#104424) Add a mention of PYTHONBREAKPOINT to breakpoint() docs (python#104430) ...
carljm added a commit to carljm/cpython that referenced this pull requestMay 15, 2023
* main: (204 commits)pythongh-101819: Fix _io clinic input for unused base class method stubs (python#104418)pythongh-101819: Isolate `_io` (python#101948) Bump mypy from 1.2.0 to 1.3.0 in /Tools/clinic (python#104501)pythongh-104494: Update certain Tkinter pack/place tests for Tk 8.7 errors (python#104495)pythongh-104050: Run mypy on `clinic.py` in CI (python#104421)pythongh-104490: Consistently define phony make targets (python#104491)pythongh-67056: document that registering/unregistering an atexit func from within an atexit func is undefined (python#104473)pythongh-104487: PYTHON_FOR_REGEN must be minimum Python 3.10 (python#104488)pythongh-101282: move BOLT config after PGO (pythongh-104493)pythongh-104469 Convert _testcapi/float.c to use AC (pythongh-104470)pythongh-104456: Fix ref leak in _ctypes.COMError (python#104457)pythongh-98539: Make _SSLTransportProtocol.abort() safe to call when closed (python#104474)pythongh-104337: Clarify random.gammavariate doc entry (python#104410) Minor improvements to typing docs (python#104465)pythongh-87092: avoid gcc warning on uninitialized struct field in assemble.c (python#104460)pythonGH-71383: IDLE - Document testing subsets of modules (python#104463)pythongh-104454: Fix refleak in AttributeError_reduce (python#104455)pythongh-75710: IDLE - add docstrings and comments to editor module (python#104446)pythongh-91896: Revert some very noisy DeprecationWarnings for `ByteString` (python#104424) Add a mention of PYTHONBREAKPOINT to breakpoint() docs (python#104430) ...
Sign up for freeto join this conversation on GitHub. Already have an account?Sign in to comment
Labels
None yet
4 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Uh oh!
There was an error while loading.Please reload this page.
By convention make targets that don't refer to a file have a dependency on the fake
.PHONYtarget/file. This ensures that these targets are always evaluated because there is no rule to create a.PHONYfile and that will force make to think the rule is out of date and needs to be rebuilt.This commit consistently associates our virtual targets with
.PHONYby declaring the.PHONYdependency immediately above the make rule.Before, some
.PHONYassociations were inline (as this patch establishes). Others were defined in common blocks. Even others were defined incorrectly, actually assigning a.PHONYvariable instead of operating on the make target!Before, not all virtual targets had
.PHONYassociations. And there were some defined.PHONYassociations in common blocks whose targets had long been deleted.Hopefully the unified convention will prevent things from getting out of sync going forward.
Why do this?
First, consistency is good. Now people don't have to know to look for a separate block of
.PHONYattribution. Hopefully this prevents missing.PHONYannotations going forward.Second, there are some cases where virtual make targets are virtual / phony when they shouldn't be. These are creating race conditions and avoidable rebuilds across multiple
makeinvocations. e.g. amake allmake installinvocation will perform PGO+BOLT if BOLT is enabled becauseprofile-optandbolt-optare phony and always invoked. I plan follow-ups to this cleanup to fix some bugs I've run into.