RFR: 8340804: doc/building.md update Xcode instructions to note that full install is required

[George Adams]

On Tue, 24 Sep 2024 12:53:08 GMT, Erik Joelsson <erikj at openjdk.org> wrote:

>> Since JDK17 there has been a dependency on metal in the macOS builds which is only available as part of the full Xcode IDE (rather than command-line tools). We currently recommend only installing the command-line tools in the building.md doc which is incorrect.
>> 
>> See https://github.com/openjdk/jdk/blob/e1c4d3039f6b5106ce3f65d50f607eacc2a8d168/make/autoconf/toolchain.m4#L681
>
> doc/building.html line 618:
> 
>> 616: <p>The oldest supported version of Xcode is 13.0.</p>
>> 617: <p>You will need to download Xcode either from the App Store or specific
>> 618: versions can be easily located via <a href="https://xcodereleases.com">https://xcodereleases.com</a>.</p>
> 
> If I run `make update-build-docs`, that does not turn into a link tag. Did you hand edit the html or convert it automatically?
> 
> Suggestion:
> 
> versions can be easily located via https://xcodereleases.com.</p>

sorry I manually make it a link tag, that's incorrect, I'll fix it now.

-------------

PR Review Comment: https://git.openjdk.org/jdk/pull/21154#discussion_r1773291033