brew/docs/Xcode.md

# Xcode
## Supported Xcode Versions
Homebrew supports and recommends the latest Xcode and/or Command Line
Tools available for your platform:

 macOS  | Xcode | Command Line Tools
 ----- | ----- | ----------------------------
 10.6  | 3.2.6 | N/A
 10.7  | 4.6.3 | April 2013
 10.8  | 5.1.1 | April 2014
 10.9  | 6.2   | 6.2
 10.10 | 7.2.1 | 7.2
 10.11 | 8.0   | 7.3
 10.12 | 8.0   | 8.0


## Compiler Version Database

 Xcode     | GCC 4.0     | GCC 4.2     | LLVM-GCC 4.2     | LLVM        | Clang           | LLVM (SVN)
 --------- | ----------- | ----------- | ---------------- | ----------- | --------------- | ----------
 2.5.0     | 5370        | —           | —                | —           | —               | —
 3.1.4     | 5493        | 5577        | 5555             | 2064.3      | —               | —
 3.2.0     | 5493        | 5646        | 5646             | 2118        | —               | —
 3.2.1     | 5493        | 5646        | 5646             | 2206        | —               | —
 3.2.2     | 5493        | 5659        | 5646             | 2207.5      | 1.0.2           | —
 3.2.3     | 5494        | 5664        | 5658             | 2326.10     | 1.5 (60)        | —
 3.2.4     | 5494        | 5664        | 5658             | 2326.10     | 1.5 (60)        | —
 3.2.5     | 5494        | 5664        | 5658             | 2333.4      | 1.6 (70)        | —
 3.2.6     | 5494        | 5666        | 5658             | 2335.6      | 1.7 (77)        | 2.9
 4.0.0     | 5494        | 5666        | 5658             | 2335.9      | 2.0 (137)       | 2.9
 4.0.2     | 5494        | 5666        | 5658             | 2335.9      | 2.0 (137)       | 2.9
 4.1.0     | —           | 5666        | 5658             | 2335.15.00  | 2.1 (163.7.1)   | 3.0
 4.2.0     | —           | —           | 5658             | 2336.1.00   | 3.0 (211.10.1)  | 3.0
 4.3.0     | —           | —           | 5658             | 2336.9.00   | 3.1 (318.0.45)  | 3.1
 4.3.1     | —           | —           | 5658             | 2336.9.00   | 3.1 (318.0.54)  | 3.1
 4.3.2     | —           | —           | 5658             | 2336.9.00   | 3.1 (318.0.58)  | 3.1
 4.3.3     | —           | —           | 5658             | 2336.9.00   | 3.1 (318.0.61)  | 3.1
 4.4.0     | —           | —           | 5658             | 2336.11.00  | 4.0 (421.0.57)  | 3.1
 4.4.1     | —           | —           | 5658             | 2336.11.00  | 4.0 (421.0.60)  | 3.1
 4.5.0     | —           | —           | 5658             | 2336.11.00  | 4.1 (421.11.65) | 3.1
 4.5.1     | —           | —           | 5658             | 2336.11.00  | 4.1 (421.11.66) | 3.1
 4.5.2     | —           | —           | 5658             | 2336.11.00  | 4.1 (421.11.66) | 3.1
 4.6.0     | —           | —           | 5658             | 2336.11.00  | 4.2 (425.0.24)  | 3.2
 4.6.1     | —           | —           | 5658             | 2336.11.00  | 4.2 (425.0.27)  | 3.2
 4.6.2     | —           | —           | 5658             | 2336.11.00  | 4.2 (425.0.28)  | 3.2
 4.6.3     | —           | —           | 5658             | 2336.11.00  | 4.2 (425.0.28)  | 3.2
 5.0.0     | —           | —           | —                | —           | 5.0 (500.2.76)  | 3.3
 5.0.1     | —           | —           | —                | —           | 5.0 (500.2.78)  | 3.3
 5.0.1     | —           | —           | —                | —           | 5.0 (500.2.79)  | 3.3
 5.1       | —           | —           | —                | —           | 5.1 (503.0.38)  | 3.4
 5.1.1     | —           | —           | —                | —           | 5.1 (503.0.40)  | 3.4
 6.0       | —           | —           | —                | —           | 6.0 (600.0.51)  | 3.5
 6.0.1     | —           | —           | —                | —           | 6.0 (600.0.51)  | 3.5
 6.1       | —           | —           | —                | —           | 6.0 (600.0.54)  | 3.5
 6.2       | —           | —           | —                | —           | 6.0 (600.0.57)  | 3.5
 6.3       | —           | —           | —                | —           | 6.1 (602.0.49)  | 3.6
 6.3.1     | —           | —           | —                | —           | 6.1 (602.0.49)  | 3.6
 6.3.2     | —           | —           | —                | —           | 6.1 (602.0.53)  | 3.6
 6.4       | —           | —           | —                | —           | 6.1 (602.0.53)  | 3.6
 7.0       | —           | —           | —                | —           | 7.0 (700.0.72)  | -
 7.0.1     | —           | —           | —                | —           | 7.0 (700.0.72)  | -
 7.1       | —           | —           | —                | —           | 7.0 (700.1.76)  | -
 7.1.1     | —           | —           | —                | —           | 7.0 (700.1.76)  | -
 7.2       | —           | —           | —                | —           | 7.0 (700.1.81)  | -
 7.2.1     | —           | —           | —                | —           | 7.0 (700.1.81)  | -
 7.3       | —           | —           | —                | —           | 7.3 (703.0.29)  | -
 7.3.1     | —           | —           | —                | —           | 7.3 (703.0.31)  | -
 8.0       | —           | —           | —                | —           | 8.0 (800.0.38)  | -

## References to Xcode and compiler versions in code
When a new Xcode release is made, the following things need to be
updated:

* `MacOS::Xcode.latest_version`
* `MacOS::CLT.latest_version`
* `MacOS::STANDARD_COMPILERS`
* `MacOS::Xcode.version fallback logic`
* ensure compiler version Regexps continue to work (`MacOS` module)