• Open Menu Close Menu
  • Apple
  • Shopping Bag
  • Apple
  • Mac
  • iPad
  • iPhone
  • Watch
  • TV
  • Music
  • Support
  • Search apple.com
  • Shopping Bag

Lists

Open Menu Close Menu
  • Terms and Conditions
  • Lists hosted on this site
  • Email the Postmaster
  • Tips for posting to public mailing lists
Re: Which DocSets to Get?
[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: Which DocSets to Get?


  • Subject: Re: Which DocSets to Get?
  • From: Ronald Hayden <email@hidden>
  • Date: Mon, 21 Sep 2009 15:35:30 -0700

I realized I didn't really answer part of your question:

Do all the "newer" sets (e.g. 10.6 vs 10.5, iphone 3 vs 2.x, etc) include all legacy info

I focused on our definition of "legacy" -- but, yes, newer versions of doc sets always contain all the info in previous versions of the doc set, unless something has been determined to be no longer relevant to development, in which case it becomes a "legacy" document, treated as I described.


 -- Ron


On Sep 21, 2009, at 3:28 PM, Ronald Hayden wrote:

With Xcode 3.2, how does one determine which documentation sets should be downloaded?

By default, you should have any current documentation relevant to the installed SDKs.


If your preference is set to auto-download doc updates (which is the default for new users, but long-time users may have different settings), and you only need the current docs relevant to the SDKs you are using, you shouldn't have to do anything. The design of the doc system in Snow Leopard is to make it such that the typical Xcode user should never have to think about what docs they need or whether to update the docs -- the "right thing" should happen automatically.


Do all the "newer" sets (e.g. 10.6 vs 10.5, iphone 3 vs 2.x, etc) include all legacy info, or may there be important information excluded in these "newer" sets?

As of Snow Leopard, legacy docs are no longer part of the standard RefLibs, to address long-standing concerns of search results being cluttered with legacy docs. If you need the legacy OS X documentation, you can go into the Documentation pref pane and "Get" the OS X Legacy RefLib. At this time only the OS X docs have a legacy RefLib; in the future, as appropriate, we'll add Legacy doc sets for other platforms (web/iPhone).


Note that "Legacy" here refers to complete documents that have been consigned to legacy. Legacy API will still be reflected in the regular RefLib, in a separate file for the class, as has been the case for a few years.

There should be no "important" information in the Legacy RefLib, unless by mistake. If it's important to current development, it remains in the regular RefLib.

-- Ron


On Sep 21, 2009, at 3:07 PM, Keary Suska wrote:

With Xcode 3.2, how does one determine which documentation sets should be downloaded? Do all the "newer" sets (e.g. 10.6 vs 10.5, iphone 3 vs 2.x, etc) include all legacy info, or may there be important information excluded in these "newer" sets?

TIA,

Keary Suska
Esoteritech, Inc.
"Demystifying technology for your home or business"

_______________________________________________
Do not post admin requests to the list. They will be ignored.
Xcode-users mailing list (email@hidden)
Help/Unsubscribe/Update your Subscription:
@apple.com


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

_______________________________________________ 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
References: 
 >Which DocSets to Get? (From: Keary Suska <email@hidden>)
 >Re: Which DocSets to Get? (From: Ronald Hayden <email@hidden>)

  • Prev by Date: Re: Which DocSets to Get?
  • Next by Date: Re: Which DocSets to Get?
  • Previous by thread: Re: Which DocSets to Get?
  • Next by thread: Re: Which DocSets to Get?
  • Index(es):
    • Date
    • Thread