2330 Commits

Author SHA1 Message Date
Eric Knibbe
43c8fec557
docs: mark console output appropriately 2023-09-11 02:26:37 -04:00
Eric Knibbe
9372edf38f
docs: re-case titles 2023-09-11 02:26:37 -04:00
Eric Knibbe
931f762598
docs+rubydoc: various grammar/wording fixes 2023-09-11 02:26:37 -04:00
Eric Knibbe
484efe2911
docs: various additions & changes 2023-09-05 01:06:31 -04:00
Eric Knibbe
7718c5ad61
docs: improve links & formatting 2023-09-05 00:54:26 -04:00
Eric Knibbe
110e14937b
docs/Tips: add bundle, --adopt, VS Code plugins 2023-09-05 00:46:55 -04:00
Eric Knibbe
a63cee48e3
docs/FAQ: ensure homebrew/core is downloaded 2023-09-05 00:38:31 -04:00
Eric Knibbe
6dfacae5d2
docs/Cask-Cookbook: more on_<system> improvements 2023-09-05 00:37:16 -04:00
Eric Knibbe
4205cb495a
docs: rework Cask-Cookbook to match current practice
and migrate `livecheck` stanza documentation to Brew-Livecheck.md
2023-09-02 00:43:51 -04:00
Issy Long
de50e84184
Merge pull request #15930 from issyl0/markdown-numbering
docs: Use Markdown automatic numbering in staging branch instructions
2023-09-02 00:51:10 +01:00
Issy Long
68bccb9bbb
docs: Use Markdown automatic numbering in staging branch instructions
- It's always a pain to re-number everything when adding or removing
  steps, so let's use the Markdown numbering trick.
- This does render correctly in HTML, I tested building the site.
2023-09-02 00:30:38 +01:00
Eric Knibbe
10b06d9826
Docs: update test-bot images and description 2023-09-01 13:24:12 -04:00
Eric Knibbe
217ebf88c7
remove OSDN link due to site unreliability 2023-09-01 00:27:05 -04:00
Eric Knibbe
23f656bf8c
docs: localize FAQ images 2023-09-01 00:21:44 -04:00
Issy Long
1c91da27bb
The Python Setuptools docs have moved around too, the reference no longer exists 2023-09-01 01:02:05 +01:00
Issy Long
ee7ff97877
Fix link to renamed Cask Cookbook section 2023-09-01 01:02:04 +01:00
Issy Long
484c7e07d1
Cache the external links for an hour, and ignore GitHub.com 2023-09-01 01:02:03 +01:00
Issy Long
17de29e93d
Disable HTMLProofer's assume_extension option
- It reports a lot of broken internal links that do actually exist, it's
  just file extension inference weirdness.
2023-09-01 01:02:02 +01:00
Issy Long
c0144234d1
The E&R policy doc is only in Homebrew/homebrew-governance-private 2023-09-01 01:02:01 +01:00
Issy Long
3c69671b84
The py2cairo formula was deleted, don't refer to it in docs anymore 2023-09-01 01:02:00 +01:00
Issy Long
32bbe6d5de
Ignore <a name= HTML tags on the Installation page in anchor tag linting 2023-09-01 01:01:59 +01:00
Issy Long
7f3a4fe667
Fix link to Ruby's FileUtils documentation in the Formula Cookbook 2023-09-01 01:01:58 +01:00
Issy Long
7f2ed15db3
Update html-proofer configuration - the parameter names changed 2023-09-01 01:01:57 +01:00
Mike McQuaid
59cc141524
Merge pull request #15923 from MikeMcQuaid/brew_contributions_improvements
dev-cmd/contributions: usability/performance improvements.
2023-08-30 15:21:30 +01:00
Mike McQuaid
d357607b2c
dev-cmd/contributions: usability/performance improvements.
- more sensible/performant defaults: default to primary repositories
  only for the last year rather than all repositories forever
- allow specifying more than one user at a time
- output the breakdown of contributions without needing `--csv`
- add a space before the `--csv` output
- consolidate some code
- avoid counting authored commits twice, to improve performance
- retry failed GitHub API calls (this happens often when querying all
  maintainers)
- stop counting after we find 1000 commits for a given user to avoid
  excessive API queries/pagination
