With the Mercurial integration enabled, you can perform basic Mercurial operations from inside WebStorm.
The information provided in the topics listed below assumes that you are familiar with the basics of Mercurial version control system.
In this section:
- Using Mercurial Integration
- Adding Files to a Local Mercurial Repository
- Setting up a Local Mercurial Repository
- Managing Mercurial Branches and Bookmarks
- Switching Between Working Directories
- Pulling Changes from the Upstream (Pull)
- Pushing Changes to the Upstream (Push)
- Tagging Changesets
- Mercurial is installed on your computer.
The location of the Mercurial executable file is correctly specified on the Mercurial page
of the Settings
If you followed the standard installation procedure, the default location is /opt/local/bin or /usr/local/bin for Linux and Mac OS and /Program Files/Mercurial for Windows.
It is recommended that you add the path to the Mercurial executable file to the PATH variable. In this case, you can specify only the executable name, the full path to the executable location is not required. For more information about environment variables, see Path Variables.
- Mercurial integration is enabled for the current project root or directory.
If you want to use a remote repository, create a Mercurial hosting account first. You can access the remote repository through a pair of ssh keys or apply the username/password and keyboard interactive authentication methods supported by the Mercurial integration.
- When the Mercurial integration with WebStorm is enabled, the item appears on the menu, and on the context menus of the Editor and Project views.
- The files in the folders under the Mercurial control are highlighted according to their status. See File Status Highlights for file status highlighting conventions.
- Results of modifications show in the Changes tool window.
- When using the Mercurial integration, it is helpful to open the Version Control tool window.
Its Console tab displays the following data:
- All the commands generated based on the settings you specify through the WebStorm user interface.
- Information messages concerning the results of executing generated Mercurial commands.
- Error messages.