Use `main` for Homebrew branches about brew HOT 6 OPEN

It will be important to ensure that brew update, brew update-reset and brew test-bot all behave as expected.

To confirm, "behave as expected" here means that e.g. brew update will seamlessly move the tap branch from master -> main right? if I recall correctly last time I tried this it instead errored and asked you to run brew tap --repair, which seems like something brew could handle for you.

https://github.com/homebrew/brew/blob/0a358b851875d8fe070396a7870a7f9b0dfc1634/Library/Homebrew/cmd/update-report.rb#L263-L269

from brew.

Ideally yeah. And if any fixes are required, it may mean having to keep a copy of master around indefinitely as an intermediate update step.

If it doesn't work well, a local symbolic-ref might be an alternative idea.

from brew.

To confirm, "behave as expected" here means that e.g. brew update will seamlessly move the tap branch from master -> main right?

Yes.

And if any fixes are required, it may mean having to keep a copy of master around indefinitely as an intermediate update step.

Ideally we don't want to do this but agreed it's worth doing if needed (at least on Homebrew/brew).

from brew.

In the past, third party taps handled this with opoo but a silent method for renaming the main (or any) branch which doesn't require keeping the old branch around would be welcome.

from brew.

Noting the "help wanted" tag, I'm interested in working on this, but I'm not clear what the action item is, or at least not what work there is that a non-maintainer could do (i.e. I clearly won't be renaming your repos on GitHub).

I tried renaming the main branch on a personal tap: brew update detects the rename, and recommends running brew tap --repair, which in turn works perfectly for correcting the refs in the tap.

Is the next step just adding logic to brew update to run brew tap --repair (or the equivalent ruby command) automatically when a branch rename is detected?

edit: I guess I should say that tap --repair works almost perfectly. After the rename there is still a ref left behind to remotes/origin/oldname, which git remote prune origin fixes.

from brew.

Is the next step just adding logic to brew update to run brew tap --repair (or the equivalent ruby command) automatically when a branch rename is detected?

Thanks for asking @rrotter! Yes, I think so. brew update should be able to handle these changes and run the relevant commands automatically for users with no intervention (although perhaps an ohai notifying them of the default branch change.

When you've verified this with some test personal taps: we can start moving some of the lesser used Homebrew official taps over.

from brew.