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

# Common Issues for Core Contributors

## 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:
* `git reset --hard <SHA>` in homebrew/core to reset to the commit before before all the commits created by `brew pr-pull`.
* `brew pr-pull <options>` to upload the right bottles. Add the `--warn-on-upload-failure` flag 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/master` 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` flag to the linker and can be
fixed like [this](https://github.com/Homebrew/homebrew-core/commit/c4ad981d788b21a406a6efe7748f2922986919a8).
Import docs from wiki. Closes Homebrew/homebrew#33211. 2014-10-26 14:54:36 +00:00			`# Common Issues for Core Contributors`

			`## 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:`
			* `git reset --hard <SHA>` in homebrew/core to reset to the commit before before all the commits created by `brew pr-pull`.
			* `brew pr-pull <options>` to upload the right bottles. Add the `--warn-on-upload-failure` flag 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/master` to return to the latest commit and discard the commits made by `brew pr-pull`.

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.`

Common-Issues-for-Core-Contributors: update link 2016-09-14 17:33:30 +01:00			This can be caused by passing the obsolete `-s` flag to the linker and can be
docs: update some legacy-homebrew commit URLs. Use the nice homebrew-core ones instead. 2019-01-21 14:31:41 +00:00			`fixed like [this](https://github.com/Homebrew/homebrew-core/commit/c4ad981d788b21a406a6efe7748f2922986919a8).`