brew/docs/Xcode.md

# Xcode

## Supported Xcode versions
Homebrew supports and recommends the latest Xcode and/or Command Line
Tools available for your platform (see `OS::Mac::Xcode.latest_version` and `OS::Mac::CLT.latest_version` in [`Library/Homebrew/os/mac/xcode.rb`](https://github.com/Homebrew/brew/blob/master/Library/Homebrew/os/mac/xcode.rb)).

## Xcode compiler versions

See `OS::Mac::STANDARD_COMPILERS` in [`Library/Homebrew/os/mac.rb`](https://github.com/Homebrew/brew/blob/master/Library/Homebrew/os/mac.rb).

## Updating for new Xcode releases
When a new Xcode release is made, the following things need to be
updated:

* In [`Library/Homebrew/os/mac/xcode.rb`](https://github.com/Homebrew/brew/blob/master/Library/Homebrew/os/mac/xcode.rb)
  * `OS::Mac::Xcode.latest_version`
  * `OS::Mac::CLT.latest_version`
  * `OS::Mac::Xcode.detect_version_from_clang_version`
* In [`Library/Homebrew/os/mac.rb`](https://github.com/Homebrew/brew/blob/master/Library/Homebrew/os/mac.rb)
  * `OS::Mac::STANDARD_COMPILERS`
Import docs from wiki. Closes Homebrew/homebrew#33211. 2014-10-26 14:54:36 +00:00			`# Xcode`
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
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			`## Supported Xcode versions`
Import docs from wiki. Closes Homebrew/homebrew#33211. 2014-10-26 14:54:36 +00:00			`Homebrew supports and recommends the latest Xcode and/or Command Line`
Xcode 9.2 Update all the necessary versions but also cleanup some related indentation and point the `Xcode.md` document to the code rather than duplicating it there (which means it sometimes ends up outdated). 2017-12-08 14:59:15 +00:00			Tools available for your platform (see `OS::Mac::Xcode.latest_version` and `OS::Mac::CLT.latest_version` in [`Library/Homebrew/os/mac/xcode.rb`](https://github.com/Homebrew/brew/blob/master/Library/Homebrew/os/mac/xcode.rb)).
Import docs from wiki. Closes Homebrew/homebrew#33211. 2014-10-26 14:54:36 +00:00
Xcode 9.2 Update all the necessary versions but also cleanup some related indentation and point the `Xcode.md` document to the code rather than duplicating it there (which means it sometimes ends up outdated). 2017-12-08 14:59:15 +00:00			`## Xcode compiler versions`
Import docs from wiki. Closes Homebrew/homebrew#33211. 2014-10-26 14:54:36 +00:00
Xcode 9.2 Update all the necessary versions but also cleanup some related indentation and point the `Xcode.md` document to the code rather than duplicating it there (which means it sometimes ends up outdated). 2017-12-08 14:59:15 +00:00			See `OS::Mac::STANDARD_COMPILERS` in [`Library/Homebrew/os/mac.rb`](https://github.com/Homebrew/brew/blob/master/Library/Homebrew/os/mac.rb).
Import docs from wiki. Closes Homebrew/homebrew#33211. 2014-10-26 14:54:36 +00:00
Xcode 9.2 Update all the necessary versions but also cleanup some related indentation and point the `Xcode.md` document to the code rather than duplicating it there (which means it sometimes ends up outdated). 2017-12-08 14:59:15 +00:00			`## Updating for new Xcode releases`
Import docs from wiki. Closes Homebrew/homebrew#33211. 2014-10-26 14:54:36 +00:00			`When a new Xcode release is made, the following things need to be`
			`updated:`

Various documentation edits Mostly edits to formatting, grammar, wording for consistency & readability. 2018-10-05 17:23:22 -04:00			* In [`Library/Homebrew/os/mac/xcode.rb`](https://github.com/Homebrew/brew/blob/master/Library/Homebrew/os/mac/xcode.rb)
Xcode 9.2 Update all the necessary versions but also cleanup some related indentation and point the `Xcode.md` document to the code rather than duplicating it there (which means it sometimes ends up outdated). 2017-12-08 14:59:15 +00:00			* `OS::Mac::Xcode.latest_version`
			* `OS::Mac::CLT.latest_version`
			* `OS::Mac::Xcode.detect_version_from_clang_version`
Various documentation edits Mostly edits to formatting, grammar, wording for consistency & readability. 2018-10-05 17:23:22 -04:00			* In [`Library/Homebrew/os/mac.rb`](https://github.com/Homebrew/brew/blob/master/Library/Homebrew/os/mac.rb)
Xcode 9.2 Update all the necessary versions but also cleanup some related indentation and point the `Xcode.md` document to the code rather than duplicating it there (which means it sometimes ends up outdated). 2017-12-08 14:59:15 +00:00			* `OS::Mac::STANDARD_COMPILERS`