Switching a Working Copy

To update the working copy to a different URL use the Switch option ( Modify->Switch (Alt+S) ). This option updates your working copy to mirror a new URL—usually a URL which shares a common ancestor with your working copy, although not necessarily. This is the subversion way to move a working copy to a new branch.

After "switching" to the branch, your working copy is no different than what you would get from doing a fresh checkout of the directory. It is usually more efficient to use this command, because often branches only differ by a small degree. The server sends only the minimal set of changes necessary to make your working copy reflect the branch directory. The Switch dialog provides the following fields:

URL

The URL against which the working copy will be updated.

Revision

Select the radio button and enter a value equal to a revision number. KEYWORDS are supported:

HEAD

The latest revision in the repository.

BASE

The "pristine" revision of an item in a working copy.

COMMITTED

The last revision in which an item changed before (or at) BASE.

PREV

The revision just before the last revision in which an item changed. (Technically, COMMITTED - 1.)

Date

Select the radio button and enter a value equal to a revision date or time. Specify date or time using any of the following syntax:

  • 2004-02-17

  • 15:30

  • 15:30:00.200000

  • 2004-02-17 15:30

  • 2004-02-17 15:30 +0230

  • 2004-02-17T15:30

  • 2004-02-17T15:30Z

  • 2004-02-17T15:30-04:00

  • 20040217T1530

  • 20040217T1530Z

  • 20040217T1530-0500

Tag

Use to specify the folder name in the tag folder of the repository against which to update the working copy.

Branch

Use to specify the folder name in the branch folder of the repository against which to update the working copy.

Trunk

Use to specify the folder name in the trunk folder of the repository against which to update the working copy.

Change URL

Changes the path of a selected item in the URL field to point to the Tag, Branch, or Trunk folder name in the repository.

Non-recursive

Operate on single directory only.