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. Expand the Additional Options section of the displayed sheet using the disclosure button.
  4. Uncheck Update contents of externals.
  5. Click the Update button.

You can also control whether externals are included in update operations using the Include Externals in Updates option in the Working Copy menu. This option is on by default, but you can disable it as follows:

  1. Pull down the Working Copy menu.
  2. Uncheck the Include Externals in Updates menu item.

With this option disabled, Update to Latest Revision will no longer include externals in the update. In addition, the Update contents of externals option in the Update... sheet will not be set by default.

The Include Externals in Updates option can be set individually for each working copy.

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 Include Externals in Updates. 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

Subversion 1.5 introduced the concept of a sparse working copy (or sparse check out). 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. Expand the displayed sheet by clicking on the disclosure button () labeled Additional Options.
  4. Select the required depth from the Depth popup menu.
  5. Check Permanently extend folder to this depth.
  6. Click the Update button.

Sparse check outs are only available when checking out 1.5 format working copies.