[XL] Change in dart/sdk[main]: [analyzer/linter] Clean up error message comments.

0 views
Skip to first unread message

Paul Berry (Gerrit)

unread,
Aug 7, 2025, 6:32:29 PM8/7/25
to Konstantin Shcheglov, Brian Wilkerson, Johnni Winther, Commit Queue, dart-analys...@google.com, rev...@dartlang.org
Attention needed from Brian Wilkerson, Johnni Winther and Konstantin Shcheglov

New activity on the change

Open in Gerrit

Related details

Attention is currently required from:
  • Brian Wilkerson
  • Johnni Winther
  • Konstantin Shcheglov
Submit Requirements:
  • requirement is not satisfiedCode-Owners
  • requirement is not satisfiedCode-Review
  • requirement is not satisfiedReview-Enforcement
Inspect html for hidden footers to help with email filtering. To unsubscribe visit settings. DiffyGerrit
Gerrit-MessageType: comment
Gerrit-Project: sdk
Gerrit-Branch: main
Gerrit-Change-Id: I6aa1f75fa0b8e4fb9724dcba00fb7d1f06dfb355
Gerrit-Change-Number: 444205
Gerrit-PatchSet: 5
Gerrit-Owner: Paul Berry <paul...@google.com>
Gerrit-Reviewer: Brian Wilkerson <brianwi...@google.com>
Gerrit-Reviewer: Johnni Winther <johnni...@google.com>
Gerrit-Reviewer: Konstantin Shcheglov <sche...@google.com>
Gerrit-Reviewer: Paul Berry <paul...@google.com>
Gerrit-Attention: Konstantin Shcheglov <sche...@google.com>
Gerrit-Attention: Johnni Winther <johnni...@google.com>
Gerrit-Attention: Brian Wilkerson <brianwi...@google.com>
Gerrit-Comment-Date: Thu, 07 Aug 2025 22:32:26 +0000
Gerrit-HasComments: No
Gerrit-Has-Labels: No
unsatisfied_requirement
open
diffy

Konstantin Shcheglov (Gerrit)

unread,
Aug 7, 2025, 8:15:34 PM8/7/25
to Paul Berry, Brian Wilkerson, Johnni Winther, Commit Queue, dart-analys...@google.com, rev...@dartlang.org
Attention needed from Brian Wilkerson, Johnni Winther and Paul Berry

Konstantin Shcheglov voted Code-Review+1

Code-Review+1
Open in Gerrit

Related details

Attention is currently required from:
  • Brian Wilkerson
  • Johnni Winther
  • Paul Berry
Submit Requirements:
    • requirement is not satisfiedCode-Owners
    • requirement satisfiedCode-Review
    • requirement satisfiedReview-Enforcement
    Inspect html for hidden footers to help with email filtering. To unsubscribe visit settings. DiffyGerrit
    Gerrit-MessageType: comment
    Gerrit-Project: sdk
    Gerrit-Branch: main
    Gerrit-Change-Id: I6aa1f75fa0b8e4fb9724dcba00fb7d1f06dfb355
    Gerrit-Change-Number: 444205
    Gerrit-PatchSet: 5
    Gerrit-Owner: Paul Berry <paul...@google.com>
    Gerrit-Reviewer: Brian Wilkerson <brianwi...@google.com>
    Gerrit-Reviewer: Johnni Winther <johnni...@google.com>
    Gerrit-Reviewer: Konstantin Shcheglov <sche...@google.com>
    Gerrit-Reviewer: Paul Berry <paul...@google.com>
    Gerrit-Attention: Johnni Winther <johnni...@google.com>
    Gerrit-Attention: Paul Berry <paul...@google.com>
    Gerrit-Attention: Brian Wilkerson <brianwi...@google.com>
    Gerrit-Comment-Date: Fri, 08 Aug 2025 00:15:32 +0000
    Gerrit-HasComments: No
    Gerrit-Has-Labels: Yes
    unsatisfied_requirement
    satisfied_requirement
    open
    diffy

    Johnni Winther (Gerrit)

    unread,
    Aug 8, 2025, 2:35:13 AM8/8/25
    to Paul Berry, Konstantin Shcheglov, Brian Wilkerson, Commit Queue, dart-analys...@google.com, rev...@dartlang.org
    Attention needed from Brian Wilkerson and Paul Berry

    Johnni Winther voted Code-Review+1

    Code-Review+1
    Open in Gerrit

    Related details

    Attention is currently required from:
    • Brian Wilkerson
    • Paul Berry
    Submit Requirements:
    • requirement is not satisfiedCode-Owners
    • requirement satisfiedCode-Review
    • requirement satisfiedReview-Enforcement
    Inspect html for hidden footers to help with email filtering. To unsubscribe visit settings. DiffyGerrit
    Gerrit-MessageType: comment
    Gerrit-Project: sdk
    Gerrit-Branch: main
    Gerrit-Change-Id: I6aa1f75fa0b8e4fb9724dcba00fb7d1f06dfb355
    Gerrit-Change-Number: 444205
    Gerrit-PatchSet: 5
    Gerrit-Owner: Paul Berry <paul...@google.com>
    Gerrit-Reviewer: Brian Wilkerson <brianwi...@google.com>
    Gerrit-Reviewer: Johnni Winther <johnni...@google.com>
    Gerrit-Reviewer: Konstantin Shcheglov <sche...@google.com>
    Gerrit-Reviewer: Paul Berry <paul...@google.com>
    Gerrit-Attention: Paul Berry <paul...@google.com>
    Gerrit-Attention: Brian Wilkerson <brianwi...@google.com>
    Gerrit-Comment-Date: Fri, 08 Aug 2025 06:35:08 +0000
    Gerrit-HasComments: No
    Gerrit-Has-Labels: Yes
    unsatisfied_requirement
    satisfied_requirement
    open
    diffy

    Paul Berry (Gerrit)

    unread,
    Aug 8, 2025, 9:31:18 AM8/8/25
    to Phil Quitslund, Johnni Winther, Konstantin Shcheglov, Brian Wilkerson, Commit Queue, dart-analys...@google.com, rev...@dartlang.org
    Attention needed from Brian Wilkerson and Phil Quitslund

    Paul Berry added 1 comment

    Patchset-level comments
    File-level comment, Patchset 6 (Latest):
    Paul Berry . resolved

    Phil, can you take a look at the pkg/linter changes, since Brian is out today?

    Open in Gerrit

    Related details

    Attention is currently required from:
    • Brian Wilkerson
    • Phil Quitslund
    Submit Requirements:
    • requirement is not satisfiedCode-Owners
    • requirement satisfiedCode-Review
    • requirement satisfiedReview-Enforcement
    Inspect html for hidden footers to help with email filtering. To unsubscribe visit settings. DiffyGerrit
    Gerrit-MessageType: comment
    Gerrit-Project: sdk
    Gerrit-Branch: main
    Gerrit-Change-Id: I6aa1f75fa0b8e4fb9724dcba00fb7d1f06dfb355
    Gerrit-Change-Number: 444205
    Gerrit-PatchSet: 6
    Gerrit-Owner: Paul Berry <paul...@google.com>
    Gerrit-Reviewer: Brian Wilkerson <brianwi...@google.com>
    Gerrit-Reviewer: Johnni Winther <johnni...@google.com>
    Gerrit-Reviewer: Konstantin Shcheglov <sche...@google.com>
    Gerrit-Reviewer: Paul Berry <paul...@google.com>
    Gerrit-Reviewer: Phil Quitslund <pquit...@google.com>
    Gerrit-Attention: Phil Quitslund <pquit...@google.com>
    Gerrit-Attention: Brian Wilkerson <brianwi...@google.com>
    Gerrit-Comment-Date: Fri, 08 Aug 2025 13:31:14 +0000
    Gerrit-HasComments: Yes
    Gerrit-Has-Labels: No
    unsatisfied_requirement
    satisfied_requirement
    open
    diffy

    Phil Quitslund (Gerrit)

    unread,
    Aug 10, 2025, 1:28:50 PM8/10/25
    to Paul Berry, Johnni Winther, Konstantin Shcheglov, Brian Wilkerson, Commit Queue, dart-analys...@google.com, rev...@dartlang.org
    Attention needed from Brian Wilkerson and Paul Berry

    Phil Quitslund voted Code-Review+1

    Code-Review+1
    Open in Gerrit

    Related details

    Attention is currently required from:
    • Brian Wilkerson
    • Paul Berry
    Submit Requirements:
    • requirement satisfiedCode-Owners
    • requirement satisfiedCode-Review
    • requirement satisfiedReview-Enforcement
    Inspect html for hidden footers to help with email filtering. To unsubscribe visit settings. DiffyGerrit
    Gerrit-MessageType: comment
    Gerrit-Project: sdk
    Gerrit-Branch: main
    Gerrit-Change-Id: I6aa1f75fa0b8e4fb9724dcba00fb7d1f06dfb355
    Gerrit-Change-Number: 444205
    Gerrit-PatchSet: 6
    Gerrit-Owner: Paul Berry <paul...@google.com>
    Gerrit-Reviewer: Brian Wilkerson <brianwi...@google.com>
    Gerrit-Reviewer: Johnni Winther <johnni...@google.com>
    Gerrit-Reviewer: Konstantin Shcheglov <sche...@google.com>
    Gerrit-Reviewer: Paul Berry <paul...@google.com>
    Gerrit-Reviewer: Phil Quitslund <pquit...@google.com>
    Gerrit-Attention: Paul Berry <paul...@google.com>
    Gerrit-Attention: Brian Wilkerson <brianwi...@google.com>
    Gerrit-Comment-Date: Sun, 10 Aug 2025 17:28:48 +0000
    Gerrit-HasComments: No
    Gerrit-Has-Labels: Yes
    satisfied_requirement
    open
    diffy

    Paul Berry (Gerrit)

    unread,
    Aug 11, 2025, 9:01:35 AM8/11/25
    to Phil Quitslund, Johnni Winther, Konstantin Shcheglov, Brian Wilkerson, Commit Queue, dart-analys...@google.com, rev...@dartlang.org
    Attention needed from Brian Wilkerson

    Paul Berry voted Commit-Queue+2

    Commit-Queue+2
    Open in Gerrit

    Related details

    Attention is currently required from:
    • Brian Wilkerson
    Submit Requirements:
    • requirement satisfiedCode-Owners
    • requirement satisfiedCode-Review
    • requirement satisfiedReview-Enforcement
    Inspect html for hidden footers to help with email filtering. To unsubscribe visit settings. DiffyGerrit
    Gerrit-MessageType: comment
    Gerrit-Project: sdk
    Gerrit-Branch: main
    Gerrit-Change-Id: I6aa1f75fa0b8e4fb9724dcba00fb7d1f06dfb355
    Gerrit-Change-Number: 444205
    Gerrit-PatchSet: 6
    Gerrit-Owner: Paul Berry <paul...@google.com>
    Gerrit-Reviewer: Brian Wilkerson <brianwi...@google.com>
    Gerrit-Reviewer: Johnni Winther <johnni...@google.com>
    Gerrit-Reviewer: Konstantin Shcheglov <sche...@google.com>
    Gerrit-Reviewer: Paul Berry <paul...@google.com>
    Gerrit-Reviewer: Phil Quitslund <pquit...@google.com>
    Gerrit-Attention: Brian Wilkerson <brianwi...@google.com>
    Gerrit-Comment-Date: Mon, 11 Aug 2025 13:01:31 +0000
    Gerrit-HasComments: No
    Gerrit-Has-Labels: Yes
    satisfied_requirement
    open
    diffy

    Commit Queue (Gerrit)

    unread,
    Aug 11, 2025, 9:39:59 AM8/11/25
    to Paul Berry, Phil Quitslund, Johnni Winther, Konstantin Shcheglov, Brian Wilkerson, dart-analys...@google.com, rev...@dartlang.org

    Commit Queue submitted the change

    Change information

    Commit message:
    [analyzer/linter] Clean up error message comments.

    This change modifies the comments in the analyzer and linter
    `messages.yaml` files so that:

    - Parameters are always described at the end of the comment. If the
    message takes no parameters, the comment ends with the text `No
    parameters.`

    - Parameter descriptions are always word wrapped to 80 columns.

    It also fixes the format of the comment field for
    `ANALYSIS_OPTION_DEPRECATED` to remove an unintentional blank line,
    and adds documentation for the second parameter of
    `INVALID_EXPORT_OF_INTERNAL_ELEMENT_INDIRECTLY` (which was previously
    missing).

    In a follow-up CL, I will transition to a more structured format for
    parameters in these `messages.yaml` files, and the `Parameters:`
    sections of the comments will be automatically generated from this
    structured format during code generation. Cleaning up the comments now
    will ensure that the follow-up CL is clean (makes no changes to
    generated files), so we'll be able to have high confidence in its
    correctness.
    Change-Id: I6aa1f75fa0b8e4fb9724dcba00fb7d1f06dfb355
    Reviewed-by: Johnni Winther <johnni...@google.com>
    Commit-Queue: Paul Berry <paul...@google.com>
    Reviewed-by: Konstantin Shcheglov <sche...@google.com>
    Reviewed-by: Phil Quitslund <pquit...@google.com>
    Files:
    • M pkg/_fe_analyzer_shared/lib/src/scanner/errors.g.dart
    • M pkg/analyzer/lib/src/analysis_options/error/option_codes.g.dart
    • M pkg/analyzer/lib/src/dart/error/ffi_code.g.dart
    • M pkg/analyzer/lib/src/dart/error/hint_codes.g.dart
    • M pkg/analyzer/lib/src/dart/error/syntactic_errors.g.dart
    • M pkg/analyzer/lib/src/error/codes.g.dart
    • M pkg/analyzer/lib/src/manifest/manifest_warning_code.g.dart
    • M pkg/analyzer/lib/src/pubspec/pubspec_warning_code.g.dart
    • M pkg/analyzer/messages.yaml
    • M pkg/linter/lib/src/lint_codes.g.dart
    • M pkg/linter/messages.yaml
    Change size: XL
    Delta: 11 files changed, 1357 insertions(+), 132 deletions(-)
    Branch: refs/heads/main
    Submit Requirements:
    • requirement satisfiedCode-Review: +1 by Johnni Winther, +1 by Phil Quitslund, +1 by Konstantin Shcheglov
    Open in Gerrit
    Inspect html for hidden footers to help with email filtering. To unsubscribe visit settings. DiffyGerrit
    Gerrit-MessageType: merged
    Gerrit-Project: sdk
    Gerrit-Branch: main
    Gerrit-Change-Id: I6aa1f75fa0b8e4fb9724dcba00fb7d1f06dfb355
    Gerrit-Change-Number: 444205
    Gerrit-PatchSet: 7
    Gerrit-Owner: Paul Berry <paul...@google.com>
    Gerrit-Reviewer: Brian Wilkerson <brianwi...@google.com>
    open
    diffy
    satisfied_requirement
    Reply all
    Reply to author
    Forward
    0 new messages