2647 Commits

Author SHA1 Message Date
Mike McQuaid
319c3e95b5
Merge pull request #19658 from Homebrew/bootsnap_default
Enable Bootsnap by default
2025-04-01 07:31:26 +00:00
Patrick Linnane
9fd33121da
docs/Support-Tiers: update unsupported config examples
Signed-off-by: Patrick Linnane <patrick@linnane.io>
2025-03-31 16:11:28 -07:00
Mike McQuaid
9560c01453
Enable Bootsnap by default
- do some optimisation of `require`s before Bootsnap
- remove `HOMEBREW_BOOTSTRAP` environment variable as it's set by
  default
- add fast require in `bootsnap.rb` using logic from `ruby.sh`
- cleanup `bootsnap.rb` a bit
- remove setting `HOMEBREW_BOOTSNAP` in GitHub Actions
2025-03-31 17:55:07 +01:00
Mike McQuaid
7f17aeca61
Add Support Tiers documentation
This provides clarify to users about the support tiers for Homebrew.

Co-authored-by: Douglas Eichelberger <697964+dduugg@users.noreply.github.com>
Co-authored-by: Bo Anderson <mail@boanderson.me>
Co-authored-by: Sam Ford <1584702+samford@users.noreply.github.com>
2025-03-31 09:40:47 +01:00
BrewTestBot
2cee8e9c08
Update manpage and completions.
Autogenerated by the [sponsors-maintainers-man-completions](https://github.com/Homebrew/brew/blob/HEAD/.github/workflows/sponsors-maintainers-man-completions.yml) workflow.
2025-03-28 09:05:47 +00:00
Mike McQuaid
5ec5063dc7
Add brew update-if-needed
This uses the logic in `brew.sh` for deciding whether or not to run
`brew update --auto-update` and makes it a dedicated command that can
be used instead of `brew update` in scripts to be really fast in the
no-op case.

`brew update` will always do at least some updating which is a nicer
default but is much slower.
2025-03-27 13:16:00 +00:00
Mike McQuaid
8e89be7fe8
Merge pull request #19597 from Homebrew/sponsors-maintainers-man-completions
Update manpage and completions.
2025-03-25 11:47:41 +00:00
Mike McQuaid
2dbce6bac5
Merge pull request #19579 from Homebrew/bundle_version_file
Add `version_file:` DSL to `Brewfile`
2025-03-25 10:11:52 +00:00
BrewTestBot
b5d1e7426b
Update manpage and completions.
Autogenerated by the [sponsors-maintainers-man-completions](https://github.com/Homebrew/brew/blob/HEAD/.github/workflows/sponsors-maintainers-man-completions.yml) workflow.
2025-03-25 09:07:49 +00:00
BrewTestBot
d914539bda
Update manpage and completions.
Autogenerated by the [sponsors-maintainers-man-completions](https://github.com/Homebrew/brew/blob/HEAD/.github/workflows/sponsors-maintainers-man-completions.yml) workflow.
2025-03-25 03:06:12 +00:00
Mike McQuaid
df0fe8a802
Add version_file: DSL to Brewfile
This allows writing to e.g. `.ruby-version` files directly from the
`Brewfile`, making it easy to keep these versions in sync.
2025-03-24 17:34:35 +00:00
Mike McQuaid
e41a1f6d8a
Add brew install --as-dependency
This option avoids needing to immediately use
`brew tab --no-installed-on-request` when manually installing a
dependency.
2025-03-21 15:49:22 +00:00
Mike McQuaid
e0597c0dc4
Merge pull request #19542 from Homebrew/brew_bundle_docs
Import documentation for `brew bundle`
2025-03-19 12:34:40 +00:00
Mike McQuaid
d84fac5af4
Look for VSCode variants
We've had requests for this in Homebrew/bundle a few times so let's
implement it both for there and for `brew edit`.

Tested on my machine with `cursor` and working as expected.
2025-03-19 11:42:37 +00:00
Mike McQuaid
dea26d02b7
Import documentation for brew bundle
This was in the (soon to be archived) Homebrew/homebrew-bundle
repository's `README`. There's some good content here that doesn't
cleanly fit into the `brew` manpage so let's move it here.

While we're here, let's de-emphasize `whalebrew` as it's not
widely used and add commented-out deprecation warnings for its future
deprecation.
2025-03-19 10:53:00 +00:00
Mike McQuaid
f8baea29cb
Merge pull request #19540 from Homebrew/brew_bundle_cleanup
Cleanup some missing references to Homebrew Bundle.
2025-03-19 10:07:37 +00:00
Mike McQuaid
7a57af242e
Cleanup some missing references to Homebrew Bundle.
Let's just call it `brew bundle` from now on as it's a normal command.

Also, fix a reference to "Homebrew Services" while we're here.
2025-03-19 09:51:39 +00:00
BrewTestBot
eb1430f7ce
Update manpage and completions.
Autogenerated by the [sponsors-maintainers-man-completions](https://github.com/Homebrew/brew/blob/HEAD/.github/workflows/sponsors-maintainers-man-completions.yml) workflow.
2025-03-19 09:21:20 +00:00
BrewTestBot
3bb7db20a2
Update manpage and completions.
Autogenerated by the [sponsors-maintainers-man-completions](https://github.com/Homebrew/brew/blob/HEAD/.github/workflows/sponsors-maintainers-man-completions.yml) workflow.
2025-03-19 07:11:41 +00:00
Mike McQuaid
bdeca530ff
Migrate Homebrew/bundle to Homebrew/brew
Co-authored-by: Bo Anderson <mail@boanderson.me>
2025-03-19 06:47:01 +00:00
Mike McQuaid
689fb13299
docs/Common-Issues: fix style. 2025-03-18 08:43:51 +00:00
Mike McQuaid
e81794c96a
docs/Common-Issues: tweak wording. 2025-03-18 08:41:25 +00:00
NeimadTL
7c23b7aa4a Add possible curl issues
This new part of documentation has been added in order to provide
users a way to identify curl related issues which may or may not be
caused by their workstation.
2025-03-17 19:29:39 -04:00
botantony
96eacb7fd9
std_go_args: add -tags flag
Signed-off-by: botantony <antonsm21@gmail.com>
2025-03-16 21:41:19 +01:00
Benjamin Bergman
b378ec91fe
Fix typo in Installation.md 2025-03-14 13:25:21 -05:00
BrewTestBot
9dcc35ced0
Update manpage and completions.
Autogenerated by the [sponsors-maintainers-man-completions](https://github.com/Homebrew/brew/blob/HEAD/.github/workflows/sponsors-maintainers-man-completions.yml) workflow.
2025-03-14 08:43:39 +00:00
Mike McQuaid
084ddca27a
Cleanup and fix homebrew-services migration 2025-03-13 15:22:01 +00:00
BrewTestBot
493c07372b
Update manpage and completions.
Autogenerated by the [sponsors-maintainers-man-completions](https://github.com/Homebrew/brew/blob/HEAD/.github/workflows/sponsors-maintainers-man-completions.yml) workflow.
2025-03-13 10:53:02 +00:00
BrewTestBot
8f2317f908
Update manpage and completions.
Autogenerated by the [sponsors-maintainers-man-completions](https://github.com/Homebrew/brew/blob/HEAD/.github/workflows/sponsors-maintainers-man-completions.yml) workflow.
2025-03-11 10:09:23 +00:00
BrewTestBot
3e7a583a93
Update manpage and completions.
Autogenerated by the [sponsors-maintainers-man-completions](https://github.com/Homebrew/brew/blob/HEAD/.github/workflows/sponsors-maintainers-man-completions.yml) workflow.

Signed-off-by: Patrick Linnane <patrick@linnane.io>
2025-03-07 08:17:59 -08:00
BrewTestBot
9bde3e18a6
Update manpage and completions.
Autogenerated by the [sponsors-maintainers-man-completions](https://github.com/Homebrew/brew/blob/HEAD/.github/workflows/sponsors-maintainers-man-completions.yml) workflow.
2025-03-05 00:08:18 +00:00
botantony
bf7514f328
docs: add a bit more information about std_*_args to Formula Cookbook 2025-03-04 13:04:10 +01:00
Heath Stewart
222e8d129a
Document pwsh shell completion
Based on discussion in #19408, update the documentation to specify that `:pwsh` must be passed explicitly and that it will translate to a "powershell" argument, as is currently supported by Go's common `github.com/spf13/cobra` module and Rust's common `clap` (with `clap_complete`) crate.
2025-03-04 02:16:48 -08:00
Heath Stewart
42caf20fa4
Add PowerShell (pwsh) completion support
Resolves #19403
2025-03-02 18:17:38 -08:00
BrewTestBot
302d33c26e
Update manpage and completions.
Autogenerated by the [sponsors-maintainers-man-completions](https://github.com/Homebrew/brew/blob/HEAD/.github/workflows/sponsors-maintainers-man-completions.yml) workflow.
2025-02-25 16:00:57 +00:00
Sam Ford
140d45f325
docs: Fix broken RubyDoc URL fragments
Some RubyDoc URL fragments in the Formula Cookbook documentation
include an equals sign (`%3D`) but the `id` attributes in the current
RubyDoc HTML don't include the equals sign, so the documentation CI
job is failing with errors like `External link
https://rubydoc.brew.sh/Formula#revision=-class_method failed:
https://rubydoc.brew.sh/Formula exists, but the hash
'revision=-class_method' does not`. This updates the URLs to remove
`%3D` accordingly.
2025-02-24 12:08:52 -05:00
Sam Ford
5e57df7287
livecheck: restrict POST hashes to symbol keys
I initially set the type for livecheck's `post_form` and `post_json`
hashes to allow either a string or symbol key. I used string keys in
the documentation, as there will inevitably be some form field names
that would pose a problem for symbols (e.g., `E-mail` uses a hyphen,
`1twothree` starts with a digit, etc.). However, I remembered that we
can simply use quote symbols like `:"E-mail"` to handle these
situations, as they have the flexibility of a string while still being
a symbol.

With that in mind, this updates related type signatures to only allow
symbol keys and updates documentation and tests accordingly. The
documentation example contains a hyphenated form field, so it
demonstrates how to handle names that don't work as a bare symbol.
2025-02-21 21:54:46 -05:00
BrewTestBot
fb04179fd8
Update manpage and completions.
Autogenerated by the [sponsors-maintainers-man-completions](https://github.com/Homebrew/brew/blob/HEAD/.github/workflows/sponsors-maintainers-man-completions.yml) workflow.
2025-02-21 19:40:15 +00:00
Colin Dean
dfbc931769
Recommend abbreviated multi-platform loader
Co-authored-by: Mike McQuaid <mike@mikemcquaid.com>
2025-02-19 11:58:07 -05:00
Colin Dean
eab6e9f7f3
Use suggested post-installation steps
Thanks, @jvns!
2025-02-18 12:08:21 -05:00
Colin Dean
1733a78133
Prevent copying w/o reading by removing valid envvars and noting dirs
Co-authored-by: Eric Knibbe <enk3@outlook.com>
2025-02-14 10:25:32 -05:00
Colin Dean
33fde6faec
Lowercases a link fragment to satisfy checks 2025-02-13 15:12:03 -05:00
Colin Dean
1ad0f550b1 Adds post-installation steps to installation with extend version in tips
Inspired by @jvns' [post][1], I realized that I've had this problem on multiple teams, where someone missed the step at the end and didn't know how to recover. Typically, I've provided a version like what I've added to the Tips 'n' Tricks page so that I didn't have to think about what OS-arch pair my users are using.

I've tested the loader added to tips and tricks with both bash and zsh and it passes both shellcheck and shfmt in posix mode.

[1]: https://mastodon.social/@b0rk@jvns.ca/113997565198024027
2025-02-13 19:50:10 +00:00
Bevan Kay
0f8fd5e512
docs/governance/2021-agm-minutes.md: fix broken link 2025-02-13 10:56:14 +11:00
Bevan Kay
baea0d3ec9
docs/Homebrew-Governance.md: fix broken link 2025-02-13 10:56:13 +11:00
BrewTestBot
cddc2fc615
Update manpage and completions.
Autogenerated by the [sponsors-maintainers-man-completions](https://github.com/Homebrew/brew/blob/HEAD/.github/workflows/sponsors-maintainers-man-completions.yml) workflow.
2025-02-09 00:11:25 +00:00
Issy Long
f9b33d7c44
Merge pull request #19265 from Homebrew/review-some-docs
Review some docs
2025-02-08 16:04:23 +00:00
Issy Long
8f75f66d01
Review some docs
- Most of these were fine still, apart from:
  - FAQ: `hub` is less maintained than `gh`.
  - Brew-Maintainer-Guide: link to GitHub docs on commit signing via GPG or SSH.
  - Interesting-Taps-and-Forks: remove outdated information about `homebrew/core` being in `Library/Taps`.
  - New-Maintainer-Checklist: remove outdated information about the `@members` team.
2025-02-08 14:43:49 +00:00
Issy Long
00905fbd7e
Enforce that all docs have last_review_date frontmatter
- So we don't forget to add it to new docs we write.
2025-02-08 00:14:10 +00:00
BrewTestBot
769fb8739f
Update manpage and completions.
Autogenerated by the [sponsors-maintainers-man-completions](https://github.com/Homebrew/brew/blob/HEAD/.github/workflows/sponsors-maintainers-man-completions.yml) workflow.
2025-02-07 19:42:46 +00:00