brew/docs/Common-Issues-for-Core-Contributors.md
Issy Long 31d7bcc583
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 11:56:07 +00:00

1.3 KiB

last_review_date
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/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 option to the linker and can be fixed using inreplace.