Differences between revisions 310 and 372 (spanning 62 versions)
Revision 310 as of 2017-02-01 17:47:41
Size: 78891
Editor: KevinBullock
Comment: update 4.1-rc to 4.1 (final)
Revision 372 as of 2018-11-03 03:58:04
Size: 79531
Comment: relnotes 4.8rc0 --stoprev 4.8
Deletions are marked like this. Additions are marked like this.
Line 13: Line 13:


== Mercurial 4.8 (2018-11-02) ==

An [[Release4.8|overview of new features]] available. This is a regularly-scheduled quarterly feature release.

=== commands ===
 * add: add a label for messages about added files
 * addremove: add labels for messages about added and removed files
 * annotate: pass in wdir rev and node to formatter (BC)
 * annotate: rename {line_number} to {lineno} (BC)
 * bookmarks: add explicit option to list bookmarks of the given names
 * bookmarks: pass in formatter to printbookmarks() instead of opts (API)
 * clone: allow local cloning to create more than one level of directories
 * debugcommands: introduce debugrevlogindex (BC)
 * debugcommands: use openstorage() in debugdata (BC)
 * grep: add MULTIREV support to --allfiles flag
 * grep: rename {line_number} to {lineno} as well (BC)
 * grep: search all commits in allfiles mode
 * help: adding a proper declaration for shortlist/basic commands (API)
 * help: adding support for command categories
 * identify: change {parents} to a list of nodes (BC)
 * identify: show remote bookmarks in 'hg id url -Tjson -B'
 * log: have changesetformatter fill in wdir() rev and node (BC)
 * log: respect graphshorten on terminal nodes (collapsing o-~ to just o~)
 * merge: improve interactive one-changed one-deleted message (Bts:issue5550)
 * phase: explicitly exclude secret phase and above
 * phase: expose a '_phase(idx)' revset
 * phase: handle phase with no command flag
 * phase: report number of non-public changeset alongside the new range
 * push: add "remote" to 'repository changed while pushing' messages (Bts:issue5971)
 * remove: add a label for messages about removed files
 * rename: return error status if any rename/copy failed
 * resolve: add a flag for the default behavior of re-merging
 * resolve: add config to make hg resolve not re-merge by default
 * resolve: add confirm config option
 * resolve: add option to warn/abort on -m with unresolved conflict markers
 * resolve: graduate resolve.mark-check from experimental, add docs
 * resolve: rename {status} to {mergestatus} to not shadow change status (BC)
 * status: advertise --abort instead of 'update -C .' to abort a merge
 * status: advertise --abort instead of 'update -C .' to abort graft
 * status: remove "morestatus" message from formatter data (BC)
 * status: rename {copy} to {source} for compatibility with {file_copies} (BC)
 * verify: make output less confusing (Bts:issue5924)

=== core ===
 * context: drop compatibility for 'context.descendant' (API)
 * context: move logic from `changectx.__init__` to `localrepo.__getitem__` (API)
 * context: remove unused overlayfilectx (API)
 * dispatch: don't show list of commands on bogus command
 * dispatch: making all hg abortions be output with a specific label
 * dispatch: show a short error message when invalid global option given
 * exchange: support declaring pull depth
 * exchange: support defining narrow file patterns for pull
 * filelog: add a hasnode() method (API)
 * filelog: drop _generaldelta attribute (API)
 * filelog: drop index attribute (API)
 * filelog: remove checkhash() (API)
 * filelog: remove revdiff() (API)
 * filelog: remove version attribute (API)
 * filelog: stop proxying "opener" (API)
 * filelog: stop proxying _addrevision() (API)
 * filelog: stop proxying checksize() (API)
 * filelog: stop proxying compress() (API)
 * filelog: stop proxying datafile (API)
 * filelog: stop proxying deltaparent() (API)
 * filelog: stop proxying flags() (API)
 * filelog: stop proxying headrevs() (API)
 * filelog: stop proxying rawsize() (API)
 * filelog: stop proxying start(), end(), and length() (API)
 * localrepo: add repository feature when repo can be stream cloned
 * localrepo: add requirement when narrow files creation option present
 * localrepo: automatically load lfs extension when required (BC)
 * localrepo: define "features" on repository instances (API)
 * localrepo: define storage backend in creation options (API)
 * localrepo: move repo creation logic out of `localrepository.__init__` (API)
 * localrepo: pass ui to newreporequirements() (API)
 * localrepo: support marking repos as having shallow file storage
 * localrepo: support writing shared file (API)
 * pager: do not enable when TERM=dumb
 * repository: establish API for emitting revision deltas
 * revlog: add method for obtaining storage info (API)
 * revlog: drop !LookupError alias (API)
 * revlog: drop !RevlogError alias (API)
 * revlog: drop compatibility for 'revlog.descendant' (API)
 * revlog: drop emitrevisiondeltas() and associated functionality (API)
 * revlog: drop some more error aliases (API)
 * revlog: new API to emit revision data
 * revlog: reuse cached delta for identical base revision (Bts:issue5975)
 * revset: expand bookmark(.) to the active bookmark
 * revsetlang: fix position of '-' in spaceless 'a-b' expressions
 * streamclone: don't support stream clone unless repo feature present
 * streamclone: include obsstore file into stream bundle if client can read it
 * templatefuncs: add truncate parameter to pad
 * templatekw: add experimental {status} keyword
 * templatekw: deprecate old-style template keyword function (API)
 * templates: rename "user" to "luser" defined in default map file (API)
 * tracing: new module to make tracing events in hg easier
 * tracing: trace command function execution
 * transaction: make entries a private attribute (API)
 * transaction: remember original len(repo) instead of tracking added revs (API)
 * util: make timedcm require the label (API)
 * wireprotov2: add bookmarks to "changesetdata" command
 * wireprotov2: add phases to "changesetdata" command
 * wireprotov2: client support for advertising redirect targets
 * wireprotov2: client support for following content redirects
 * wireprotov2: define and implement "changesetdata" command
 * wireprotov2: define and implement "filedata" command
 * wireprotov2: define and implement "filesdata" command
 * wireprotov2: define and implement "manifestdata" command
 * wireprotov2: server support for sending content redirects
 * wireprotov2: support response caching

=== extensions ===
 * absorb: import extension from Facebook's hg-experimental
 * absorb: print '{rev}:' as a prefix to the hash
 * absorb: print summary of changesets affected
 * absorb: prompt user to accept absorb changes by default
 * amend: support "history-editing-backup" config option
 * closehead: fix close-head -r listification
 * commitextras: work nicely with other extensions
 * convert: fix a file descriptor leak
 * extension: add a summary of total loading time per extension
 * extensions: add detailed loading information
 * extensions: new closehead module for closing arbitrary heads
 * fastannotate: initial import from Facebook's hg-experimental
 * fastannotate: make the default value for 'fastannotate.useflock' dynamic
 * fix: add a monkey-patchable point after all new revisions have been committed
 * fix: compute changed lines lazily to make whole-file fixer tools faster
 * fix: determine fixer tool failure by exit code instead of stderr
 * fix: pull out flag definitions to make them re-usable from extensions
 * fsmonitor: use vfs instead of opener (Bts:issue5938)
 * journal: do not pass in repolookuperror string to template (BC)
 * journal: unify template name for "nodes" (BC)
 * largefiles: automatically load largefiles extension when required (BC)
 * lfs: add repository feature denoting the use of LFS
 * lfs: autoload the extension when cloning from repo with lfs enabled
 * lfs: consult the narrow matcher when extracting pointers from ctx (Bts:issue5794)
 * lfs: don't add extension to hgrc after clone or share (BC)
 * lfs: don't add extension to hgrc after conversion (BC)
 * logtoprocess: connect all fds to /dev/null to avoid bad interaction with pager
 * logtoprocess: define $HG for children processes
 * narrow: add '--import-rules' flag to tracked command
 * narrow: add a --narrowspec flag to clone command
 * narrow: add narrow and ellipses as server capabilities
 * narrow: add server logic to send cg while widening without ellipsis
 * narrow: check for servers' narrow support before doing anything (BC)
 * narrow: drop support for remote expansion (BC)
 * narrow: introduce a config option to check if narrow is enabled or not
 * narrow: move .hg/narrowspec to .hg/store/narrowspec (BC)
 * narrow: move support for 'hg verify' into core
 * narrow: the first version of narrow_widen wireprotocol command
 * narrow: validate spec files are well-formed during clone (BC)
 * patchbomb: allow using HGHOSTNAME to force a hostname
 * phabricator: drop support for the legacy phabricator.auth.token config (BC)
 * phabricator: mark extension as experimental for now
 * rebase: add --stop option to stop rebase at any point (Bts:issue5206)
 * rebase: don't try to prune obsolete changeset already in the destination
 * rebase: explicitly track collapses as fold
 * rebase: skip extinct revisions even if it has no successor in rebase set
 * rebase: support "history-editing-backup" config option
 * remotenames: add names argument to remotenames revset
 * share: allow more than one level of directories to be created
 * shelve: add an "internal" extra
 * shelve: fix crash on unshelve without .shelve metadata file
 * shelve: use the internal phase when possible
 * sqlitestore: file storage backend using SQLite
 * strip: ignore orphaned internal changesets while computing safe strip roots

=== hgweb ===
 * hgweb: add error template to json so it won't crash
 * hgweb: map Abort to 403 error to report inaccessible path for example
 * hgweb: show shortlog by default in json output (Bts:issue5978)
 * hgweb: use scmutil.binnode() to translate None to wdir hash (Bts:issue5988)

=== chg ===
 * chgserver: add "setumask2" command which uses correct message frame
 * chgserver: restore pager fds attached within runcommand session
 * rust-chg: add Client extensions to run cHg-specific requests
 * rust-chg: add callback to handle pager and shell command requests

=== unsorted ===
 * ancestors: actually iterate over ancestors in topological order (Bts:issue5979)
 * bundle2: graduate bundle2.stream option from experimental to server section
 * changegroup: pass sorted revisions into group() (API)
 * changegroup: port to emitrevisions() (Bts:issue5976)
 * changegroup: remove reordering control (BC)
 * changegroup: restore default node ordering (Bts:issue6001)
 * cleanupnodes: drop special casing around prune markers (API)
 * commands: restore compatibility for "^cmd" registration (Bts:issue6005)
 * copies: improve logic of deciding copytracing on based of config options
 * crecord: make nextsametype() check that parent item exists (Bts:issue6009)
 * crecord: make enter move cursor down to the next item of the same type
 * delta: skip "empty delta" optimisation for non-general case (Bts:issue6006)
 * error: introduce !StorageError
 * filemerge: add config knob to check capabilities of internal merge tools
 * filemerge: show warning if chosen tool has no binary files capability
 * fileset: extract language processing part to new module (API)
 * fileset: optimize 'x and not y' to 'x - y'
 * fileset: roughly adjust weights of functions
 * formatter: remove experimental marker from -T option
 * formatter: rename {abspath}/{file} to {path}, and drop relative {path} (BC)
 * global: replace most uses of !RevlogError with !StorageError (API)
 * hg: allow extra arguments to be passed to repo creation (API)
 * httppeer: expose capabilities for each command
 * index: drop support for negative indexes into the index
 * index: handle index[-1] as nullid more explicitly
 * linelog: fix infinite loop vulnerability
 * lookup: add option to disambiguate prefix within revset
 * mail: always fall back to iso-8859-1 if us-ascii won't work (BC)
 * mail: modernize check for Python-with-TLS
 * manifest: add rawsize() proxy (API)
 * meld: enable auto-merge
 * mergetool: warn if ui.merge points to nonexistent tool
 * narrowspec: limit patterns to path: and rootfilesin: (BC)
 * narrowspec: use sparse.parseconfig() to parse narrowspec file (BC)
 * obsolete: fix !ValueError when stored note contains ':' char (Bts:issue5783)
 * overlayworkingctx: fix exception in metadata-only inmemory merges (Bts:issue5960)
 * phase: add an archived phase
 * phases: add an internal phases
 * pullreport: issue a message about "extinct" pulled changesets
 * py3: rename pycompat.getcwd() to encoding.getcwd() (API)
 * revisions: allow "x123" to refer to nodeid prefix "123"
 * scmutil: accept multiple predecessors in 'replacements' (API)
 * shortest: never emit 0-length prefix even if unique
 * shortest: use 'x' prefix to disambiguate from revnum if configured
 * sparse-revlog: only refine delta candidates in the sparse case (Bts:issue6006)
 * statprof: fix indent level of fp.write() (Bts:issue6004)
 * statprof: update the name as the i increases (Bts:issue6003)
 * storageutil: consistently raise !LookupError (API)
 * storageutil: implement file identifier resolution method (BC)
 * storageutil: move metadata parsing and packing from revlog (API)
 * storageutil: new module for storage primitives (API)
 * url: allow to configure timeout on http connection

=== Behavior Changes ===

 * annotate: pass in wdir rev and node to formatter (BC)
 * annotate: rename {line_number} to {lineno} (BC)
 * changegroup: remove reordering control (BC)
 * debugcommands: introduce debugrevlogindex (BC)
 * debugcommands: use openstorage() in debugdata (BC)
 * formatter: rename {abspath}/{file} to {path}, and drop relative {path} (BC)
 * grep: rename {line_number} to {lineno} as well (BC)
 * identify: change {parents} to a list of nodes (BC)
 * journal: do not pass in repolookuperror string to template (BC)
 * journal: unify template name for "nodes" (BC)
 * largefiles: automatically load largefiles extension when required (BC)
 * lfs: don't add extension to hgrc after clone or share (BC)
 * lfs: don't add extension to hgrc after conversion (BC)
 * localrepo: automatically load lfs extension when required (BC)
 * log: have changesetformatter fill in wdir() rev and node (BC)
 * mail: always fall back to iso-8859-1 if us-ascii won't work (BC)
 * narrow: check for servers' narrow support before doing anything (BC)
 * narrow: drop support for remote expansion (BC)
 * narrow: move .hg/narrowspec to .hg/store/narrowspec (BC)
 * narrow: validate spec files are well-formed during clone (BC)
 * narrowspec: limit patterns to path: and rootfilesin: (BC)
 * narrowspec: use sparse.parseconfig() to parse narrowspec file (BC)
 * phabricator: drop support for the legacy phabricator.auth.token config (BC)
 * resolve: rename {status} to {mergestatus} to not shadow change status (BC)
 * status: remove "morestatus" message from formatter data (BC)
 * status: rename {copy} to {source} for compatibility with {file_copies} (BC)
 * storageutil: implement file identifier resolution method (BC)

=== Internal API Changes ===

 * bookmarks: pass in formatter to printbookmarks() instead of opts (API)
 * changegroup: pass sorted revisions into group() (API)
 * cleanupnodes: drop special casing around prune markers (API)
 * context: drop compatibility for 'context.descendant' (API)
 * context: move logic from `changectx.__init__` to `localrepo.__getitem__` (API)
 * context: remove unused overlayfilectx (API)
 * filelog: add a hasnode() method (API)
 * filelog: drop _generaldelta attribute (API)
 * filelog: drop index attribute (API)
 * filelog: remove checkhash() (API)
 * filelog: remove revdiff() (API)
 * filelog: remove version attribute (API)
 * filelog: stop proxying "opener" (API)
 * filelog: stop proxying _addrevision() (API)
 * filelog: stop proxying checksize() (API)
 * filelog: stop proxying compress() (API)
 * filelog: stop proxying datafile (API)
 * filelog: stop proxying deltaparent() (API)
 * filelog: stop proxying flags() (API)
 * filelog: stop proxying headrevs() (API)
 * filelog: stop proxying rawsize() (API)
 * filelog: stop proxying start(), end(), and length() (API)
 * fileset: extract language processing part to new module (API)
 * global: replace most uses of !RevlogError with !StorageError (API)
 * help: adding a proper declaration for shortlist/basic commands (API)
 * hg: allow extra arguments to be passed to repo creation (API)
 * localrepo: define "features" on repository instances (API)
 * localrepo: define storage backend in creation options (API)
 * localrepo: move repo creation logic out of `localrepository.__init__` (API)
 * localrepo: pass ui to newreporequirements() (API)
 * localrepo: support writing shared file (API)
 * manifest: add rawsize() proxy (API)
 * py3: rename pycompat.getcwd() to encoding.getcwd() (API)
 * revlog: add method for obtaining storage info (API)
 * revlog: drop !LookupError alias (API)
 * revlog: drop !RevlogError alias (API)
 * revlog: drop compatibility for 'revlog.descendant' (API)
 * revlog: drop emitrevisiondeltas() and associated functionality (API)
 * revlog: drop some more error aliases (API)
 * scmutil: accept multiple predecessors in 'replacements' (API)
 * storageutil: consistently raise !LookupError (API)
 * storageutil: move metadata parsing and packing from revlog (API)
 * storageutil: new module for storage primitives (API)
 * templatekw: deprecate old-style template keyword function (API)
 * templates: rename "user" to "luser" defined in default map file (API)
 * transaction: make entries a private attribute (API)
 * transaction: remember original len(repo) instead of tracking added revs (API)
 * util: make timedcm require the label (API)




== Mercurial 4.7.2 (2018-10-01) ==
This is a regularly-scheduled bugfix release containing following fixes:

=== security ===

Fix a potential out-of-bounds read in manifest parsing C code.

=== core ===
 * various minor correctness fixes in revsets for commonancestors() and similar

=== unsorted ===
 * chgserver: do not send system() back to client if stdio redirected (Bts:issue5992)
 * procutil: compare fd number to see if stdio protection is needed (Bts:issue5992)

== Mercurial 4.7.1 (2018-09-04) ==

This is a regularly-scheduled bugfix release containing following fixes:

=== commands ===
 * merge: do not delete untracked files silently (Bts:issue5962)

=== core ===
 * revlog: fix descendant deprecated method

=== hgweb ===
 * hgweb: load revcount + 1 entries to fill nextentry in log page (Bts:issue5972)

=== performance ===
 * remotephase: avoid full changelog iteration (Bts:issue5964)
 * remotephase: fast path newheads computation in simple case (Bts:issue5964)
 * scmutil: avoid quadratic membership testing (Bts:issue5969)
 * sparse-revlog: fix delta validity computation


== Mercurial 4.7 (2018-08-01) ==

This is a regularly-scheduled quarterly feature release and has its own release notes page which can be found here [[Release4.7|Full release notes]].


== Mercurial 4.6.2 (2018-07-03) ==

This is a regularly-scheduled bugfix release containing following fixes:

 * merge: do not fill manifest of committed revision with pseudo node (Bts:issue5526)
 * crecord: fix line number in hunk header (Bts:issue5917)
 * lazymanifest: don't crash when out of memory (Bts:issue5916)
 * procutil: use unbuffered stdout on Windows

== Mercurial 4.6.1 (2018-06-06) ==

This is a regularly-scheduled bugfix release that also contains security fixes.

=== Security Fixes ===

Multiple issues found in mpatch.c with a fuzzer:

 * OVE-20180430-0001 / CVE-2018-13348
 * OVE-20180430-0002 / CVE-2018-13347
 * OVE-20180430-0004 / CVE-2018-13346

With the following fixes:

 * mpatch: be more careful about parsing binary patch data (SEC)
 * mpatch: protect against underflow in mpatch_apply (SEC)
 * mpatch: ensure fragment start isn't past the end of orig (SEC)
 * mpatch: fix UB in int overflows in gather() (SEC)
 * mpatch: fix UB integer overflows in discard() (SEC)
 * mpatch: avoid integer overflow in mpatch_decode (SEC)
 * mpatch: avoid integer overflow in combine() (SEC)

No exploits are known at the time, however, it is highly recommended that all users upgrade.

=== Bug Fixes ===

Also included in this release are the following,

 * zstandard: pull in bug fixes from upstream 0.9.1 (Bts:issue5884)
 * bundle2: fix old clients from reading newer format (Bts:issue5872)
 * bdiff: fix xdiff long/int64 conversion (Bts:issue5885)
 * push: continue without locking on lock failure other than EEXIST (Bts:issue5882)
 * lfs: fix crash in command server (Bts:issue5902)
 * hghave: fix deadlock in test runner
 * rebase: fix error when computing obsoletenotrebased (Bts:issue5907)
 * rebase: prioritize indicating an interrupted rebase over update (Bts:issue5838)
 * revset: pass in lookup function to matchany() (Bts:issue5879)


== Mercurial 4.6 (2018-05-06) ==

[[Release4.6|Full release notes]] are available. This is a regularly-scheduled quarterly feature release.

=== New Features ===

==== pullbundles ====

Pullbundles allow the server to answer client requests using pre-built bundles. This is different from the existing clonebundle feature:

 * pullbundles can be used for both the initial clone and later pull operations
 * pullbundles can be used incrementally, i.e. to cover the changes up to the start of the current month as one bundle and the remaining changes as second bundle
 * the bundle is transferred inline as part of the existing connection without a secondary server

Pullbundles are only used for clients running Mercurial 4.6 as well.

==== push ====

If 'server.streamunbundle' option is enabled, the server will directly apply the changes send by the changes. This avoids potentially large temporary files on the server side. It can also prevent concurrent pushes.

==== notify extension ====

The 'maxdiffstat' option can be used to truncate long file lists similar to 'maxdiff' for the patch part of the email.

==== hgweb ====

hgweb now shows date and user for operations that resulted in obsolete commit(s). For unstable commits, it shows the exact reason why they are considered unstable.

`Server:` header is now configurable using `web.server-header` option.

==== templates ====

A new template keyword 'reporoot' which shows the root directory of the current repository.
A new template function 'mailmap' which maps author fields based on values in a .mailmap file.

==== Other notable features ====

 * revset: parse error now shows a hint where the error occurred
 * templates: parse error now shows a hint where the error occured
 * forget: new '--dry-run' and '--interactive' flags
 * copyfile: preserve stat info (mtime, etc.) when doing copies/renames
 * bundle2 format is documented and can be found using 'hg help internals.bundle2'

=== Backwards Compatibility Changes ===

 * Support for connecting to Mercurial servers older than 0.9.1 has been removed.

 * Working-directory commands now respect "-X PATTERN" no matter if PATTERN matches explicitly-specified FILEs. For example, "hg add foo -X foo" no longer add the file "foo".

 * Support for the experimental manifestv2 format has been removed, as it was never completed and failed to meet expectations.

 * '{' in output filename passed to archive/cat/export is taken as a start of a template expression.

 * The HTTP wire protocol server no longer accepts the "cmd" argument to control which command to run via HTTP POST bodies. The "cmd" argument must be specified on the URL query string.

 * Hgweb no longer reads form data in POST requests from multipart/form-data and application/x-www-form-urlencoded requests. Arguments should be specified as URL path components or in the query string in the URL instead.

 * Query string shorts in hgweb like "?cs=@" have been removed. Use URLs of the form "/:cmd" instead.

 * The HTTP client no longer accepts text/plain and application/hg-changegroup Content-Type values as a valid Mercurial command response. These should only be encountered on pre 1.0 Mercurial servers.

=== Performance Improvements ===

 * 'hg manifest --all' is likely slower due to changing its implementation to respect storage interface boundaries. If you are impacted by this regression in a meaningful way, please make noise on the development mailing list and it can be dealt with.

 * 'hg diff' is much faster for larger repositories. 40% improvements have been reported. Other operations using diffs like hgweb also benefit.

