mirrors/brew

0 Fork 0

mirror of https://github.com/Homebrew/brew.git synced 2026-10-28 09:34:42 +08:00

Files

T

Mike McQuaid 615a49c602 Preserve working directories when switching users

- Changing directory inside `as-brew-user` and `as-console-user` makes
  relative paths resolve against the target user's home, breaking
  `bundle --file` and local `Brewfile` discovery.
- Setting `HOME` is enough to use the target user's configuration
  and caches. Keeping the caller's directory fixes relative paths for
  every command without duplicating argument parsing in the wrappers.

Fixes #24359

2026-10-26 17:44:30 +00:00

_layouts

base.html: update to match main configuration

2026-10-01 08:07:14 +00:00

assets/img/docs

docs: drop advice to disable security or lower support tier

2026-06-15 16:41:01 +01:00

bin

jekyll: update to match main configuration

2026-08-05 01:33:32 +00:00

governance

Update package manager slogan

2026-07-26 19:48:28 +01:00

script

bootstrap: update to match main configuration

2026-08-05 01:33:32 +00:00

vale-styles/Homebrew

Document Homebrew and MDM administration

2026-10-25 19:27:32 +00:00

_config.yml

Update package manager slogan

2026-07-26 19:48:28 +01:00

.mdl_ruleset.rb

docs: localize internal URLs

2025-05-22 12:17:52 -04:00

.mdl_style.rb

docs: brew style --fix

2024-06-13 09:55:31 +01:00

.mdlrc

docs: add mdl for Markdown linting

2021-12-02 22:58:31 -05:00

.rubocop.yml

rubocop: Always run the "every formula should have a test block" check

2026-10-10 18:19:08 +01:00

.ruby-version

Further Portable Ruby cleanup

2024-06-14 12:22:02 +01:00

Acceptable-Casks.md

cask/audit: reject new casks requiring Rosetta

2026-10-21 00:02:33 +11:00

Acceptable-Formulae.md

docs: implementlists for readability

2026-07-23 10:20:25 +10:00

Adding-Software-to-Homebrew.md

docs/Adding-Software-to-Homebrew: pass the package type to brew style

2026-07-20 10:01:34 -07:00

Advisory-Matching.md

Document Homebrew and MDM administration

2026-10-25 19:27:32 +00:00

AGENTS.md

docs: enforce sentence-case headings and codify prose conventions

2026-07-20 13:29:18 -07:00

Analytics.md

Sample only user-set env config in analytics

2026-07-24 19:40:08 +01:00

Autobump.md

Change RubyDoc links

2025-10-15 17:39:14 +01:00

Bottles.md

Document Homebrew and MDM administration

2026-10-25 19:27:32 +00:00

Brew-Bundle-and-Brewfile.md

Document Homebrew and MDM administration

2026-10-25 19:27:32 +00:00

Brew-Livecheck.md

Clarify when to use GithubLatest livecheck

2026-10-19 18:46:09 +11:00

Brewfile

docs/Brewfile: use unversioned Ruby formula

2026-03-23 19:11:33 -07:00

BrewTestBot-For-Maintainers.md

docs: update maintainer operations guides

2026-07-20 11:47:25 -07:00

BrewTestBot.md

docs: update maintainer operations guides

2026-07-20 11:47:25 -07:00

Building-Against-Non-Homebrew-Dependencies.md

docs: update formula authoring and toolchain references

2026-07-20 09:50:52 -07:00

C++-Standard-Libraries.md

docs: update formula authoring and toolchain references

2026-07-20 09:50:52 -07:00

Cask-Cookbook.md

Prefill app and zap in brew create --cask

2026-10-22 09:14:20 +01:00

Checksum-Requirements.md

docs/Checksum-Requirements: cover casks in the shared requirement

2026-07-18 23:40:26 -07:00

CNAME

Cleanup documentation site

2017-01-04 10:53:21 +00:00

Command-Not-Found.md

docs: update command and integration references

2026-07-18 23:34:31 -07:00

Common-Issues-for-Maintainers.md

docs: update maintainer operations guides

2026-07-20 11:47:25 -07:00

Common-Issues.md

Honour curl environment options consistently

2026-10-22 17:13:28 +01:00

Creating-a-Homebrew-Issue.md

docs/Tips-and-Tricks: rename from weird filename.

