IntelliJ IDEA 14.0.0 Web Help

Switch Working Directory Dialog

VCS | Mercurial | Update to

Use this dialog box to update the current working directory to a named branch, light-weight branch (bookmark), or a specific changeset identified by a tag, hash, or revision number.

By default, Mercurial requires that before update the current working directory should be clean, that is, it should not contain any uncommitted changes. Otherwise the update operation fails and IntelliJ IDEA shows the corresponding error message. The message also recommends that you clean the current working directory by running the hg update <target branch, bookmark, or changeset> -C to discard the uncommitted changes.

Item Description
Repository From this drop-down list, choose the repository to run the update in. The contents of the Branch, Tag, and Bookmark drop-down lists are updated to show the branches, tags, and bookmarks that are available in the selected repository.
Switch to In this area, choose the branch, bookmark, or changeset to switch to.
  • Branch: choose this option to switch to another line of development identified by a branch name and update to the branch head. Choose the desired branch from the drop-down list which shows all the named branches available in the current repository.
  • Tag: choose this option to update to a changeset to which you have previously assigned a tag identifier. Choose the relevant tag from the drop-down list.

    The list shows both local tags (from .hg/localtags) and global tags (from .hgtags).

  • Bookmark: choose this option to switch to another line of development which is identified by a bookmark and update to its head. Choose the relevant bookmark from the drop-down list which shows all the available light-weight branches in the current repository.
  • Revision: choose this option to update to a specific changeset identified by its hash or revision number. In the text box, type the relevant revision number or paste the hash. To copy a hash, open the Log tab of the Changes tool window, select the relevant branch and revision, and then choose Copy Hash on the context menu of the selection.
Overwrite locally modified files (no backup) If you are going to update to another branch, bookmark, or changeset and you have any uncommitted changes in the current line of development, technically there can be two ways to treat them. The uncommitted changes can be either committed before update or abandoned (cleaned).

By default, Mercurial requires that before update the current working directory should be clean, that is, it should not contain any uncommitted changes. Otherwise the update operation fails and IntelliJ IDEA shows the corresponding error message. The message also recommends that you clean the current working directory by running the hg update <target branch, bookmark, or changeset> -C to discard the uncommitted changes. Use the Overwrite locally modified files (no backup) check box to prevent failures during update when the current working copy is not clean.

  • Select the check box to abandon any uncommitted local changes.
  • Clear the check box if you are sure that the current working directory is clean.

See Also

Last modified: 12 November 2014
comments powered by Disqus