=== Bug Fixes ===

 * grep: fixes erroneous output of grep in forward order (Bts:issue3885)
 * dirstate: drop explicit files that shouldn't match (BC) (Bts:issue4679)
 * procutil: rewrite popen() as a subprocess.Popen wrapper (Bts:issue4746) (API)
 * bookmarks: test for exchanging long bookmark names (Bts:issue5165)
 * templater: drop symbols which should be overridden by new 'ctx' (Bts:issue5612)
 * clone: updates the help text for hg clone -{r,b} (Bts:issue5654)
 * bundle: updates the help text for hg bundle (Bts:issue5744)
 * histedit: make histedit's commands accept revsets (Bts:issue5746)
 * releasenotes: replace abort with warning while parsing (Bts:issue5775)
 * context: skip path conflicts by default when clearing unknown file (Bts:issue5776)
 * templatekw: switch most of showlist template keywords to new API (Bts:issue5779)
 * rebase: do not consider extincts for divergence detection (Bts:issue5782)
 * revert: use an exact matcher in interactive diff selection (Bts:issue5789)
 * subrepo: don't attempt to share remote sources (Bts:issue5793)
 * lfs: respect narrowmatcher when testing to add 'lfs' requirement (Bts:issue5794)
 * showconfig: allow multiple section.name selectors (Bts:issue5797)
 * annotate: do not poorly split lines at CR (Bts:issue5798)
 * convert: avoid closing ui.fout in subversion code (Bts:issue5807)
 * setdiscovery: back out changeset 5cfdf6137af8 (Bts:issue5809)
 * fsmonitor: layer on another hack in bser.c for os.stat() compat (Bts:issue5811)
 * notify: access the initial revision on an unfiltered repository (Bts:issue5821)
 * rebase: fix issue 5494 also with --collapse
 * date: fixed a bug in parsing months like 'Feb 2018', 'Apr 2018'
 * diffhelper: rename module to avoid conflicts with ancient C module (Bts:issue5846)
 * infinitepush: ensure fileindex bookmarks use '/' separators (Bts:issue5840)
 * import: fix crash on --exact check of empty commit (Bts:issue5702)
 * hgweb: reuse body file object when hgwebdir calls hgweb (Bts:issue5851)
 * debugcolor: fix crash by empty styles (Bts:issue5856)
 * hgweb: discard Content-Type header for 304 responses (Bts:issue5844)
 * hgweb: allow Content-Security-Policy header on 304 responses (Bts:issue5844)
 * paper: don't register click handlers with inline javascript (Bts:issue5812)
 * httppeer: detect redirect to URL without query string (Bts:issue5860)
 * filelog: don't crash on invalid copy metadata (Bts:issue5748)


=== New experimental features ===

Each release there are lot of new features added which are hidden under the EXPERIMENTAL tag as the behavior may change in future or the feature is not complete yet. The experimental features added in this cycle are:

==== narrow extension ====

Allows to create clones which fetch history data for only a subset of files. This experimental extension is now distributed with Mercurial.

==== remotenames extension ====

Shows `remotebookmarks` and `remotebranches` in the UI. This experimental extension is now distributed with Mercurial.

==== infinitepush extension ====

Allows to store some pushes in a remote blob store on the server and to serve commits from remote blob store. The revisions are stored on disk or in everstore, the metadata are stored in sql or on disk. This experimental extension is now distributed with Mercurial.

==== fix extension ====

Allows to rewrite file content in changesets or working copy. For example, automatically applying formatting fixes to modified lines of code. This experimental extension is now distributed with Mercurial.

==== lfs extension ====

An alternative to the largefiles extension, which uses the git-lfs protocol. This experimental extension is now distributed with Mercurial.

=== API Changes ===

 * Content from mercurial.hgweb.protocol has been moved to mercurial.wireprotoserver.

 * Content from mercurial.sshserver has been moved into mercurial.wireprotoserver.

 * sshserver no longers looks for wire protocol command handlers in methods named `do_<command>`. Use `@wireproto.wireprotocommand` to declare wire protocol command handler functions.

 * Log-related utility functions has been renamed as follows:

   - cmdutil.loglimit -> logcmdutil.getlimit

   - cmdutil.diffordiffstat -> logcmdutil.diffordiffstat

   - cmdutil._changesetlabels -> logcmdutil.changesetlabels

   - cmdutil.changeset_printer -> logcmdutil.changesetprinter

   - cmdutil.jsonchangeset = logcmdutil.jsonchangeset

   - cmdutil.changeset_templater -> logcmdutil.changesettemplater

   - cmdutil.logtemplatespec -> logcmdutil.templatespec

   - cmdutil.makelogtemplater -> logcmdutil.maketemplater

   - cmdutil.show_changeset -> logcmdutil.changesetdisplayer

   - cmdutil.getlogrevs -> logcmdutil.getrevs

   - cmdutil.getloglinerangerevs -> logcmdutil.getlinerangerevs

   - cmdutil.displaygraph -> logcmdutil.displaygraph

   - cmdutil.graphlog -> logcmdutil.graphlog

   - cmdutil.checkunsupportedgraphflags -> logcmdutil.checkunsupportedgraphflags

   - cmdutil.graphrevs -> logcmdutil.graphrevs

   - cmdutil._makenofollowlogfilematcher -> logcmdutil._makenofollowfilematcher

 * The following deprecated methods have been removed from context, with replacements:

   - unstable() -> orphan()

   - bumped() -> phasedivergent()

   - divergent() -> contentdivergent()

   - troubled() -> isunstable()

   - troubles() -> instabilities()

 * The following deprecated methods have been removed from obsolete, with replacements:

   - _addprecursors() -> _addpredecessors()

   - obsstore.precursors -> obsstore.predecessors

   - allprecursors() -> obsutil.allprecursors()

   - allsuccessors() -> obsutil.allsuccessors()

   - marker() -> obsutil.marker

   - getmarkers() -> obsutil.getmarkers()

   - exclusivemarkers() -> obsutil.exclusivemarkers()

   - foreground() -> obsutil.foreground()

   - successorssets() -> obsutil.successorsset()

   - unstable() -> orphan()

   - bumped() -> phasedivergent()

   - divergent() -> contentdivergent()

 * The following deprecated methods have been removed from obsutil: `marker.precnode()` and `allprecursors()`. Use `marker.prednode()` and `allpredecessors()` instead.

 * `beginparentchange()` and `endparentchange()` have been replaced by the `parentchange` context manager.

 * The deprecated `localrepo.walk()` has been removed, and replaced by `repo[node].walk()`.

 * The following deprecated methods have been removed from bookmarks: `__setitem__()`, `__delitem__()`, `update()`, and `recordchange()`. Use `bookmarks.applychanges()` instead.

 * The `cmdutil._revertprefetch()` hook point for prefetching stored files has been replaced by the command agnostic `cmdutil._prefetchfiles()`. The new function takes a list of files, instead of a list of lists of files.

 * `sshpeer.sshpeer.__init__` now receives arguments describing an existing connection instead of creating a connection itself.

 * `sshpeer.sshpeer` renamed to `sshpeer.sshv1peer`.

 * `wireproto.pushres` and `wireproto.pusherr` now explicitly track stdio output.

 * `redirect()` and `restore()` have been removed from the wire protocol handler interface. Use `mayberedirectstdio()` instead.

 * The `_client()` method of the wire protocol handler interface has been renamed to `client()`.

 * Wire protocol command handlers now return a `wireprototypes.bytesresponse` instead of a raw bytes instance. Protocol handlers will continue handling bytes instances. However, any extensions wrapping wire protocol commands will need to handle the new type.

 * SSH protocol handler now advertises its name internally as "ssh-v1" instead of "ssh."

 * File prefetching is now handled by registering a callback with `scmutil.fileprefetchhooks`.

 * HTTP protocol handlers now advertises its internal name as "http-v1" instead of "http".

 * `context.basectx` no longer implements `__int__`. Context instances will no longer cast to ints. Consumers should call `ctx.rev()` instead.

 * `templatekw.showdict()` and `showlist()` are deprecated in favor of new `(context, mapping)` API. Switch the keyword function to new API and use `templatekw.compatdict()` and `compatlist()` instead.

 * `hgweb_mod.perms` and `wireproto.permissions` have been removed. Wire protocol commands should declare their required permissions in the `@wireprotocommand` decorator.

 * The WSGI request object no longer exposes a `form` attribute containing parsed query string data. Use the `qsparams` attribute instead.

 * `hgweb.hgweb_mod.permhooks` no longer take a `wsgirequest` instance as an argument.

 * hgweb `@webcommand` functions must use the new response object passed in via "web.res" to initiate sending of a response. The hgweb WSGI application will no longer start sending the response automatically.

 * Various helper functions in hgweb.webutil no longer accept a templater instance. Access the templater through the "web" argument instead.

 * Various functions in hgweb.webutil now take a modern request object instead of "wsgirequest".

 * `@webcommand` functions now only receive a single argument. The request and templater instances can be accessed via the "req" and "templater" attributes of the first argument. Note that the request object is different from previous Mercurial releases and consumers of the previous "req" 2nd argument will need updating to use the new API.

 * The old "wsgirequest" class for handling everything WSGI in hgweb has been replaced by separate request and response types. Various high-level functions in the hgweb WSGI applications now receive these new types as arguments instead of the old "wsgirequest" type.

 * The `render(mapping)` method of the templater has been renamed to `renderdefault(mapping)`.

 * `httppeer.httppeer.__init__` now takes additional arguments. Instances should be obtained by calling `httppeer.instance()` or `httppeer.makepeer()` instead.

 * The templater is no longer callable. Use `templater.generate(t, mapping)` instead of `templater(t, **pycompat.strkwargs(mapping))`.

 * `templatekw._showlist()` is deprecated in favor of `templateutil._showcompatlist()`, which takes `context` in place of `templ`.

 * Several generic string helper functions have been moved to utils.stringutil module.

 * The `util.Abort` alias has been removed. Use `error.Abort`.

 * `merge.update()` and `merge.applyupdates()` now return a class with named attributes instead of a tuple. Switch consumers to access elements by name instead of by offset.

 * Utility functions related to process/executable management have been moved to utils.procutil module.

 * localrepo.localrepository.featuresetupfuncs has been renamed to localrepo.featuresetupfuncs.

 * localrepo.localrepository.filterpats was renamed to localrepo.localrepository._filterpats.

 * Template filters should declare input data type and/or catch `AttributeError`, `ValueError`, `TypeError`, etc. as needed. See the doc of "registrar.templatefilters" for details.

 * "wireproto" module no longer re-exports various types used to define responses to wire protocol commands. Access these types from the "wireprototypes" module.

 * `filelog.parsemeta()` and `filelog.packmeta()` have been moved to the revlog module.

 * `procutil.popen()` no longer supports text mode I/O.

 * `hook.hook()` and `hook.runhooks()` may return a negative integer to denote that the process was killed by signal.

 * `filelog.filelog` is now a standalone class and doesn't inherit from revlog. Instead, it wraps a revlog instance at `self._revlog`. This change was made in an attempt to formalize storage APIs and prevent revlog implementation details leaking through to callers.

 * The `fp` argument is removed from `cmdutil.export()`. Use `cmdutil.exportfile()` instead.

 * `cmdutil.export()` takes a formatter as an argument.

 * `patch.extract()` is now a context manager. Callers no longer have to worry about deleting the temporary file it creates, as the file is tied to the lifetime of the context manager.

 * The wire protocol peer's `iterbatch()` for bulk executing commands has been removed. Use `peer.commandexecutor()` instead.


== Mercurial 4.5.3 (2018-04-04) ==

This is a regularly-scheduled bugfix release.

=== Bug Fixes ===
 * rebase: on abort, don't strip commits that didn't need to be rebased (Bts:issue5822)
 * hgweb: garbage collect on every request
 * amend: abort if unresolved merge conflicts found (Bts:issue5805)

== Mercurial 4.5.1 / 4.5.2 (2018-03-06) ==
(4.5.2 was released immediately after 4.5.1 to fix a release oversight.)

This is a regularly-scheduled bugfix release.

=== Security Fixes ===
All versions of Mercurial prior to 4.5.2 have vulnerabilities in the HTTP server that allow permissions bypass to:

 * Perform writes on repositories that should be read-only
 * Perform reads on repositories that shouldn't allow read access

CVE-2018-1000132 has been assigned these vulnerabilities.

The nature of the vulnerabilities is:

 1. Wire protocol commands that didn't explicitly declare their permissions had no permissions checking done. The `web.{allow-pull, allow-push, deny_read, etc}` config options governing access control were never consulted when running these commands. This allowed permissions bypass for impacted commands.
 1. The `batch` wire protocol command did not list its permission requirements nor did it enforce permissions on individual sub-commands.

The implication of these vulnerabilities is that no permissions checking was performed on commands and this could lead to accessing data that `web.*` config options were supposed to prevent access to or modifying data (via wire protocol commands that can mutate data) without authorization. A Mercurial HTTP server in its default configuration is supposed to be read-only. However, a well-crafted `batch` command could invoke commands that perform writes.

The `batch` write permissions bypass has been present since Mercurial 1.9. The flaw of not checking permissions for wire protocol commands that don't declare their needed permissions has been present since Mercurial 1.0.

Assuming you are running a server without any custom commands provided by extensions, your exposure is unauthorized data access (if relying on the `web.*` config options to limit access) and unauthorized data mutation via the `batch` command.

Server operators can detect unauthorized use of the `batch` command by looking for requests to URLs of the form `repo?cmd=batch` with arguments containing `pushkey` or `unbundle`. This may produce false positives. A more comprehensive check would decode the argument string and verify that `pushkey` or `unbundle` are command names (not values). The arguments specified via `x-hgarg-<N>` request headers can span multiple headers. So advanced attackers could hide the vulnerability by splitting a `pushkey` or `unbundle` string across multiple headers. So the only reliable way to detect if this vulnerability is being exploited is to decode these headers like Mercurial does. The format for specifying arguments is documented at https://www.mercurial-scm.org/repo/hg/file/4.5/mercurial/help/internals/wireprotocol.txt#l26. Python code for decoding headers is at https://www.mercurial-scm.org/repo/hg/file/4.5/mercurial/hgweb/protocol.py#l70.

Mercurial 4.5.2 fixes these vulnerabilities by:

 * Performing permissions checking on all wire protocol commands, not just commands that list their permissions.
 * Checking permissions on sub-commands issued to the `batch` command.

Wire protocol commands not declaring wire protocol permissions will be assumed to be read-write commands and a server in its default configuration (which only allows read-only access), will refuse to execute these commands.

For package maintainers needing to backport the fixes, the relevant changesets from 4.5.2 are `2c647da851ed::2ecb0fc535b1`. These can be viewed online at e.g. https://www.mercurial-scm.org/repo/hg/rev/2ecb0fc535b1. The author of these commits has backports to 4.4 and 4.3 on a personal fork at https://hg.mozilla.org/users/gszorc_mozilla.com/hg. The backports for 4.4 are `a4843835c835::7cf827e5f8af` and for 4.3 are `db527ae12671::86f9a022ccb8`. To obtain these changesets, run e.g. `hg pull -r 7cf827e5f8af https://hg.mozilla.org/users/gszorc_mozilla.com/hg`.

=== Backwards Compatibility Changes ===
 * The "batch" wire protocol command now enforces permissions of each invoked sub-command. Wire protocol commands must define their operation type or the "batch" command will assume they can write data and will prevent their execution on HTTP servers unless the HTTP request method is POST, the server is configured to allow pushes, and the (possibly authenticated) HTTP user is authorized to perform a push.

 * Wire protocol commands not defining their operation type in "wireproto.PERMISSIONS" are now assumed to be used for "push" operations and access control to run those commands is now enforced accordingly.

=== Bug Fixes ===
 * fileset: don't abort when running copied() on a revision with a removed file
 * date: fix parsing months
 * setup: only allow Python 3 from a source checkout (Bts:issue5804)
 * annotate: do not poorly split lines at CR (Bts:issue5798)
 * subrepo: don't attempt to share remote sources (Bts:issue5793)
 * subrepo: activate clone pooling to enable sharing with remote URLs
 * changegroup: do not delta lfs revisions
 * revlog: do not use delta for lfs revisions
 * revlog: resolve lfs rawtext to vanilla rawtext before applying delta

== Mercurial 4.5 (2018-02-01) ==
=== New Features ===
==== revert --interactive ====
The revert command now accepts the flag --interactive to allow reverting only some of the changes to the specified files.

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

==== 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.

==== Largefiles changes ====
 * largefiles: add a 'debuglfput' command to put largefile into the store
 * largefiles: add support for 'largefiles://' url scheme
 * largefiles: allow to run 'debugupgraderepo' on repo with largefiles
 * largefiles: convert EOL of hgrc before appending to bytes IO
 * largefiles: explicitly set the source and sink types to 'hg' for lfconvert
 * largefiles: modernize how capabilities are added to the wire protocol

=== 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.

==== Other Changes ====
 * When interactive revert is run against a revision other than the working directory parent, the diff shown is the diff to <em>apply</em> to the working directory, rather than the diff to <em>discard</em> from the working copy. This is in line with related user experiences with 'git' and appears to be less confusing with 'ui.interface=curses'.
 * Let 'hg rebase' avoid content-divergence by skipping obsolete changesets (and their descendants) when they are present in the rebase set along with one of their successors but none of their successors is in destination.
 * A new experimental config flag, 'rebase.experimental.inmemory', makes rebase perform an in-memory merge instead of doing it on-disk in the working copy.
 * The `HGPLAINEXCEPT` environment variable can now include `color` to allow automatic output colorization in otherwise automated environments.
 * A new unamend command in uncommit extension which undoes the effect of the amend command by creating a new changeset which was there before amend and moving the changes that were amended to the working directory.
 * A '--abort' flag to merge command to abort the ongoing merge.
 * An experimental flag '--rev' to 'hg branch' which can be used to change branch of changesets.
 * bundle2 read I/O significantly improved
 * bundle2 memory use significantly reduced during read
 * clonebundle: it is now possible to serve the clonebundle using a git-lfs compatible server.
 * templatefilters: add slashpath() to convert path separator to slash (Bts:issue5572)
 * A new experimental config flag, 'inline-color-diff', adds within-line color diff capacity
 * histedit: add support to output nodechanges using formatter to help with editor integrations

=== Backwards Compatibility Changes ===
 * `log --follow-first -rREV`, which is deprecated, now follows the first parent of merge revisions from the specified `REV` just like `log --follow -rREV`.
 * `log --follow -rREV FILE..` now follows file history across copies and renames.
 * transaction: register summary callbacks only at start of transaction
 * hgweb's graph view no longer supports browsers that lack <canvas> support
 * hgweb: only include graph-related data in jsdata variable on /graph pages
 * graphlog: add another graph node type, unstable, using character `*`
 * remove: print message for each file in verbose mode only while using '-A'

=== Bug Fixes ===
 * Bookmark, whose name is longer than 255, can again be exchanged again between 4.4+ client and servers (Bts:issue5165)
 * The convert extension works with bzr < 2.6.0 again (Bts:issue5733)
 * Mercurial will now attempt to use hardlinks on NTFS on Windows (Bts:issue4580)
 * The revset `x^::` is now correctly parsed as `(x^)::` instead of being an error (Bts:issue5764)
 * Setting the diff.noprefix configuration option no longer breaks the `--stat` flag on `hg diff` (Bts:issue5759)
 * `hg outgoing` now honors `:pushurl` paths from hgrc (Bts:issue5365)
 * log: translate column labels at once (Bts:issue5750)
 * patch: improve heuristics to not take the word `diff` as header (Bts:issue1879)
 * templater: look up symbols/resources as if they were separated (Bts:issue5699)
 * http and ssh: support for emitting extra debug logs about requests as they happen

=== API Changes ===
 * `bundlerepo.bundlerepository.bundle` and `bundlerepo.bundlerepository.bundlefile` are now prefixed with an underscore.
 * Rename bundlerepo.bundlerepository.bundlefilespos to _cgfilespos.
 * dirstate no longer provides a 'dirs()' method. To test for the existence of a directory in the dirstate, use 'dirstate.hasdir(dirname)'.
 * mapping does not contain all template resources. use context.resource() in template functions.
 * `text=False|True` option is dropped from the vfs interface because of Python 3 compatibility issue. Use `util.tonativeeol/fromnativeeol()` to convert EOL manually.
 * `wireproto.streamres.__init__` no longer accepts a `reader` argument. Use the `gen` argument instead.
 * exchange.getbundlechunks() now returns a 2-tuple instead of just an iterator.
 * bundle2 parts are no longer seekable by default
 * memfilectx: the changectx argument is now mandatory in constructor

== Mercurial 4.4.2 (2017-12-01) ==
This is a regularly-scheduled bugfix release.

=== Notable changes ===
==== 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.

=== Bug fixes ===
 * 'hg amend' now correctly handles deleted and removed files, as well as subrepos. (Bts:issue5732, Bts:issue5677)
 * largefiles now correctly handles dropped standin files when updating largefiles.
 * Fixed an issue with deleting symlinks to directories when ui.origbackuppath is set. (Bts:issue5731)

=== Performance improvements ===
 * Improved performance in path conflict checking introduced in Mercurial 4.4. (Bts:issue5716)

== Mercurial 4.4.1 (2017-11-07) ==
=== Notable changes ===
 * Git and Subversion subrepos have been disabled by default to mitigate a potential security risk if files overlapping with a subrepo managed to be committed to a repository.
 * Subrepos are now more paranoid about symlink traversal.
 * The share extension handles drive letters on Windows better.

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.

== Mercurial 4.4 (2017-11-01) ==
=== Notable changes ===
==== 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.

==== 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
 1. 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.

==== Other changes ====
 * Estimated time is more accurate with non-linear progress

 * "hg status -v" can now show unfinished state. For example, when in an unfinished rebase state, "hg status -v" might show:
 {{{
 # The repository is in an unfinished *rebase* state.
 # No unresolved merge conflicts.
 # To continue: hg rebase --continue
 # To abort: hg rebase --abort
}}}

 * Added '--ignore-space-at-eol' diff option to ignore whitespace differences at line endings.

 * show: use consistent node length in views

 * show: decrease minimum displayed hash length from 5 to 4

 * A new uncommit extension which provides 'hg uncommit' using which one can uncommit part or all of the changeset. This command undoes the effect of a local commit, returning the affected files to their uncommitted state.

 * 'hg clone --uncompressed' uses clone bundles when possible

 * 'hg annotate --skip' now prints a '*' on lines with skipped revisions

 * New 'commands.update.check' feature to adjust constraints on when 'hg update' will allow updates with a dirty working copy.

 * Add an experimental -L/--line-range FILE,FROMLINE:TOLINE option to 'hg log' command to follow the history of files by line range. In combination with -p/--patch option, only diff hunks within specified line range will be displayed. Feedback, especially on UX aspects, is welcome.

 * Print warning when fsmonitor isn't being used on a large repository

=== Backwards Compatibility Changes ===
 * The config option for copytrace 'experimental.disablecopytrace' is now replaced with 'experimental.copytrace' which defaults to 'on'. If you need to turn off copytracing, add '[experimental] copytrace = off' to your config.

 * 'hg clone --stream' should now be used instead of --uncompressed. --uncompressed is marked as deprecated and is an alias for --stream. There is no schedule for elimination of --uncompressed.

 * The 'experimental.updatecheck' name for the new 'commands.update.check' feature is now deprecated, and will be removed after this release.

 * Mercurial subrepositories are now shared instead of cloned when the parent repository is shared. This prevents dangling subrepository references in the share source. Previously shared repositories with cloned subrepositories will continue to function unchanged.

 * Push no longer triggers a pushkey hook when updating phases. Use the new 'txnclose-phase' and 'txnclose-phase' hooks instead. (Applies when both server and client use version 4.4 or above).

=== Bug Fixes ===
 * Core rebase algorithm has been rewritten to be more robust (Bts:issue5578, Bts:issue5630)

 * Creating a share of a repository with a Mercurial subrepository will now share the subrepository (Bts:issue5675)

=== Performance Improvements ===
 * improved performance when many aliases are defined

=== API Changes ===
==== remove peer.batch() ====
Replace with peer.iterbatch().

==== Other Changes ====
 * @peer.batchable can no longer emit local values

 * @peer.batchable functions must now yield exactly 2 values

 * Rename attributes on sshpeer to reflect peer API

 * peer.peerrepository has been removed. Use repository.peer abstract base class to represent a peer repository.

 * revset.stringset() now takes 'order' as the last argument.

