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:

* 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 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:`
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
docs/Common-Issues-for-Core-Contributors: add steps to fix failed bottle publish 2020-07-01 10:31:56 -04:00			* `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.`

CI: add docs.yml With fixes for Markdown syntax to allow tests to pass. 2022-11-19 17:06:01 -05:00			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).