mirror of
https://github.com/Homebrew/brew.git
synced 2026-08-12 22:29:27 +04:00
Douglas Eichelberger
c84b9a7b97
Adds a `brew deadcode` dev-cmd that finds and removes dead code identified by Spoom, excluding test code so that definitions referenced only by their specs are also treated as dead. Definitions documented with `# @api public` or `# @api internal`, or defined with an `override` signature, are always kept, since Spoom cannot see their dynamic, subclass or cross-tap (e.g. homebrew-core) callers. Removes the dead code it identified, restoring false positives (dynamically dispatched diagnostic checks and cask stanza classes, TestRunnerFormula platform predicates, livecheck skip conditions, TopologicalHash tsort methods and YARD docstring plugin methods). homebrew-core-used helpers such as kernel_major_version, deny_network_access!, require_root and detected_python_shebang are restored and annotated `# @api internal`. Test-only cache resets are relocated into the specs that need them.
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