Release Notes

Features and bugfixes in our latest releases. Please see the Download page for links to source and binaries.

Note that Mercurial follows a time-based release plan with major releases every three months and minor (bugfix) releases on the first of every month (see TimeBasedReleasePlan).

{i} Be sure to read the upgrade notes when upgrading.

(See the archive for older versions)

1. Mercurial 4.5 (2018-02-01)

1.1. New Features

1.1.1. revert --interactive

The revert command now accepts the flag --interactive to allow reverting only some of the changes to the specified files.

1.1.2. Accessing hidden changesets

Set config option 'experimental.directaccess = True' to access hidden changesets from read only commands.

1.1.3. githelp extension

The githelp extension provides the hg githelp command. This command attempts to convert a git command to its Mercurial equivalent. The extension can be useful to Git users new to Mercurial.

1.1.4. Largefiles changes

1.2. hgweb changes

hgweb now shows more information about commits: phase (if it's not public), obsolescence status (with a short explanation and links to the successors) and instabilities (e.g. orphan, phase-divergent or content-divergent).

Client-side graph code has been simplified by delegating more work to the backend, so /graph page is now more in sync with /log page, visually and feature-wise. Unfortunately, this code change means that 3rd-party themes for 4.5+ are required to have graphentry.tmpl template available (copy it from the base theme if you don't use %include and then reference it in map file) and render entries in graph.tmpl -- look at one of the core themes to see what it needs to look like. JS functions that create graph vertices and edges are now available in Graph.prototype, making it possible to call the original functions from custom theme-specific functions if needed.

Graph now shows different symbols for normal, branch-closing, obsolete and unstable commits, and marks currently checked out commit with a circle around its graph node.

There's also now json-graph API endpoint that can be used for rendering commit graph in 3rd-party applications.

1.2.1. Other Changes

1.3. Backwards Compatibility Changes

1.4. Bug Fixes

1.5. API Changes

2. Mercurial 4.4.2 (2017-12-01)

This is a regularly-scheduled bugfix release.

2.1. Notable changes

2.1.1. Stricter command option parsing

Mercurial can now optionally parse "early" options (-R/--repository, --cwd, --config, --debugger, and --profile) more strictly, for more secure integration with tools that invoke 'hg' commands. Setting HGPLAIN=+strictflags will parse these options more strictly, which prevents them from being injected as arguments to other flags.

2.2. Bug fixes

2.3. Performance improvements

3. Mercurial 4.4.1 (2017-11-07)

3.1. Notable changes

It is possible that a specially malformed repository can cause Git subrepositories to run arbitrary code in the form of a .git/hooks/post-update script checked in to the repository in Mercurial 4.4 and earlier. Typical use of Mercurial prevents construction of such repositories, but they can be created programmatically.

4. Mercurial 4.4 (2017-11-01)

4.1. Notable changes

4.1.1. Control whitespace settings for annotation on hgweb

/annotate URLs on hgweb now accept query string arguments to influence how whitespace changes impact results.

The arguments "ignorews," "ignorewsamount," "ignorewseol," and "ignoreblanklines" now have the same meaning as their [annotate] config section counterparts. Any provided setting overrides the server default.

HTML checkboxes have been added to the paper and gitweb themes to expose current whitespace settings and to easily modify the current view.

4.1.2. Fast, heuristic copy-tracing

A new fast heuristic algorithm for copytracing which assumes that the files moves are either:

  1. renames in the same directory
  2. moves in other directories with same names

You can use this algorithm by setting 'experimental.copytrace=heuristics'. This setting performs full copytracing if both source and destination branches contains non-public changesets only.

4.1.3. Other changes

4.2. Backwards Compatibility Changes

4.3. Bug Fixes

4.4. Performance Improvements

4.5. API Changes

4.5.1. remove peer.batch()

Replace with peer.iterbatch().

4.5.2. Other Changes

5. Mercurial 4.3.3 (2017-10-01)

6. Mercurial 4.3.2 (2017-09-18)

7. Mercurial 4.3 / 4.3.1 (2017-08-10)

(4.3.1 was released immediately after 4.3 to fix a release oversight.)

An overview of new features available. This is a regularly-scheduled quarterly feature release.

7.1. Notable changes

7.2. CVE-2017-1000115

Mercurial's symlink auditing was incomplete prior to 4.3, and could be abused to write to files outside the repository.

7.3. CVE-2017-1000116

Mercurial was not sanitizing hostnames passed to ssh, allowing shell injection attacks on clients by specifying a hostname starting with -oProxyCommand. This is also present in Git (CVE-2017-1000117) and Subversion (CVE-2017-9800), so please patch those tools as well if you have them installed.

8. Mercurial 4.2.3 (2017-08-10)

This was an out-of-cycle backport of security fixes from 4.3 for users stuck on Python 2.6.

9. Mercurial 4.2.2 (2017-07-05)

This is a regularly-scheduled bugfix release.

10. Mercurial 4.2.1 (2017-6-4)

This is a regularly-scheduled bugfix release.

11. Mercurial 4.2 (2017-5-2)

An overview of new features available. This is a regularly-scheduled quarterly feature release.

11.1. Notable changes

11.2. commands

11.3. core

11.4. extensions

11.5. hgweb

11.6. Behavior changes

11.7. Internal API changes

12. Mercurial 4.1.3 (2017-4-18)

This is an out of cycle release to address a security issue:

13. Mercurial 4.1.2 (2017-4-3)

This is a regularly-scheduled bugfix release.

14. Mercurial 4.1.1 (2017-3-2)

This is a regularly-scheduled bugfix release.

15. Mercurial 4.1 (2017-2-1)

An overview of new features available. This is a regularly-scheduled quarterly feature release.

15.1. commands

15.2. core

15.3. extensions

15.4. hgweb

15.5. chg

15.6. Behavior Changes

15.7. Internal API Changes

16. Mercurial 4.0.2 (2017-01-04)

This is a regularly-scheduled bugfix release.

17. Mercurial 4.0.1 (2016-12-1)

This is a regularly-scheduled bugfix release.

18. Mercurial 4.0 (2016-11-1)

An overview of new features available. This is a regularly-scheduled quarterly feature release. Unlike other 4.0 software releases, this is simply 3.9 + .1, so it should be the usual pain-free upgrade.

18.1. commands

18.2. core

18.3. extensions

18.4. hgweb

WhatsNew (last edited 2018-02-06 06:02:51 by AntonShestakov)