Updating a Working Copy

Updating the Selection

To update individual items in a working copy to their latest revisions:

  1. Select one or more items in the working copy. Use the Cmd key to select multiple items. The Shift (⇧) key can be used to select ranges of items.

  2. Select Working Copy > Update to Latest Revision (key equivalent ⌘U) to pull the items’ latest revisions from the repository to the working copy.

    Alternatively, select Update to Latest Revision from the items’ right-click menu or click the Update button in the toolbar:

Updating the Entire Working Copy

To update the entire working copy to the latest revision in the repository:

  1. Select the working copy in the source list.

  2. Select Working Copy > Update to Latest Revision.

    Alternatively, select Update to Latest Revision from the working copy’s action menu (or right-click menu).

The Working Copy menu also contains an alternate item to force update of the entire working copy regardless of the selection and active view.

Access this alternate menu item (Working Copy > Update All to Latest Revision, key equivalent ⌥⌘U) by pulling fown the Working Copy menu and then pressing the Option button.

The alternate menu item can also be accessed by holding down the Option key while pressing the Update toolbar item.

See Alternate Menu Functions for more information on Cornerstone’s alternate menu functions.

Updating to a Specific Revision

Update the selected items to a specific revision or date by performing the following steps:

  1. Select the items to update in the working copy browser.
  2. Select Working Copy > Update… (key equivalent ⇧⌘U).
  3. Use the Revision field to specify the revision to update to.
  4. Click the Update button.

Updating Externals

By default, updating your working copy will also update any referenced externals. This may not be appropriate for working copies with externals which change infrequently or which contain a large number of externals.

To perform a single update without including externals:

  1. Select the working copy in the source list.
  2. Select Working Copy > Update... (key equivalent ⇧⌘U).
  3. Uncheck Update contents of externals.
  4. Click the Update button.

You can also control whether externals are included in update operations using the Update contents of externals option in the Working Copy section of the inspector.

Your working copy may depend on a particular version of an external to function or build correctly. If you do not include externals by default in your updates then you can introduce inconsistencies into your project.

Exercise care when disabling Update contents of externals. Be sure to monitor the changes made to your project’s external dependencies and manually update your working copy’s externals as necessary.

Extending a Sparse Working Copy

A sparse working copy does not contain all items present in the repository. Instead, the user elects to only check out portions of the folder in the repository as needed.

To extend a working copy with previously-excluded files and sub-folders:

  1. Select the folders in the working copy you wish to update.
  2. Select Working Copy > Update… (key equivalent ⇧⌘U).
  3. Select the required depth from the Depth popup menu.
  4. Check Permanently extend folder to this depth.
  5. Click the Update button.