Document install step interpolation - #23347
Merged
Merged
Conversation
Contributor
There was a problem hiding this comment.
Pull request overview
Updates Homebrew documentation to clarify how Ruby interpolation (#{...}) differs from install-time {{...}} tokens inside structured install-step blocks, helping authors write steps that survive JSON serialisation and expand correctly at install time.
Changes:
- Adds an “Interpolation in steps blocks” subsection to the Formula cookbook’s steps documentation.
- Adds the same clarification to the Cask cookbook’s steps documentation.
- Refines examples to recommend explicit
{{...}}tokens (andbase:/source_base:/target_base:where applicable) for install-time expansion.
Reviewed changes
Copilot reviewed 2 out of 2 changed files in this pull request and generated 2 comments.
| File | Description |
|---|---|
| docs/Formula-Cookbook.md | Documents Ruby vs {{...}} token expansion semantics for formula structured steps. |
| docs/Cask-Cookbook.md | Documents Ruby vs {{...}} token expansion semantics for cask structured steps. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
MikeMcQuaid
force-pushed
the
document-install-step-interpolation
branch
from
July 29, 2026 09:52
6bef1fa to
7a846e3
Compare
chenrui333
approved these changes
Jul 29, 2026
MikeMcQuaid
marked this pull request as draft
July 29, 2026 16:18
MikeMcQuaid
force-pushed
the
document-install-step-interpolation
branch
from
July 29, 2026 16:26
7a846e3 to
3ab7457
Compare
- Distinguish Ruby interpolation from install-time tokens that survive JSON serialisation. - Keep token-producing compatibility helpers valid while rejecting arbitrary interpolation. - Emit explicit install-time tokens from formula autocorrections.
MikeMcQuaid
force-pushed
the
document-install-step-interpolation
branch
from
July 29, 2026 16:59
3ab7457 to
095b9ce
Compare
MikeMcQuaid
marked this pull request as ready for review
July 29, 2026 17:18
This was referenced Aug 3, 2026
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
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
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.
As requested by @SMillerDev
OpenAI Codex GPT 5.6 Sol max with local review.