mirrors/brew
1
0
Fork 0
mirror of https://github.com/Homebrew/brew.git synced 2025-07-14 16:09:03 +08:00
Code Issues Packages Projects Releases Wiki Activity
brew/docs/Troubleshooting.md
Mike McQuaid 710859e300
Update Linuxbrew references to Homebrew on Linux 
This is a clearer branding for us to use.

Also, as part of testing this, make some fixes to Jekyll in the docs folder.

Fixes #5835
2019-03-12 20:13:38 +00:00

2.0 KiB
Raw Blame History

Troubleshooting

Run brew update twice and brew doctor (and fix all the warnings) before creating an issue!

This document will help you check for common issues and make sure your issue has not already been reported.

Check for common issues

Check to see if the issue has been reported

Create an issue

If your problem hasn't been solved or reported, then create an issue:

  1. Upload debugging information to a Gist:
  • If you had a formula-related problem: run brew gist-logs <formula> (where <formula> is the name of the formula).
  • If you encountered a non-formula problem: upload the output of brew config and brew doctor to a new Gist.
  1. Create a new issue on the Homebrew/homebrew-core issue tracker or Homebrew/linuxbrew-core issue tracker
  • Give your issue a descriptive title which includes the formula name (if applicable) and the version of macOS or Linux you are using. For example, if a formula fails to build, title your issue "<formula> failed to build on <10.x>", where "<formula>" is the name of the formula that failed to build, and "<10.x>" is the version of macOS or Linux you are using.
  • Include the URL output by brew gist-logs <formula> (if applicable).
  • Include links to any additional Gists you may have created (such as for the output of brew config and brew doctor).