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/HEAD/Library/Homebrew/os/mac/xcode.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/HEAD/Library/Homebrew/os/mac/xcode.rb)
  * `OS::Mac::Xcode.latest_version`
  * `OS::Mac::CLT.latest_version`
  * `OS::Mac::Xcode.detect_version_from_clang_version`
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`
Refer to default branch in links with HEAD Anywhere we can use `blob/master` we can use `blob/HEAD` instead. This will make life easier if we ever rename our default branch in future (once/if Git and GitHub provides the necessary tooling to do so). 2020-06-25 11:20:57 +01: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/HEAD/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			`## 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:`

Refer to default branch in links with HEAD Anywhere we can use `blob/master` we can use `blob/HEAD` instead. This will make life easier if we ever rename our default branch in future (once/if Git and GitHub provides the necessary tooling to do so). 2020-06-25 11:20:57 +01:00			* In [`Library/Homebrew/os/mac/xcode.rb`](https://github.com/Homebrew/brew/blob/HEAD/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`