2025-04-25 09:46:29 +01:00

Custom-GCC-and-cross-compilers.md

docs: update formula authoring and toolchain references

2026-07-20 09:50:52 -07:00

Deprecating-Disabling-and-Removing.md

Deprecate Homebrew wrapper configuration

2026-09-13 08:45:07 +01:00

Description-Guidelines.md

Unify formula and cask description guidelines

2026-10-14 23:34:49 +11:00

docs_rubocop_style.yml

Fix/reenable brew style docs

2024-06-13 12:31:47 +01:00

Expense-and-Reimbursement-Policy.md

docs: implementlists for readability

2026-07-23 10:20:25 +10:00

External-Commands.md

docs: update command and integration references

2026-07-18 23:34:31 -07:00

FAQ.md

Allow Keychain tokens for Git downloads

2026-10-23 17:41:03 +01:00

Formula-Cookbook.md

Merge pull request #24290 from HaraldNordgren/keep-no-linkage-build-dependencies

2026-10-19 14:08:33 +00:00

Gemfile

Gemfiles: require a minimum Ruby version

2026-09-15 11:48:52 -07:00

Gemfile.lock

build(deps): bump the bundler group across 2 directories with 10 updates

2026-10-23 13:12:01 +01:00

Homebrew-and-Iru.md

Document Homebrew and MDM administration

2026-10-25 19:27:32 +00:00

Homebrew-and-Jamf-Pro.md

Document Homebrew and MDM administration

2026-10-25 19:27:32 +00:00

Homebrew-and-Microsoft-Intune.md

Document Homebrew and MDM administration

2026-10-25 19:27:32 +00:00

Homebrew-brew-Maintainer-Guide.md

docs: update maintainer operations guides

2026-07-20 11:47:25 -07:00

Homebrew-Fleet-Management.md

Document Homebrew and MDM administration

2026-10-25 19:27:32 +00:00

Homebrew-for-Mac-Admins.md

Document Homebrew and MDM administration

2026-10-25 19:27:32 +00:00

Homebrew-for-Teams.md

Document Homebrew and MDM administration

2026-10-25 19:27:32 +00:00

Homebrew-Governance-Archives.md

docs: restyle governance and maintainer process pages

2026-07-18 23:34:31 -07:00

Homebrew-Governance.md

Homebrew-Governance.md: update to match main configuration

2026-10-14 13:57:52 +00:00

Homebrew-homebrew-cask-Maintainer-Guide.md

docs: update maintainer operations guides

2026-07-20 11:47:25 -07:00

Homebrew-homebrew-core-Maintainer-Guide.md

docs: implementlists for readability

2026-07-23 10:20:25 +10:00

Homebrew-Inventory-and-SBOM.md

Document Homebrew and MDM administration

2026-10-25 19:27:32 +00:00

Homebrew-Leadership-Responsibilities.md

Homebrew-Leadership-Responsibilities.md: update to match main configuration

2026-10-01 08:07:14 +00:00

Homebrew-on-Linux.md

Add as-brew-user and support MDM deployment

2026-09-23 09:45:53 -05:00

Homebrew-Package-Policies.md

Document Homebrew and MDM administration

2026-10-25 19:27:32 +00:00

Homebrew-Security-and-Supply-Chain.md

Document Homebrew and MDM administration

2026-10-25 19:27:32 +00:00

Homebrew-Vulnerability-Management.md

Document Homebrew and MDM administration

2026-10-25 19:27:32 +00:00

How-to-Build-Software-Outside-Homebrew-with-Homebrew-keg-only-Dependencies.md

docs: implementlists for readability

2026-07-23 10:20:25 +10:00

How-to-Create-and-Maintain-a-Tap.md

Document Homebrew and MDM administration

2026-10-25 19:27:32 +00:00

How-To-Open-a-Homebrew-Pull-Request.md

Clarify package commit squashing

2026-09-11 11:45:22 +01:00

How-To-Organise-the-AGM.md

docs: restyle governance and maintainer process pages

2026-07-18 23:34:31 -07:00

index.md

Document Homebrew and MDM administration

2026-10-25 19:27:32 +00:00

index.mdl_style.rb

docs: improve docs.

2026-06-08 20:35:04 +01:00

Installation.md

Preserve working directories when switching users

2026-10-26 17:44:30 +00:00

Interesting-Taps-and-Forks.md

Rename Homebrew security docs page

2026-06-21 13:56:57 +01:00

Kickstarter-Supporters.md

Review some docs

2025-02-08 14:43:49 +00:00

Language-Runtimes-and-Packages.md

docs: implementlists for readability

2026-07-23 10:20:25 +10:00

Language-Specific-Formulae.md

pypi: resolve non-PyPI sources missing from PyPI

2026-09-19 18:20:41 +09:00

Licence-Guidelines.md

Document Homebrew and MDM administration

2026-10-25 19:27:32 +00:00

Linux-CI.md

Migrate to Ubuntu 24.04

2026-05-09 08:58:42 -04:00

Maintainer-Guidelines.md

Update package manager slogan

2026-07-26 19:48:28 +01:00

Maintainer-Stipends-and-Grants.md

docs: fix errors reported by Vale 3.17.0

2026-07-31 14:51:00 -07:00

Maintainers-Avoiding-Burnout.md

docs: update maintainer operations guides

2026-07-20 11:47:25 -07:00

Manpage.md

Document Homebrew and MDM administration

2026-10-25 19:27:32 +00:00

MCP-Server.md

docs/MCP-Server: update Cursor URL

2026-08-03 13:11:24 -07:00

Migrating-A-Formula-To-A-Tap.md

Review some docs

2025-02-08 14:43:49 +00:00

New-Maintainer-Checklist.md

docs: update maintainer operations guides

2026-07-20 11:47:25 -07:00

Package-Acceptance-Policy.md

audit: require livecheck for new packages

2026-10-17 21:08:39 +11:00

Prose-Style-Guidelines.md

docs: enforce sentence-case headings and codify prose conventions

2026-07-20 13:29:18 -07:00

Querying-Brew.md

Document Homebrew and MDM administration

2026-10-25 19:27:32 +00:00

Rakefile

Skip unavailable MacPorts website links

2026-10-22 11:59:25 +01:00

README.md

docs: improve docs.

2026-06-08 20:35:04 +01:00

Releases.md

Block releases on open release blockers

2026-07-24 19:20:36 +01:00

Rename-A-Formula.md

docs: update formula authoring and toolchain references

2026-07-20 09:50:52 -07:00

Reproducible-Builds.md

docs: update formula authoring and toolchain references

2026-07-20 09:50:52 -07:00

Responsible-AI-Usage.md

Enforce responsible AI contribution policy

2026-07-29 09:53:23 +01:00

robots.txt

docs: Add sitemap.xml, robots.txt.

2017-07-02 15:09:26 +01:00

Shell-Completion.md

docs: address review comments on platform pages

2026-07-19 09:01:13 -07:00

Support-Tiers.md

Add as-brew-user and support MDM deployment

2026-09-23 09:45:53 -05:00

Tap-Trust.md

Document Homebrew and MDM administration

2026-10-25 19:27:32 +00:00

Taps.md

Document Homebrew and MDM administration

2026-10-25 19:27:32 +00:00

Tips-and-Tricks.md

Keep API cache bodies and validators consistent

2026-10-17 13:21:00 +01:00

Troubleshooting.md

Prefer reliable installed download tools

2026-10-24 17:20:37 +01:00

Typechecking.md

docs/Typechecking: note that some RBI files are handwritten

2026-07-20 12:40:19 -07:00

Updating-Software-in-Homebrew.md

Fix typos, grammar and Cachable module name

2026-09-13 19:31:21 -05:00

Versions.md

Document Homebrew and MDM administration

2026-10-25 19:27:32 +00:00

Working-with-Homebrew-as-an-Upstream-Project.md

docs: clarify upstream expectations

2026-04-26 12:39:01 +01:00

Xcode.md

Stop inferring Xcode versions from clang

2026-10-06 10:19:24 -07:00

README.md

last_review_date

last_review_date
2026-06-08

Homebrew Documentation

These are the source files for the Homebrew documentation site.

A GitHub Action is run to validate each change before the site is deployed to GitHub Pages.

Usage

Open https://docs.brew.sh in your web browser.

To instead generate the site locally, available on http://localhost:4000, run:

cd $(brew --repository)/docs
brew bundle --install exec -- bundle install
bin/jekyll serve