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.
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.
