brew/docs/Custom-GCC-and-cross-compilers.md

# Custom GCC and Cross Compilers

Homebrew depends on having an up-to-date version of Xcode because it comes with
specific versions of build tools, e.g. `clang`.

Installing a custom version of GCC or `autotools` into the `PATH` has the
potential to break lots of compiles so we prefer the Apple- or Homebrew-provided
compilers.

Cross-compilers based on GCC will typically be "keg-only" and therefore not
linked into the path by default.

Rather than merging in brews for either of these cases at this time, we're
listing them on this page. If you come up with a formula for a new version of
GCC or cross-compiler suite, please link it in here.

- Homebrew provides a `gcc` formula for use with Xcode 4.2+ or when needing
  C++11 support on earlier versions.
- Homebrew provides older GCC formulae, e.g. `gcc@7`
- Homebrew provides the LLVM Clang, which is bundled with the `llvm` formula.
- [RISC-V](https://github.com/riscv/homebrew-riscv) provides the RISC-V
  toolchain including binutils and GCC.
Cleanup documentation site GitHub now nicely generates a documentation site for us at http://brew.sh/brew based on our docs folder. Optimise the output of this and the GitHub docs directory for readability and the various user groupings. 2017-01-04 10:53:21 +00:00			`# Custom GCC and Cross Compilers`
docs: fix titles on docs.brew.sh 2017-01-04 16:16:00 -06:00
Custom-GCC-and-cross-compilers: wrap to ~80 characters 2016-09-14 17:38:51 +01:00			`Homebrew depends on having an up-to-date version of Xcode because it comes with`
docs: grammar edits, sentence-case secondary headings Also changes some heading levels so only one primary heading appears per page. 2017-03-18 17:45:12 -04:00			specific versions of build tools, e.g. `clang`.
Import docs from wiki. Closes Homebrew/homebrew#33211. 2014-10-26 14:54:36 +00:00
docs: code example reformatting Add labeled fences to most code blocks, monospace terms where appropriate, omit "$" when referring to variables 2017-03-25 22:53:33 -04:00			Installing a custom version of GCC or `autotools` into the `PATH` has the
docs: grammar edits, sentence-case secondary headings Also changes some heading levels so only one primary heading appears per page. 2017-03-18 17:45:12 -04:00			`potential to break lots of compiles so we prefer the Apple- or Homebrew-provided`
Custom-GCC-and-cross-compilers: wrap to ~80 characters 2016-09-14 17:38:51 +01:00			`compilers.`
Import docs from wiki. Closes Homebrew/homebrew#33211. 2014-10-26 14:54:36 +00:00
Custom-GCC-and-cross-compilers: wrap to ~80 characters 2016-09-14 17:38:51 +01:00			`Cross-compilers based on GCC will typically be "keg-only" and therefore not`
			`linked into the path by default.`
Import docs from wiki. Closes Homebrew/homebrew#33211. 2014-10-26 14:54:36 +00:00
Custom-GCC-and-cross-compilers: wrap to ~80 characters 2016-09-14 17:38:51 +01:00			`Rather than merging in brews for either of these cases at this time, we're`
			`listing them on this page. If you come up with a formula for a new version of`
			`GCC or cross-compiler suite, please link it in here.`
Import docs from wiki. Closes Homebrew/homebrew#33211. 2014-10-26 14:54:36 +00:00
Update documentation and generate manpage * update references in `--cc` flag, using modern gcc examples * note that issues should not be filed if `--cc` flag is used * remove reference to `HOMEBREW_CC` as it should not be exposed to users * generate manpages using `brew man` with these changes 2018-07-05 17:25:19 -04:00			- Homebrew provides a `gcc` formula for use with Xcode 4.2+ or when needing
Update manpages using man brew Properly update man pages using the local brew executable (from the repo), and copy the man pages to the repo. 2018-07-01 18:47:13 -04:00			`C++11 support on earlier versions.`
Update deprecations - Add some `odeprecated` - Make some `odeprecated` now `odisabled` - Remove `odisabled` code. - Remove old update migrations - Remove GCC 4.0 compiler - Remove Tiger-only code - Remove 32-bit-only code - Remove use of LD64 - Remove GCC 4.3 - 4.8 support. 2019-01-08 19:13:46 +00:00			- Homebrew provides older GCC formulae, e.g. `gcc@7`
Various documentation edits Mostly edits to formatting, grammar, wording for consistency & readability. 2018-10-05 17:23:22 -04:00			- Homebrew provides the LLVM Clang, which is bundled with the `llvm` formula.
Update documentation and generate manpage * update references in `--cc` flag, using modern gcc examples * note that issues should not be filed if `--cc` flag is used * remove reference to `HOMEBREW_CC` as it should not be exposed to users * generate manpages using `brew man` with these changes 2018-07-05 17:25:19 -04:00			`- [RISC-V](https://github.com/riscv/homebrew-riscv) provides the RISC-V`
			`toolchain including binutils and GCC.`