Re: the neverending docs download story
Re: the neverending docs download story
- Subject: Re: the neverending docs download story
- From: Ronald Hayden <email@hidden>
- Date: Sat, 12 Jul 2008 21:44:45 -0700
Is this a bug?
If the Core Reference doc set updates each time you start up Xcode,
it's a bug -- it should update to the latest, and then not update
until our next monthly update. If this occurs again, please do file a
bug; I haven't gotten any previous reports of this.
Note that, at this time, we don't do incremental downloads, so if
Xcode is quit before the doc set install is done, it will redownload
the entire package the next time it checks. (Bugs have already been
filed requesting incremental downloads.)
Why can't the original 1 GB download include the complete current
documentation?
There are a couple of policies behind this:
1) A desire to cut down the size of the SDK package. To minimize the
initial download of the SDK, we install minimal documentation, and
then later update based on whatever documentation you have installed.
In this way, if you aren't a WebObjects or Java programmer, you don't
spend any time downloading that doc.
2) The ability to provide accurate docs and working sample code at
release. Especially for a project with as much rapid turnaround as
the iPhone, we can't always qualify all the sample code at the time
the final SDK package is built, so by installing minimal docs and then
doing an update on the day the release goes out, we get several more
days to qualify sample code, put together accurate release notes, etc.
I understand how this can be annoying. However, if we stopped doing
it, then most likely we'd just increase the amount of time you spent
downloading stuff. In particular, we'd most likely determine that
we'd have to fix some sample code or API doc based on the latest
release and push out an update, which would mean that you'd have
downloaded all the docs with the SDK and then immediately downloaded a
doc update.
-- Ron
On Jul 12, 2008, at 3:42 PM, Matt Neuburg wrote:
I downloaded Xcode 3.1. This was a 1 GB download, of which about 400
MB is
the core reference doc set.
So once everything was installed, I started up Xcode, and started
reading
the documentation. As I did so, I noticed that it was downloading
300 MB
*more* for the core reference doc set.
When that had installed itself, I quit Xcode. I later started Xcode up
against and read some more documentation. Meanwhile, it was
downloading 500
MB **more** for the core reference doc set.
Is this a bug? Will it ever end? Why can't the original 1 GB download
include the complete current documentation? Or if it does, what's
all this
additional downloading?
Thx - m.
--
matt neuburg, phd = email@hidden, <http://www.tidbits.com/matt/>
A fool + a tool + an autorelease pool = cool!
One of the 2007 MacTech Top 25: <http://tinyurl.com/2rh4pf>
AppleScript: the Definitive Guide - Second Edition!
<http://www.amazon.com/gp/product/0596102119>
_______________________________________________
Do not post admin requests to the list. They will be ignored.
Xcode-users mailing list (email@hidden)
Help/Unsubscribe/Update your Subscription:
This email sent to email@hidden
_______________________________________________
Do not post admin requests to the list. They will be ignored.
Xcode-users mailing list (email@hidden)
Help/Unsubscribe/Update your Subscription:
This email sent to email@hidden