== Mercurial 4.3.3 (2017-10-01) ==
 * Prevent crashes when clearing progress bar. (Bts:issue5684)
 * rebase: move bookmarks with --keep (Bts:issue5682)

== Mercurial 4.3.2 (2017-09-18) ==
 * restore compatibility with older versions of Python 2.7 by not using a bytearray with struct.unpack_from()
 * restore mingw compatibility for setup.py
 * hgwebdir: read 'web.template' untrusted (plugs potential security issue)
 * repair: preserve phase when not using generaldelta (Bts:issue5678)
 * ssh: fix flakey ssh errors on BSD systems
 * restore error handling behavior around certain I/O errors; the regressed behavior could result in transactions not being properly rolled back if stdio handles encountered errors (Bts:issue5658)
 * templatekw: choose {latesttag} by len(changes), not date (Bts:issue5659)
 * record: fix revert -i for lines without newline (Bts:issue5651)
 * mq: create non-lossy patches, also with custom global diff configuration

== Mercurial 4.3 / 4.3.1 (2017-08-10) ==
(4.3.1 was released immediately after 4.3 to fix a release oversight.)

An [[Release4.3|overview of new features]] available. This is a regularly-scheduled quarterly feature release.

=== Notable changes ===
 * experimental amend extension providing the amend command
 * experimental sparse extension
 * Support for Python 2.6 has been dropped.
 * Bundles created by the strip extension now store phase information. It will be restored when unbundling.
 * The strip extension now removes relevant obsmarkers. If a backup requested (the default), the obsmarkers are stored in the backup bundle and will be restored when unbundling.
 * `hg show work` (from the experimental `show` extension) now displays more info
 * `hg show stack` is a new view for the current, in-progress changeset and others around it
 * Mitigation for two security vulnerabilities

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

=== 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.

== 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.

== Mercurial 4.2.2 (2017-07-05) ==
This is a regularly-scheduled bugfix release.

 * largefiles: avoid a crash when archiving a subrepo with largefiles disabled
 * rebase: also test abort from pretxnclose error
 * rebase: backed out changes 2519994d25ca and cf8ad0e6c0e4 (Bts:issue5610)
 * rebase: reinforce testing around precommit hook interrupting a rebase

