Re: Lost markers after Reference Library update
Re: Lost markers after Reference Library update
- Subject: Re: Lost markers after Reference Library update
- From: Ronald Hayden <email@hidden>
- Date: Mon, 31 Dec 2007 17:54:15 -0800
Could you please clarify what the current and near-future situation
is with regard to the availability of separately downloadable docset
updates? My various machines aren't always networked together.
Here is a summary of the doc set functionality; let me know if it
doesn't answer your question:
In the Documentation preferences, you'll find a set of default paths
that Xcode searches to find doc sets. The default set includes */
Library/Developer locations in your home directory, in the system
directories, and on the network. If for any reason you'd like Xcode
to search another location (perhaps a separate hard drive or
partition), you can add the location. On startup, Xcode searches
these directories and loads the latest version it finds of each doc
set. If you'd like multiple machines to use the same doc sets, you
can point them to the same location. They do need to have access
through the file system to the same location; we don't support loading
the doc sets from a web server or some such.
The doc set updates are controlled by an RSS feed. If there is a
later update to a doc set, you get the "Update" button that lets you
download the latest update; we only support downloading the latest
update, not any interim updates that you might have missed. If
multiple systems/copies of Xcode are pointed to a location, anyone who
has appropriate permissions can update the doc sets at that location.
Some tips that people might find helpful:
- If you would like to know where a particular doc set in Xcode is
located, you can use the context menu to "Get Info" on the doc set,
which will show the path and give a button to display the doc set in
the Finder. "Get Info" also shows the RSS feed URL and other
information.
- If there is a doc set showing in the feed you will never be
interested in and you haven't downloaded, you can use the delete key
to remove it from sight (if you have downloaded it, you'll need to
delete the doc set first, using the Finder or command-line). To
display all doc sets again, use the gear menu to "Show Hidden
Documentation Sets".
- If you are having trouble finding something, make sure the "All Doc
Sets" button is selected in the search bar.
- If you provide a framework for others in your department or company,
you can generate a doc set (Doxygen is probably the simplest way) and
make it available on the internal network or through an internal web
server. We've found this to be very useful for distributing draft and
internal documentation. For more information on how to set up an RSS
feed for yourself and such, see the Documentation Set Guide:
http://developer.apple.com/documentation/DeveloperTools/Conceptual/Documentation_Sets/
-- Ron
On Dec 31, 2007, at 3:54 PM, Jeff Johnson wrote:
On Dec 30, 2007, at 7:27 PM, Ronald Hayden wrote:
BTW for some of us running Xcode on multiple systems it seemed to
save time and make more sense to download the large doc updates
once, then update all local systems off the same download dmg....
In other words, I'm not sure the RSS system is progress. It also
takes away some control....
We have actually attempted to increase the flexibility of the
system here -- you can place doc sets in a central location on your
network and use the Xcode doc preferences to point to that
location. In this manner, you can have one set of updated doc sets
that are used by multiple systems.
Ron,
Could you please clarify what the current and near-future situation
is with regard to the availability of separately downloadable docset
updates? My various machines aren't always networked together.
-Jeff
_______________________________________________
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