Skip to content

mrcrowl/vscode-hg

Repository files navigation

Overview

Integrated Mercurial source control

Prerequisites

Note: This extension leverages your machine's Mercurial (hg) installation,
so you need to install Mercurial first.


Hg

Features

  • Add files and commit from the source control side-bar (i.e. where git normally appears).

  • All the basics: commit, add, forget, update, push and pull.

  • See changes inline within text editor.

  • Interactive log for basic file history and diff.

  • Branch, merge heads, merge with branch, resolve + unresolve files.

  • Quickly switch branches, push and pull via status bar.

  • Supports named-branches or bookmark workflows.

  • Automatic incoming/outgoing counters.

  • Undo/rollback.

  • Shelve/Unshelve support.

  • Purge support.

  • Rebase support.

  • Show annotation for current line or for whole file.

Feedback & Contributing

  • Please report any bugs, suggestions or documentation requests via the Github issues (yes, I see the irony).
  • Feel free to submit pull requests.

Initialize a new repo

Init a repo

  • Just click the Mercurial icon from the source control title area:

Update to a branch/tag/bookmark

Change branches

  • The current branch name is shown in the bottom-left corner.
  • Click it to see a list of branches and tags that you can update to.
  • When hg.useBookmarks is enabled, this changes to bookmarks.

Settings

hg.enabled { boolean }

  • Enables Hg as a source control manager in VS Code.

hg.useBookmarks { boolean }

hg.pushPullScope { all | current | default }

  • Specifies what to include in Push/Pull operations.
  • Depends on the choice of hg.useBookmarks.
  • For named-branches mode:   (i.e. hg.useBookmarks = false)
    "all" — all branches / unrestricted (this is the default)
    "current" — only includes changesets for the current branch
    "default" — only includes changesets for the default branch
  • For bookmarks mode:   (i.e. hg.useBookmarks = true)
    "all" — all bookmarks / unrestricted (this is the default)
    "current" — only includes changesets for the active bookmark
    "default" — only includes changesets for bookmarks on the default branch

hg.pushPullBranch DEPRECATED { all | current | default }

  • Use hg.pushPullScope instead.
  • Specifies which branch(es) should be included in Push/Pull operations.
  • Included only for backwards compatibility.

hg.autoUpdate { boolean }

  • Enables automatic update of working directory to branch/bookmark head after pulling (equivalent to hg pull --update)
    "true" — enabled
    "false" — disabled, manual update/merge required

hg.autoInOut { boolean }

  • Enables automatic counting of incoming/outgoing changes.
  • When enabled, these show in the status bar.
  • Updated every 3 minutes, or whenever a commit/push/pull is done.
  • Note: when hg.pushPullBranch is set to "current" or "default" then only the respective branch will be included in the counts.

hg.autoRefresh { boolean }

  • Enables automatic refreshing of Source Control tab and badge counter when files within the project change:
    "true" — enabled
    "false" — disabled, manual refresh still available.

hg.countBadge { tracked | all | off }

  • Controls the badge counter for Source Control in the activity bar:
    "tracked" — only count changes to tracked files (default).
    "all" — include untracked files in count.
    "off" — no badge counter.

hg.allowPushNewBranches { boolean }

  • Overrides the warning that normally occurs when a new branch is pushed:
    "true" — new branches are pushed without warning (default).
    "false" — shows a prompt when new branches are being pushed (e.g hg push --new-branch)

hg.path { string | null }

  • Specifies an explicit hg file path to use.
  • This should only be used if hg cannot be found automatically.
  • The default behaviour is to search for hg in commonly-known install locations and on the PATH.

hg.commandMode

  • Controls the method used to communicate with hg.
  • There is a slight start-up performance cost with repeatedly running hg commands.
  • Running a command server process in the background allows frequently-used commands to run ~10× faster (e.g. cat, status, summary, branch etc.)
  • The server feature is still expiremental, and is therefore not the default. "cli" — spawn a new hg process per command (default). "server" — run a command server process  i.e. hg serve --cmdserve

hg.lineAnnotationEnabled

  • Enables hg annotate decorations at end of the currently selected lines.

Acknowledgements

Core Maintainers

Other Contributions

ajansveld, hoffmael, nioh-wiki, joaomoreno, nsgundy, KristjanTammekivi, Marcelotsvaz, gd4Ark