Mercurial: Committing Changes to the Repository

See Also

Once your working copies of version-controlled files have been edited, you can then place changes into the repository using the Mercurial Commit action. If you have an issue tracker set up with your repository, the commit dialog box lets you associate your commit action with an existing issue.

To commit changes in local files to the repository:

  1. Select a version-controlled file or folder (e.g. from the Projects, Files, or Favorites window) and choose Mercurial > Commit from the right-click menu. The Commit Dialog opens, listing all files that contain local changes. If the files you want to commit do not already exist in the repository, the commit action will add them.
  2. Enter a commit message in the Commit Message text area, indicating the purpose of the commit.
  3. Click Commit. The IDE executes the commit and sends your local changes to the repository. You can also view files being commited to the repository from the Output window (Ctrl-4).

Updating Issues

You can update an issue by associating your commit action with an existing issue in your repository's issue tracker. To do so, click on the Update Issue heading in the Commit dialog box to expand it, then specify the following:

You can also specify the following options:

Ignoring Files

If your local working directory includes files or directories that you do not want to place under version control, you can set the IDE to ignore them permanantly using the Ignore command.

To ignore local files in your working directory:

  1. Select the file or directory you wish to ignore from the Projects, Files, Favorites, or Status window.
  2. Choose Ignore (or Mercurial > Ignore) from the right-click menu of selected file or directory. The IDE ignores the file or directory whenever Mercurial commands are called on it or on the directory within which it is stored.
See Also
Cloning an External Mercurial Repository
Comparing File Revisions
About Issue Trackers
Adding an Issue Tracker

Legal Notices