Skip to content

[pigeon]: Correct comment references in doc comments#11129

Merged
auto-submit[bot] merged 2 commits intoflutter:mainfrom
srawlins:comm-refs
Feb 26, 2026
Merged

[pigeon]: Correct comment references in doc comments#11129
auto-submit[bot] merged 2 commits intoflutter:mainfrom
srawlins:comm-refs

Conversation

@srawlins
Copy link
Contributor

Several doc comments had missed comment references or erroneous comment references. Also a few grammar nits are fixed.

  • [Foo] [Bar] is a Markdown reference link, which presents "Foo" text, linking to a reference "Bar". In order to make this link to Foo and Bar, we need a word in between.
  • Prefer referencing a parameter with square brackets rather than backticks in order to allow for static tooling, like hover, rename, etc.

Pre-Review Checklist

  • I read the [Contributor Guide] and followed the process outlined there for submitting PRs.
  • I read the [Tree Hygiene] page, which explains my responsibilities.
  • I read and followed the [relevant style guides] and ran [the auto-formatter].
  • I signed the [CLA].
  • The title of the PR starts with the name of the package surrounded by square brackets, e.g. [shared_preferences]
  • I [linked to at least one issue that this PR fixes] in the description above.
  • I followed [the version and CHANGELOG instructions], using [semantic versioning] and the [repository CHANGELOG style], or I have commented below to indicate which documented exception this PR falls under[^1].
  • I updated/added any relevant documentation (doc comments with ///).
  • I added new tests to check the change I am making, or I have commented below to indicate which [test exemption] this PR falls under[^1].
  • All existing and new tests are passing.

Copy link

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

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

Code Review

This pull request updates documentation comments in packages/pigeon/lib/src/generator_tools.dart. The changes primarily involve correcting comment references to use square brackets for parameters and methods (e.g., [input], [addScoped]) and improving the phrasing of comments for clarity and grammatical correctness. For instance, the documentation for the Indent.format method's trimIndentation parameter has been expanded for better understanding.

@srawlins
Copy link
Contributor Author

None of the changes here are to public API comments. Does this require a CHANGELOG note then?

Copy link
Contributor

@tarrinneal tarrinneal left a comment

Choose a reason for hiding this comment

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

solid improvements, thank you

@tarrinneal
Copy link
Contributor

@stuartmorgan-g more exceptions

@stuartmorgan-g
Copy link
Collaborator

version/changelog override: no client-facing effect since these aren't exported.

(The script doesn't do complex analysis so this kind of false positive is expected.)

@stuartmorgan-g stuartmorgan-g added override: no versioning needed Override the check requiring version bumps for most changes override: no changelog needed Override the check requiring CHANGELOG updates for most changes labels Feb 26, 2026
@stuartmorgan-g stuartmorgan-g added the autosubmit Merge PR when tree becomes green via auto submit App label Feb 26, 2026
@auto-submit auto-submit bot merged commit 6301571 into flutter:main Feb 26, 2026
81 checks passed
engine-flutter-autoroll added a commit to engine-flutter-autoroll/flutter that referenced this pull request Feb 27, 2026
github-merge-queue bot pushed a commit to flutter/flutter that referenced this pull request Feb 27, 2026
flutter/packages@e1d0169...a27d7c5

2026-02-26 [email protected] [pigeon] Tidy GeneratorAdapters to be
const, with getters instead of fields (flutter/packages#11131)
2026-02-26 [email protected] [webview_flutter] Remove
usesCleartextTraffic (flutter/packages#11124)
2026-02-26 [email protected] [pigeon]: Correct comment references in
doc comments (flutter/packages#11129)
2026-02-26 [email protected] [webview_flutter_android] Remove
usesCleartextTraffic (flutter/packages#11122)
2026-02-26 [email protected] Roll Flutter from
dad6f9d to b31548f (39 revisions) (flutter/packages#11116)
2026-02-26 [email protected] [espresso] Remove usesCleartextTraffic
(flutter/packages#11125)
2026-02-26 [email protected] [pigeon] Use function types in order to
avoid dynamic calls (flutter/packages#11130)
2026-02-26 [email protected] [shared_preferences] Revert
androidx.datastore:datastore to 1.1.7 (flutter/packages#11128)

If this roll has caused a breakage, revert this CL and stop the roller
using the controls here:
https://autoroll.skia.org/r/flutter-packages-flutter-autoroll
Please CC [email protected] on the revert to ensure that a
human
is aware of the problem.

To file a bug in Flutter:
https://github.com/flutter/flutter/issues/new/choose

To report a problem with the AutoRoller itself, please file a bug:
https://issues.skia.org/issues/new?component=1389291&template=1850622

Documentation for the AutoRoller is here:
https://skia.googlesource.com/buildbot/+doc/main/autoroll/README.md
xxxOVALxxx pushed a commit to xxxOVALxxx/flutter that referenced this pull request Mar 10, 2026
…r#183009)

flutter/packages@e1d0169...a27d7c5

2026-02-26 [email protected] [pigeon] Tidy GeneratorAdapters to be
const, with getters instead of fields (flutter/packages#11131)
2026-02-26 [email protected] [webview_flutter] Remove
usesCleartextTraffic (flutter/packages#11124)
2026-02-26 [email protected] [pigeon]: Correct comment references in
doc comments (flutter/packages#11129)
2026-02-26 [email protected] [webview_flutter_android] Remove
usesCleartextTraffic (flutter/packages#11122)
2026-02-26 [email protected] Roll Flutter from
dad6f9d to b31548f (39 revisions) (flutter/packages#11116)
2026-02-26 [email protected] [espresso] Remove usesCleartextTraffic
(flutter/packages#11125)
2026-02-26 [email protected] [pigeon] Use function types in order to
avoid dynamic calls (flutter/packages#11130)
2026-02-26 [email protected] [shared_preferences] Revert
androidx.datastore:datastore to 1.1.7 (flutter/packages#11128)

If this roll has caused a breakage, revert this CL and stop the roller
using the controls here:
https://autoroll.skia.org/r/flutter-packages-flutter-autoroll
Please CC [email protected] on the revert to ensure that a
human
is aware of the problem.

To file a bug in Flutter:
https://github.com/flutter/flutter/issues/new/choose

To report a problem with the AutoRoller itself, please file a bug:
https://issues.skia.org/issues/new?component=1389291&template=1850622

Documentation for the AutoRoller is here:
https://skia.googlesource.com/buildbot/+doc/main/autoroll/README.md
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

autosubmit Merge PR when tree becomes green via auto submit App override: no changelog needed Override the check requiring CHANGELOG updates for most changes override: no versioning needed Override the check requiring version bumps for most changes p: pigeon

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants