Skip to content

docs(ast_tools): correct comments concerning enum inheritance#24395

Merged
graphite-app[bot] merged 1 commit into
mainfrom
om/07-12-docs_ast_tools_correct_comments_concerning_enum_inheritance
Jul 12, 2026
Merged

docs(ast_tools): correct comments concerning enum inheritance#24395
graphite-app[bot] merged 1 commit into
mainfrom
om/07-12-docs_ast_tools_correct_comments_concerning_enum_inheritance

Conversation

@overlookmotel

@overlookmotel overlookmotel commented Jul 12, 2026

Copy link
Copy Markdown
Member

Follow-on after #23555.

Since that PR was written, the inherit_variants! macro was removed, so some of the comments were out of date.

Bring those comments up to date. Also shorten the comments a bit and reformat them.

@github-actions github-actions Bot added the A-ast-tools Area - AST tools label Jul 12, 2026

Copy link
Copy Markdown
Member Author

How to use the Graphite Merge Queue

Add either label to this PR to merge it via the merge queue:

  • 0-merge - adds this PR to the back of the merge queue
  • hotfix - for urgent changes, fast-track this PR to the front of the merge queue

You must have a Graphite account in order to use the merge queue. Sign up using this link.

An organization admin has enabled the Graphite Merge Queue in this repository.

Please do not merge from GitHub as this will restart CI on PRs being processed by the merge queue.

This stack of pull requests is managed by Graphite. Learn more about stacking.

@overlookmotel
overlookmotel marked this pull request as ready for review July 12, 2026 10:19
Copilot AI review requested due to automatic review settings July 12, 2026 10:19
@overlookmotel overlookmotel self-assigned this Jul 12, 2026

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Pull request overview

Updates documentation comments in the AST tools derive generators to reflect the current enum-variant inheritance mechanism (INHERIT marker variants) after removal of the older inherit_variants! macro, keeping the rationale for delegation clear and up to date.

Changes:

  • Refresh and shorten comments in the estree derive generator describing delegation for inherited variants.
  • Refresh and reformat comments in the clone_in derive generator describing delegation via to_* casts and From impls.
  • Minor whitespace tweaks around inherited-variant arm generation blocks.

Reviewed changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 2 comments.

File Description
tasks/ast_tools/src/derives/estree.rs Updates comments explaining how INHERIT-based inherited variants delegate ESTree serialization to reduce duplicated match arms/binary size.
tasks/ast_tools/src/derives/clone_in.rs Updates comments explaining how INHERIT-based inherited variants delegate cloning via to_* + From to avoid duplicated match arms/binary bloat.

Comment thread tasks/ast_tools/src/derives/estree.rs
Comment thread tasks/ast_tools/src/derives/clone_in.rs
@graphite-app

graphite-app Bot commented Jul 12, 2026

Copy link
Copy Markdown
Contributor

Merge activity

Follow-on after #23555.

Since that PR was written, the `inherit_variants!` macro was removed, so some of the comments were out of date.

Bring those comments up to date. Also shorten the comments a bit and reformat them.
@graphite-app
graphite-app Bot force-pushed the om/07-12-docs_ast_tools_correct_comments_concerning_enum_inheritance branch from e049e5c to c15c423 Compare July 12, 2026 10:25
@graphite-app
graphite-app Bot merged commit c15c423 into main Jul 12, 2026
27 checks passed
@graphite-app
graphite-app Bot deleted the om/07-12-docs_ast_tools_correct_comments_concerning_enum_inheritance branch July 12, 2026 10:30
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

A-ast-tools Area - AST tools

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants