[39458] trunk/doc-new/guide/xml/installing.xml

[markd at macports.org]

>Date: Wed, 20 Aug 2008 12:56:20 -0700 (PDT)
>From: ryandesign at macports.org
>Subject: [39458] trunk/doc-new/guide/xml/installing.xml
>To: macports-changes at lists.macosforge.org
>Message-ID: <20080820195620.695922023D5 at beta.macosforge.org>
>Content-Type: text/plain; charset="utf-8"
>
>Revision: 39458
>          http://trac.macosforge.org/projects/macports/changeset/39458
>Author:   ryandesign at macports.org
>Date:     2008-08-20 12:56:20 -0700 (Wed, 20 Aug 2008)
>Log Message:
>-----------
>installing.xml: list the latest versions of Xcode
>
>Modified Paths:
>--------------
>    trunk/doc-new/guide/xml/installing.xml
>
>Modified: trunk/doc-new/guide/xml/installing.xml
>===================================================================
>--- trunk/doc-new/guide/xml/installing.xml      2008-08-20 19:54:19 UTC
>(rev 39457)
>+++ trunk/doc-new/guide/xml/installing.xml      2008-08-20 19:56:20 UTC
>(rev 39458)
>@@ -110,7 +110,10 @@
>         url="http://developer.apple.com/tools/xcode/">Xcode
>Tools</ulink> from
>         Apple's developer site?do not install it from a Mac OS X install
>disk
>         unless you've checked for the latest version on Apple's site;
>older
>-        versions of Xcode Tools often cause port install failures.</para>
>+        versions of Xcode Tools often cause port install failures. The
>latest
>+        versions at the time of this writing are Xcode 3.1 for Mac OS X
>10.5
>+        Leopard, Xcode 2.5 for Mac OS X 10.4 Tiger, and Xcode 1.5 for
>Mac OS X
>+        10.3 Panther.</para>
>       </listitem>

Hi Ryan,

Personally, I'd prefer directing users to the place where the latest Xcode
version is listed for the current OS (10.5) since it is a moving target. 
Otherwise we fix the guide in time more than absolutely necessary and
commit ourselves to updating the guide for Apple updates anywhere such
references are made.   Also, saying "at the time of writing" seems not to
help since there isn't a way to know what time that is for that particular
text snippet, so it almost invites putting the date in parenthesis.

I see that Apple's developer site now has a button named "Download Latest
Xcode"    http://developer.apple.com/tools/xcode/

So I favor something like I pasted below.  I can't even find Xcode 1.5 on
Apple's site (though it must be there somewhere), and since we don't
officially support 10.3 anymore I don't think anything needs to be said on
that.

---------------------
Download and install the latest version of Xcode Tools by clicking the
button "Download Latest Xcode" here:
(http://developer.apple.com/tools/xcode/).  Do not install Xcode Tools
from a Mac OS X install DVD unless you verify that you are installing the
latest version as listed on Apple's developer site; older versions often
cause port install failures.

If you are installing MacPorts on Mac OS X 10.4, download and install
Xcode 2.5
(http://connect.apple.com/cgi-bin/WebObjects/MemberSite.woa/wa/getSoftware?bundleID=19907)
---------------------

How does that seem?
>
Mark