brew/docs/Common-Issues-for-Core-Contributors.md

---
last_review_date: "1970-01-01"
---

# Common Issues for Maintainers

## Overview

This is a page for maintainers to diagnose certain build errors.

## Issues

### Bottle publishes failed but the commits are correct in the git history

Follow these steps to fix this issue:

* Download and extract the bottle artifact.
* `brew pr-upload --no-commit` in the bottle directory.

Alternative instructions using `pr-pull`:

* `git reset --hard <SHA>` in `homebrew/core` to reset to the commit before all the commits created by `brew pr-pull`.
* `brew pr-pull <options>` to upload the right bottles. Add the `--warn-on-upload-failure` switch if the bottles have been partially uploaded and you're certain that the bottle checksums will match the checksums already present in the `bottle do` block of the formula.
* `git reset --hard origin/HEAD` to return to the latest commit and discard the commits made by `brew pr-pull`.

### `ld: internal error: atom not found in symbolIndex(__ZN10SQInstance3GetERK11SQObjectPtrRS0_) for architecture x86_64`

The exact atom may be different.

This can be caused by passing the obsolete `-s` option to the linker and can be fixed [using `inreplace`](https://github.com/Homebrew/homebrew-core/commit/c4ad981d788b21a406a6efe7748f2922986919a8).
Add a `last_reviewed_date` to docs metadata - At the AGM we formed an ad-hoc documentation working group. - One of our ideas was that we should have a last reviewed date for documentation, so that we can periodically implement a review mechanism (GitHub Actions posts to Slack for a regular documentation outdatedness check?) to track how old docs are and ensure they're still relevant. - This is a first step towards that goal, by adding a `last_review_date` to the metadata of all docs with a date of earlier than Homebrew's inception because everything needs reviewing so that we start from a good base! 2025-02-03 10:59:02 +00:00			`---`
			`last_review_date: "1970-01-01"`
			`---`

Maintainers docs: content & formatting updates 2022-11-30 19:39:21 -05:00			`# Common Issues for Maintainers`
Import docs from wiki. Closes Homebrew/homebrew#33211. 2014-10-26 14:54:36 +00:00
			`## Overview`

			`This is a page for maintainers to diagnose certain build errors.`

			`## Issues`

docs/Common-Issues-for-Core-Contributors: add steps to fix failed bottle publish 2020-07-01 10:31:56 -04:00			`### Bottle publishes failed but the commits are correct in the git history`

			`Follow these steps to fix this issue:`
CI: add docs.yml With fixes for Markdown syntax to allow tests to pass. 2022-11-19 17:06:01 -05:00
pr-upload: add --no-commit flag 2020-10-03 12:33:47 -04:00			`* Download and extract the bottle artifact.`
			* `brew pr-upload --no-commit` in the bottle directory.

			Alternative instructions using `pr-pull`:
CI: add docs.yml With fixes for Markdown syntax to allow tests to pass. 2022-11-19 17:06:01 -05:00
Maintainers docs: content & formatting updates 2022-11-30 19:39:21 -05:00			* `git reset --hard <SHA>` in `homebrew/core` to reset to the commit before all the commits created by `brew pr-pull`.
docs+rubydoc: various grammar/wording fixes 2023-09-08 14:46:15 -04:00			* `brew pr-pull <options>` to upload the right bottles. Add the `--warn-on-upload-failure` switch if the bottles have been partially uploaded and you're certain that the bottle checksums will match the checksums already present in the `bottle do` block of the formula.
Switch to using `main` as the default branch Homebrew/brew has moved to a `main` default branch so we can more move references from `master` to `main`. 2025-06-24 11:14:57 +01:00			* `git reset --hard origin/HEAD` to return to the latest commit and discard the commits made by `brew pr-pull`.
docs/Common-Issues-for-Core-Contributors: add steps to fix failed bottle publish 2020-07-01 10:31:56 -04:00
Import docs from wiki. Closes Homebrew/homebrew#33211. 2014-10-26 14:54:36 +00:00			### `ld: internal error: atom not found in symbolIndex(__ZN10SQInstance3GetERK11SQObjectPtrRS0_) for architecture x86_64`

			`The exact atom may be different.`

docs+rubydoc: various grammar/wording fixes 2023-09-08 14:46:15 -04:00			This can be caused by passing the obsolete `-s` option to the linker and can be fixed [using `inreplace`](https://github.com/Homebrew/homebrew-core/commit/c4ad981d788b21a406a6efe7748f2922986919a8).