Skip to content

Remove inaccurate code comment #349

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 our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
Jul 8, 2025
Merged

Remove inaccurate code comment #349

merged 2 commits into from
Jul 8, 2025

Conversation

gwynne
Copy link
Contributor

@gwynne gwynne commented Feb 4, 2025

Remove an inaccurate comment from the code.

Motivation:

The removed comment incorrectly described the flush() method as not having an effect when the flush mode is set to .always. Not only is this the opposite of the actual behavior, in fact the method itself is not affected by the flush mode at all; that check is made elsewhere. Further, at the point where the check is made, the behavior is clearly spelled out by the code making the check, so moving the comment there seems redundant. As such, it seemed best to simply remove it altogether.

Modifications:

Removed a comment.

Result:

The inaccurate comment can no longer cause confusion.

Copy link
Member

@FranzBusch FranzBusch left a comment

Choose a reason for hiding this comment

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

Makes sense to me

@FranzBusch FranzBusch added the semver/none No version bump required. label Jul 8, 2025
@FranzBusch FranzBusch enabled auto-merge (squash) July 8, 2025 12:20
@FranzBusch FranzBusch merged commit 2281e43 into apple:main Jul 8, 2025
32 checks passed
@gwynne gwynne deleted the patch-1 branch July 8, 2025 19:18
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
semver/none No version bump required.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants