IntelliJ IDEA 2021.3 Help

Add files to a local Mercurial repository

After a Mercurial repository for a project is initialized, you need to add the project data to it:

  • If you have specified Mercurial as the version control system for your project in the Settings dialog, IntelliJ IDEA suggests to put each new file under Mercurial control during the file creation.

  • You can add all unversioned files to Mercurial control or select files to add.

To add all currently unversioned files to Mercurial control

  1. Open the Commit tool window Alt+0

  2. Navigate to the Unversioned Files node and choose Add to VCS from the context menu.

To add specific file(s) to a local Mercurial repository, do one of the following:

  • Switch to the Commit tool window Alt+0, expand the Unversioned Files node, and select the files to be added. From the context menu, choose Add to VCS.

To specify the commit options

  • If you need to perform pre-commit checks, upload files to a server after the commit, or commit with advanced options, click the Gear icon:

    advanced commit options popup
    • In the Before Commit area, select the actions you want IntelliJ IDEA to perform before committing the selected files to the local repository.

      The following options are available:

      • Reformat code: perform code formatting according to the Project Code Style settings.

      • Rearrange code: rearrange your code according to the arrangement rules preferences.

      • Optimize imports: remove redundant import statements.

      • Analyze code: analyze modified files before committing them. Click Choose profile to select an inspection profile from which the IDE will run inspections.

      • Check TODO (<filter name>): Review the TODO items matching the specified filter. Click Configure to choose an existing TODO filter, or open the TODO settings page and define a new filter to be applied.

      • Cleanup: batch-apply quick-fixes from code cleanup inspections. Click Choose profile to select a profile from which the IDE will run inspections.

      • Run Tests: run tests as pre-commit checks. Click Choose configuration near Run Tests and select which configuration you want to run.

      • Update copyright: add or update a copyright notice according to the selected copyright profile - scope combination.

    • In the After Commit area, you can select the server access configuration or a server group to use for uploading the committed files to a local or remote host, a mounted disk, or a directory. See Deploy your application for details.

      The following options are available:

      • Run tool: select the external tool that you want IntelliJ IDEA to launch after the selected changes have been committed. You can select a tool from the list, or click the Browse button the Browse button and configure an external tool in the External Tools dialog that opens.

      • Upload files to: select the server access configuration or a server group to use for uploading the committed files to a local or remote host, a mounted disk, or a directory.

        • To suppress uploading, choose None.

        • To add a server configuration to the list, click the Browse button and fill in the required fields in the Add Server dialog that opens.

        The list is only available if the FTP/SFTP Connectivity plugin is enabled.

      • Always use selected server or group of servers: always upload files to the selected server or a server group.

        The checkbox is only available if the FTP/SFTP Connectivity plugin is enabled.

  • Switch to the Project tool window and select the files to be added. From the context menu, choose Mercurial | Add to VCS.

Last modified: 01 August 2022