The Switch action is useful when the repository location of a working
copy, or an already committed item in the working copy, must be changed within the same
repository. The action is available on the Tools menu when a versioned
resource is selected in the current working copy that is displayed in the Working
Copy view.
Note: External items cannot be switched using this action. Instead, change the
value of the svn:externals property set on the parent directory of the
external item and update the parent directory.
Figure: The Switch Dialog Box
The following options can be configured in the Switch dialog box:
- Switch to URL
- The
new location in the same repository to which you are switching.
Tip: You can switch to items that were deleted, moved, or replaced, by specifying the
original URL (before the item was removed) and use a
peg
revision at the end (for example,
URL@rev1234).
Note: For items that are already
switched that you want to switch back, the proposed URL is the
original location of the item.
- Revision
- The specific version of the location to which you are switching.
- Depth - (This option is applicable only for directories)
- Current depth - Obeys the depths registered for the directories
in the working copy that are to be switched.
- Recursive (infinity) - Switches the location of the selected
folder and all of its files and folders.
- Immediate children (immediates) - Switches the location of the
selected folder and its child files and folders without recursing subfolders.
- File children only (files) - Switches the location of the
selected folder and its child files.
- This folder only (empty) - Switches the location of the selected
folder (no child files or folders are included).
- Ignore "svn:externals" definitions
- When enabled, external items are ignored in the switch operation. This option is only
available if you choose the Current depth or Recursive
(infinity) depth.
- Change the working copy item to the specified depth
- Changes the sticky depth on the directory in the working copy.
- Ignore ancestry
- When disabled, the SVN system does not allow you to switch to a location that does not
share a common ancestry with the current location. If enabled, the SVN does not check for
a common ancestry.