2023-08-30 15:08:50 +01:00
Mike McQuaid
9863d555a8
cmd/deps: fix documentation and handling of formula_options.
https://github.com/Homebrew/brew/pull/15892#issuecomment-1698659908
2023-08-30 08:46:59 +01:00
Mike McQuaid
851df262a0
Merge pull request #15892 from apainintheneck/rework-recursive-dependency-resolution
dependency_helpers: rework recursive dependency resolution
2023-08-30 08:29:24 +01:00
apainintheneck
b2b8f0ea86 cmd/uses & cmd/deps: update help/man pages
- add clarification about precedence of command options
- reword some options for readability
- clarify the defaults in `brew deps`
2023-08-28 22:14:26 -07:00
Eric Knibbe
de5742a929
docs: use relative path for custom header images 2023-08-27 12:34:50 -04:00
Amy Grace
edf022d94e
docs: update formula and cask URLs to new sharded format 2023-08-26 14:54:19 +01:00
Sean Molenaar
11821aa74b
Update Acceptable-Formulae.md
Co-authored-by: Mike McQuaid <mike@mikemcquaid.com>
2023-08-15 18:21:17 +02:00
Sean Molenaar
2db75db7f8
Update Acceptable-Formulae.md
Co-authored-by: Patrick Linnane <patrick@linnane.io>
2023-08-15 18:16:10 +02:00
Sean Molenaar
d523cdc0ec
fix: use cannot instead of can not
Co-authored-by: Mike McQuaid <mike@mikemcquaid.com>
2023-08-15 17:27:02 +02:00
Sean Molenaar
8d537260af
chore: document the policy on static libraries 2023-08-15 17:18:33 +02:00
Mike McQuaid
98c8dd01e4
Merge pull request #15868 from MikeMcQuaid/more_install_from_api_again
brew.sh: don't set `HOMEBREW_NO_INSTALL_FROM_API` automatically.
2023-08-15 14:27:06 +01:00
Mike McQuaid
1481eac57c
brew.sh: don't set HOMEBREW_NO_INSTALL_FROM_API automatically.
My understanding is that now https://github.com/Homebrew/brew/pull/15778
has been merged this should now work fine on both older macOS versions
and non-default prefixes so let's try this again.
2023-08-15 11:42:02 +01:00
Clint Harrison
4ade9351e4
Allow HOMEBREW_CURLRC to provide a path for curl --config
Co-authored-by: Mike McQuaid <mike@mikemcquaid.com>
Co-authored-by: Carlo Cabrera <30379873+carlocab@users.noreply.github.com>
2023-08-15 11:29:02 +01:00
Eric Knibbe
569c833924
Formula-Cookbook: expand terminology table 2023-08-12 21:48:16 -04:00
Mike McQuaid
597f0840a3
dev-cmd/tests: add --fail-fast.
This is useful when testing very slow test files with many tests.
2023-08-10 16:27:37 +01:00
Eric Knibbe
0f4b0028b5
Formula-Cookbook: expand environment var section 2023-08-08 08:22:59 -04:00
Eric Knibbe
2b8c37b04e
Formula-Cookbook: revise download strategy docs 2023-08-07 15:30:11 -04:00
BrewTestBot
c2160f68e7
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.
2023-08-07 16:10:53 +00:00
apainintheneck
0979f7c35f cmd/bump: add --installed flag
This allows users to only try to bump formulae and casks they
currently have installed. It copies this behavior from the
livecheck command.
2023-08-05 10:01:11 -07:00
Eric Knibbe
b3ecd91f97
dev-cmd/edit: suggest tapping core repositories 2023-08-01 13:39:28 -04:00
Mike McQuaid
8a74f83223
Merge pull request #15799 from MikeMcQuaid/deprecate_postgresql_upgrade_database
Deprecate `postgresql-upgrade-database`
2023-08-01 17:34:29 +01:00
Mike McQuaid
e3c0faf4e2
Merge pull request #15787 from MikeMcQuaid/env_file_configuration
Allow configuring Homebrew with `.env` files
2023-08-01 13:07:19 +01:00
Mike McQuaid
04e07dc0db
Deprecate postgresql-upgrade-database
This is an out-of-band deprecation but this command is broken and we're
not going to fix it so it's not really worth a deprecation cycle.

See https://github.com/orgs/Homebrew/discussions/4685
2023-08-01 12:00:30 +01:00
Mike McQuaid
375a7ee8dc
Allow configuring Homebrew with .env files
For a long time people have requested some sort of configuration files
for Homebrew. Now: here's the first version of that.

Similarly to how you can configure Git for a system, a repository or
a user: you can configure Homebrew for a system, a prefix or a user.

The system-wide configuration file is `/etc/homebrew/brew.env`, the
prefix-specific configuration file is
`$HOMEBREW_PREFIX/etc/homebrew/brew.env`
and the user-specific configuration file is `~/.homebrew/brew.env`.

As we need to read these files from Bash in `bin/brew` (so they can)
influence functionality ASAP: they are in a simple format that Bash
can read. It may be that we have more complex array or hash data in
future that's configured through JSON or YAML (most likely JSON as we
use it more) and stored in a `brew.json`/`brew.yaml` file in the same
directory.

As this is relying on `eval` in Bash which is fairly dangerous: we
filter the lines with a regex to ensure we're only permitting setting
`HOMEBREW_*` variables and nothing more.

To give a bit of power to system administrators, the
`HOMEBREW_SYSTEM_ENV_TAKES_PRIORITY` variable can be set in
`/etc/homebrew/brew.env` to ensure that the system-wide configuration
file is loaded last and overrides any prefix or user settings.

Now that we have an actual location for configuration files, let's also
change the `brew livecheck` watchlist configuration file to be in this
directory and deprecate the existing location. As this is a developer
command and the mitigation is to just move the file: we don't need to
follow the normal deprecation process here.
2023-07-28 17:17:14 +01:00
Sam Ford
e9e484ea31
docs: Fix GithubReleases strategy block example
The `strategy` block example for `GithubReleases` in the
`brew livecheck` documentation should be using `release` inside the
`#map` block instead of `json`. I accidentally overlooked one instance
of `json` when adapting the code from the `GithubLatest` example above
it.
2023-07-28 10:23:35 -04:00
Mike McQuaid
7801878c74
post_install: improvements and fixes.
- warn if running `brew postinstall` explicitly and there's no
  `post_install` defined in the formula
- add a `post_install` alias for `brew postinstall` to make life
  easier for those jumping between `postinstall` and `post_install` in
  e.g. Homebrew development
- refactor `post_install` formula path logic into a new method for
  improved readability
- handle the JSON API `post_install` formula path case
2023-07-28 11:26:09 +01:00