Correct cask migration docs to measured behavior#34
Merged
Conversation
Live-tested on stable Homebrew 6.0.6: brew update auto-installs the formula via tap_migrations but leaves the cask installed with its binary owning pj on PATH; completing the migration requires uninstalling the cask and linking the formula. Also document the current Homebrew locking bug that breaks brew upgrade/reinstall for source-built tap formulae, with the uninstall+install workaround.
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
1 participant
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.
Post-release verification of the v1.0.0 cask→formula migration, live-tested on stable Homebrew 6.0.6 by recreating a real cask user (old cask installed from the tap's git history, then
brew update):What actually happens
brew updatedetects the removed cask viatap_migrations.jsonand auto-installs thepjformula ✅/opt/homebrew/bin/pj—pj versionkeeps reporting the old version ❌brew upgrade pjis then a no-op ("1.0.0 already installed")brew uninstall --cask pjandbrew link pj(the formula was installed while the cask owned the binary path, so its link was skipped)The docs previously said
brew update && brew upgrade pjcompletes the migration — corrected to the verified four-step sequence.Second finding: Homebrew locking bug breaks
brew upgrade pjConfirmed on both stable 6.0.6 and current master (6.0.6-68):
brew upgrade pjandbrew reinstall pjfail withA process has already locked /opt/homebrew/Cellar/pjfor this source-built tap formula, even with the lock verifiably free (a directflockacquires it; zero brew processes running). Related upstream reports: Homebrew/brew#22293. Added a Known Issue note to the upgrade section with the workingbrew uninstall pj && brew install pjworkaround.The published v1.0.0 release notes have been updated in place to match.
🤖 Generated with Claude Code [Fable 5]