== Mercurial 4.2.1 (2017-6-4) ==
This is a regularly-scheduled bugfix release.

 * `hg graft` now works when grafting across merges that were problematic before ([[https://www.mercurial-scm.org/repo/hg-stable/rev/b4e1e30528c7|b4e1e30528c7]]).
 * A race condition in `hg status` was partially fixed (Bts:issue5584).
 * The message about deprecated SHA-1 hashes in the [hostfingerprints] config section now references the correct syntax for replacing them with SHA-256 hashes (Bts:issue5559).

== Mercurial 4.2 (2017-5-2) ==
An [[Release4.2|overview of new features]] available. This is a regularly-scheduled quarterly feature release.

=== Notable changes ===
 * Pager support has been moved into core and is now enabled by default. This is now controlled with the ui.paginate setting.
  * Note that in 4.2-rc, the ui.paginate option was named pager.enable. The old name has been dropped in the final release. If you had turned pagination off using pager.enable=False, please update your config.
 * Color support has also been moved into core and is now enabled by default (the ui.color setting now defaults to 'auto').
 * The new experimental 'show' extension provides a way to view various information about your repository in an ergonomic way. It is deliberately designed for human consumption and not for scripting, so it doesn't carry the same [[CompatibilityRules|backward compatibility guarantees]] as other commands. See 'hg help -e show' for more information.
 * Mercurial now requires `setuptools` on Windows.

=== commands ===
 * Pager support has been added to the 'log', 'diff', 'branches', 'files', 'status', 'summary', and 'tags' commands, as well as the '--patch', '--list', and '--stat' options of hg shelve.
 * bisect: set a blockedtag when running the check command
 * bookmarks: check HG_PENDING strictly
 * branches: populate all template keywords in formatter
 * commandserver: handle backlog before exiting
 * commandserver: prevent unlinking socket twice
 * commit: optionally strip quotes from commit template (BC)
 * diff: add --binary option for git mode diffs
 * help: add pointer how to narrow list of resolved/unresolved files (Bts:issue5469)
 * pager: advertise the config option in the default hgrc
 * pager: avoid shell=True on subprocess.Popen for better errors (Bts:issue5491)
 * pager: don't terminate with extreme prejudice on SIGPIPE (BC)
 * pager: exit cleanly on SIGPIPE (BC)
 * pager: improve support for various flavors of 'more' on Windows
 * pager: use less as a fallback on Unix
 * pull: abort pull --update if config requires destination (Bts:issue5528)
 * serve: add support for Mercurial subrepositories
 * status: handle more node indicators in buildstatus
 * status: support commands.status.relative config
 * update: accept --merge to allow merging across topo branches (Bts:issue5125)
 * verify: fix length check

=== core ===
 * bundle2: ignore errors seeking a bundle after an exception (Bts:issue4784)
 * checkheads: upgrade the obsolescence postprocessing logic (Bts:issue4354)
 * color: insert color code after every "\e[0m" (Bts:issue5413)
 * color: sync text attributes and buffered text output on Windows (Bts:issue5508)
 * config: use "churn" as an example extension
 * config: drop pager from the recommended extension
 * context: optimize linkrev adjustment in blockancestors() (Bts:issue5538)
 * crecord: avoid setting non-existing SIGTSTP signal on windows (Bts:issue5512)
 * debian: configure editor and pager to sensible-editor and sensible-pager by default
 * dispatch: ignore further SIGPIPE while handling KeyboardInterrupt
 * dispatch: protect against malicious 'hg serve --stdio' invocations (SEC)
 * dispatch: start profiling earlier
 * filemerge: optionally strip quotes from merge marker template (BC)
 * formatter: add support for changeset templating
 * formatter: support json formatting of long type
 * graphlog: draw multiple edges towards null node (Bts:issue5440)
 * graphlog: optionally strip quotes from graphnode template (BC)
 * localrepo: deprecate 'repo.join' in favor of 'repo.vfs.join'
 * localrepo: deprecate 'repo.opener' (API)
 * localrepo: deprecate 'wfile'
 * localrepo: deprecated 'repo.wopener' (API)
 * match: adding support for matching files inside a directory
 * packaging: add make target for linux wheels
 * patch: make diff in git mode respect --text option (Bts:issue5510)
 * plain: ignore [commands] config
 * profiling: add statprof support for Chrome trace viewer rendering
 * progress: retry ferr.flush() and .write() on EINTR (Bts:issue5532)
 * py3: stop exporting urlparse from pycompat and util (API)
 * rcutil: let environ override system configs (BC)
 * rcutil: let rccomponents return different types of configs (API)
 * rcutil: move scmutil.*rcpath to rcutil (API)
 * rcutil: rename rcpath to rccomponents (API)
 * rcutil: split osrcpath to return default.d paths (API)
 * record: update help message to use operation instead of "record" (Bts:issue5432)
 * revlog: avoid applying delta chain on cache hit
 * revset: split language services to revsetlang module (API)
 * revset: stop supporting plain list as input set (API)
 * revset: stop supporting predicate that returns plain list (API)
 * setup: use setuptools on Windows (Bts:issue5400)
 * smartset: move set classes and related functions from revset module (API)
 * sshpeer: try harder to snag stderr when stdout closes unexpectedly
 * templatefilter: add support for 'long' to json()
 * templatekw: have showlist() take mapping dict with no **kwargs expansion (API)
 * templatekw: make join() escape values of extras (BC) (Bts:issue5504)
 * templater: make pad() strip color codes before computing width (Bts:issue5416)
 * test-profile: allow negative time in JSON output (issue5542)
 * track-tags: write all tag changes to a file
 * util: always force line buffered stdout when stdout is a tty (BC)
 * vfs: extract 'vfs' class and related code to a new 'vfs' module (API)

=== extensions ===
 * histedit: log the time taken to read in the commands list
 * histedit: make check for unresolved conflicts explicit (Bts:issue5545)
 * histedit: modify rollup to discard date from the rollup commit (Bts:issue4820)
 * histedit: use safecleanupnode in _aborthistedit (Bts:issue5500)
 * largefiles: add copytostore() fstandin argument to replace readstandin() (API)
 * largefiles: add lfile argument to updatestandin() for efficiency (API)
 * largefiles: make copytostore() accept only changectx as the 2nd argument (API)
 * largefiles: omit updating newly added standin at linear merging
 * largefiles: remove unused keyword argument of copytostore() (API)
 * largefiles: replace hashrepofile by hashfile (API)
 * largefiles: set the extension as enabled locally after a share requiring it
 * patchbomb: add config knob to generate flags by template (Bts:issue5354)
 * patchbomb: drop internal option for pbranch extension (API)
 * patchbomb: use modern pager to display -n/--test result (BC)
 * rebase: abort hg pull --rebase if rebase.requiredest is set (Bts:issue5514)
 * rebase: abort if *any* commit in rebase set is public
 * rebase: add flag to require destination
 * rebase: allow aborting if last-message.txt is missing
 * rebase: allow destination-free continue and abort (Bts:issue5513)
 * rebase: allow rebasing children of wd to wd if a new branch has been set (BC)
 * rebase: unhide original working directory node as well (Bts:issue5219)
 * shelve: add -n/--name option to unshelve (Bts:issue5475)
 * shelve: add logic to preserve active bookmarks
 * show: new extension for displaying various repository data

=== hgweb ===
 * hgweb: add a "patch" query parameter to filelog command
 * hgweb: do not show "descending" link in followlines UI for filelog heads
 * hgweb: handle a "descend" query parameter in filelog command
 * hgweb: handle a "linerange" request parameter in filelog command
 * hgwebdir: add support for explicit index files

=== Behavior changes ===
 * commit: optionally strip quotes from commit template (BC)
 * filemerge: optionally strip quotes from merge marker template (BC)
 * graphlog: optionally strip quotes from graphnode template (BC)
 * pager: don't terminate with extreme prejudice on SIGPIPE (BC)
 * pager: exit cleanly on SIGPIPE (BC)
 * patchbomb: use modern pager to display -n/--test result (BC)
 * rcutil: let environ override system configs (BC)
 * rebase: allow rebasing children of wd to wd if a new branch has been set (BC)
 * templatekw: make join() escape values of extras (BC) (Bts:issue5504)
 * util: always force line buffered stdout when stdout is a tty (BC)

=== Internal API changes ===
 * largefiles: add copytostore() fstandin argument to replace readstandin() (API)
 * largefiles: add lfile argument to updatestandin() for efficiency (API)
 * largefiles: make copytostore() accept only changectx as the 2nd argument (API)
 * largefiles: remove unused keyword argument of copytostore() (API)
 * largefiles: replace hashrepofile by hashfile (API)
 * localrepo: deprecate 'repo.opener' (API)
 * localrepo: deprecated 'repo.wopener' (API)
 * patchbomb: drop internal option for pbranch extension (API)
 * py3: stop exporting urlparse from pycompat and util (API)
 * rcutil: let rccomponents return different types of configs (API)
 * rcutil: move scmutil.*rcpath to rcutil (API)
 * rcutil: rename rcpath to rccomponents (API)
 * rcutil: split osrcpath to return default.d paths (API)
 * revset: split language services to revsetlang module (API)
 * revset: stop supporting plain list as input set (API)
 * revset: stop supporting predicate that returns plain list (API)
 * smartset: move set classes and related functions from revset module (API)
 * templatekw: have showlist() take mapping dict with no **kwargs expansion (API)
 * vfs: extract 'vfs' class and related code to a new 'vfs' module (API)

== Mercurial 4.1.3 (2017-4-18) ==
This is an out of cycle release to address a security issue:

 * `hg serve --stdio` could be tricked into granting authorized users access to the Python debugger. Thanks to Jonathan Claudius of Mozilla for reporting this issue. This issue is only a security issue for repositories served using --stdio, which includes ssh but *not* http. This is CVE-2017-9462.

== Mercurial 4.1.2 (2017-4-3) ==
This is a regularly-scheduled bugfix release.

 * Mercurial should work inside IIS on Windows again. (Bts:issue5493)
 * zstd support now refuses to work on old bundle formats. (Bts:issue5506)
 * Merges involving subrepositories no longer crash in some cases. (Bts:issue5505)
 * Checking for new heads during push is [[https://www.mercurial-scm.org/repo/hg/rev/ed5b25874d998ababb181a939dd37a16ea644435|no longer]] accidentally quadratic

== Mercurial 4.1.1 (2017-3-2) ==
This is a regularly-scheduled bugfix release.

 * Several incorrect mailing list addresses have been corrected.
 * Various error cases have been corrected during push and pull.
 * Minor issues that happened when Mercurial spawned worker processes have been fixed.
Line 98: Line 1262:
Line 109: Line 1272:
Line 121: Line 1283:
Line 136: Line 1297:
An [[Release4.0|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.  An [[Release4.0|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.
Line 159: Line 1320:
 
Line 176: Line 1337:
 
Line 194: Line 1355:

== Mercurial 3.9.2 (2016-10-1) ==
This is a regularly-scheduled bugfix release.

 * annotate: correct output in some merge cases (Bts:issue5360)
 * crecord: properly handle files with No newline at eof (Bts:issue5268)
 * grep: rewrite help to better document current (confusing) behavior

== Mercurial 3.9.1 (2016-9-1) ==
This is a regularly-scheduled bugfix release.

 * bundle2: fail faster when interrupted
 * bundle2: localize handleoutput remote prompts
 * convert: move svn config initializer out of the module level
 * debian: update source URL in copyright file
 * exchange: correctly specify url to unbundle (Bts:issue5145)
 * help: add example of '[templates]' usage
 * help: update link to wiki/CommandServer
 * osx: update bugzilla link in readme
 * revset: fix keyword arguments to go through optimization process
 * win32: update link to mailing list in readme
 * win32: update wiki link in mercurial.ini

== Mercurial 3.9 (2016-8-1) ==
An [[Release3.9|overview of new features]] available.

=== commands ===
 * annotate: handle empty files earlier
 * annotate: optimize line counting
 * bookmarks: abort 'push -B .' when no active bookmark
 * bookmarks: add 'hg pull -B .' for pulling the active bookmark (Bts:issue5258)
 * bookmarks: jettison bmstore's write() method per deprecation policy
 * bookmarks: make writing files out avoid ambiguity of file stat
 * commandserver: add new forking server implemented without using SocketServer
 * commandserver: backport handling of forking server from chgserver
 * commandserver: manually create file objects from socket
 * commandserver: send pgid in hello message
 * commandserver: use SOMAXCONN as queue size of pending connections
 * patch: allow copy information to be passed in
 * patch: define full messages for interactive record/revert
 * pull: add help information about pulling active bookmark
 * revert: don't backup if no files reverted in interactive mode (Bts:issue4793)
 * revert: use "discard"/"revert" verb when reverting interactively (Bts:issue5143)
 * update: fix bug when update tries to modify folder symlink

=== core ===
 * date: accept broader range of ISO 8601 time specs
 * revlog: add a fast path for "ambiguous identifier"
 * templatekw: fix join format of parents keyword (Bts:issue5292)
 * templatekw: fix join format of revset() function
 * revset: build dict of extra sort options before evaluating set
 * transaction: turn lack of locking into a hard failure (API)
 * ui: don't fixup [paths] sub-options
 * ui: path option to declare which revisions to push by default
 * ui: provide official way to reset internal state per command
 * sslutil: allow TLS 1.0 when --insecure is used
 * sslutil: improve messaging around unsupported protocols (Bts:issue5303)
 * sslutil: work around SSLContext.get_ca_certs bug on Windows (Bts:issue5313)
 * sslutil: abort when unable to verify peer connection (BC)
 * sslutil: config option to specify TLS protocol version
 * sslutil: convert socket validation from a class to a function (API)
 * sslutil: don't access message attribute in exception (Bts:issue5285)
 * sslutil: more robustly detect protocol support
 * sslutil: move sslkwargs logic into internal function (API)
 * sslutil: per-host config option to define certificates
 * sslutil: remove sslkwargs() (API)
 * sslutil: remove ui from sslkwargs (API)
 * sslutil: require TLS 1.1+ when supported
 * sslutil: require serverhostname argument (API)
 * sslutil: stop checking for web.cacerts=! (BC)
 * sslutil: support defining cipher list
 * hg: copy [hostsecurity] options to remote ui instances (Bts:issue5305)
 * demandimport: avoid infinite recursion at actual module importing (Bts:issue5304)
 * rbc: fix superfluous rebuilding from scratch - don't abuse self._rbcnamescount
 * url: avoid re-issuing incorrect password (Bts:issue3210)
 * util: better handle '-' in version string (Bts:issue5302)
 * packagelib: do not remove packages directory in hggetversion (Bts:issue5262)

=== extensions ===
 * histedit: add optional parameter for determining intial editor line
 * largefiles: check file in the repo store before checking remotely (Bts:issue5257)
 * largefiles: make cloning not ask two times about password (Bts:issue4883)
 * largefiles: makes verify batching stat calls to remote
 * largefiles: send statlfile remote calls only for nonexisting locally files
 * rebase: do not abort if all changesets have equivalents in the destination
 * rebase: handle successor targets (Bts:issue5198)
 * rebase: introduce a rebaseruntime (RR) class
 * rebase: make collapsing use explicit logic to decide on the rev to reuse
 * rebase: pass repo, ui and opts objects to the RR class constructor
 * rebase: remove sortedstate-related confusion
 * shelve: make unshelve be able to abort in any case
 * keyword: avoid traceback when kwdemo is run outside a repo
 * rebase: turn rebase revs into set before filtering obsolete
 * extdiff: escape path for docstring (Bts:issue5301)

=== unsorted ===
 * atomictempfile: add context manager support
 * atomictempfile: add read to the supported file operations
 * bashcompletion: show available command-line switches for aliases
 * chg: send SIGPIPE to server immediately when pager exits (Bts:issue5278)
 * dispatch: add fail-* family of hooks
 * dispatch: always load extensions before running shell aliases (Bts:issue5230)
 * dispatch: defer environment variable resolution in alias commands (BC)
 * dispatch: set ui.insecureconnections when --insecure is used
 * dispatch: stop setting web.cacerts=! to indicate --insecure
 * error: make HintException a mix-in class not derived from BaseException (API)
 * error: make hintable exceptions reject unknown keyword arguments (API)
 * hgcia: remove hgcia (BC)
 * journal: add share extension support
 * journal: add support for seaching by pattern
 * localrepo: jettison parents() method per deprecation policy (API)
 * mail: unsupport smtp.verifycert (BC)
 * py3: shift from __future__ import absolute import to beginning (Bts:issue5269)
 * rollback: add a config knob for entirely disabling the command
 * subrepo: use unset instead of env -u to fix test on BSDs (Bts:issue5229)
 * templates: add support for filelog webcommand in json style
 * templates: add support for filerevision webcommand in json style
 * templates: add support for search webcommand in json style
 * templates: add support for summary webcommand in json style
 * update: fix bare --clean to work on new branch (Bts:issue5003) (BC)
 * url: add distribution and version to user-agent request header (BC)
 * chg: forward SIGINT, SIGHUP to process group

== Mercurial 3.8.4 (2016-7-01) ==
This is a regularly-scheduled bugfix release.

 * bdiff: extend matches across popular lines
 * bdiff: remove effectively dead code
 * bundle2: don't assume ordering of heads checked after push
 * help: document that [subpaths] may rewrite relative paths
 * largefiles: fix support for local largefiles while using share extension
 * sslutil: synchronize hostname matching logic with CPython

== Mercurial 3.8.3 (2016-6-01) ==
This is a regularly-scheduled bugfix release.

 * bookmarks: allow pushing active bookmark on new remote head (Bts:issue5236)
 * localrepo: prevent executable-bit only changes from being lost on amend
 * strip: invalidate phase cache after stripping changeset (Bts:issue5235)

== Mercurial 3.8.2 (2016-5-16) ==
This is an unscheduled bugfix release. 3.8.1 contained a noisy deprecation warning that was only intended for Mercurial developers, sorry.

 * bookmarks: properly invalidate volatile sets when writing bookmarks
 * builddeb: add distroseries to tagged versions
 * bundle2: properly request phases during getbundle
 * debian: add wish to suggests
 * debian: forgot to make debian/rules executable in 6b95a623ec90
 * deprecation: gate deprecation warning behind devel configuration
 * help: fix the display for `hg help internals.revlogs` (Bts:issue5227)
 * help: search section of help topic by translated section name correctly
 * hg-ssh: copy doc string to man page
 * patch: show lower-ed translated message correctly
 * progress: stop excessive clearing (Bts:issue4801)

== Mercurial 3.8 / 3.8.1 (2016-5-1) ==
(3.8.1 was released immediately after 3.8 to fix a release oversight.)

Regularly scheduled feature release. This release contains a low-priority security fix for:

CVE-2016-3105 Mercurial: arbitrary code execution when converting Git repos

 . Mercurial prior to 3.8 allowed arbitrary code execution when using the convert extension on Git repos with hostile names. This could affect automated code conversion services that allow arbitrary repository names. This is a further side-effect of Git CVE-2015-7545. Reported and fixed by Blake Burkhart.

There's also an [[Release3.8|overview of new features]] available.

=== commands ===
 * bookmarks: add 'hg push -B .' for pushing the active bookmark (Bts:issue4917)
 * bookmarks: avoid creating a nested repository during testing
 * branchmap: check node against changelog instead of repo
 * commands: add postincoming explicit brev argument (API)
 * commands: centralize code to update with extra care for non-file components
 * commit: block amend while histedit is in progress (Bts:issue4800)
 * fileset: replace predicate by filesetpredicate of registrar (API)
 * graft: suggest the correct tool to continue (not graft)
 * graft: use single quotes around command hint
 * log: disable graph styling when HGPLAIN is set (Bts:issue5212)
 * log: fix seen state handling for > 2 parents (Bts:issue5174)
 * log: fix status template to list copy source per dest (Bts:issue5155)
 * merge: minimize conflicts when common base is not shown (Bts:issue4447)
 * pull: activate a bookmark matching with the destination of the update (BC)
 * pull: deactivate a bookmark not matching with the destination of the update
 * revert: makes interactive mode ask to forget added files (Bts:issue4936)
 * verify: check directory manifests
 * verify: check for orphaned dirlogs
 * verify: include "manifest" prefix in a few more places
 * verify: move cross-checking of changeset/manifest out of _crosscheckfiles()
 * verify: show progress while verifying dirlogs
 * verify: don't init subrepo when missing one is referenced (Bts:issue5128) (API)

=== core ===
 * bdiff: balance recursion to avoid quadratic behavior (Bts:issue4704)
 * bdiff: further restrain potential quadratic performance
 * hook: report untrusted hooks as failure (Bts:issue5110) (BC)
 * revset: remove useless extpredicate class (API)
 * revset: make sort() do dumb multi-pass sorting for multiple keys (Bts:issue5218)
 * templater: load and expand aliases by template engine (API) (Bts:issue4842)
 * templater: separate function to create templater from map file (API)
 * ui: add prompt argument to write (Bts:issue5154) (API)

=== extensions ===
 * convert: keep converted hg parents that are outside convert.hg.revs (BC)
 * histedit: adds hint how to reorder changesets at editor (Bts:issue3766)
 * histedit: improve error when run on nodes with children (Bts:issue5056)
 * histedit: make histedit aware of obsolescense not stored in state (Bts:issue4800)
 * largefiles: add abstract methods in remotestore class
 * largefiles: don't access repo.changelog directly in getlfilestoupload
 * largefiles: don't explicitly list optional parameters that are not used
 * largefiles: drop partial support for not having a user cache
 * largefiles: introduce push --lfrev to control which revisions are pushed
 * largefiles: replace invocation of os.path module by vfs in lfcommands.py
 * largefiles: specify unit for ui.progress when operating on files
 * largefiles: use revisions as a ui.progress unit
 * rebase: 'hg pull --rebase' now update only if there was nothing to rebase
 * rebase: add potential divergent commit hashes to error message (Bts:issue5086)
 * rebase: adds storing collapse message (Bts:issue4792)
 * rebase: choose default destination the same way as 'hg merge' (BC)
 * rebase: explicitly test abort from ambiguous destination
 * rebase: fix crash when rebase aborts while rebasing obsolete revisions
 * rebase: mention help merge-tools in help
 * rebase: perform update through the 'update' command
 * rebase: remove experimental option from 'rebase' config section
 * rebase: respect checkunknown and checkignored in more cases
 * rebase: suggest the correct tool to continue (not rebase)
 * rebase: restrict rebase destination to the pulled set (Bts:issue5214)
 * shelve: adds restoring newly created branch (Bts:issue5048) (BC)
 * shelve: changes getting opts values by get method
 * shelve: make non bare shelve not saving branch information in bundle
 * shelve: preserve newly created branch on non-bare shelve in wctx (BC)
 * shelve: suggest the correct tool to continue (not unshelve)

=== hgweb ===
 * hgweb: add option to convert encoding of graphdata()
 * hgweb: add parents to json-log (Bts:issue5074)
 * hgweb: generate last change date for an empty atom-bookmarks feed (Bts:issue5022)

=== unsorted ===
 * blackbox: optionally log event source
 * bugzilla: do not load style file if template is specified (BC)
 * bundle: move writebundle() from changegroup.py to bundle2.py (API)
 * bundle: warn when update to revision existing only in a bundle (Bts:issue5004)
 * bundlerepo: properly handle hidden linkrev in filelog (Bts:issue4945)
 * changelog: add class to represent parsed changelog revisions
 * changelog: avoid slicing raw data until needed
 * changelog: backed out changeset 1778770e1982
 * changelog: backed out changeset 86de91c56355
 * changelog: lazily parse date/extra field
 * changelog: lazily parse description
 * changelog: lazily parse files
 * changelog: lazily parse manifest node
 * changelog: lazily parse user
 * changelog: lazy decode description (API)
 * changelog: lazy decode user (API)
 * changelog: parse description last
 * chg: fallback to original hg for some unsupported commands or flags
 * chg: forward job control signals to worker process (Bts:issue5051)
 * chg: pass sensitive command line flags to server
 * chgserver: create new process group after fork (Bts:issue5051)
 * date: reallow negative timestamp, fix for Windows buggy gmtime() (Bts:issue2513)
 * debugrevlog: fix dumping manifest fails on empty first revision (Bts:issue5062)
 * demandimport: blacklist sqlalchemy.events as it has side effects (Bts:issue5085)
 * demandimport: enforce ignore list while processing modules in fromlist
 * destutil: choose non-closed branch head at first (BC)
 * dispatch: add wd parameter to _getlocal
 * dispatch: catch KeyboardInterrupt more broadly
 * dispatch: factor out command failure handling into a function
 * dispatch: flush ui before returning from dispatch
 * dispatch: make cmdalias forward command attributes to function
 * dispatch: make loading extra information from extension extensible
 * dispatch: show deprecation warning if command has no attributes (Bts:issue5137)
 * dispatch: store norepo/optionalrepo/inferrepo attributes in function (API)
 * dispatch: strip command line options like config file options
 * encoding: add option to escape non-ascii characters in JSON
 * graphlog: bring back color to node symbol template
 * graphmod: set default edge styles for ascii graphs (BC)
 * hg: perform update after pulling during clone with share (Bts:issue5103)
 * http: support sending hgargs via POST body instead of in GET or headers
 * localrepo: move new repo requirements into standalone function (API)
 * localrepo: support background closing for wwrite()
 * mail: retain hostname for sslutil.wrapsocket (Bts:issue5203)
 * match: rename "narrowmatcher" to "subdirmatcher" (API)
 * mpatch: un-nest the move() method
 * mpatch: unify mpatchError (Bts:issue5182)
 * notify: do not load style file if template is specified (BC)
 * record: deprecate the extension
 * registrar: add templatefilter to mark a function as template filter (API)
 * registrar: add templatefunc to mark a function as template function (API)
 * registrar: add templatekeyword to mark a function as template keyword (API)
 * registrar: remove useless base classes (API)
 * remove: add progress support
 * remove: fix --force option help description (Bts:issue5177)
 * remove: queue warnings until after status messages (Bts:issue5140) (API)
 * scmutil: support background closing for write()
 * serve: add chdir command for --daemon-postexec
 * serve: rename --daemon-pipefds to --daemon-postexec (BC)
 * sslutil: require a server hostname when wrapping sockets (API)
 * streamclone: specify unit for ui.progress when handling data
 * subrepo: disable localizations when calling Git (Bts:issue5176)
 * templatefilters: drop broken "jsonescape" from filters table (BC)
 * templatefilters: make json filter be byte-transparent (BC) (Bts:issue4926)
 * templatekw: switch ctx of list expression to rev of {parents} (BC)
 * test-debugextensions: passes with byte-compilation disabled (Bts:issue5147)
 * testing: expand Hypothesis tests with branch commands
 * tests: add test for "log -r wdir() -p" (Bts:issue4871)
 * tests: ensure that 'hg update' is disabled during histedit (Bts:issue3655)
 * tests: update test output for test written on stable branch (Bts:issue5104)
 * treemanifest: don't use cp -T, not supported on OS X
 * update: change default destination to tipmost descendant (Bts:issue4673) (BC)
 * update: check command line before modifying repo
 * version: verbose list internal and external extension source (Bts:issue4731)

== Mercurial 3.7.3 (2016-3-29) ==
This is an out of cycle release to address three security issues:

CVE-2016-3630 Mercurial: remote code execution in binary delta decoding

 . Mercurial prior to 3.7.3 contained two bounds-checking errors in its binary delta decoder that may be exploitable via clone, push, or pull.

CVE-2016-3068 Mercurial: arbitrary code execution with Git subrepos

 . Mercurial prior to 3.7.3 allowed URLs for Git subrepos that could result in arbitrary code execution on clone. This is a further side-effect of Git CVE-2015-7545. Reported by Blake Burkhart.

CVE-2016-3069 Mercurial: arbitrary code execution when converting Git repos

 . Mercurial prior to 3.7.3 allowed arbitrary code execution when converting Git repos with hostile names. This could affect automated conversion services. Reported by Blake Burkhart.

 * bdiff: (pure) support array.array arrays (Bts:issue5130)
 * convert: add new, non-clowny interface for shelling out to git (SEC)
 * convert: dead code removal - old git calling functions (SEC)
 * convert: rewrite calls to Git to use the new shelling mechanism (SEC)
 * convert: rewrite gitpipe to use common.commandline (SEC)
 * convert: test for shell injection in git calls (SEC)
 * files: don't recurse into subrepos without a path or -S (Bts:issue5127)
 * hg: perform update after pulling during clone with share (Bts:issue5103)
 * mq: restrict generated patch name to 75 characters (Bts:issue5117)
 * obsolete: fix n^2 marker computation behavior
 * parsers: detect short records (SEC)
 * parsers: fix list sizing rounding error (SEC)
 * streamclone: fix error when store files grow while stream cloning
 * subrepo: adapt to git's recent renames-by-default
 * subrepo: set GIT_ALLOW_PROTOCOL to limit git clone protocols (SEC)

== Mercurial 3.7.2 (2016-3-1) ==
This is a regularly-scheduled bugfix release.

 * bundlerepo: properly handle hidden linkrev in filelog (Bts:issue4945)
 * bundlerepo: properly handle hidden linkrev in manifestlog (Bts:issue4945)
 * demandimport: add _imp to ignore list
 * doc: correct example concerning "hg purge" alias in man page "hgrc.5"
 * doc: remove deprecated option from synopsis of command help
 * fileset: fix copy/paste in eol() error message
 * help: fix typo in backgroundclose documentation
 * help: hg.intevation.de is new primary name of hg.intevation.de (and new cert)
 * help: update template examples to use reST literal syntax
 * hg: obtain lock when creating share from pooled repo (Bts:issue5104)
 * log: fix order of revisions filtered by multiple OR options (Bts:issue5100)
 * rebase: update working directory when aborting (Bts:issue5084)
 * revert: properly revert to ancestor of p2 during merge (Bts:issue5052)
 * revset: flatten chained 'list' operations (aka function args) (Bts:issue5072)
 * setup: avoid procedure related to hg.exe at setup.py --pure
 * ui: fix crash by non-interactive prompt echo for user name
 * unionrepo: properly handle hidden linkrev in revlog (Bts:issue5070)
 * zeroconf: forward all arguments passed to ui.configitems() wrapper

== Mercurial 3.7.1 (2016-2-3) ==
This addresses an urgent regression in compilation on Solaris and metadata handling for conversions.

 * amend: don't preserve most extra fields
 * graft: don't preserve most extra fields
 * histedit: fix typo in documentation
 * osutil: disable compilation of recvfds() on unsupported platforms
 * osutil: do not abort loading pure module just because libc has no recvmsg()
 * rebase: backout changeset 986d04b9fedd
 * rebase: backout changeset d755a9531fce
 * rebase: don't preserve most extra fields

== Mercurial 3.7 (2016-2-1) ==
Regularly scheduled feature release. There's also an [[Release3.7|overview of new features]] available.

=== commands ===
 * merge: don't try to merge subrepos twice (Bts:issue4988)
 * pull: advance current active bookmark at pull --update correctly
 * templater: abort if infinite recursion detected while evaluation (Bts:issue4758)

 * annotate: add missing period to help
 * annotate: mention that -n is suppressed in help
 * backout: disable --merge with --no-commit (Bts:issue4874)
 * bookmark: deprecate 'bmstore.write' method
 * bookmarks: hoist getbkfile out of bmstore class
 * bookmarks: make _readactive safe when readlines raises ENOENT
 * branch: reword help text
 * clone: move bookmarks and checkouts before pull help
 * clonebundles: improve BUNDLESPEC documentation
 * clonebundles: remove advertisement of feature
 * commands.summary: switch to mergestate.read()
 * commands: inline definition of localrepo.parents() and drop the method (API)
 * commands: make backout acquire locks before processing
 * commands: make commit acquire locks before processing (Bts:issue4368)
 * commands: use context manager for opened bundle file
 * commandserver: drop tell() and seek() from channels (Bts:issue5049)
 * commandserver: reset state of progress bar per command
 * commit: add a way to return more information from the chunkselector
 * commit: add amend mode for crecord commit -i
 * commit: add some help examples (Bts:issue4963)
 * commit: adjust the quoting in the examples to be Windows friendly
 * commit: fix rest syntax of examples
 * commit: make commit acquire store lock before processing for consistency
 * commit: preserve extra when amending with commit --amend
 * fileset: add missing() predicate (Bts:issue4925)
 * fileset: use set instead of list to mark predicates for efficiency (API)
 * graft: clarify in help that '-r' is not just optional
 * graft: copy extra (except branch) when copying changesets
 * graft: hook afterresolvedstates
 * graft: improve --continue abort message
 * help: fix quoting for bundle1 options
 * import: add word to help text
 * import: limit scope of msg in tryimportone
 * import: reorder help text
 * log: speed up single file log with hidden revs (Bts:issue4747)
 * log: add 'hg log' example for full hashes
 * log: help provide sort by date example
 * log: mention ordering
 * log: speed up hg log <file|folder>
 * merge.graft: add option to keep second parent
 * merge: add options to warn or ignore on colliding unknown files
 * merge: move almost all change/delete conflicts to resolve phase (BC) (API)
 * merge: refuse update/merge if there are unresolved conflicts (BC)
 * mergestate: raise structured exception for unsupported merge records
 * patch: disable nobinary when HGPLAIN=1
 * pull: make a single call to obsstore.add (Bts:issue5006)
 * pull: return 255 value on update failure (Bts:issue4948) (BC)
 * push: specify default-push and default as fallback paths
 * status: back out changeset 89f49813526c
 * status: change + back out == clean (API)
 * status: revert + flag-change == modified
 * summary: add troubles list to the output of hg summary
 * summary: mention graft
 * summary: print unstable, bumped and divergent as unconditionally plural
 * tags: mention --quiet switch in help (Bts:issue4920)
 * verify: add a hook that can let extensions manipulate file lists
 * verify: clean up weird error/warning lists
 * verify: get rid of some unnecessary local variables
 * verify: move checklog() onto class
 * verify: move exc() function onto class
 * verify: remove unreachable code to reraise KeyboardInterrupt

=== core ===
 * context: don't use util.cachefunc due to cycle creation (Bts:issue5043)
 * context: use a the nofsauditor when matching file in history (Bts:issue4749)
 * parsers: check results of PyInt_FromLong (Bts:issue4771)
 * repoview: fix corrupted hiddencache crash Mercurial (Bts:issue5042)
 * revlog: avoid string slice when decompressing u* chunks
 * revlog: clarify which revision is added to 'tested' when using cached delta
 * revlog: don't consider nullrev when choosing delta base
 * revlog: improve documentation
 * revlog: make calls to _isgooddelta() consistent
 * revlog: make clearcaches() more effective
 * revlog: return offset from _chunkraw()
 * revsetbenchmarks: support benchmarking changectx loading
 * ui: optionally ignore sub-options from configitems()
 * ui: support declaring path push urls as sub-options
 * util: disable floating point stat times (Bts:issue4836)
 * wireproto: config options to disable bundle1
 * wireproto: support disabling bundle1 only if repo is generaldelta

=== extensions ===
 * crecord: fix help bar display issue (Bts:issue5063)
 * histedit: add progress support
 * histedit: explain basics of histedit commands
 * histedit: pick an appropriate base changeset by default (BC)
 * largefiles: actions will now always have a file - drop check
 * largefiles: fall back to the original for change/delete conflicts
 * largefiles: fix commit of missing largefiles
 * largefiles: make prompt order deterministic
 * largefiles: specify where .orig files are kept
 * largefiles: use a context manager in _getfile
 * largefiles: use util.readfile in lfconvert
 * largefiles: use util.readfile in overrides
 * largefiles: fix an explicit largefile commit after a remove (Bts:issue4969)
 * largefiles: prevent committing a missing largefile
 * mq: check for reserved patch name with qimport -r (Bts:issue5033)
 * mq: let the user choose where .orig files are kept
 * rebase: add date parameter to concludenode function
 * rebase: better error message when rebased changes are all in destination
 * rebase: create a new variable to make the next patch more legible
 * rebase: hook afterresolvedstates
 * rebase: only clear rebase status after the rebase transaction has completed
 * rebase: pass date parameter to concludenode
 * rebase: prevent creating divergence
 * rebase: propagate extra dict from rebase source changeset
 * rebase: remove extra "if" from check of collapsing named branches
 * rebase: better way to detect non-detaching revisions (Bts:issue5044)
 * rebase: restore help for rebase w/o args (Bts:issue5059)
 * shelve: choose where .orig file locations are kept
 * shelve: execute checkunfinished inside wlock scope
 * shelve: hook afterresolvedstates
 * shelve: lowercase flag description
 * shelve: permit shelves to contain unknown files
 * shelve: remove redundant acquisition of wlock for sub commands of unshelve
 * shelve: switch to mergestate.read()
 * shelve: use a context manager for file I/O in listcmd
 * shelve: widen wlock scope of shelve for consistency while processing
 * shelve: widen wlock scope of unshelve for consistency while processing
 * unshelve: add -k as short form of --keep
 * unshelve: add support for custom merge tools
 * unshelve: shed spurious space

=== hgweb ===
 * hgweb: eliminate duck-typing to select hgweb or hgwebdir by command option
 * hgweb: load server settings from --web-conf (Bts:issue4699)
 * hgweb: make sure command options are set to all ui objects
 * hgweb: support rendering a sub-topic
 * hgweb: support rendering sub-topic indexes
 * hgweb: update canvas.width before dynamically redrawing graph (Bts:issue2683)

=== unsorted ===
 * addrevision: only use the incoming base if it is a good delta (Bts:issue4975)
 * backout: commit changeset by default (BC)
 * backout: fix --no-commit option (Bts:issue5054)
 * batchget: add support for backing up files
 * builddeb: add --distid option to specify Distributor ID
 * changegroup: introduce cg3, which has support for exchanging treemanifests
 * changelog: add a new method to get files modified by a changeset
 * checkunknownfiles: make control flow clearer
 * crecord: edit during hg crecord should preserve cursor position (Bts:issue5041)
 * debugignore: find out why a file is being ignored (Bts:issue4856)
 * demandimport: add support for PyPy
 * demandimport: don't enable when running under PyPy
 * destutil: use scmutil.revrange for desthistedit (Bts:issue5001)
 * diff: don't crash when merged-in addition was removed (Bts:issue4786)
 * discovery: properly filter changeset in 'peer.known' (Bts:issue4982)
 * dispatch: copy inferrepo attribute to alias commands
 * dispatch: report similar names consistently
 * dispatch: use print function
 * dispatch: use versiontuple()
 * dockerrpm: fix CentOS 5 RPMs (Bts:issue4977)
 * encoding: handle UTF-16 internal limit with fromutf8b (Bts:issue5031)
 * encoding: re-escape U+DCxx characters in toutf8b input (Bts:issue4927)
 * error: add a structured exception for unsupported merge records
 * extdiff: correctly handle deleted subrepositories (Bts:issue3153)
 * extdiff: use @command decorator to set up diff commands
 * filemerge: add a 'leave unresolved' option to change/delete prompts
 * filemerge: add a 'leave unresolved' option to regular prompts
 * filemerge: add support for change/delete conflicts to the ':local' merge tool
 * filemerge: add support for change/delete conflicts to the ':other' merge tool
 * filemerge: add support for change/delete conflicts to the ':prompt' tool
 * filemerge: default change/delete conflicts to 'leave unresolved' (BC)
 * filemerge: default regular prompts to 'leave unresolved' (BC)
 * graphlog: make node symbol templatable by ui.graphnodetemplate option
 * graphlog: rename glog function
 * hghave: support HGMODULEPOLICY for pure
 * localrepo: don't reference transaction from hook closure (Bts:issue5043)
 * lsprof: support PyPy (Bts:issue4573)
 * mac: fix percent-encoding of non-utf-8 characters (Bts:issue4999)
 * match: add option to return line and lineno from readpattern
 * mercurial: pass ui to extensions.load (Bts:issue5007)
 * mercurial: support loading modules from zipimporter
 * paths: do not process default-push as pushurl of default path (Bts:issue5000)
 * posix: work around "posix" systems without os.link available (Bts:issue4974)
 * run-tests: skip threading for a single test (Bts:issue5040)
 * scmutil: support background file closing
 * sslutil: fix reversed logic (Bts:issue5034)
 * streamclone: use backgroundfilecloser (Bts:issue4889)
 * streamclone: use context manager for writing files
 * streamclone: use read()
 * templates: make earlycommands and othercommands optional
 * templates: use canvaswidth instead of fixed width for canvas (Bts:issue2683)
 * test-extension: do not depend on demandimport (Bts:issue5012)
 * unionrepo: fix wrong rev being checked in iscensored (Bts:issue5024)
 * webcommands: get correct parents when comparing a removed file (Bts:issue4962)
 * webcommands: stop using ersatz if-else ternary operator for rename variable
 * webcommands: test that fctx is not None in filediff()
 * zeroconf: access repo on hgweb_mod properly (Bts:issue5036)

== Mercurial 3.6.3 (2016-1-1) ==
This is a regularly-scheduled bugfix release.

 * cmdutil: use crecordmod.checkcurses
 * copyfile: add an optional parameter to copy other stat data
 * crecord: stop raising error.Abort if curses is not found (Bts:issue5008)
 * dirstate: don't write repo.currenttransaction to repo.dirstate if repo
 * dockerlib: short form for non-unique uid/gid for CentOS 5 compat (Bts:issue4977)
 * merge: while checking for unknown files don't follow symlinks (Bts:issue5027)
 * mq: use fallback patch name if no alpha-numeric in summary line (Bts:issue5025)
 * parsers: fix parse_dirstate to check len before unpacking header (Bts:issue4979)
 * paths: include #fragment again
 * push: restore old behavior of default-push (Bts:issue5000)
 * record: don't dereference symlinks while copying over stat data
 * revlog: seek to end of file before writing (Bts:issue4943)
 * ui: try to handle $$ more robustly in prompts (Bts:issue4970)

== Mercurial 3.6.2 (2015-12-1) ==
This is a regularly-scheduled bugfix release.

 * docker: match more version of 'hg docker version' (Bts:issue4967)
 * localrepo.commit: check all files for resolve state (Bts:issue4972)
 * rebase: add returning value from pullrebase function
 * resolve: restore .orig only after merge is fully complete (Bts:issue4952)
 * share: wrap bmstore._writerepo for transaction sensitivity (Bts:issue4940)
 * tags: create new sortdict for performance reasons

== Mercurial 3.6.1 (2015-11-9) ==
This is an out-of-cycle bugfix release for issues related to hooks.

 * changegroup: call 'prechangegroup' hook before setting up write delay
 * changegroup: fix the scope of a try finally
 * clonebundles: fix typo s/comand/command/
 * demandimport: fix level passed to loader of sub-modules
 * dirstate: fix filefoldmap incosistency on file delete
 * dockerlib: allow non-unique uid and gid of $DBUILDUSER (Bts:issue4657)
 * exchange: do not attempt clone bundle if local repo is non-empty (Bts:issue4932)
 * hooks: always include HG_PENDING
 * hooks: fix hooks not firing if prechangegroup was set (Bts:issue4934)
 * parsers: fix width of datalen variable in fm1readmarkers
 * posix: fix test-permissions regression
 * posix: retry on symlink race in checklink
 * templatefilters: try round-trip utf-8 conversion by json filter (Bts:issue4933)
 * wireproto: move clonebundles command from extension (Bts:issue4931)
 * wix: style-coal.css has been renamed

== Mercurial 3.6 (2015-11-1) ==
Regularly scheduled feature release.

=== commands ===
 * bookmark: do not crash when active bookmark is forward and --date is used
 * bookmarks: don't deactivate on no-op update (Bts:issue4901)
 * clone: fix updaterev to update to latest branch changeset (Bts:issue4528)
 * clonebundles: support for seeding clones from pre-generated bundles
 * commit: abort when a committemplate is not changed (BC)
 * help: distinguish sections when multiple match (Bts:issue4802)
 * help: pass around ui to doc loader (API)
 * help: pass around ui to rewriter hooks (API)
 * merge: perform all premerges before any merges (BC)
 * merge: abort on file/directory case folding collisions (Bts:issue4892)
 * phases: return zero for no-op operations (Bts:issue4751) (BC)
 * resolve: perform all premerges before performing any file merges (BC)

=== core ===
 * cmdutil: make in-memory changes visible to external editor (Bts:issue4378)
 * cmdutil: stop tryimportone from using dirstateguard (BC)
 * context: don't hex encode all unknown 20 char revision specs (Bts:issue4890)
 * dirstate: batch calls to statfiles (Bts:issue4878)
 * parsers: fix infinite loop or out-of-bound read in fm1readmarkers (Bts:issue4888)
 * revlog: add an aggressivemergedelta option
 * revlog: change generaldelta delta parent heuristic
 * revset: do not fall through to revspec for literal: branch (Bts:issue4838)
 * revsets: makes follow() supports file patterns (Bts:issue4757) (BC)
 * templater: add new docheader/footer components for XML (Bts:issue4135)
 * templater: create string unescape helper (Bts:issue4798)
 * templater: do not pre-evaluate generator keyword at runsymbol (Bts:issue4868)
 * templater: introduce {latesttag()} function to match a pattern (Bts:issue4184)
 * templater: switch ctx of list expression to rev of revset() (BC)
 * ui: change default path fallback mechanism (Bts:issue4796)
 * util: use tuple accessor to get accurate st_mtime value (Bts:issue4836)
 * wireproto: properly parse false boolean args (BC)

=== extensions ===
 * histedit: use one editor when multiple folds happen in a row (Bts:issue3524) (BC)
 * largefiles: better handling of merge of largefiles that are not available
 * mq: generate patch names from first line of description
 * rebase: avoid losing branch commits with --keepbranch (Bts:issue4835)
 * rebase: fix warning about ignoring tool option on rebase continue (Bts:issue4698)
 * rebase: fix wrong 'no changes to commit' when using --collapse
 * rebase: on abort delete rebase state file no matter what
 * rebase: properly abort when destination is public (Bts:issue4896)
 * rebase: properly handle chains of markers with missing nodes
 * shelve: bundle using bundle2 if repository is general delta (Bts:issue4862)
 * shelve: delete shelve statefile on any exception during abort
 * shelve: restore shelved dirstate explicitly after aborting transaction
 * shelve: restore unshelved dirstate explicitly after aborting transaction

=== hgweb ===
 * hgweb: consume generator inside context manager (Bts:issue4756)
 * hgweb: ensure both foreground and background colors are specified (Bts:issue4872)
 * hgweb: overwrite cwd to resolve file patterns relative to repo (Bts:issue4568)

=== unsorted ===
 * builddeb: actually run make when building the deb (Bts:issue4778)
 * buildrpm: mkdir -p two needed directories (Bts:issue4779)
 * bundle2: don't try to recover from a GeneratorExit (Bts:issue4785)
 * bundle: extend the format of --type to support version and compression
 * debian: install bash completion as hg and not mercurial (Bts:issue4900)
 * debian: install hgk as part of mercurial-common (Bts:issue4829)
 * dispatch: error out on invalid -R path even if optionalrepo (Bts:issue4805) (BC)
 * dispatch: stop warning about EPIPE in --debug mode
 * graphmod: compute slow revset query once prior to reachableroots (Bts:issue4782)
 * highlight: add highlightfiles config option which takes a fileset (Bts:issue3005)
 * highlight: add option to prevent content-only based fallback
 * highlight: exit early on textual and unknown files (Bts:issue3005)
 * incoming: request a bundle2 when possible (BC)
 * localrepo: recreate phasecache if changelog was modified (Bts:issue4855)
 * lock: loop a finite number of times in trylock (Bts:issue4787)
 * mercurial: add debugextensions command (Bts:issue4676)
 * minirst: don't treat top level item as children of last item (Bts:issue4803)
 * notify: fix fromauthor setting for 'incoming' hook type (Bts:issue4194)
 * posix: shellquote do not require quoting for "+" (Bts:issue4818)
 * reachableroots: verify integer range of heads argument (Bts:issue4775)
 * revpair: restrict odd-range handling to top-level x:y expression (Bts:issue4774)
 * revrange: drop old-style parser in favor of revset (API)
 * test-merge-tools: include /usr/sbin in path for sysctl (Bts:issue4813)
 * traceback: allow providing a local support contact point
 * treemanifest: rework lazy-copying code (Bts:issue4840)
 * windows: read all global config files, not just the first (Bts:issue4491) (BC)
 * worker: restore old countcpus code (Bts:issue4869)

== Mercurial 3.5.2 (2015-10-01) ==
Regularly-scheduled bugfix release.

 * hgweb: use latest mtime for caching tag (Bts:issue4814)
 * largefiles: restore archiving largefiles with hgweb (Bts:issue4859)
 * localrepo: recreate phasecache if changelog was modified (Bts:issue4855)
 * monoblue: fix page subtitle on help pages
 * unbundle: cleanly abort on unknown bundle2 feature

== Mercurial 3.5.1 (2015-09-01) ==
Regularly-scheduled bugfix release.

 * convert: fix git copy file content conversions
 * filesets: ignore unit case in size() predicate for single value
 * help: fix typo familar -> familiar
 * help: fix typo in scripting documentation
 * hg: avoid auto sharing when the clone destination is remote
 * hgweb: fix trust of templates path (BC)
 * histedit: backout ebb5bb9bc32e
 * largefiles: ensure lfutil.getstandinmatcher() only matches standins
 * match: fix a case-only rename + explicit path commit on icasefs (Bts:issue4768)
 * parsers: fix memory leak in compute_phases_map_sets
 * rebase: lock the repo during the full rebase operation
 * revset: prevent crash caused by empty group expression while optimizing "and"
 * revset: prevent crash caused by empty group expression while optimizing "or"
 * strip: use the 'finally: tr.release' pattern during stripping
 * update: wlock the repo for the whole 'hg update' command
 * wix: avoid an abort with 'hg help -k foo'

== Mercurial 3.5 (2015-07-31) ==
Regularly-scheduled feature release.

=== commands ===
 * bookmark: informs of failure to upgrade a bookmark
 * bookmark: remove the "touch changelog" hack
 * bookmarks: abort the whole push if bookmarks fails to update (BC)
 * bookmarks: change bookmark within a transaction
 * bookmarks: clear active bookmark on non-linear update
 * bookmarks: mark internal-only config option
 * bookmarks: mark internal-only option
 * bookmarks: name label for active bookmark correctly
 * bookmarks: remove unused updatecurrentbookmark function (API)
 * bookmarks: rename bookmarkcurrent to activebookmark (API)
 * bookmarks: rename current to active in variables and comments
 * bookmarks: rename readcurrent to readactive (API)
 * bookmarks: rename setcurrent to activate (API)
 * bookmarks: rename unsetcurrent to deactivate (API)
 * bookmarks: simplify iscurrent to isactivewdirparent (API)
 * bookmarks: use try/except/finally
 * branch: don't warn about branches if repository has multiple branches already
 * commands: use the optional badfn argument when building a matcher
 * commands: use try/except/finally
 * commit: add ui.allowemptycommit config option
 * commit: avoid match.files() in conditions
 * commit: improve --close-branch documentation
 * commit: mark internal-only option
 * commit: no longer allow empty commit with the 'force' argument (API)
 * config: give it an includepaths option for looking for config files
 * files: recurse into subrepos automatically with an explicit path
 * import-checker: add xargs like mode
 * import-checker: don't treat modules as relative one if not found
 * import-checker: exclude mercurial packages installed into the system path
 * import-checker: loop to get list of locally defined modules at first
 * import: cross-reference patch.fuzz option from 'hg help import'
 * import: cross-reference ui.patch option from 'hg help import'
 * import: use ui.allowemptycommit to allow empty commits
 * log: add a status template
 * patch: add 'extra' argument to makememctx
 * patch: add fuzz config flag (Bts:issue4697)
 * phases: abort the whole push if phases fail to update (BC)
 * phases: fix bug where native phase computation wasn't called
 * phases: really fix native phase computation
 * pull: allow a generic way to pass parameters to the pull operation
 * pull: document the race condition with bookmark name
 * pull: only list remote bookmarks if -B is used to populate pulled heads
 * pull: only prefetch bookmarks when using bundle1
 * pull: prevent race condition in bookmark update when using -B (Bts:issue4689)
 * pull: skip pulling remote bookmarks with bundle1 if a value already exist
 * pull: skip pulling remote bookmarks with bundle2 if a value already exists
 * push: catch and process PushkeyFailed error
 * push: make pushkey part advisory
 * push: only say we are trying to push obsmarkers when we actually try
 * revert: fix edition of newly added file during --interactive
 * summary: add a phase line (draft, secret) to the output
 * summary: move the parents phase marker to commit line (Bts:issue4688)
 * tags: support reading tags cache without populating
 * tags: support setting hgtags fnodes cache entries
 * tags: use try/except/finally
 * verify: check the subrepository references in .hgsubstate
 * verify: clarify misleading fncache message

=== core ===
 * dirstate: ensure mv source is marked deleted when walking icasefs (Bts:issue4760)
 * ignore: fix include: rules depending on current directory (Bts:issue4759)
 * parsers: fix buffer overflow by invalid parent revision read from revlog
 * revlog: add support for a callback whenever revisions are added
 * revlog: raise an exception earlier if an entry is too large (Bts:issue4675)
 * revset: fix a crash in parents() when 'wdir()' is in the set
 * revset: fix iteration over ordered addset composed of non-ordered operands
 * revset: gratuitous formating fix in keyword
 * revset: improves time complexity of 'roots(xxx)'
 * revset: port extra() to support keyword arguments
 * revset: reduce nesting of chained 'or' operations (Bts:issue4624)
 * revsetbenchmarks: fix argument parsing
 * revsetbenchmarks: improve error output in case of failure
 * revsetbenchmarks: improve revision printing
 * revsetbenchmarks: support combining variants with "+"
 * templater: do not reevaluate rawstring as template (BC)
 * templater: remove noop calls of parsestring(s, quoted=False) (API)
 * templater: rename parsestring() to unquotestring() (API)
 * templater: take any string literals as template, but not for rawstring (BC)
 * templater: tokenize decimal integer literal (Bts:issue4638) (BC)
 * wireproto: correctly escape batched args and responses (Bts:issue4739)

=== extensions ===
 * convert: add config option for disabling ancestor parent checks
 * convert: add support for specifying multiple revs
 * convert: allow customizing git remote prefix
 * convert: apply the appropriate phases to the destination (Bts:issue4165)
 * convert: fix bug with converting the same commit twice
 * convert: handle copies when converting from Perforce (Bts:issue4744)
 * convert: handle deleted files when converting from Perforce (Bts:issue4743)
 * convert: handle deleted files when converting from Perforce (Bts:issue4743)
 * convert: improve support for unusual .gitmodules
 * convert: support incremental conversion with hg subrepos
 * convert: support multiple specifed revs in git source
 * convert: use 'default' for specifying branch name in branchmap (Bts:issue4753)
 * convert: when converting from Perforce use original local encoding by default (BC)
 * extdiff: allow modifications in subrepos to be copied back
 * highlight: produce correct markup when there's a blank line just before EOF
 * histedit: abort rather than edit a public changeset (Bts:issue4704)
 * histedit: mark defaultrev option experimental
 * largefiles: allow the archiving of largefiles to be disabled
 * largefiles: avoid match.files() in conditions
 * largefiles: ignore hidden changesets with 'verify --large --lfa'
 * largefiles: pass in whole matcher to getstandinmatcher()
 * largefiles: restore the original converter class after lfconvert --to-normal
 * largefiles: use the convert extension for 'lfconvert --to-normal'
 * largefiles: use the optional badfn argument when building a matcher
 * largefiles: use try/except/finally
 * mq: ban \r and \n in patch names (Bts:issue4711)
 * mq: tweak config reading to make check-config happy
 * mq: use the optional badfn argument when building a matcher
 * mq: use ui.allowemptycommit to allow empty commits
 * rebase: add short -k option for --keep
 * rebase: remove extraneous blank at the end of file
 * shelve: allow --patch and --stat without --list for a single shelf
 * shelve: always backup shelves instead of deleting them
 * shelve: keep old backups if timestamp can't decide exact order of them
 * shelve: make maxbackup doc check-config friendly
 * shelve: omit incorrect 'commit' suggestion at 'hg shelve -i'
 * shelve: only keep the latest N shelve backups
 * shelve: refactor allowables to specify sets of valid operations
 * shelve: use try/except/finally
 * transplant: restore dirstate correctly at unexpected failure

=== hgweb ===
 * hgweb: don't dereference symbolic revision in paper & coal style (Bts:issue2296)
 * paper: show branch/tags/bookmarks when blaming (Bts:issue3559)
 * paper: show branch/tags/bookmarks when browsing (Bts:issue3559)
 * paper: show branch/tags/bookmarks when comparing (Bts:issue3559)
 * paper: show branch/tags/bookmarks when diffing (Bts:issue3559)
 * paper: show branch/tags/bookmarks when viewing (Bts:issue3559)

=== unsorted ===
 * archive: drop the leading '.' path component from the prefix (Bts:issue4634)
 * archive: fix changesincelatesttag with wdir()
 * archive: support 'wdir()'
 * bufferedinputpipe: remove N^2 computation of buffer length (Bts:issue4735)
 * bundle2: fix type of experimental option
 * bundle2: pull bookmark the old way if no bundle2 listkeys support (Bts:issue4701)
 * canonpath: fix infinite recursion
 * censor: make various path forms available like other Mercurial commands
 * censor: mark experimental option
 * changegroup: compute seen files as changesets are added (Bts:issue4750)
 * changelog: change input type of index_get_parents
 * changelog: fix bug in heads computation
 * changelog: move index_get_parents function up
 * changelog: update read pending documentation
 * check-commit: catch both patterns of double empty lines
 * check-commit: print limit when user has a too-long summary
 * check-config: add config option checker
 * crecord: fix issue when backgrounding editor would leave artefact
 * demandimport: alias builtin as builtins
 * demandimport: define a 'deactivated' context manager
 * demandimport: support importing builtins for Python 3
 * devel: rename 'all' to 'all-warnings' (BC)
 * dispatch: add support for python-flamegraph[0] profiling
 * dispatch: disable demandimport for the --debugger option
 * email: fix config default value inconsistency
 * exchange: support transferring .hgtags fnodes mapping
 * extdiff: add support for subrepos
 * filemerge: mark internal-only config option
 * formatter: add template support
 * formatter: mark developer options
 * generaldelta: mark experimental reordering option
 * hg: support for auto sharing stores when cloning
 * hgewb: disable progress when serving (Bts:issue4582)
 * hghave: allow adding customized features at runtime
 * http2: mark experimental and developer options
 * localrepo: eliminate requirements class variable (API)
 * localrepo: kill off sopener (API)
 * localrepo: mark format options
 * mail: pass ui to sslutil.wrapsocket() even if verifycert is off (Bts:issue4713)
 * match: add an optional constructor parameter for a bad() override
 * match: add optional warn argument
 * match: introduce boolean prefix() method
 * match: resolve filesets in subrepos for commands given the '-S' argument
 * parser: factor out function that parses right-hand side of prefix/infix ops
 * parser: fill invalid infix and suffix actions by None
 * parser: reorder infix/suffix handling to be similar to prefix/primary flow
 * parser: resolve ambiguity where both prefix and primary actions are defined
 * parser: separate actions for primary expression and prefix operator
 * parser: take suffix action if no infix action is defined
 * pathutil: hint if a path is root relative instead of cwd relative (Bts:issue4663)
 * phase: default to current revision if no rev is provided (Bts:issue4666)
 * profiler: mark developer-only config option
 * progress: deprecate the progress extension
 * progress: mark experimental option
 * progress: respect ui.quiet (Bts:issue4726)
 * revrange: build balanced tree of addsets from revisions (Bts:issue4565)
 * run-tests: introduce PYTHON3 boolean constant (Bts:issue4668)
 * run-tests: move all open-coded sys.version_info checks to PYTHON3 (Bts:issue4668)
 * run-tests: move unicode-to-bytes operations on paths to a helper (Bts:issue4667)
 * run-tests: prefer PYTHON3 constant to many version_info checks (Bts:issue4668)
 * run-tests: replace open-coded .decode()s on paths with a helper (Bts:issue4667)
 * scmutil: add an optional parameter to matcher factories for a bad() override
 * scmutil: use the optional badfn argument when building a matcher
 * setup.py: drop compatibility with Python 2.4 and 2.5 (BC)
 * setup: hide octal literals inside strings so they're portable (Bts:issue4554)
 * sshpeer: break "OutOfBandError" feature for ssh (BC)
 * sshpeer: run the ssh command unbuffered
 * ssl: prompt passphrase of client key file via ui.getpass() (Bts:issue4648)
 * subrepo: mark internal-only option

 * templatekw: display active bookmark more consistently (Bts:issue4552) (BC)
 * test-discovery: disable bundle2 for legacy test (Bts:issue4610)
 * bookmarks: abort the whole push if bookmarks fails to update (BC)
 * phases: abort the whole push if phases fail to update (BC)
 * templater: do not reevaluate rawstring as template (BC)
 * templater: take any string literals as template, but not for rawstring (BC)
 * templater: tokenize decimal integer literal (Bts:issue4638) (BC)

 * bookmarks: remove unused updatecurrentbookmark function (API)
 * bookmarks: rename bookmarkcurrent to activebookmark (API)
 * bookmarks: rename readcurrent to readactive (API)
 * bookmarks: rename setcurrent to activate (API)
 * bookmarks: rename unsetcurrent to deactivate (API)
 * bookmarks: simplify iscurrent to isactivewdirparent (API)
 * commit: no longer allow empty commit with the 'force' argument (API)
 * templater: remove noop calls of parsestring(s, quoted=False) (API)
 * templater: rename parsestring() to unquotestring() (API)

== Mercurial 3.4.2 (2015-07-01) ==
 * changegroup: properly compute common base in changeggroupsubset (Bts:issue4736)
 * crecord: fix a typo introduced when moving crecord to core
 * crecord: fix three typos introduced while moving crecord into core
 * hgwebdir: avoid redundant repo and directory entries when 'web.name' is set
 * hgwebdir: don't allow the hidden parent of a subrepo to show as a directory
 * parsers: do not cache !RevlogError type (Bts:issue4451)
 * pull: avoid race condition with 'hg pull --rev name --update' (Bts:issue4706)
 * templater: do not preprocess template string in "if" expression (Bts:issue4714)
 * templater: evaluate arguments passed to diff() appropriately
 * templater: parse \"...\" as string for 2.9.2-3.4 compatibility (Bts:issue4733)
 * transplant: only pull the transplanted revision (Bts:issue4692)
 * transplant: update test to use hash for remote transplant

== Mercurial 3.4.1 (2015-06-01) ==
This is a regularly-scheduled bugfix release.

 * archive: always use portable path component separators with subrepos
 * commands: hide formatter option as EXPERIMENTAL, not as DEPRECATED
 * context: don't complain about a matcher's subrepo paths in changectx.walk()
 * convert: properly pass null ids through .hgtags (Bts:issue4678)
 * extensions: clear aftercallbacks after execution (Bts:issue4646)
 * hgweb: bring back infinite scroll in shortlog of paper style
 * histedit: fix --continue when rules are finished
 * histedit: fix --edit-plan
 * histedit: fix keep during --continue
 * histedit: fix serializing of None backupfile
 * histedit: fix test-histedit-edit on vfat
 * localrepo: pass hook argument txnid to pretxnopen hooks
 * localrepo: rename hook argument from TXNID to txnid (BC)
 * localrepo: use correct argument name for pretxnclose hooks (BC)
 * match: explicitly naming a subrepo implies always() for the submatcher
 * mergecopies: avoid slowdown from linkrev adjustment (Bts:issue4680)
 * rebase: check that the bookmark is still valid when restoring (Bts:issue4669)
 * rebase: clear merge when aborting before any rebasing (Bts:issue4661)
 * revbranchcache: return uncached branchinfo for nullrev (Bts:issue4683)
 * revset: drop magic of fullreposet membership test (Bts:issue4682)
 * revset: id() called with 40-byte strings should give the same results as for short strings
 * revset: map postfix '%' to only() to optimize operand recursively (Bts:issue4670)
 * ssh: capture output with bundle2 again (Bts:issue4642)
 * templatekw: compare target context and its parent exactly (Bts:issue4690)
 * templater: do not process \-escapes at parsestring() (Bts:issue4290)
 * templater: fix crash by passing invalid object to date() function
 * templater: strictly parse leading backslashes of '{' (Bts:issue4569) (BC)
 * transaction: really fix _addbackupentry key usage (Bts:issue4684)
 * transaction: separate calculating TXNID from creating transaction object
 * transaction: use the proper variable in '_addbackupentry' (Bts:issue4684)
 * util.checkcase: don't abort on broken symlinks

== Mercurial 3.4 (2015-05-01) ==
This is a regularly-scheduled feature release.

=== commands ===
 * annotate: add option to annotate working-directory files
 * annotate: always prepare ancestry context of base fctx (Bts:issue4600)
 * annotate: always adjust linkrev before walking down to parents (Bts:issue4623)
 * annotate: prepare ancestry context of workingfilectx
 * bookmarks: add incoming() to replace diff() for incoming bookmarks
 * bookmarks: add outgoing() to replace diff() for outgoing bookmarks
 * bookmarks: check @pathalias suffix before available @number for efficiency
 * bookmarks: enhance test of showing detail about incoming/outgoing bookmarks
 * bookmarks: prevent divergent bookmark from being updated unexpectedly
 * bookmarks: reuse @number bookmark, if it refers changeset referred remotely
 * bookmarks: rewrite comparing bookmarks in commands.summary() by compare()
 * bookmarks: show detailed status about incoming/outgoing bookmarks
 * clone: add progress support to hardlink clones (Bts:issue3059)
 * commands.import: accept a prefix option
 * commands.push: abort when revisions evaluate to empty set (BC)
 * commands: add ui.statuscopies config knob
 * debuginstall: expand the editor path before searching for it (Bts:issue4380)
 * files: split reusable implementation into cmdutil for subrepo support
 * files: use ctx object to access dirstate
 * graft: allow creating sibling grafts
 * graft: record intermediate grafts in extras
 * log: display closing-branch nodes as "_" (BC)
 * log: fix --follow null parent not to include revision 0
 * log: make -fr show complete history from the given revs (BC)
 * log: prefer 'wctx' over 'pctx' for working context
 * patch.internalpatch: accept a prefix parameter
 * patch.internalpatch: add a default value for prefix
 * patch: rename pathstrip to pathtransform
 * pull: print "pulling from foo" before accessing the other repo
 * push: acquire local 'wlock' if "pushback" is expected (BC) (Bts:issue4596)
 * resolve: silence warning of unknown pats for -l/--list (BC)
 * revert: evaluate filesets against working directory (Bts:issue4497)
 * revert: fix --interactive on local modification (Bts:issue4576)
 * revert: stop marking files clean after interactive revert (Bts:issue4592)
 * revert: accept just -I/-X without paths or -a/-i (Bts:issue4592)
 * revert: apply normallookup on reverted file if size isn't changed (Bts:issue4583)
 * revert: restore the ability to revert across case only renames (Bts:issue4481)
 * status: add relative directory help text (Bts:issue3835)

=== core ===
 * bundle2: capture transaction rollback message output (Bts:issue4614)
 * bundle2: disable ouput capture unless we use http (Bts:issue4613 Bts:issue4615)
 * changelog: fix readpending if no pending data exist (Bts:issue4609)
 * dirstate: fix order of initializing nf vs f
 * filelog: allow censored files to contain padding data
 * merge: run update hook after the last wlock release
 * pushkey: flush pending data before running a pre-pushkey hook (Bts:issue4607)
 * repoview: improve compute staticblockers perf
 * revlog: _addrevision creates full-replace deltas based on censored revisions
 * revlog: add "iscensored()" to revlog public API
 * revlog: addgroup checks if incoming deltas add censored revs, sets flag bit
 * revlog: in addgroup, reject ill-formed deltas based on censored nodes
 * revlog: make converting from inline to non-line work after a strip
 * revlog: special case expanding full-replacement deltas received by exchange
 * subrepo: don't write .hgsubstate lines with empty subrepo state (Bts:issue4622)
 * subrepo: update the help text to account for diff -I/-X gitsubrepo support
 * tags: establish a separate and shared cache of .hgtags filenodes
 * tags: change format of tags cache files
 * tags: have a different cache file per filter level
 * ui: disable revsetaliases in plain mode (BC)
 * util: add progress callback support to copyfiles
 * windows: make shellquote() quote any path containing '\' (Bts:issue4629)

=== extensions ===
 * color: be more conservative about setting ANSI mode on Windows (BC)
 * color: fix crash in cmd.exe
 * color: omit terminfo/win32 warning if non-interactive (Bts:issue4543)
 * color: support a different color mode when the pager is active
 * convert: adjust progress bar for octopus merges (Bts:issue4169)
 * histedit: add --edit-plan option to histedit
 * histedit: allow histedit --continue when not on a descendant (BC)
 * histedit: fix preventing strips during histedit
 * histedit: fix style of new error message
 * histedit: improve roll action integration with fold
 * histedit: fix rollup prompting for a commit message (Bts:issue4606)
 * largefiles: don't crash when cloning to a remote repo
 * largefiles: don't mangle filesets when fixing up the log matcher
 * largefiles: always consider updatelfiles 'checked' parameter set
 * largefiles: avoid infinite recursive call of openlfdirstate in overriderevert
 * largefiles: don't create chain of __contains__ calls
 * largefiles: don't prefix standin patterns with '.hglf' when logging
 * largefiles: don't warn when reverting a forgotten largefile
 * largefiles: extract and reuse 'standin' variable in overriderevert()
 * largefiles: for update -C, only update largefiles when necessary
 * largefiles: handle logging from outside the repo
 * largefiles: introduce lfutil.findstorepath()
 * largefiles: override cmdutil.revert() instead of comands.revert()
 * largefiles: report the source of copied/moved largefiles in status -C
 * largefiles: set the extension as enabled locally after a clone requiring it
 * largefiles: teach log to handle patterns
 * largefiles: update _subdirlfs() comment
 * largefiles: use common function to build content of .hg_archival.txt
 * largefiles: use lfutil.findstorepath() when verifying a local repo
 * largefiles: use the core file copy logic to validate the destination path
 * largefiles: use the share source as the primary local store (Bts:issue4471)
 * mq: avoid silent failure when single patch doesn't apply (Bts:issue4604)
 * rebase: don't forward "source" argument to rebase (Bts:issue4633)
 * rebase: restore bookmark state on abort
 * record: edit patch of newly added files (Bts:issue4304)
 * record: fix adding new file with record from within a subdir (Bts:issue4626)
 * record: fix record with change on moved file crashes (Bts:issue4619)
 * shelve: acquire lock in the right order
 * shelve: add interactive mode
 * shelve: add interactive mode command line option

=== hgweb ===
 * hgweb: resurrect <span> tag on diffline to fix rendering in monoblue style
 * hgweb: use introrev() for finding parents (Bts:issue4506)
 * json: implement {bookmarks} template
 * json: implement {branches} template
 * json: implement {changeset} template
 * json: implement {comparison} template
 * json: implement {fileannotate} template
 * json: implement {filediff} template
 * json: implement {helptopics} template
 * json: implement {help} template
 * json: implement {manifest} template
 * json: implement {shortlog} and {changelog} templates
 * json: implement {tags} template

=== unsorted ===
 * archive: change the default prefix to `''` from None
 * archive: look for first visible revision to build repo identity (Bts:issue4591)
 * bundle2-localpeer: properly propagate the server output on error (Bts:issue4594)
 * bundle2-wireproto: properly propagate the server output on error (Bts:issue4594)
 * changeset_printer: display p1rev:p1node with "+" suffix for workingctx
 * check-commit: be more picky about detection of wrong bug tag
 * check-commit: check capitalization in summary lines
 * churn: deprecate -t option in favour of -T
 * crecord: fix another underbar
 * crecord: fix underbar style for orig_stdout
 * devel-warn: add a prefix to all messages ("devel-warn: ")
 * dirs._addpath: don't mutate Python strings after exposing them (Bts:issue4589)
 * dispatch: consolidate formatting of !ParseErrors
 * dispatch: offer near-edit-distance suggestions for {file,rev}set functions
 * dispatch: offer suggestions of similar-named commands
 * extensions: support callbacks after another extension loads
 * get-with-headers: support parsing and pretty printing JSON
 * graphlog: do not bypass commands.log so that -fr works
 * graphlog: move comment and flag denoting revs might be unsorted
 * graphlog: remove too early return from getgraphlogrevs() for empty repo
 * lazymanifest: fix memory leak in lmiter_iterentriesnext() after 3d485727e45e
 * lazymanifest: fix pure hg iterkeys()
 * linkrev: fix issue with annotate of working copy
 * manifestv2: add support for reading new manifest format
 * manifestv2: add support for writing new manifest format
 * obsolete: avoid infinite loop from obs-cycle in divergence (Bts:issue4126)
 * record: add interactive option to the commit command
 * record: allow editing new files (Bts:issue4304)
 * record_curses: fix ui bug for newly added file
 * revbranchcache: add test for when the cache is not writable
 * revbranchcache: move out of branchmap onto localrepo
 * revbranchcache: populate cache incrementally
 * revbranchcache: store repo on the object
 * revbranchcache: write cache even during read operations
 * revrange: don't parse revset aliases as hash prefixes (Bts:issue4553)
 * rollback: clear resolve state (Bts:issue4593)
 * ssl: resolve symlink before checking for Apple python executable (Bts:issue4588)
 * ssl: set explicit symbol "!" to web.cacerts to disable SSL verification (BC)
 * strip: properly clear resolve state with --keep (Bts:issue4593)
 * subrepo: add 'cat' support for git subrepos
 * subrepo: add basic support to hgsubrepo for the files command
 * subrepo: add include/exclude support for diffing git subrepos
 * subrepo: add status support for ignored and clean files in git subrepos
 * subrepo: change arguments of abstractsubrepo.__init__ (API)
 * subrepos: support adding files in git subrepos
 * test-convert-git: show insane progress bar with octopus merge (Bts:issue4169)
 * test-histedit-edit.t: demonstrate qnew fails during a histedit (Bts:issue4366)
 * test-https: enable dummycert test only if Apple python is used (Bts:issue4500)
 * test-shelve: be more lenient about whitespace (Bts:issue4124)
 * tests: add test showing tags cache drops filtered heads (Bts:issue4550)
 * tests: handle deleted .hg directory (git 2.2.0 and higher) (Bts:issue4585)
 * trydiff: join filename with prefix only once
 * unbundle: acquire 'wlock' when processing bundle2 (BC) (Bts:issue4596)
 * webcommands: define a dict of available commands
 * webcommands: define web commands using a decorator

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.8 (2018-11-02)

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

1.1. commands

  • add: add a label for messages about added files
  • addremove: add labels for messages about added and removed files
  • annotate: pass in wdir rev and node to formatter (BC)
  • annotate: rename {line_number} to {lineno} (BC)
  • bookmarks: add explicit option to list bookmarks of the given names
  • bookmarks: pass in formatter to printbookmarks() instead of opts (API)
  • clone: allow local cloning to create more than one level of directories
  • debugcommands: introduce debugrevlogindex (BC)
  • debugcommands: use openstorage() in debugdata (BC)
  • grep: add MULTIREV support to --allfiles flag
  • grep: rename {line_number} to {lineno} as well (BC)
  • grep: search all commits in allfiles mode
  • help: adding a proper declaration for shortlist/basic commands (API)
  • help: adding support for command categories
  • identify: change {parents} to a list of nodes (BC)
  • identify: show remote bookmarks in 'hg id url -Tjson -B'
  • log: have changesetformatter fill in wdir() rev and node (BC)
  • log: respect graphshorten on terminal nodes (collapsing o-~ to just o~)

  • merge: improve interactive one-changed one-deleted message (issue5550)

  • phase: explicitly exclude secret phase and above
  • phase: expose a '_phase(idx)' revset
  • phase: handle phase with no command flag
  • phase: report number of non-public changeset alongside the new range
  • push: add "remote" to 'repository changed while pushing' messages (issue5971)

  • remove: add a label for messages about removed files
  • rename: return error status if any rename/copy failed
  • resolve: add a flag for the default behavior of re-merging
  • resolve: add config to make hg resolve not re-merge by default
  • resolve: add confirm config option
  • resolve: add option to warn/abort on -m with unresolved conflict markers
  • resolve: graduate resolve.mark-check from experimental, add docs
  • resolve: rename {status} to {mergestatus} to not shadow change status (BC)
  • status: advertise --abort instead of 'update -C .' to abort a merge
  • status: advertise --abort instead of 'update -C .' to abort graft
  • status: remove "morestatus" message from formatter data (BC)
  • status: rename {copy} to {source} for compatibility with {file_copies} (BC)
  • verify: make output less confusing (issue5924)

1.2. core

  • context: drop compatibility for 'context.descendant' (API)
  • context: move logic from changectx.__init__ to localrepo.__getitem__ (API)

  • context: remove unused overlayfilectx (API)
  • dispatch: don't show list of commands on bogus command
  • dispatch: making all hg abortions be output with a specific label
  • dispatch: show a short error message when invalid global option given
  • exchange: support declaring pull depth
  • exchange: support defining narrow file patterns for pull
  • filelog: add a hasnode() method (API)
  • filelog: drop _generaldelta attribute (API)
  • filelog: drop index attribute (API)
  • filelog: remove checkhash() (API)
  • filelog: remove revdiff() (API)
  • filelog: remove version attribute (API)
  • filelog: stop proxying "opener" (API)
  • filelog: stop proxying _addrevision() (API)
  • filelog: stop proxying checksize() (API)
  • filelog: stop proxying compress() (API)
  • filelog: stop proxying datafile (API)
  • filelog: stop proxying deltaparent() (API)
  • filelog: stop proxying flags() (API)
  • filelog: stop proxying headrevs() (API)
  • filelog: stop proxying rawsize() (API)
  • filelog: stop proxying start(), end(), and length() (API)
  • localrepo: add repository feature when repo can be stream cloned
  • localrepo: add requirement when narrow files creation option present
  • localrepo: automatically load lfs extension when required (BC)
  • localrepo: define "features" on repository instances (API)
  • localrepo: define storage backend in creation options (API)
  • localrepo: move repo creation logic out of localrepository.__init__ (API)

  • localrepo: pass ui to newreporequirements() (API)
  • localrepo: support marking repos as having shallow file storage
  • localrepo: support writing shared file (API)
  • pager: do not enable when TERM=dumb
  • repository: establish API for emitting revision deltas
  • revlog: add method for obtaining storage info (API)
  • revlog: drop LookupError alias (API)

  • revlog: drop RevlogError alias (API)

  • revlog: drop compatibility for 'revlog.descendant' (API)
  • revlog: drop emitrevisiondeltas() and associated functionality (API)
  • revlog: drop some more error aliases (API)
  • revlog: new API to emit revision data
  • revlog: reuse cached delta for identical base revision (issue5975)

  • revset: expand bookmark(.) to the active bookmark
  • revsetlang: fix position of '-' in spaceless 'a-b' expressions
  • streamclone: don't support stream clone unless repo feature present
  • streamclone: include obsstore file into stream bundle if client can read it
  • templatefuncs: add truncate parameter to pad
  • templatekw: add experimental {status} keyword
  • templatekw: deprecate old-style template keyword function (API)
  • templates: rename "user" to "luser" defined in default map file (API)
  • tracing: new module to make tracing events in hg easier
  • tracing: trace command function execution
  • transaction: make entries a private attribute (API)
  • transaction: remember original len(repo) instead of tracking added revs (API)
  • util: make timedcm require the label (API)
  • wireprotov2: add bookmarks to "changesetdata" command
  • wireprotov2: add phases to "changesetdata" command
  • wireprotov2: client support for advertising redirect targets
  • wireprotov2: client support for following content redirects
  • wireprotov2: define and implement "changesetdata" command
  • wireprotov2: define and implement "filedata" command
  • wireprotov2: define and implement "filesdata" command
  • wireprotov2: define and implement "manifestdata" command
  • wireprotov2: server support for sending content redirects
  • wireprotov2: support response caching

1.3. extensions

  • absorb: import extension from Facebook's hg-experimental
  • absorb: print '{rev}:' as a prefix to the hash
  • absorb: print summary of changesets affected
  • absorb: prompt user to accept absorb changes by default
  • amend: support "history-editing-backup" config option
  • closehead: fix close-head -r listification
  • commitextras: work nicely with other extensions
  • convert: fix a file descriptor leak
  • extension: add a summary of total loading time per extension
  • extensions: add detailed loading information
  • extensions: new closehead module for closing arbitrary heads
  • fastannotate: initial import from Facebook's hg-experimental
  • fastannotate: make the default value for 'fastannotate.useflock' dynamic
  • fix: add a monkey-patchable point after all new revisions have been committed
  • fix: compute changed lines lazily to make whole-file fixer tools faster
  • fix: determine fixer tool failure by exit code instead of stderr
  • fix: pull out flag definitions to make them re-usable from extensions
  • fsmonitor: use vfs instead of opener (issue5938)

  • journal: do not pass in repolookuperror string to template (BC)
  • journal: unify template name for "nodes" (BC)
  • largefiles: automatically load largefiles extension when required (BC)
  • lfs: add repository feature denoting the use of LFS
  • lfs: autoload the extension when cloning from repo with lfs enabled
  • lfs: consult the narrow matcher when extracting pointers from ctx (issue5794)

  • lfs: don't add extension to hgrc after clone or share (BC)
  • lfs: don't add extension to hgrc after conversion (BC)
  • logtoprocess: connect all fds to /dev/null to avoid bad interaction with pager
  • logtoprocess: define $HG for children processes
  • narrow: add '--import-rules' flag to tracked command
  • narrow: add a --narrowspec flag to clone command
  • narrow: add narrow and ellipses as server capabilities
  • narrow: add server logic to send cg while widening without ellipsis
  • narrow: check for servers' narrow support before doing anything (BC)
  • narrow: drop support for remote expansion (BC)
  • narrow: introduce a config option to check if narrow is enabled or not
  • narrow: move .hg/narrowspec to .hg/store/narrowspec (BC)
  • narrow: move support for 'hg verify' into core
  • narrow: the first version of narrow_widen wireprotocol command
  • narrow: validate spec files are well-formed during clone (BC)
  • patchbomb: allow using HGHOSTNAME to force a hostname
  • phabricator: drop support for the legacy phabricator.auth.token config (BC)
  • phabricator: mark extension as experimental for now
  • rebase: add --stop option to stop rebase at any point (issue5206)

  • rebase: don't try to prune obsolete changeset already in the destination
  • rebase: explicitly track collapses as fold
  • rebase: skip extinct revisions even if it has no successor in rebase set
  • rebase: support "history-editing-backup" config option
  • remotenames: add names argument to remotenames revset
  • share: allow more than one level of directories to be created
  • shelve: add an "internal" extra
  • shelve: fix crash on unshelve without .shelve metadata file
  • shelve: use the internal phase when possible
  • sqlitestore: file storage backend using SQLite
  • strip: ignore orphaned internal changesets while computing safe strip roots

1.4. hgweb

  • hgweb: add error template to json so it won't crash
  • hgweb: map Abort to 403 error to report inaccessible path for example
  • hgweb: show shortlog by default in json output (issue5978)

  • hgweb: use scmutil.binnode() to translate None to wdir hash (issue5988)

1.5. chg

  • chgserver: add "setumask2" command which uses correct message frame
  • chgserver: restore pager fds attached within runcommand session
  • rust-chg: add Client extensions to run cHg-specific requests
  • rust-chg: add callback to handle pager and shell command requests

1.6. unsorted

  • ancestors: actually iterate over ancestors in topological order (issue5979)

  • bundle2: graduate bundle2.stream option from experimental to server section
  • changegroup: pass sorted revisions into group() (API)
  • changegroup: port to emitrevisions() (issue5976)

  • changegroup: remove reordering control (BC)
  • changegroup: restore default node ordering (issue6001)

  • cleanupnodes: drop special casing around prune markers (API)
  • commands: restore compatibility for "^cmd" registration (issue6005)

  • copies: improve logic of deciding copytracing on based of config options
  • crecord: make nextsametype() check that parent item exists (issue6009)

  • crecord: make enter move cursor down to the next item of the same type
  • delta: skip "empty delta" optimisation for non-general case (issue6006)

  • error: introduce StorageError

  • filemerge: add config knob to check capabilities of internal merge tools
  • filemerge: show warning if chosen tool has no binary files capability
  • fileset: extract language processing part to new module (API)
  • fileset: optimize 'x and not y' to 'x - y'
  • fileset: roughly adjust weights of functions
  • formatter: remove experimental marker from -T option
  • formatter: rename {abspath}/{file} to {path}, and drop relative {path} (BC)
  • global: replace most uses of RevlogError with StorageError (API)

  • hg: allow extra arguments to be passed to repo creation (API)
  • httppeer: expose capabilities for each command
  • index: drop support for negative indexes into the index
  • index: handle index[-1] as nullid more explicitly
  • linelog: fix infinite loop vulnerability
  • lookup: add option to disambiguate prefix within revset
  • mail: always fall back to iso-8859-1 if us-ascii won't work (BC)
  • mail: modernize check for Python-with-TLS
  • manifest: add rawsize() proxy (API)
  • meld: enable auto-merge
  • mergetool: warn if ui.merge points to nonexistent tool
  • narrowspec: limit patterns to path: and rootfilesin: (BC)
  • narrowspec: use sparse.parseconfig() to parse narrowspec file (BC)
  • obsolete: fix ValueError when stored note contains ':' char (issue5783)

  • overlayworkingctx: fix exception in metadata-only inmemory merges (issue5960)

  • phase: add an archived phase
  • phases: add an internal phases
  • pullreport: issue a message about "extinct" pulled changesets
  • py3: rename pycompat.getcwd() to encoding.getcwd() (API)
  • revisions: allow "x123" to refer to nodeid prefix "123"
  • scmutil: accept multiple predecessors in 'replacements' (API)
  • shortest: never emit 0-length prefix even if unique
  • shortest: use 'x' prefix to disambiguate from revnum if configured
  • sparse-revlog: only refine delta candidates in the sparse case (issue6006)

  • statprof: fix indent level of fp.write() (issue6004)

  • statprof: update the name as the i increases (issue6003)

  • storageutil: consistently raise LookupError (API)

  • storageutil: implement file identifier resolution method (BC)
  • storageutil: move metadata parsing and packing from revlog (API)
  • storageutil: new module for storage primitives (API)
  • url: allow to configure timeout on http connection

1.7. Behavior Changes

  • annotate: pass in wdir rev and node to formatter (BC)
  • annotate: rename {line_number} to {lineno} (BC)
  • changegroup: remove reordering control (BC)
  • debugcommands: introduce debugrevlogindex (BC)
  • debugcommands: use openstorage() in debugdata (BC)
  • formatter: rename {abspath}/{file} to {path}, and drop relative {path} (BC)
  • grep: rename {line_number} to {lineno} as well (BC)
  • identify: change {parents} to a list of nodes (BC)
  • journal: do not pass in repolookuperror string to template (BC)
  • journal: unify template name for "nodes" (BC)
  • largefiles: automatically load largefiles extension when required (BC)
  • lfs: don't add extension to hgrc after clone or share (BC)
  • lfs: don't add extension to hgrc after conversion (BC)
  • localrepo: automatically load lfs extension when required (BC)
  • log: have changesetformatter fill in wdir() rev and node (BC)
  • mail: always fall back to iso-8859-1 if us-ascii won't work (BC)
  • narrow: check for servers' narrow support before doing anything (BC)
  • narrow: drop support for remote expansion (BC)
  • narrow: move .hg/narrowspec to .hg/store/narrowspec (BC)
  • narrow: validate spec files are well-formed during clone (BC)
  • narrowspec: limit patterns to path: and rootfilesin: (BC)
  • narrowspec: use sparse.parseconfig() to parse narrowspec file (BC)
  • phabricator: drop support for the legacy phabricator.auth.token config (BC)
  • resolve: rename {status} to {mergestatus} to not shadow change status (BC)
  • status: remove "morestatus" message from formatter data (BC)
  • status: rename {copy} to {source} for compatibility with {file_copies} (BC)
  • storageutil: implement file identifier resolution method (BC)

1.8. Internal API Changes

  • bookmarks: pass in formatter to printbookmarks() instead of opts (API)
  • changegroup: pass sorted revisions into group() (API)
  • cleanupnodes: drop special casing around prune markers (API)
  • context: drop compatibility for 'context.descendant' (API)
  • context: move logic from changectx.__init__ to localrepo.__getitem__ (API)

  • context: remove unused overlayfilectx (API)
  • filelog: add a hasnode() method (API)
  • filelog: drop _generaldelta attribute (API)
  • filelog: drop index attribute (API)
  • filelog: remove checkhash() (API)
  • filelog: remove revdiff() (API)
  • filelog: remove version attribute (API)
  • filelog: stop proxying "opener" (API)
  • filelog: stop proxying _addrevision() (API)
  • filelog: stop proxying checksize() (API)
  • filelog: stop proxying compress() (API)
  • filelog: stop proxying datafile (API)
  • filelog: stop proxying deltaparent() (API)
  • filelog: stop proxying flags() (API)
  • filelog: stop proxying headrevs() (API)
  • filelog: stop proxying rawsize() (API)
  • filelog: stop proxying start(), end(), and length() (API)
  • fileset: extract language processing part to new module (API)
  • global: replace most uses of RevlogError with StorageError (API)

  • help: adding a proper declaration for shortlist/basic commands (API)
  • hg: allow extra arguments to be passed to repo creation (API)
  • localrepo: define "features" on repository instances (API)
  • localrepo: define storage backend in creation options (API)
  • localrepo: move repo creation logic out of localrepository.__init__ (API)

  • localrepo: pass ui to newreporequirements() (API)
  • localrepo: support writing shared file (API)
  • manifest: add rawsize() proxy (API)
  • py3: rename pycompat.getcwd() to encoding.getcwd() (API)
  • revlog: add method for obtaining storage info (API)
  • revlog: drop LookupError alias (API)

  • revlog: drop RevlogError alias (API)

  • revlog: drop compatibility for 'revlog.descendant' (API)
  • revlog: drop emitrevisiondeltas() and associated functionality (API)
  • revlog: drop some more error aliases (API)
  • scmutil: accept multiple predecessors in 'replacements' (API)
  • storageutil: consistently raise LookupError (API)

  • storageutil: move metadata parsing and packing from revlog (API)
  • storageutil: new module for storage primitives (API)
  • templatekw: deprecate old-style template keyword function (API)
  • templates: rename "user" to "luser" defined in default map file (API)
  • transaction: make entries a private attribute (API)
  • transaction: remember original len(repo) instead of tracking added revs (API)
  • util: make timedcm require the label (API)

2. Mercurial 4.7.2 (2018-10-01)

This is a regularly-scheduled bugfix release containing following fixes:

2.1. security

Fix a potential out-of-bounds read in manifest parsing C code.

2.2. core

  • various minor correctness fixes in revsets for commonancestors() and similar

2.3. unsorted

  • chgserver: do not send system() back to client if stdio redirected (issue5992)

  • procutil: compare fd number to see if stdio protection is needed (issue5992)

3. Mercurial 4.7.1 (2018-09-04)

This is a regularly-scheduled bugfix release containing following fixes:

3.1. commands

  • merge: do not delete untracked files silently (issue5962)

3.2. core

  • revlog: fix descendant deprecated method

3.3. hgweb

  • hgweb: load revcount + 1 entries to fill nextentry in log page (issue5972)

3.4. performance

  • remotephase: avoid full changelog iteration (issue5964)

  • remotephase: fast path newheads computation in simple case (issue5964)

  • scmutil: avoid quadratic membership testing (issue5969)

  • sparse-revlog: fix delta validity computation

4. Mercurial 4.7 (2018-08-01)

This is a regularly-scheduled quarterly feature release and has its own release notes page which can be found here Full release notes.

5. Mercurial 4.6.2 (2018-07-03)

This is a regularly-scheduled bugfix release containing following fixes:

  • merge: do not fill manifest of committed revision with pseudo node (issue5526)

  • crecord: fix line number in hunk header (issue5917)

  • lazymanifest: don't crash when out of memory (issue5916)

  • procutil: use unbuffered stdout on Windows

6. Mercurial 4.6.1 (2018-06-06)

This is a regularly-scheduled bugfix release that also contains security fixes.

6.1. Security Fixes

Multiple issues found in mpatch.c with a fuzzer:

  • OVE-20180430-0001 / CVE-2018-13348
  • OVE-20180430-0002 / CVE-2018-13347
  • OVE-20180430-0004 / CVE-2018-13346

With the following fixes:

  • mpatch: be more careful about parsing binary patch data (SEC)
  • mpatch: protect against underflow in mpatch_apply (SEC)
  • mpatch: ensure fragment start isn't past the end of orig (SEC)
  • mpatch: fix UB in int overflows in gather() (SEC)
  • mpatch: fix UB integer overflows in discard() (SEC)
  • mpatch: avoid integer overflow in mpatch_decode (SEC)
  • mpatch: avoid integer overflow in combine() (SEC)

No exploits are known at the time, however, it is highly recommended that all users upgrade.

6.2. Bug Fixes

Also included in this release are the following,

  • zstandard: pull in bug fixes from upstream 0.9.1 (issue5884)

  • bundle2: fix old clients from reading newer format (issue5872)

  • bdiff: fix xdiff long/int64 conversion (issue5885)

  • push: continue without locking on lock failure other than EEXIST (issue5882)

  • lfs: fix crash in command server (issue5902)

  • hghave: fix deadlock in test runner
  • rebase: fix error when computing obsoletenotrebased (issue5907)

  • rebase: prioritize indicating an interrupted rebase over update (issue5838)

  • revset: pass in lookup function to matchany() (issue5879)

7. Mercurial 4.6 (2018-05-06)

Full release notes are available. This is a regularly-scheduled quarterly feature release.

7.1. New Features

7.1.1. pullbundles

Pullbundles allow the server to answer client requests using pre-built bundles. This is different from the existing clonebundle feature:

  • pullbundles can be used for both the initial clone and later pull operations
  • pullbundles can be used incrementally, i.e. to cover the changes up to the start of the current month as one bundle and the remaining changes as second bundle
  • the bundle is transferred inline as part of the existing connection without a secondary server

Pullbundles are only used for clients running Mercurial 4.6 as well.

7.1.2. push

If 'server.streamunbundle' option is enabled, the server will directly apply the changes send by the changes. This avoids potentially large temporary files on the server side. It can also prevent concurrent pushes.

7.1.3. notify extension

The 'maxdiffstat' option can be used to truncate long file lists similar to 'maxdiff' for the patch part of the email.

7.1.4. hgweb

hgweb now shows date and user for operations that resulted in obsolete commit(s). For unstable commits, it shows the exact reason why they are considered unstable.

Server: header is now configurable using web.server-header option.

7.1.5. templates

A new template keyword 'reporoot' which shows the root directory of the current repository. A new template function 'mailmap' which maps author fields based on values in a .mailmap file.

7.1.6. Other notable features

  • revset: parse error now shows a hint where the error occurred
  • templates: parse error now shows a hint where the error occured
  • forget: new '--dry-run' and '--interactive' flags
  • copyfile: preserve stat info (mtime, etc.) when doing copies/renames
  • bundle2 format is documented and can be found using 'hg help internals.bundle2'

7.2. Backwards Compatibility Changes

  • Support for connecting to Mercurial servers older than 0.9.1 has been removed.
  • Working-directory commands now respect "-X PATTERN" no matter if PATTERN matches explicitly-specified FILEs. For example, "hg add foo -X foo" no longer add the file "foo".
  • Support for the experimental manifestv2 format has been removed, as it was never completed and failed to meet expectations.
  • '{' in output filename passed to archive/cat/export is taken as a start of a template expression.
  • The HTTP wire protocol server no longer accepts the "cmd" argument to control which command to run via HTTP POST bodies. The "cmd" argument must be specified on the URL query string.
  • Hgweb no longer reads form data in POST requests from multipart/form-data and application/x-www-form-urlencoded requests. Arguments should be specified as URL path components or in the query string in the URL instead.
  • Query string shorts in hgweb like "?cs=@" have been removed. Use URLs of the form "/:cmd" instead.
  • The HTTP client no longer accepts text/plain and application/hg-changegroup Content-Type values as a valid Mercurial command response. These should only be encountered on pre 1.0 Mercurial servers.

7.3. Performance Improvements

  • 'hg manifest --all' is likely slower due to changing its implementation to respect storage interface boundaries. If you are impacted by this regression in a meaningful way, please make noise on the development mailing list and it can be dealt with.
  • 'hg diff' is much faster for larger repositories. 40% improvements have been reported. Other operations using diffs like hgweb also benefit.

7.4. Bug Fixes

  • grep: fixes erroneous output of grep in forward order (issue3885)

  • dirstate: drop explicit files that shouldn't match (BC) (issue4679)

  • procutil: rewrite popen() as a subprocess.Popen wrapper (issue4746) (API)

  • bookmarks: test for exchanging long bookmark names (issue5165)

  • templater: drop symbols which should be overridden by new 'ctx' (issue5612)

  • clone: updates the help text for hg clone -{r,b} (issue5654)

  • bundle: updates the help text for hg bundle (issue5744)

  • histedit: make histedit's commands accept revsets (issue5746)

  • releasenotes: replace abort with warning while parsing (issue5775)

  • context: skip path conflicts by default when clearing unknown file (issue5776)

  • templatekw: switch most of showlist template keywords to new API (issue5779)

  • rebase: do not consider extincts for divergence detection (issue5782)

  • revert: use an exact matcher in interactive diff selection (issue5789)

  • subrepo: don't attempt to share remote sources (issue5793)

  • lfs: respect narrowmatcher when testing to add 'lfs' requirement (issue5794)

  • showconfig: allow multiple section.name selectors (issue5797)

  • annotate: do not poorly split lines at CR (issue5798)

  • convert: avoid closing ui.fout in subversion code (issue5807)

  • setdiscovery: back out changeset 5cfdf6137af8 (issue5809)

  • fsmonitor: layer on another hack in bser.c for os.stat() compat (issue5811)

  • notify: access the initial revision on an unfiltered repository (issue5821)

  • rebase: fix issue 5494 also with --collapse
  • date: fixed a bug in parsing months like 'Feb 2018', 'Apr 2018'
  • diffhelper: rename module to avoid conflicts with ancient C module (issue5846)

  • infinitepush: ensure fileindex bookmarks use '/' separators (issue5840)

  • import: fix crash on --exact check of empty commit (issue5702)

  • hgweb: reuse body file object when hgwebdir calls hgweb (issue5851)

  • debugcolor: fix crash by empty styles (issue5856)

  • hgweb: discard Content-Type header for 304 responses (issue5844)

  • hgweb: allow Content-Security-Policy header on 304 responses (issue5844)

  • paper: don't register click handlers with inline javascript (issue5812)

  • httppeer: detect redirect to URL without query string (issue5860)

  • filelog: don't crash on invalid copy metadata (issue5748)

7.5. New experimental features

Each release there are lot of new features added which are hidden under the EXPERIMENTAL tag as the behavior may change in future or the feature is not complete yet. The experimental features added in this cycle are:

7.5.1. narrow extension

Allows to create clones which fetch history data for only a subset of files. This experimental extension is now distributed with Mercurial.

7.5.2. remotenames extension

Shows remotebookmarks and remotebranches in the UI. This experimental extension is now distributed with Mercurial.

7.5.3. infinitepush extension

Allows to store some pushes in a remote blob store on the server and to serve commits from remote blob store. The revisions are stored on disk or in everstore, the metadata are stored in sql or on disk. This experimental extension is now distributed with Mercurial.

7.5.4. fix extension

Allows to rewrite file content in changesets or working copy. For example, automatically applying formatting fixes to modified lines of code. This experimental extension is now distributed with Mercurial.

7.5.5. lfs extension

An alternative to the largefiles extension, which uses the git-lfs protocol. This experimental extension is now distributed with Mercurial.

7.6. API Changes

  • Content from mercurial.hgweb.protocol has been moved to mercurial.wireprotoserver.
  • Content from mercurial.sshserver has been moved into mercurial.wireprotoserver.
  • sshserver no longers looks for wire protocol command handlers in methods named do_<command>. Use @wireproto.wireprotocommand to declare wire protocol command handler functions.

  • Log-related utility functions has been renamed as follows:
    • - cmdutil.loglimit -> logcmdutil.getlimit

      - cmdutil.diffordiffstat -> logcmdutil.diffordiffstat

      - cmdutil._changesetlabels -> logcmdutil.changesetlabels

      - cmdutil.changeset_printer -> logcmdutil.changesetprinter - cmdutil.jsonchangeset = logcmdutil.jsonchangeset

      - cmdutil.changeset_templater -> logcmdutil.changesettemplater

      - cmdutil.logtemplatespec -> logcmdutil.templatespec

      - cmdutil.makelogtemplater -> logcmdutil.maketemplater

      - cmdutil.show_changeset -> logcmdutil.changesetdisplayer

      - cmdutil.getlogrevs -> logcmdutil.getrevs

      - cmdutil.getloglinerangerevs -> logcmdutil.getlinerangerevs

      - cmdutil.displaygraph -> logcmdutil.displaygraph

      - cmdutil.graphlog -> logcmdutil.graphlog

      - cmdutil.checkunsupportedgraphflags -> logcmdutil.checkunsupportedgraphflags

      - cmdutil.graphrevs -> logcmdutil.graphrevs

      - cmdutil._makenofollowlogfilematcher -> logcmdutil._makenofollowfilematcher

  • The following deprecated methods have been removed from context, with replacements:
    • - unstable() -> orphan()

      - bumped() -> phasedivergent()

      - divergent() -> contentdivergent()

      - troubled() -> isunstable()

      - troubles() -> instabilities()

  • The following deprecated methods have been removed from obsolete, with replacements:
    • - _addprecursors() -> _addpredecessors()

      - obsstore.precursors -> obsstore.predecessors

      - allprecursors() -> obsutil.allprecursors()

      - allsuccessors() -> obsutil.allsuccessors()

      - marker() -> obsutil.marker

      - getmarkers() -> obsutil.getmarkers()

      - exclusivemarkers() -> obsutil.exclusivemarkers()

      - foreground() -> obsutil.foreground()

      - successorssets() -> obsutil.successorsset()

      - unstable() -> orphan()

      - bumped() -> phasedivergent()

      - divergent() -> contentdivergent()

  • The following deprecated methods have been removed from obsutil: marker.precnode() and allprecursors(). Use marker.prednode() and allpredecessors() instead.

  • beginparentchange() and endparentchange() have been replaced by the parentchange context manager.

  • The deprecated localrepo.walk() has been removed, and replaced by repo[node].walk().

  • The following deprecated methods have been removed from bookmarks: __setitem__(), __delitem__(), update(), and recordchange(). Use bookmarks.applychanges() instead.

  • The cmdutil._revertprefetch() hook point for prefetching stored files has been replaced by the command agnostic cmdutil._prefetchfiles(). The new function takes a list of files, instead of a list of lists of files.

  • sshpeer.sshpeer.__init__ now receives arguments describing an existing connection instead of creating a connection itself.

  • sshpeer.sshpeer renamed to sshpeer.sshv1peer.

  • wireproto.pushres and wireproto.pusherr now explicitly track stdio output.

  • redirect() and restore() have been removed from the wire protocol handler interface. Use mayberedirectstdio() instead.

  • The _client() method of the wire protocol handler interface has been renamed to client().

  • Wire protocol command handlers now return a wireprototypes.bytesresponse instead of a raw bytes instance. Protocol handlers will continue handling bytes instances. However, any extensions wrapping wire protocol commands will need to handle the new type.

  • SSH protocol handler now advertises its name internally as "ssh-v1" instead of "ssh."
  • File prefetching is now handled by registering a callback with scmutil.fileprefetchhooks.

  • HTTP protocol handlers now advertises its internal name as "http-v1" instead of "http".
  • context.basectx no longer implements __int__. Context instances will no longer cast to ints. Consumers should call ctx.rev() instead.

  • templatekw.showdict() and showlist() are deprecated in favor of new (context, mapping) API. Switch the keyword function to new API and use templatekw.compatdict() and compatlist() instead.

  • hgweb_mod.perms and wireproto.permissions have been removed. Wire protocol commands should declare their required permissions in the @wireprotocommand decorator.

  • The WSGI request object no longer exposes a form attribute containing parsed query string data. Use the qsparams attribute instead.

  • hgweb.hgweb_mod.permhooks no longer take a wsgirequest instance as an argument.

  • hgweb @webcommand functions must use the new response object passed in via "web.res" to initiate sending of a response. The hgweb WSGI application will no longer start sending the response automatically.

  • Various helper functions in hgweb.webutil no longer accept a templater instance. Access the templater through the "web" argument instead.
  • Various functions in hgweb.webutil now take a modern request object instead of "wsgirequest".
  • @webcommand functions now only receive a single argument. The request and templater instances can be accessed via the "req" and "templater" attributes of the first argument. Note that the request object is different from previous Mercurial releases and consumers of the previous "req" 2nd argument will need updating to use the new API.

  • The old "wsgirequest" class for handling everything WSGI in hgweb has been replaced by separate request and response types. Various high-level functions in the hgweb WSGI applications now receive these new types as arguments instead of the old "wsgirequest" type.
  • The render(mapping) method of the templater has been renamed to renderdefault(mapping).

  • httppeer.httppeer.__init__ now takes additional arguments. Instances should be obtained by calling httppeer.instance() or httppeer.makepeer() instead.

  • The templater is no longer callable. Use templater.generate(t, mapping) instead of templater(t, **pycompat.strkwargs(mapping)).

  • templatekw._showlist() is deprecated in favor of templateutil._showcompatlist(), which takes context in place of templ.

  • Several generic string helper functions have been moved to utils.stringutil module.
  • The util.Abort alias has been removed. Use error.Abort.

  • merge.update() and merge.applyupdates() now return a class with named attributes instead of a tuple. Switch consumers to access elements by name instead of by offset.

  • Utility functions related to process/executable management have been moved to utils.procutil module.
  • localrepo.localrepository.featuresetupfuncs has been renamed to localrepo.featuresetupfuncs.
  • localrepo.localrepository.filterpats was renamed to localrepo.localrepository._filterpats.
  • Template filters should declare input data type and/or catch AttributeError, ValueError, TypeError, etc. as needed. See the doc of "registrar.templatefilters" for details.

  • "wireproto" module no longer re-exports various types used to define responses to wire protocol commands. Access these types from the "wireprototypes" module.
  • filelog.parsemeta() and filelog.packmeta() have been moved to the revlog module.

  • procutil.popen() no longer supports text mode I/O.

  • hook.hook() and hook.runhooks() may return a negative integer to denote that the process was killed by signal.

  • filelog.filelog is now a standalone class and doesn't inherit from revlog. Instead, it wraps a revlog instance at self._revlog. This change was made in an attempt to formalize storage APIs and prevent revlog implementation details leaking through to callers.

  • The fp argument is removed from cmdutil.export(). Use cmdutil.exportfile() instead.

  • cmdutil.export() takes a formatter as an argument.

  • patch.extract() is now a context manager. Callers no longer have to worry about deleting the temporary file it creates, as the file is tied to the lifetime of the context manager.

  • The wire protocol peer's iterbatch() for bulk executing commands has been removed. Use peer.commandexecutor() instead.

8. Mercurial 4.5.3 (2018-04-04)

This is a regularly-scheduled bugfix release.

8.1. Bug Fixes

  • rebase: on abort, don't strip commits that didn't need to be rebased (issue5822)

  • hgweb: garbage collect on every request
  • amend: abort if unresolved merge conflicts found (issue5805)

9. Mercurial 4.5.1 / 4.5.2 (2018-03-06)

(4.5.2 was released immediately after 4.5.1 to fix a release oversight.)

This is a regularly-scheduled bugfix release.

9.1. Security Fixes

All versions of Mercurial prior to 4.5.2 have vulnerabilities in the HTTP server that allow permissions bypass to:

  • Perform writes on repositories that should be read-only
  • Perform reads on repositories that shouldn't allow read access

CVE-2018-1000132 has been assigned these vulnerabilities.

The nature of the vulnerabilities is:

  1. Wire protocol commands that didn't explicitly declare their permissions had no permissions checking done. The web.{allow-pull, allow-push, deny_read, etc} config options governing access control were never consulted when running these commands. This allowed permissions bypass for impacted commands.

  2. The batch wire protocol command did not list its permission requirements nor did it enforce permissions on individual sub-commands.

The implication of these vulnerabilities is that no permissions checking was performed on commands and this could lead to accessing data that web.* config options were supposed to prevent access to or modifying data (via wire protocol commands that can mutate data) without authorization. A Mercurial HTTP server in its default configuration is supposed to be read-only. However, a well-crafted batch command could invoke commands that perform writes.

The batch write permissions bypass has been present since Mercurial 1.9. The flaw of not checking permissions for wire protocol commands that don't declare their needed permissions has been present since Mercurial 1.0.

Assuming you are running a server without any custom commands provided by extensions, your exposure is unauthorized data access (if relying on the web.* config options to limit access) and unauthorized data mutation via the batch command.

Server operators can detect unauthorized use of the batch command by looking for requests to URLs of the form repo?cmd=batch with arguments containing pushkey or unbundle. This may produce false positives. A more comprehensive check would decode the argument string and verify that pushkey or unbundle are command names (not values). The arguments specified via x-hgarg-<N> request headers can span multiple headers. So advanced attackers could hide the vulnerability by splitting a pushkey or unbundle string across multiple headers. So the only reliable way to detect if this vulnerability is being exploited is to decode these headers like Mercurial does. The format for specifying arguments is documented at https://www.mercurial-scm.org/repo/hg/file/4.5/mercurial/help/internals/wireprotocol.txt#l26. Python code for decoding headers is at https://www.mercurial-scm.org/repo/hg/file/4.5/mercurial/hgweb/protocol.py#l70.

Mercurial 4.5.2 fixes these vulnerabilities by:

  • Performing permissions checking on all wire protocol commands, not just commands that list their permissions.
  • Checking permissions on sub-commands issued to the batch command.

Wire protocol commands not declaring wire protocol permissions will be assumed to be read-write commands and a server in its default configuration (which only allows read-only access), will refuse to execute these commands.

For package maintainers needing to backport the fixes, the relevant changesets from 4.5.2 are 2c647da851ed::2ecb0fc535b1. These can be viewed online at e.g. https://www.mercurial-scm.org/repo/hg/rev/2ecb0fc535b1. The author of these commits has backports to 4.4 and 4.3 on a personal fork at https://hg.mozilla.org/users/gszorc_mozilla.com/hg. The backports for 4.4 are a4843835c835::7cf827e5f8af and for 4.3 are db527ae12671::86f9a022ccb8. To obtain these changesets, run e.g. hg pull -r 7cf827e5f8af https://hg.mozilla.org/users/gszorc_mozilla.com/hg.

9.2. Backwards Compatibility Changes

  • The "batch" wire protocol command now enforces permissions of each invoked sub-command. Wire protocol commands must define their operation type or the "batch" command will assume they can write data and will prevent their execution on HTTP servers unless the HTTP request method is POST, the server is configured to allow pushes, and the (possibly authenticated) HTTP user is authorized to perform a push.
  • Wire protocol commands not defining their operation type in "wireproto.PERMISSIONS" are now assumed to be used for "push" operations and access control to run those commands is now enforced accordingly.

9.3. Bug Fixes

  • fileset: don't abort when running copied() on a revision with a removed file
  • date: fix parsing months
  • setup: only allow Python 3 from a source checkout (issue5804)

  • annotate: do not poorly split lines at CR (issue5798)

  • subrepo: don't attempt to share remote sources (issue5793)

  • subrepo: activate clone pooling to enable sharing with remote URLs
  • changegroup: do not delta lfs revisions
  • revlog: do not use delta for lfs revisions
  • revlog: resolve lfs rawtext to vanilla rawtext before applying delta

10. Mercurial 4.5 (2018-02-01)

10.1. New Features

10.1.1. revert --interactive

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

10.1.2. Accessing hidden changesets

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

10.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.

10.1.4. Largefiles changes

  • largefiles: add a 'debuglfput' command to put largefile into the store
  • largefiles: add support for 'largefiles://' url scheme
  • largefiles: allow to run 'debugupgraderepo' on repo with largefiles
  • largefiles: convert EOL of hgrc before appending to bytes IO
  • largefiles: explicitly set the source and sink types to 'hg' for lfconvert
  • largefiles: modernize how capabilities are added to the wire protocol

10.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.

10.2.1. Other Changes

  • When interactive revert is run against a revision other than the working directory parent, the diff shown is the diff to <em>apply</em> to the working directory, rather than the diff to <em>discard</em> from the working copy. This is in line with related user experiences with 'git' and appears to be less confusing with 'ui.interface=curses'.

  • Let 'hg rebase' avoid content-divergence by skipping obsolete changesets (and their descendants) when they are present in the rebase set along with one of their successors but none of their successors is in destination.
  • A new experimental config flag, 'rebase.experimental.inmemory', makes rebase perform an in-memory merge instead of doing it on-disk in the working copy.
  • The HGPLAINEXCEPT environment variable can now include color to allow automatic output colorization in otherwise automated environments.

  • A new unamend command in uncommit extension which undoes the effect of the amend command by creating a new changeset which was there before amend and moving the changes that were amended to the working directory.
  • A '--abort' flag to merge command to abort the ongoing merge.
  • An experimental flag '--rev' to 'hg branch' which can be used to change branch of changesets.
  • bundle2 read I/O significantly improved
  • bundle2 memory use significantly reduced during read
  • clonebundle: it is now possible to serve the clonebundle using a git-lfs compatible server.
  • templatefilters: add slashpath() to convert path separator to slash (issue5572)

  • A new experimental config flag, 'inline-color-diff', adds within-line color diff capacity
  • histedit: add support to output nodechanges using formatter to help with editor integrations

10.3. Backwards Compatibility Changes

  • log --follow-first -rREV, which is deprecated, now follows the first parent of merge revisions from the specified REV just like log --follow -rREV.

  • log --follow -rREV FILE.. now follows file history across copies and renames.

  • transaction: register summary callbacks only at start of transaction
  • hgweb's graph view no longer supports browsers that lack <canvas> support

  • hgweb: only include graph-related data in jsdata variable on /graph pages
  • graphlog: add another graph node type, unstable, using character *

  • remove: print message for each file in verbose mode only while using '-A'

10.4. Bug Fixes

  • Bookmark, whose name is longer than 255, can again be exchanged again between 4.4+ client and servers (issue5165)

  • The convert extension works with bzr < 2.6.0 again (issue5733)

  • Mercurial will now attempt to use hardlinks on NTFS on Windows (issue4580)

  • The revset x^:: is now correctly parsed as (x^):: instead of being an error (issue5764)

  • Setting the diff.noprefix configuration option no longer breaks the --stat flag on hg diff (issue5759)

  • hg outgoing now honors :pushurl paths from hgrc (issue5365)

  • log: translate column labels at once (issue5750)

  • patch: improve heuristics to not take the word diff as header (issue1879)

  • templater: look up symbols/resources as if they were separated (issue5699)

  • http and ssh: support for emitting extra debug logs about requests as they happen

10.5. API Changes

  • bundlerepo.bundlerepository.bundle and bundlerepo.bundlerepository.bundlefile are now prefixed with an underscore.

  • Rename bundlerepo.bundlerepository.bundlefilespos to _cgfilespos.
  • dirstate no longer provides a 'dirs()' method. To test for the existence of a directory in the dirstate, use 'dirstate.hasdir(dirname)'.
  • mapping does not contain all template resources. use context.resource() in template functions.
  • text=False|True option is dropped from the vfs interface because of Python 3 compatibility issue. Use util.tonativeeol/fromnativeeol() to convert EOL manually.

  • wireproto.streamres.__init__ no longer accepts a reader argument. Use the gen argument instead.

  • exchange.getbundlechunks() now returns a 2-tuple instead of just an iterator.
  • bundle2 parts are no longer seekable by default
  • memfilectx: the changectx argument is now mandatory in constructor

11. Mercurial 4.4.2 (2017-12-01)

This is a regularly-scheduled bugfix release.

11.1. Notable changes

11.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.

11.2. Bug fixes

  • 'hg amend' now correctly handles deleted and removed files, as well as subrepos. (issue5732, issue5677)

  • largefiles now correctly handles dropped standin files when updating largefiles.
  • Fixed an issue with deleting symlinks to directories when ui.origbackuppath is set. (issue5731)

11.3. Performance improvements

  • Improved performance in path conflict checking introduced in Mercurial 4.4. (issue5716)

12. Mercurial 4.4.1 (2017-11-07)

12.1. Notable changes

  • Git and Subversion subrepos have been disabled by default to mitigate a potential security risk if files overlapping with a subrepo managed to be committed to a repository.
  • Subrepos are now more paranoid about symlink traversal.
  • The share extension handles drive letters on Windows better.

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.

13. Mercurial 4.4 (2017-11-01)

13.1. Notable changes

13.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.

13.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.

13.1.3. Other changes

  • Estimated time is more accurate with non-linear progress
  • "hg status -v" can now show unfinished state. For example, when in an unfinished rebase state, "hg status -v" might show:
     # The repository is in an unfinished *rebase* state.
     # No unresolved merge conflicts.
     # To continue:                hg rebase --continue
     # To abort:                   hg rebase --abort
  • Added '--ignore-space-at-eol' diff option to ignore whitespace differences at line endings.
  • show: use consistent node length in views
  • show: decrease minimum displayed hash length from 5 to 4
  • A new uncommit extension which provides 'hg uncommit' using which one can uncommit part or all of the changeset. This command undoes the effect of a local commit, returning the affected files to their uncommitted state.
  • 'hg clone --uncompressed' uses clone bundles when possible
  • 'hg annotate --skip' now prints a '*' on lines with skipped revisions
  • New 'commands.update.check' feature to adjust constraints on when 'hg update' will allow updates with a dirty working copy.
  • Add an experimental -L/--line-range FILE,FROMLINE:TOLINE option to 'hg log' command to follow the history of files by line range. In combination with -p/--patch option, only diff hunks within specified line range will be displayed. Feedback, especially on UX aspects, is welcome.

  • Print warning when fsmonitor isn't being used on a large repository

13.2. Backwards Compatibility Changes

  • The config option for copytrace 'experimental.disablecopytrace' is now replaced with 'experimental.copytrace' which defaults to 'on'. If you need to turn off copytracing, add '[experimental] copytrace = off' to your config.
  • 'hg clone --stream' should now be used instead of --uncompressed. --uncompressed is marked as deprecated and is an alias for --stream. There is no schedule for elimination of --uncompressed.
  • The 'experimental.updatecheck' name for the new 'commands.update.check' feature is now deprecated, and will be removed after this release.
  • Mercurial subrepositories are now shared instead of cloned when the parent repository is shared. This prevents dangling subrepository references in the share source. Previously shared repositories with cloned subrepositories will continue to function unchanged.
  • Push no longer triggers a pushkey hook when updating phases. Use the new 'txnclose-phase' and 'txnclose-phase' hooks instead. (Applies when both server and client use version 4.4 or above).

13.3. Bug Fixes

  • Core rebase algorithm has been rewritten to be more robust (issue5578, issue5630)

  • Creating a share of a repository with a Mercurial subrepository will now share the subrepository (issue5675)

13.4. Performance Improvements

  • improved performance when many aliases are defined

13.5. API Changes

13.5.1. remove peer.batch()

Replace with peer.iterbatch().

13.5.2. Other Changes

  • @peer.batchable can no longer emit local values
  • @peer.batchable functions must now yield exactly 2 values
  • Rename attributes on sshpeer to reflect peer API
  • peer.peerrepository has been removed. Use repository.peer abstract base class to represent a peer repository.
  • revset.stringset() now takes 'order' as the last argument.

14. Mercurial 4.3.3 (2017-10-01)

  • Prevent crashes when clearing progress bar. (issue5684)

  • rebase: move bookmarks with --keep (issue5682)

15. Mercurial 4.3.2 (2017-09-18)

  • restore compatibility with older versions of Python 2.7 by not using a bytearray with struct.unpack_from()
  • restore mingw compatibility for setup.py
  • hgwebdir: read 'web.template' untrusted (plugs potential security issue)
  • repair: preserve phase when not using generaldelta (issue5678)

  • ssh: fix flakey ssh errors on BSD systems
  • restore error handling behavior around certain I/O errors; the regressed behavior could result in transactions not being properly rolled back if stdio handles encountered errors (issue5658)

  • templatekw: choose {latesttag} by len(changes), not date (issue5659)

  • record: fix revert -i for lines without newline (issue5651)

  • mq: create non-lossy patches, also with custom global diff configuration

16. 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.

16.1. Notable changes

  • experimental amend extension providing the amend command
  • experimental sparse extension
  • Support for Python 2.6 has been dropped.
  • Bundles created by the strip extension now store phase information. It will be restored when unbundling.
  • The strip extension now removes relevant obsmarkers. If a backup requested (the default), the obsmarkers are stored in the backup bundle and will be restored when unbundling.
  • hg show work (from the experimental show extension) now displays more info

  • hg show stack is a new view for the current, in-progress changeset and others around it

  • Mitigation for two security vulnerabilities

16.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.

16.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.

17. 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.

18. Mercurial 4.2.2 (2017-07-05)

This is a regularly-scheduled bugfix release.

  • largefiles: avoid a crash when archiving a subrepo with largefiles disabled
  • rebase: also test abort from pretxnclose error
  • rebase: backed out changes 2519994d25ca and cf8ad0e6c0e4 (issue5610)

  • rebase: reinforce testing around precommit hook interrupting a rebase

19. Mercurial 4.2.1 (2017-6-4)

This is a regularly-scheduled bugfix release.

  • hg graft now works when grafting across merges that were problematic before (b4e1e30528c7).

  • A race condition in hg status was partially fixed (issue5584).

  • The message about deprecated SHA-1 hashes in the [hostfingerprints] config section now references the correct syntax for replacing them with SHA-256 hashes (issue5559).

20. Mercurial 4.2 (2017-5-2)

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

20.1. Notable changes

  • Pager support has been moved into core and is now enabled by default. This is now controlled with the ui.paginate setting.
    • Note that in 4.2-rc, the ui.paginate option was named pager.enable. The old name has been dropped in the final release. If you had turned pagination off using pager.enable=False, please update your config.
  • Color support has also been moved into core and is now enabled by default (the ui.color setting now defaults to 'auto').
  • The new experimental 'show' extension provides a way to view various information about your repository in an ergonomic way. It is deliberately designed for human consumption and not for scripting, so it doesn't carry the same backward compatibility guarantees as other commands. See 'hg help -e show' for more information.

  • Mercurial now requires setuptools on Windows.

20.2. commands

  • Pager support has been added to the 'log', 'diff', 'branches', 'files', 'status', 'summary', and 'tags' commands, as well as the '--patch', '--list', and '--stat' options of hg shelve.
  • bisect: set a blockedtag when running the check command
  • bookmarks: check HG_PENDING strictly
  • branches: populate all template keywords in formatter
  • commandserver: handle backlog before exiting
  • commandserver: prevent unlinking socket twice
  • commit: optionally strip quotes from commit template (BC)
  • diff: add --binary option for git mode diffs
  • help: add pointer how to narrow list of resolved/unresolved files (issue5469)

  • pager: advertise the config option in the default hgrc
  • pager: avoid shell=True on subprocess.Popen for better errors (issue5491)

  • pager: don't terminate with extreme prejudice on SIGPIPE (BC)
  • pager: exit cleanly on SIGPIPE (BC)
  • pager: improve support for various flavors of 'more' on Windows
  • pager: use less as a fallback on Unix
  • pull: abort pull --update if config requires destination (issue5528)

  • serve: add support for Mercurial subrepositories
  • status: handle more node indicators in buildstatus
  • status: support commands.status.relative config
  • update: accept --merge to allow merging across topo branches (issue5125)

  • verify: fix length check

20.3. core

  • bundle2: ignore errors seeking a bundle after an exception (issue4784)

  • checkheads: upgrade the obsolescence postprocessing logic (issue4354)

  • color: insert color code after every "\e[0m" (issue5413)

  • color: sync text attributes and buffered text output on Windows (issue5508)

  • config: use "churn" as an example extension
  • config: drop pager from the recommended extension
  • context: optimize linkrev adjustment in blockancestors() (issue5538)

  • crecord: avoid setting non-existing SIGTSTP signal on windows (issue5512)

  • debian: configure editor and pager to sensible-editor and sensible-pager by default
  • dispatch: ignore further SIGPIPE while handling KeyboardInterrupt

  • dispatch: protect against malicious 'hg serve --stdio' invocations (SEC)
  • dispatch: start profiling earlier
  • filemerge: optionally strip quotes from merge marker template (BC)
  • formatter: add support for changeset templating
  • formatter: support json formatting of long type
  • graphlog: draw multiple edges towards null node (issue5440)

  • graphlog: optionally strip quotes from graphnode template (BC)
  • localrepo: deprecate 'repo.join' in favor of 'repo.vfs.join'
  • localrepo: deprecate 'repo.opener' (API)
  • localrepo: deprecate 'wfile'
  • localrepo: deprecated 'repo.wopener' (API)
  • match: adding support for matching files inside a directory
  • packaging: add make target for linux wheels
  • patch: make diff in git mode respect --text option (issue5510)

  • plain: ignore [commands] config
  • profiling: add statprof support for Chrome trace viewer rendering
  • progress: retry ferr.flush() and .write() on EINTR (issue5532)

  • py3: stop exporting urlparse from pycompat and util (API)
  • rcutil: let environ override system configs (BC)
  • rcutil: let rccomponents return different types of configs (API)
  • rcutil: move scmutil.*rcpath to rcutil (API)
  • rcutil: rename rcpath to rccomponents (API)
  • rcutil: split osrcpath to return default.d paths (API)
  • record: update help message to use operation instead of "record" (issue5432)

  • revlog: avoid applying delta chain on cache hit
  • revset: split language services to revsetlang module (API)
  • revset: stop supporting plain list as input set (API)
  • revset: stop supporting predicate that returns plain list (API)
  • setup: use setuptools on Windows (issue5400)

  • smartset: move set classes and related functions from revset module (API)
  • sshpeer: try harder to snag stderr when stdout closes unexpectedly
  • templatefilter: add support for 'long' to json()
  • templatekw: have showlist() take mapping dict with no **kwargs expansion (API)
  • templatekw: make join() escape values of extras (BC) (issue5504)

  • templater: make pad() strip color codes before computing width (issue5416)

  • test-profile: allow negative time in JSON output (issue5542)
  • track-tags: write all tag changes to a file
  • util: always force line buffered stdout when stdout is a tty (BC)
  • vfs: extract 'vfs' class and related code to a new 'vfs' module (API)

20.4. extensions

  • histedit: log the time taken to read in the commands list
  • histedit: make check for unresolved conflicts explicit (issue5545)

  • histedit: modify rollup to discard date from the rollup commit (issue4820)

  • histedit: use safecleanupnode in _aborthistedit (issue5500)

  • largefiles: add copytostore() fstandin argument to replace readstandin() (API)
  • largefiles: add lfile argument to updatestandin() for efficiency (API)
  • largefiles: make copytostore() accept only changectx as the 2nd argument (API)
  • largefiles: omit updating newly added standin at linear merging
  • largefiles: remove unused keyword argument of copytostore() (API)
  • largefiles: replace hashrepofile by hashfile (API)
  • largefiles: set the extension as enabled locally after a share requiring it
  • patchbomb: add config knob to generate flags by template (issue5354)

  • patchbomb: drop internal option for pbranch extension (API)
  • patchbomb: use modern pager to display -n/--test result (BC)
  • rebase: abort hg pull --rebase if rebase.requiredest is set (issue5514)

  • rebase: abort if *any* commit in rebase set is public
  • rebase: add flag to require destination
  • rebase: allow aborting if last-message.txt is missing
  • rebase: allow destination-free continue and abort (issue5513)

  • rebase: allow rebasing children of wd to wd if a new branch has been set (BC)
  • rebase: unhide original working directory node as well (issue5219)

  • shelve: add -n/--name option to unshelve (issue5475)

  • shelve: add logic to preserve active bookmarks
  • show: new extension for displaying various repository data

20.5. hgweb

  • hgweb: add a "patch" query parameter to filelog command
  • hgweb: do not show "descending" link in followlines UI for filelog heads
  • hgweb: handle a "descend" query parameter in filelog command
  • hgweb: handle a "linerange" request parameter in filelog command
  • hgwebdir: add support for explicit index files

20.6. Behavior changes

  • commit: optionally strip quotes from commit template (BC)
  • filemerge: optionally strip quotes from merge marker template (BC)
  • graphlog: optionally strip quotes from graphnode template (BC)
  • pager: don't terminate with extreme prejudice on SIGPIPE (BC)
  • pager: exit cleanly on SIGPIPE (BC)
  • patchbomb: use modern pager to display -n/--test result (BC)
  • rcutil: let environ override system configs (BC)
  • rebase: allow rebasing children of wd to wd if a new branch has been set (BC)
  • templatekw: make join() escape values of extras (BC) (issue5504)

  • util: always force line buffered stdout when stdout is a tty (BC)

20.7. Internal API changes

  • largefiles: add copytostore() fstandin argument to replace readstandin() (API)
  • largefiles: add lfile argument to updatestandin() for efficiency (API)
  • largefiles: make copytostore() accept only changectx as the 2nd argument (API)
  • largefiles: remove unused keyword argument of copytostore() (API)
  • largefiles: replace hashrepofile by hashfile (API)
  • localrepo: deprecate 'repo.opener' (API)
  • localrepo: deprecated 'repo.wopener' (API)
  • patchbomb: drop internal option for pbranch extension (API)
  • py3: stop exporting urlparse from pycompat and util (API)
  • rcutil: let rccomponents return different types of configs (API)
  • rcutil: move scmutil.*rcpath to rcutil (API)
  • rcutil: rename rcpath to rccomponents (API)
  • rcutil: split osrcpath to return default.d paths (API)
  • revset: split language services to revsetlang module (API)
  • revset: stop supporting plain list as input set (API)
  • revset: stop supporting predicate that returns plain list (API)
  • smartset: move set classes and related functions from revset module (API)
  • templatekw: have showlist() take mapping dict with no **kwargs expansion (API)
  • vfs: extract 'vfs' class and related code to a new 'vfs' module (API)

21. Mercurial 4.1.3 (2017-4-18)

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

  • hg serve --stdio could be tricked into granting authorized users access to the Python debugger. Thanks to Jonathan Claudius of Mozilla for reporting this issue. This issue is only a security issue for repositories served using --stdio, which includes ssh but *not* http. This is CVE-2017-9462.

22. Mercurial 4.1.2 (2017-4-3)

This is a regularly-scheduled bugfix release.

  • Mercurial should work inside IIS on Windows again. (issue5493)

  • zstd support now refuses to work on old bundle formats. (issue5506)

  • Merges involving subrepositories no longer crash in some cases. (issue5505)

  • Checking for new heads during push is no longer accidentally quadratic

23. Mercurial 4.1.1 (2017-3-2)

This is a regularly-scheduled bugfix release.

  • Several incorrect mailing list addresses have been corrected.
  • Various error cases have been corrected during push and pull.
  • Minor issues that happened when Mercurial spawned worker processes have been fixed.

24. Mercurial 4.1 (2017-2-1)

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

24.1. commands

  • commands: config option to control bundle compression level
  • crecord: add an experimental option for space key to move cursor down
  • crecord: rewrite status line text (BC)
  • diff: add experimental support for more git-diff extended diff features
  • graft: support grafting changes to new file in renamed directory (issue5436)

  • help: show help for disabled extensions (issue5228)

  • help: update help for 'hg update' which was misleading (issue5427)

  • merge: fix crash on criss cross merge with dir move and delete (issue5020)

  • summary: add evolution "troubles" information to summary output
  • summary: use the same labels as log command in "parent: " line
  • templates: display evolution "troubles" in command line style

24.2. core

  • changelog: keep track of file end in appender (issue5444)

  • dispatch: stop supporting non-use of @command (API)
  • hook: do not redirect stdout/err/in to ui while running in-process hooks (BC)
  • httppeer: advertise and support application/mercurial-0.2
  • localrepo: experimental support for non-zlib revlog compression
  • manifest: add bundlemanifestlog support
  • manifest: add unionmanifestlog support
  • manifest: make revlog verification optional
  • patch: add experimental config knob for displaying the index header
  • patch: add similarity config knob in experimental section
  • patch: add label for coloring the index extended header
  • patch: add label for coloring the similarity extended header
  • profiling: make statprof the default profiler (BC)
  • profiling: use vendored statprof and upstream enhancements (BC)
  • revlog: REVIDX_EXTSTORED flag
  • revlog: add clone method
  • revlog: ensure that flags do not overflow 2 bytes
  • revlog: flag processor
  • revlog: inline start() and end() for perf reasons
  • revlog: make compressed size comparisons consistent
  • revlog: merge hash checking subfunctions
  • revlog: move decompress() from module to revlog class (API)
  • revlog: optimize _chunkraw when startrev==endrev
  • revlog: pass revlog flags to addrevision
  • revlog: reorder index accessors to match data structure order
  • revlog: use compression engine API for compression
  • revlog: use compression engine APIs for decompression
  • revset: add regular expression support to 'desc'
  • revset: make children() not look at p2 if null (issue5439)

  • run-tests: forward Python USER_BASE from site (issue5425)

  • server: move cmdutil.service() to new module (API)
  • templatekw: force noprefix=False to insure diffstat consistency (issue4755)

  • ui: check EOF of getpass() response read from command-server channel
  • ui: do not translate empty configsource() to 'none' (API)
  • ui: factor out ui.load() to create a ui without loading configs (API)
  • util: compression APIs to support revlog compression and decompression
  • util: declare wire protocol support of compression engines
  • wireproto: advertise supported media types and compression formats
  • wireproto: only advertise HTTP-specific capabilities to HTTP peers (BC)
  • wireproto: perform chunking and compression at protocol layer (API)

24.3. extensions

  • convert: add config option to control storing original revision
  • convert: add config option to copy extra keys from Git commits
  • convert: config option for git rename limit
  • convert: config option to control Git committer actions
  • rebase: calculate ancestors for --base separately (issue5420)

  • rebase: check for conflicts before continuing
  • rebase: fail-fast the pull if working dir is not clean (BC)
  • shelve: allow multiple shelves with --patch and --stat
  • shelve: choose a legal shelve name when no name is passed (issue5112)

  • shelve: make --keep option survive user intervention (issue5431)

  • shelve: make unshelve not crash when there are missing files (issue4176)

24.4. hgweb

  • hgweb: link to raw-file on annotation page (BC)
  • hgweb: make log streams compatible with command server
  • hgweb: restore ascending iteration on revs in filelog web command
  • hgweb: support Content Security Policy

24.5. chg

  • chg: send type information via S channel (BC)
  • chg: support long socket path
  • chgserver: make S channel support pager request
  • chgserver: override runcommand

24.6. Behavior Changes

  • chg: send type information via S channel (BC)
  • crecord: rewrite status line text (BC)
  • hgweb: link to raw-file on annotation page (BC)
  • hook: do not redirect stdout/err/in to ui while running in-process hooks (BC)
  • profiling: make statprof the default profiler (BC)
  • profiling: use vendored statprof and upstream enhancements (BC)
  • rebase: fail-fast the pull if working dir is not clean (BC)
  • wireproto: only advertise HTTP-specific capabilities to HTTP peers (BC)

24.7. Internal API Changes

  • bookmarks: make bookmarks.comparebookmarks accept binary nodes (API)
  • bookmarks: rename 'compare()' to 'comparebookmarks()' (API)
  • revlog: move decompress() from module to revlog class (API)
  • server: move cmdutil.service() to new module (API)
  • ui: do not translate empty configsource() to 'none' (API)
  • ui: factor out ui.load() to create a ui without loading configs (API)
  • util: remove compressors dict (API)
  • util: remove decompressors dict (API)
  • wireproto: perform chunking and compression at protocol layer (API)
  • dispatch: stop supporting non-use of @command (API)

25. Mercurial 4.0.2 (2017-01-04)

This is a regularly-scheduled bugfix release.

  • demandimport: do not raise ImportError for unknown item in fromlist

  • posix: make poll() restart on interruption by signal (issue5452)

  • hgweb: add missing slash to file log url in rss style

26. Mercurial 4.0.1 (2016-12-1)

This is a regularly-scheduled bugfix release.

  • hgweb: cache fctx.parents() in annotate command (issue5414)

  • vfs, scmutil: ignore EPERM at os.utime, which avoids ambiguity (issue5418)

27. 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.

27.1. commands

  • annotate: calculate line count correctly
  • branchmap: acquires lock before writting the rev branch cache
  • clone: set default path correctly when doing a clone+share (issue5378)

  • copy: distinguish "file exists" cases and add a hint (BC)
  • commit: return 1 for interactive commit with no changes (issue5397)

  • config: add template support
  • debugobsolete: add formatter support (issue5134)

  • files: change documentation to match its behaviour (issue5276)

  • grep: add formatter support
  • help: show content for explicitly disabled extension (issue5228)

  • import: abort instead of crashing when copy source does not exist (issue5375)

  • import: report directory-relative paths in error messages (issue5224)

  • log: copy the way of ancestor traversal to --follow matcher (issue5376)

  • log: preserve topo sort in graph even if additional filter options specified
  • merge: add conflict labels to merge command
  • merge: avoid superfluous filemerges when grafting through renames (issue5407)

  • strip: report both bundle files in case of exception (issue5368)

  • tag: clarify warning about making a tag on a branch head
  • version: add formatter support
  • flags: allow specifying --no-boolean-flag on the command line (BC)

27.2. core

  • changelog: disable delta chains
  • copies: make _checkcopies handle copy sequences spanning the TCA (issue4028)

  • formatter: add function to convert list to appropriate format (issue5217)

  • lock: show more detail for new-style locks in lock waiting message (issue4752)

  • revset: do not rewrite ':y' to '0:y' (issue5385)

  • revset: fix order of nested '_(|int|hex)list' expression (BC)
  • revset: fix order of nested 'or' expression (BC)
  • revset: fix order of nested 'range' expression (BC)
  • revset: make reverse() and sort() no-ops when ordering requirement allows (BC)
  • revset: support "follow(renamed.py, e22f4f3f06c3)" (issue5334)

  • templater: provide a termwidth keyword (issue5395)

  • templater: add inheritance support to style maps
  • templater: add relpath() to convert repo path to relative path (issue5394)

  • templater: make pad() evaluate boolean argument (BC)
  • wireproto: unescape argument names in batch command (BC)

27.3. extensions

  • journal: properly check for held lock (issue5349)

  • journal: use fm.formatdate() to pass date tuple in appropriate type (BC)
  • journal: use fm.formatlist() to pass hashes in appropriate type (BC)
  • journal: use fm.hexfunc() to get full hash in JSON/template output (BC)
  • largefiles: fix 'deleted' files sometimes persistently appearing with R status
  • largefiles: handle that a found standin file doesn't exist when removing it
  • largefiles: more safe handling of interruptions while updating modifications
  • largefiles: when setting/clearing x bit on largefiles, don't change other bits
  • mq: release lock after transaction in qrefresh
  • mq: take wlock when 'qqueue' is doing write operations
  • rebase: properly calculate total commits to rebase (issue5347)

  • rebase: rebase changesets in topo order (issue5370) (BC)

27.4. hgweb

  • hgweb: avoid line wrap between revision and annotate-info (issue5398)

  • hgweb: config option to control zlib compression level

WhatsNew (last edited 2024-03-21 11:28:40 by RaphaelGomes)