( )⚙ D12201 tracked-key: remove the dual write and rename to tracked-hint

This is an archive of the discontinued Mercurial Phabricator instance.

Differential D12201

tracked-key: remove the dual write and rename to tracked-hint
ClosedPublic

Authored by marmoute on Feb 17 2022, 5:24 AM.

Details

Reviewers
Alphare
Group Reviewers
hg-reviewers
Commits
rHG6e559391f96e: tracked-key: remove the dual write and rename to tracked-hint
Summary

The dual-write approach was mostly useless. As explained in the previous version
of the help, the key had to be read twice before we could cache a value.

However this "read twice" limitation actually also apply to any usage of the
key. If some operation wants to rely of the "same value == same tracked set"
property it would need to read the value before, and after running that
operation (or at least, after, in all cases). So it cannot be sure the operation
it did is "valid" until checking the key after the operation. As a resultat such
operation can only be read-only or rollbackable.

This reduce the utility of the "same value == same tracked set" a lot.

So it seems simpler to drop the double write and to update the documentation to
highlight that this file does not garantee race-free operation. As a result the
"key" is demoted to a "hint".

Documentation is updated accordingly.

Diff Detail

Repository
rHG Mercurial
Branch
default
Lint
No Linters Available
Unit
No Unit Test Coverage

Event Timeline

marmoute created this revision.Feb 17 2022, 5:24 AM
Alphare requested changes to this revision.Feb 17 2022, 5:55 AM
Alphare added a subscriber: Alphare.
Alphare added inline comments.
mercurial/helptext/config.txt
958

s/writtent/written/

965

"The "identical" use a should is a SHOULD" Not sure what the intended phrasing was

969

s/isi/is/

This revision now requires changes to proceed.Feb 17 2022, 5:55 AM
marmoute updated this revision to Diff 32260.Feb 17 2022, 8:51 AM
Alphare accepted this revision.Feb 18 2022, 5:26 AM

Amended some other typos

This revision is now accepted and ready to land.Feb 18 2022, 5:26 AM

Revision Contents
Changeset List

Diff 32260

mercurial/configitems.py

b'format', b'format',
b'use-dirstate-v2', b'use-dirstate-v2',
default=False, default=False,
experimental=True, experimental=True,
alias=[(b'format', b'exp-rc-dirstate-v2')], alias=[(b'format', b'exp-rc-dirstate-v2')],
) )
coreconfigitem( coreconfigitem(
b'format', b'format',
b'use-dirstate-tracked-key', b'use-dirstate-tracked-hint',
default=False, default=False,
experimental=True, experimental=True,
) )
coreconfigitem( coreconfigitem(
b'format', b'format',
b'use-dirstate-tracked-key.version', b'use-dirstate-tracked-hint.version',
default=1, default=1,
experimental=True, experimental=True,
) )
coreconfigitem( coreconfigitem(
b'format', b'format',
b'dotencode', b'dotencode',
default=True, default=True,
) )

mercurial/dirstate.py

self, self,
opener, opener,
ui, ui,
root, root,
validate, validate,
sparsematchfn, sparsematchfn,
nodeconstants, nodeconstants,
use_dirstate_v2, use_dirstate_v2,
use_tracked_key=False, use_tracked_hint=False,
): ):
"""Create a new dirstate object. """Create a new dirstate object.
opener is an open()-like callable that can be used to open the opener is an open()-like callable that can be used to open the
dirstate file; root is the root of the directory tracked by dirstate file; root is the root of the directory tracked by
the dirstate. the dirstate.
""" """
self._use_dirstate_v2 = use_dirstate_v2 self._use_dirstate_v2 = use_dirstate_v2
self._use_tracked_key = use_tracked_key self._use_tracked_hint = use_tracked_hint
self._nodeconstants = nodeconstants self._nodeconstants = nodeconstants
self._opener = opener self._opener = opener
self._validate = validate self._validate = validate
self._root = root self._root = root
self._sparsematchfn = sparsematchfn self._sparsematchfn = sparsematchfn
# ntpath.join(root, '') of Python 2.7.9 does not add sep if root is # ntpath.join(root, '') of Python 2.7.9 does not add sep if root is
# UNC path pointing to root share (issue4557) # UNC path pointing to root share (issue4557)
self._rootdir = pathutil.normasprefix(root) self._rootdir = pathutil.normasprefix(root)
# True is any internal state may be different # True is any internal state may be different
self._dirty = False self._dirty = False
# True if the set of tracked file may be different # True if the set of tracked file may be different
self._dirty_tracked_set = False self._dirty_tracked_set = False
self._ui = ui self._ui = ui
self._filecache = {} self._filecache = {}
self._parentwriters = 0 self._parentwriters = 0
self._filename = b'dirstate' self._filename = b'dirstate'
self._filename_tk = b'dirstate-tracked-key' self._filename_th = b'dirstate-tracked-hint'
self._pendingfilename = b'%s.pending' % self._filename self._pendingfilename = b'%s.pending' % self._filename
self._plchangecallbacks = {} self._plchangecallbacks = {}
self._origpl = None self._origpl = None
self._mapcls = dirstatemap.dirstatemap self._mapcls = dirstatemap.dirstatemap
# Access and cache cwd early, so we don't access it for the first time # Access and cache cwd early, so we don't access it for the first time
# after a working-copy update caused it to not exist (accessing it then # after a working-copy update caused it to not exist (accessing it then
# raises an exception). # raises an exception).
self._cwd self._cwd
changes based on the former dirstate out can keep consistency. changes based on the former dirstate out can keep consistency.
""" """
return self._map.identity return self._map.identity
def write(self, tr): def write(self, tr):
if not self._dirty: if not self._dirty:
return return
write_key = self._use_tracked_key and self._dirty_tracked_set write_key = self._use_tracked_hint and self._dirty_tracked_set
if tr: if tr:
# delay writing in-memory changes out # delay writing in-memory changes out
if write_key:
tr.addfilegenerator(
b'dirstate-0-key-pre',
(self._filename_tk,),
lambda f: self._write_tracked_key(tr, f),
location=b'plain',
post_finalize=True,
)
tr.addfilegenerator( tr.addfilegenerator(
b'dirstate-1-main', b'dirstate-1-main',
(self._filename,), (self._filename,),
lambda f: self._writedirstate(tr, f), lambda f: self._writedirstate(tr, f),
location=b'plain', location=b'plain',
post_finalize=True, post_finalize=True,
) )
if write_key: if write_key:
tr.addfilegenerator( tr.addfilegenerator(
b'dirstate-2-key-post', b'dirstate-2-key-post',
(self._filename_tk,), (self._filename_th,),
lambda f: self._write_tracked_key(tr, f), lambda f: self._write_tracked_hint(tr, f),
location=b'plain', location=b'plain',
post_finalize=True, post_finalize=True,
) )
return return
file = lambda f: self._opener(f, b"w", atomictemp=True, checkambig=True) file = lambda f: self._opener(f, b"w", atomictemp=True, checkambig=True)
if write_key:
# we change the key-file before changing the dirstate to make sure
# reading invalidate there cache before we start writing
with file(self._filename_tk) as f:
self._write_tracked_key(tr, f)
with file(self._filename) as f: with file(self._filename) as f:
self._writedirstate(tr, f) self._writedirstate(tr, f)
if write_key: if write_key:
# we update the key-file after writing to make sure reader have a # we update the key-file after writing to make sure reader have a
# key that match the newly written content # key that match the newly written content
with file(self._filename_tk) as f: with file(self._filename_th) as f:
self._write_tracked_key(tr, f) self._write_tracked_hint(tr, f)
def delete_tracked_key(self): def delete_tracked_hint(self):
"""remove the tracked_key file """remove the tracked_hint file
To be used by format downgrad operation""" To be used by format downgrad operation"""
self._opener.unlink(self._filename_tk) self._opener.unlink(self._filename_th)
self._use_tracked_key = False self._use_tracked_hint = False
def addparentchangecallback(self, category, callback): def addparentchangecallback(self, category, callback):
"""add a callback to be called when the wd parents are changed """add a callback to be called when the wd parents are changed
Callback will be called with the following arguments: Callback will be called with the following arguments:
dirstate, (oldp1, oldp2), (newp1, newp2) dirstate, (oldp1, oldp2), (newp1, newp2)
Category is a unique identifier to allow overwriting an old callback Category is a unique identifier to allow overwriting an old callback
with a newer callback. with a newer callback.
""" """
self._plchangecallbacks[category] = callback self._plchangecallbacks[category] = callback
def _writedirstate(self, tr, st): def _writedirstate(self, tr, st):
# notify callbacks about parents change # notify callbacks about parents change
if self._origpl is not None and self._origpl != self._pl: if self._origpl is not None and self._origpl != self._pl:
for c, callback in sorted( for c, callback in sorted(
pycompat.iteritems(self._plchangecallbacks) pycompat.iteritems(self._plchangecallbacks)
): ):
callback(self, self._origpl, self._pl) callback(self, self._origpl, self._pl)
self._origpl = None self._origpl = None
self._map.write(tr, st) self._map.write(tr, st)
self._dirty = False self._dirty = False
self._dirty_tracked_set = False self._dirty_tracked_set = False
def _write_tracked_key(self, tr, f): def _write_tracked_hint(self, tr, f):
key = node.hex(uuid.uuid4().bytes) key = node.hex(uuid.uuid4().bytes)
f.write(b"1\n%s\n" % key) # 1 is the format version f.write(b"1\n%s\n" % key) # 1 is the format version
def _dirignore(self, f): def _dirignore(self, f):
if self._ignore(f): if self._ignore(f):
return True return True
for p in pathutil.finddirs(f): for p in pathutil.finddirs(f):
if self._ignore(p): if self._ignore(p):

mercurial/helptext/config.txt

$ hg debugupgraderepo \ $ hg debugupgraderepo \
--run \ --run \
--config format.use-dirstate-v2=False \ --config format.use-dirstate-v2=False \
--config storage.dirstate-v2.slow-path=allow --config storage.dirstate-v2.slow-path=allow
For a more comprehensive guide, see :hg:`help internals.dirstate-v2`. For a more comprehensive guide, see :hg:`help internals.dirstate-v2`.
``use-dirstate-tracked-key`` ``use-dirstate-tracked-hint``
Enable or disable the writing of "tracked key" file alongside the dirstate. Enable or disable the writing of "tracked key" file alongside the dirstate.
(default to disabled) (default to disabled)
That "tracked-key" can help external automations to detect changes to the That "tracked-hint" can help external automations to detect changes to the
set of tracked files. set of tracked files. (i.e the result of `hg files` or `hg status -macd`)
The tracked-key is written in a new `.hg/dirstate-tracked-key`. That file The tracked-hint is written in a new `.hg/dirstate-tracked-hint`. That file
contains two lines: contains two lines:
- the first line is the file version (currently: 1), - the first line is the file version (currently: 1),
- the second line contains the "tracked-key". - the second line contains the "tracked-hint".
That file is written right after the dirstate is written.
AlphareUnsubmitted
Not Done

s/writtent/written/

Alphare: s/writtent/written/
The tracked-key changes whenever the set of file tracked in the dirstate The tracked-hint changes whenever the set of file tracked in the dirstate
changes. The general guarantees are: changes. The general idea is:
- if the tracked key is identical, the set of tracked file MUST not have changed, - if the hint is identical, the set of tracked file SHOULD be identical,
- if the tracked key is different, the set of tracked file MIGHT differ. - if the hint is different, the set of tracked file MIGHT be different.
The "hint is identical" case use `SHOULD` as the dirstate and the hint file
AlphareUnsubmitted
Not Done

"The "identical" use a should is a SHOULD" Not sure what the intended phrasing was

Alphare: "The "identical" use a should is a `SHOULD`" Not sure what the intended phrasing was
are two distinct files and therefore that cannot be read or write in an
atomic way. If the key is identical, nothing garantee that the dirstate is
not updated right after the hint file. This is considered a negligible
limitation for the intended usecase. It is actually possible to prevent this
AlphareUnsubmitted
Not Done

s/isi/is/

Alphare: s/isi/is/
race by taking the repository lock during read operation.
They are two "ways" to use this feature: They are two "ways" to use this feature:
1) monitoring changes to the `.hg/dirstate-tracked-key`, if the file changes 1) monitoring changes to the `.hg/dirstate-tracked-hint`, if the file changes
the tracked set might have changed. the tracked set might have changed.
2) storing the value and comparing it to a later value. Beware that it is 2) storing the value and comparing it to a later value.
impossible to achieve atomic writing or reading of the two files involved
files (`.hg/dirstate` and `.hg/dirstate-tracked-key`). So it is needed to
read the `tracked-key` files twice: before and after reading the tracked
set. The `tracked-key` is only usable as a cache key if it had the same
value in both cases and must be discarded otherwise.
To enforce that the `tracked-key` value can be used race-free (with double
reading as explained in (2)), the `.hg/dirstate-tracked-key` is written
twice: before and after we change the associated `.hg/dirstate` file.
``use-persistent-nodemap`` ``use-persistent-nodemap``
Enable or disable the "persistent-nodemap" feature which improves Enable or disable the "persistent-nodemap" feature which improves
performance if the Rust extensions are available. performance if the Rust extensions are available.
The "persistent-nodemap" persist the "node -> rev" on disk removing the The "persistent-nodemap" persist the "node -> rev" on disk removing the
need to dynamically build that mapping for each Mercurial invocation. This need to dynamically build that mapping for each Mercurial invocation. This
significantly reduces the startup cost of various local and server-side significantly reduces the startup cost of various local and server-side

mercurial/localrepo.py

``reposetup()``. Generally speaking, ``hg.repository()`` should be ``reposetup()``. Generally speaking, ``hg.repository()`` should be
used. used.
""" """
_basesupported = { _basesupported = {
requirementsmod.BOOKMARKS_IN_STORE_REQUIREMENT, requirementsmod.BOOKMARKS_IN_STORE_REQUIREMENT,
requirementsmod.CHANGELOGV2_REQUIREMENT, requirementsmod.CHANGELOGV2_REQUIREMENT,
requirementsmod.COPIESSDC_REQUIREMENT, requirementsmod.COPIESSDC_REQUIREMENT,
requirementsmod.DIRSTATE_TRACKED_KEY_V1, requirementsmod.DIRSTATE_TRACKED_HINT_V1,
requirementsmod.DIRSTATE_V2_REQUIREMENT, requirementsmod.DIRSTATE_V2_REQUIREMENT,
requirementsmod.DOTENCODE_REQUIREMENT, requirementsmod.DOTENCODE_REQUIREMENT,
requirementsmod.FNCACHE_REQUIREMENT, requirementsmod.FNCACHE_REQUIREMENT,
requirementsmod.GENERALDELTA_REQUIREMENT, requirementsmod.GENERALDELTA_REQUIREMENT,
requirementsmod.INTERNAL_PHASE_REQUIREMENT, requirementsmod.INTERNAL_PHASE_REQUIREMENT,
requirementsmod.NODEMAP_REQUIREMENT, requirementsmod.NODEMAP_REQUIREMENT,
requirementsmod.RELATIVE_SHARED_REQUIREMENT, requirementsmod.RELATIVE_SHARED_REQUIREMENT,
requirementsmod.REVLOGV1_REQUIREMENT, requirementsmod.REVLOGV1_REQUIREMENT,
@repofilecache(b'dirstate') @repofilecache(b'dirstate')
def dirstate(self): def dirstate(self):
return self._makedirstate() return self._makedirstate()
def _makedirstate(self): def _makedirstate(self):
"""Extension point for wrapping the dirstate per-repo.""" """Extension point for wrapping the dirstate per-repo."""
sparsematchfn = lambda: sparse.matcher(self) sparsematchfn = lambda: sparse.matcher(self)
v2_req = requirementsmod.DIRSTATE_V2_REQUIREMENT v2_req = requirementsmod.DIRSTATE_V2_REQUIREMENT
tk = requirementsmod.DIRSTATE_TRACKED_KEY_V1 th = requirementsmod.DIRSTATE_TRACKED_HINT_V1
use_dirstate_v2 = v2_req in self.requirements use_dirstate_v2 = v2_req in self.requirements
use_tracked_key = tk in self.requirements use_tracked_hint = th in self.requirements
return dirstate.dirstate( return dirstate.dirstate(
self.vfs, self.vfs,
self.ui, self.ui,
self.root, self.root,
self._dirstatevalidate, self._dirstatevalidate,
sparsematchfn, sparsematchfn,
self.nodeconstants, self.nodeconstants,
use_dirstate_v2, use_dirstate_v2,
use_tracked_key=use_tracked_key, use_tracked_hint=use_tracked_hint,
) )
def _dirstatevalidate(self, node): def _dirstatevalidate(self, node):
try: try:
self.changelog.rev(node) self.changelog.rev(node)
return node return node
except error.LookupError: except error.LookupError:
if not self._dirstatevalidatewarned: if not self._dirstatevalidatewarned:
requirements -= to_drop requirements -= to_drop
requirements |= source_requirements requirements |= source_requirements
if createopts.get(b'sharedrelative'): if createopts.get(b'sharedrelative'):
requirements.add(requirementsmod.RELATIVE_SHARED_REQUIREMENT) requirements.add(requirementsmod.RELATIVE_SHARED_REQUIREMENT)
else: else:
requirements.add(requirementsmod.SHARED_REQUIREMENT) requirements.add(requirementsmod.SHARED_REQUIREMENT)
if ui.configbool(b'format', b'use-dirstate-tracked-key'): if ui.configbool(b'format', b'use-dirstate-tracked-hint'):
version = ui.configint(b'format', b'use-dirstate-tracked-key.version') version = ui.configint(b'format', b'use-dirstate-tracked-hint.version')
msg = _("ignoring unknown tracked key version: %d\n") msg = _("ignoring unknown tracked key version: %d\n")
hint = _("see `hg help config.format.use-dirstate-tracked-key-version") hint = _("see `hg help config.format.use-dirstate-tracked-hint-version")
if version != 1: if version != 1:
ui.warn(msg % version, hint=hint) ui.warn(msg % version, hint=hint)
else: else:
requirements.add(requirementsmod.DIRSTATE_TRACKED_KEY_V1) requirements.add(requirementsmod.DIRSTATE_TRACKED_HINT_V1)
return requirements return requirements
def checkrequirementscompat(ui, requirements): def checkrequirementscompat(ui, requirements):
"""Checks compatibility of repository requirements enabled and disabled. """Checks compatibility of repository requirements enabled and disabled.
Returns a set of requirements which needs to be dropped because dependend Returns a set of requirements which needs to be dropped because dependend

mercurial/requirements.py

# being successful (repository sizes went up due to worse delta # being successful (repository sizes went up due to worse delta
# chains), and the code was deleted in 4.6. # chains), and the code was deleted in 4.6.
GENERALDELTA_REQUIREMENT = b'generaldelta' GENERALDELTA_REQUIREMENT = b'generaldelta'
DOTENCODE_REQUIREMENT = b'dotencode' DOTENCODE_REQUIREMENT = b'dotencode'
STORE_REQUIREMENT = b'store' STORE_REQUIREMENT = b'store'
FNCACHE_REQUIREMENT = b'fncache' FNCACHE_REQUIREMENT = b'fncache'
DIRSTATE_TRACKED_KEY_V1 = b'dirstate-tracked-key-v1' DIRSTATE_TRACKED_HINT_V1 = b'dirstate-tracked-key-v1'
DIRSTATE_V2_REQUIREMENT = b'dirstate-v2' DIRSTATE_V2_REQUIREMENT = b'dirstate-v2'
# When narrowing is finalized and no longer subject to format changes, # When narrowing is finalized and no longer subject to format changes,
# we should move this to just "narrow" or similar. # we should move this to just "narrow" or similar.
NARROW_REQUIREMENT = b'narrowhg-experimental' NARROW_REQUIREMENT = b'narrowhg-experimental'
# Enables sparse working directory usage # Enables sparse working directory usage
SPARSE_REQUIREMENT = b'exp-sparse' SPARSE_REQUIREMENT = b'exp-sparse'
# the requirements are stored in store's requires # the requirements are stored in store's requires
# * DIRSTATE_V2_REQUIREMENT affects .hg/dirstate, of which there is one per # * DIRSTATE_V2_REQUIREMENT affects .hg/dirstate, of which there is one per
# working directory. # working directory.
WORKING_DIR_REQUIREMENTS = { WORKING_DIR_REQUIREMENTS = {
SPARSE_REQUIREMENT, SPARSE_REQUIREMENT,
SHARED_REQUIREMENT, SHARED_REQUIREMENT,
RELATIVE_SHARED_REQUIREMENT, RELATIVE_SHARED_REQUIREMENT,
SHARESAFE_REQUIREMENT, SHARESAFE_REQUIREMENT,
DIRSTATE_TRACKED_KEY_V1, DIRSTATE_TRACKED_HINT_V1,
DIRSTATE_V2_REQUIREMENT, DIRSTATE_V2_REQUIREMENT,
} }
# List of requirement that impact "stream-clone" (and hardlink clone) and # List of requirement that impact "stream-clone" (and hardlink clone) and
# cannot be changed in such cases. # cannot be changed in such cases.
# #
# requirements not in this list are safe to be altered during stream-clone. # requirements not in this list are safe to be altered during stream-clone.
# #

mercurial/upgrade_utils/actions.py

touches_changelog = False touches_changelog = False
touches_requirements = True touches_requirements = True
touches_dirstate = True touches_dirstate = True
compatible_with_share = True compatible_with_share = True
@registerformatvariant @registerformatvariant
class dirstatetrackedkey(requirementformatvariant): class dirstatetrackedkey(requirementformatvariant):
name = b'tracked-key' name = b'tracked-hint'
_requirement = requirements.DIRSTATE_TRACKED_KEY_V1 _requirement = requirements.DIRSTATE_TRACKED_HINT_V1
default = False default = False
description = _( description = _(
b'Add a small file to help external tooling that watch the tracked set' b'Add a small file to help external tooling that watch the tracked set'
) )
upgrademessage = _( upgrademessage = _(
supported = { supported = {
requirements.SPARSEREVLOG_REQUIREMENT, requirements.SPARSEREVLOG_REQUIREMENT,
requirements.COPIESSDC_REQUIREMENT, requirements.COPIESSDC_REQUIREMENT,
requirements.NODEMAP_REQUIREMENT, requirements.NODEMAP_REQUIREMENT,
requirements.SHARESAFE_REQUIREMENT, requirements.SHARESAFE_REQUIREMENT,
requirements.REVLOGV2_REQUIREMENT, requirements.REVLOGV2_REQUIREMENT,
requirements.CHANGELOGV2_REQUIREMENT, requirements.CHANGELOGV2_REQUIREMENT,
requirements.REVLOGV1_REQUIREMENT, requirements.REVLOGV1_REQUIREMENT,
requirements.DIRSTATE_TRACKED_KEY_V1, requirements.DIRSTATE_TRACKED_HINT_V1,
requirements.DIRSTATE_V2_REQUIREMENT, requirements.DIRSTATE_V2_REQUIREMENT,
} }
for name in compression.compengines: for name in compression.compengines:
engine = compression.compengines[name] engine = compression.compengines[name]
if engine.available() and engine.revlogheader(): if engine.available() and engine.revlogheader():
supported.add(b'exp-compression-%s' % name) supported.add(b'exp-compression-%s' % name)
if engine.name() == b'zstd': if engine.name() == b'zstd':
supported.add(b'revlog-compression-zstd') supported.add(b'revlog-compression-zstd')
return supported return supported
def supporteddestrequirements(repo): def supporteddestrequirements(repo):
"""Obtain requirements that upgrade supports in the destination. """Obtain requirements that upgrade supports in the destination.
If the result of the upgrade would create requirements not in this set, If the result of the upgrade would create requirements not in this set,
the upgrade is disallowed. the upgrade is disallowed.
Extensions should monkeypatch this to add their custom requirements. Extensions should monkeypatch this to add their custom requirements.
""" """
supported = { supported = {
requirements.CHANGELOGV2_REQUIREMENT, requirements.CHANGELOGV2_REQUIREMENT,
requirements.COPIESSDC_REQUIREMENT, requirements.COPIESSDC_REQUIREMENT,
requirements.DIRSTATE_TRACKED_KEY_V1, requirements.DIRSTATE_TRACKED_HINT_V1,
requirements.DIRSTATE_V2_REQUIREMENT, requirements.DIRSTATE_V2_REQUIREMENT,
requirements.DOTENCODE_REQUIREMENT, requirements.DOTENCODE_REQUIREMENT,
requirements.FNCACHE_REQUIREMENT, requirements.FNCACHE_REQUIREMENT,
requirements.GENERALDELTA_REQUIREMENT, requirements.GENERALDELTA_REQUIREMENT,
requirements.NODEMAP_REQUIREMENT, requirements.NODEMAP_REQUIREMENT,
requirements.REVLOGV1_REQUIREMENT, # allowed in case of downgrade requirements.REVLOGV1_REQUIREMENT, # allowed in case of downgrade
requirements.REVLOGV2_REQUIREMENT, requirements.REVLOGV2_REQUIREMENT,
requirements.SHARED_REQUIREMENT, requirements.SHARED_REQUIREMENT,
requirements.GENERALDELTA_REQUIREMENT, requirements.GENERALDELTA_REQUIREMENT,
requirements.SPARSEREVLOG_REQUIREMENT, requirements.SPARSEREVLOG_REQUIREMENT,
requirements.COPIESSDC_REQUIREMENT, requirements.COPIESSDC_REQUIREMENT,
requirements.NODEMAP_REQUIREMENT, requirements.NODEMAP_REQUIREMENT,
requirements.SHARESAFE_REQUIREMENT, requirements.SHARESAFE_REQUIREMENT,
requirements.REVLOGV1_REQUIREMENT, requirements.REVLOGV1_REQUIREMENT,
requirements.REVLOGV2_REQUIREMENT, requirements.REVLOGV2_REQUIREMENT,
requirements.CHANGELOGV2_REQUIREMENT, requirements.CHANGELOGV2_REQUIREMENT,
requirements.DIRSTATE_TRACKED_KEY_V1, requirements.DIRSTATE_TRACKED_HINT_V1,
requirements.DIRSTATE_V2_REQUIREMENT, requirements.DIRSTATE_V2_REQUIREMENT,
} }
for name in compression.compengines: for name in compression.compengines:
engine = compression.compengines[name] engine = compression.compengines[name]
if engine.available() and engine.revlogheader(): if engine.available() and engine.revlogheader():
supported.add(b'exp-compression-%s' % name) supported.add(b'exp-compression-%s' % name)
if engine.name() == b'zstd': if engine.name() == b'zstd':
supported.add(b'revlog-compression-zstd') supported.add(b'revlog-compression-zstd')

mercurial/upgrade_utils/engine.py

upgrade_op.upgrade_actions.remove(upgrade_actions.dirstatev2) upgrade_op.upgrade_actions.remove(upgrade_actions.dirstatev2)
if upgrade_actions.dirstatev2 in upgrade_op.removed_actions: if upgrade_actions.dirstatev2 in upgrade_op.removed_actions:
ui.status(_(b'downgrading from dirstate-v2 to v1\n')) ui.status(_(b'downgrading from dirstate-v2 to v1\n'))
upgrade_dirstate(ui, srcrepo, upgrade_op, b'v2', b'v1') upgrade_dirstate(ui, srcrepo, upgrade_op, b'v2', b'v1')
upgrade_op.removed_actions.remove(upgrade_actions.dirstatev2) upgrade_op.removed_actions.remove(upgrade_actions.dirstatev2)
if upgrade_actions.dirstatetrackedkey in upgrade_op.upgrade_actions: if upgrade_actions.dirstatetrackedkey in upgrade_op.upgrade_actions:
ui.status(_(b'create dirstate-tracked-key file\n')) ui.status(_(b'create dirstate-tracked-hint file\n'))
upgrade_tracked_key(ui, srcrepo, upgrade_op, add=True) upgrade_tracked_hint(ui, srcrepo, upgrade_op, add=True)
upgrade_op.upgrade_actions.remove(upgrade_actions.dirstatetrackedkey) upgrade_op.upgrade_actions.remove(upgrade_actions.dirstatetrackedkey)
elif upgrade_actions.dirstatetrackedkey in upgrade_op.removed_actions: elif upgrade_actions.dirstatetrackedkey in upgrade_op.removed_actions:
ui.status(_(b'remove dirstate-tracked-key file\n')) ui.status(_(b'remove dirstate-tracked-hint file\n'))
upgrade_tracked_key(ui, srcrepo, upgrade_op, add=False) upgrade_tracked_hint(ui, srcrepo, upgrade_op, add=False)
upgrade_op.removed_actions.remove(upgrade_actions.dirstatetrackedkey) upgrade_op.removed_actions.remove(upgrade_actions.dirstatetrackedkey)
if not (upgrade_op.upgrade_actions or upgrade_op.removed_actions): if not (upgrade_op.upgrade_actions or upgrade_op.removed_actions):
return return
if upgrade_op.requirements_only: if upgrade_op.requirements_only:
ui.status(_(b'upgrading repository requirements\n')) ui.status(_(b'upgrading repository requirements\n'))
scmutil.writereporequirements(srcrepo, upgrade_op.new_requirements) scmutil.writereporequirements(srcrepo, upgrade_op.new_requirements)
if e.errno != errno.ENOENT: if e.errno != errno.ENOENT:
raise raise
srcrepo.dirstate.write(None) srcrepo.dirstate.write(None)
scmutil.writereporequirements(srcrepo, upgrade_op.new_requirements) scmutil.writereporequirements(srcrepo, upgrade_op.new_requirements)
def upgrade_tracked_key(ui, srcrepo, upgrade_op, add): def upgrade_tracked_hint(ui, srcrepo, upgrade_op, add):
if add: if add:
srcrepo.dirstate._use_tracked_key = True srcrepo.dirstate._use_tracked_hint = True
srcrepo.dirstate._dirty = True srcrepo.dirstate._dirty = True
srcrepo.dirstate._dirty_tracked_set = True srcrepo.dirstate._dirty_tracked_set = True
srcrepo.dirstate.write(None) srcrepo.dirstate.write(None)
if not add: if not add:
srcrepo.dirstate.delete_tracked_key() srcrepo.dirstate.delete_tracked_hint()
scmutil.writereporequirements(srcrepo, upgrade_op.new_requirements) scmutil.writereporequirements(srcrepo, upgrade_op.new_requirements)

tests/test-help.t

"usegeneraldelta" "usegeneraldelta"
"dotencode" "dotencode"
"usefncache" "usefncache"
"use-dirstate-v2" "use-dirstate-v2"
"use-dirstate-tracked-key" "use-dirstate-tracked-hint"
"use-persistent-nodemap" "use-persistent-nodemap"
"use-share-safe" "use-share-safe"
"usestore" "usestore"
"sparse-revlog" "sparse-revlog"

tests/test-persistent-nodemap.t

#endif #endif
$ hg debugformat $ hg debugformat
format-variant repo format-variant repo
fncache: yes fncache: yes
dirstate-v2: no dirstate-v2: no
tracked-key: no tracked-hint: no
dotencode: yes dotencode: yes
generaldelta: yes generaldelta: yes
share-safe: yes share-safe: yes
sparserevlog: yes sparserevlog: yes
persistent-nodemap: yes persistent-nodemap: yes
copies-sdc: no copies-sdc: no
revlog-v2: no revlog-v2: no
changelog-v2: no changelog-v2: no
$ cat << EOF >> .hg/hgrc $ cat << EOF >> .hg/hgrc
> [format] > [format]
> use-persistent-nodemap=no > use-persistent-nodemap=no
> EOF > EOF
$ hg debugformat -v $ hg debugformat -v
format-variant repo config default format-variant repo config default
fncache: yes yes yes fncache: yes yes yes
dirstate-v2: no no no dirstate-v2: no no no
tracked-key: no no no tracked-hint: no no no
dotencode: yes yes yes dotencode: yes yes yes
generaldelta: yes yes yes generaldelta: yes yes yes
share-safe: yes yes yes share-safe: yes yes yes
sparserevlog: yes yes yes sparserevlog: yes yes yes
persistent-nodemap: yes no no persistent-nodemap: yes no no
copies-sdc: no no no copies-sdc: no no no
revlog-v2: no no no revlog-v2: no no no
changelog-v2: no no no changelog-v2: no no no
$ cat << EOF >> .hg/hgrc $ cat << EOF >> .hg/hgrc
> [format] > [format]
> use-persistent-nodemap=yes > use-persistent-nodemap=yes
> EOF > EOF
$ hg debugformat -v $ hg debugformat -v
format-variant repo config default format-variant repo config default
fncache: yes yes yes fncache: yes yes yes
dirstate-v2: no no no dirstate-v2: no no no
tracked-key: no no no tracked-hint: no no no
dotencode: yes yes yes dotencode: yes yes yes
generaldelta: yes yes yes generaldelta: yes yes yes
share-safe: yes yes yes share-safe: yes yes yes
sparserevlog: yes yes yes sparserevlog: yes yes yes
persistent-nodemap: no yes no persistent-nodemap: no yes no
copies-sdc: no no no copies-sdc: no no no
revlog-v2: no no no revlog-v2: no no no
changelog-v2: no no no changelog-v2: no no no

tests/test-status-tracked-key.t

============================== ===============================
Test the "tracked key" feature Test the "tracked hint" feature
============================== ===============================
The tracked key feature provide a file that get updated when the set of tracked The tracked hint feature provide a file that get updated when the set of tracked
files get updated. files get updated.
basic setup basic setup
$ cat << EOF >> $HGRCPATH $ cat << EOF >> $HGRCPATH
> [format] > [format]
> use-dirstate-tracked-key=yes > use-dirstate-tracked-hint=yes
> EOF > EOF
$ hg init tracked-key-test $ hg init tracked-hint-test
$ cd tracked-key-test $ cd tracked-hint-test
$ hg debugbuilddag '.+10' -n $ hg debugbuilddag '.+10' -n
$ hg log -G -T '{rev} {desc} {files}\n' $ hg log -G -T '{rev} {desc} {files}\n'
o 10 r10 nf10 o 10 r10 nf10
| |
o 9 r9 nf9 o 9 r9 nf9
| |
o 8 r8 nf8 o 8 r8 nf8
| |
nf6 nf6
nf7 nf7
nf8 nf8
nf9 nf9
key-file exists key-file exists
----------- -----------
The tracked key file should exist The tracked hint file should exist
$ ls -1 .hg/dirstate* $ ls -1 .hg/dirstate*
.hg/dirstate .hg/dirstate
.hg/dirstate-tracked-key .hg/dirstate-tracked-hint
key-file stay the same if the tracked set is unchanged key-file stay the same if the tracked set is unchanged
------------------------------------------------------ ------------------------------------------------------
(copy its content for later comparison) (copy its content for later comparison)
$ cp .hg/dirstate-tracked-key ../key-bck $ cp .hg/dirstate-tracked-hint ../key-bck
$ echo foo >> nf0 $ echo foo >> nf0
$ sleep 1 $ sleep 1
$ hg status $ hg status
M nf0 M nf0
$ diff --brief .hg/dirstate-tracked-key ../key-bck $ diff --brief .hg/dirstate-tracked-hint ../key-bck
$ hg revert -C nf0 $ hg revert -C nf0
$ sleep 1 $ sleep 1
$ hg status $ hg status
$ diff --brief .hg/dirstate-tracked-key ../key-bck $ diff --brief .hg/dirstate-tracked-hint ../key-bck
key-file change if the tracked set is changed manually key-file change if the tracked set is changed manually
------------------------------------------------------ ------------------------------------------------------
adding a file to tracking adding a file to tracking
$ cp .hg/dirstate-tracked-key ../key-bck $ cp .hg/dirstate-tracked-hint ../key-bck
$ echo x > x $ echo x > x
$ hg add x $ hg add x
$ diff --brief .hg/dirstate-tracked-key ../key-bck $ diff --brief .hg/dirstate-tracked-hint ../key-bck
Files .hg/dirstate-tracked-key and ../key-bck differ Files .hg/dirstate-tracked-hint and ../key-bck differ
[1] [1]
remove a file from tracking remove a file from tracking
(forget) (forget)
$ cp .hg/dirstate-tracked-key ../key-bck $ cp .hg/dirstate-tracked-hint ../key-bck
$ hg forget x $ hg forget x
$ diff --brief .hg/dirstate-tracked-key ../key-bck $ diff --brief .hg/dirstate-tracked-hint ../key-bck
Files .hg/dirstate-tracked-key and ../key-bck differ Files .hg/dirstate-tracked-hint and ../key-bck differ
[1] [1]
(remove) (remove)
$ cp .hg/dirstate-tracked-key ../key-bck $ cp .hg/dirstate-tracked-hint ../key-bck
$ hg remove nf1 $ hg remove nf1
$ diff --brief .hg/dirstate-tracked-key ../key-bck $ diff --brief .hg/dirstate-tracked-hint ../key-bck
Files .hg/dirstate-tracked-key and ../key-bck differ Files .hg/dirstate-tracked-hint and ../key-bck differ
[1] [1]
key-file changes on revert (when applicable) key-file changes on revert (when applicable)
-------------------------------------------- --------------------------------------------
$ cp .hg/dirstate-tracked-key ../key-bck $ cp .hg/dirstate-tracked-hint ../key-bck
$ hg status $ hg status
R nf1 R nf1
? x ? x
$ hg revert --all $ hg revert --all
undeleting nf1 undeleting nf1
$ hg status $ hg status
? x ? x
$ diff --brief .hg/dirstate-tracked-key ../key-bck $ diff --brief .hg/dirstate-tracked-hint ../key-bck
Files .hg/dirstate-tracked-key and ../key-bck differ Files .hg/dirstate-tracked-hint and ../key-bck differ
[1] [1]
`hg update` does affect the key-file (when needed) `hg update` does affect the key-file (when needed)
-------------------------------------------------- --------------------------------------------------
update changing the tracked set update changing the tracked set
(removing) (removing)
$ cp .hg/dirstate-tracked-key ../key-bck $ cp .hg/dirstate-tracked-hint ../key-bck
$ hg status --rev . --rev '.#generations[-1]' $ hg status --rev . --rev '.#generations[-1]'
R nf10 R nf10
$ hg up '.#generations[-1]' $ hg up '.#generations[-1]'
0 files updated, 0 files merged, 1 files removed, 0 files unresolved 0 files updated, 0 files merged, 1 files removed, 0 files unresolved
$ diff --brief .hg/dirstate-tracked-key ../key-bck $ diff --brief .hg/dirstate-tracked-hint ../key-bck
Files .hg/dirstate-tracked-key and ../key-bck differ Files .hg/dirstate-tracked-hint and ../key-bck differ
[1] [1]
(adding) (adding)
$ cp .hg/dirstate-tracked-key ../key-bck $ cp .hg/dirstate-tracked-hint ../key-bck
$ hg status --rev . --rev '.#generations[1]' $ hg status --rev . --rev '.#generations[1]'
A nf10 A nf10
$ hg up '.#generations[1]' $ hg up '.#generations[1]'
1 files updated, 0 files merged, 0 files removed, 0 files unresolved 1 files updated, 0 files merged, 0 files removed, 0 files unresolved
$ diff --brief .hg/dirstate-tracked-key ../key-bck $ diff --brief .hg/dirstate-tracked-hint ../key-bck
Files .hg/dirstate-tracked-key and ../key-bck differ Files .hg/dirstate-tracked-hint and ../key-bck differ
[1] [1]
update not affecting the tracked set update not affecting the tracked set
$ echo foo >> nf0 $ echo foo >> nf0
$ hg commit -m foo $ hg commit -m foo
$ cp .hg/dirstate-tracked-key ../key-bck $ cp .hg/dirstate-tracked-hint ../key-bck
$ hg status --rev . --rev '.#generations[-1]' $ hg status --rev . --rev '.#generations[-1]'
M nf0 M nf0
$ hg up '.#generations[-1]' $ hg up '.#generations[-1]'
1 files updated, 0 files merged, 0 files removed, 0 files unresolved 1 files updated, 0 files merged, 0 files removed, 0 files unresolved
$ diff --brief .hg/dirstate-tracked-key ../key-bck $ diff --brief .hg/dirstate-tracked-hint ../key-bck
Test upgrade and downgrade Test upgrade and downgrade
========================== ==========================
$ ls .hg/dirstate-tracked-key $ ls .hg/dirstate-tracked-hint
.hg/dirstate-tracked-key .hg/dirstate-tracked-hint
$ hg debugrequires | grep 'tracked' $ hg debugrequires | grep 'tracked'
dirstate-tracked-key-v1 dirstate-tracked-key-v1
downgrade downgrade
$ hg debugupgraderepo --config format.use-dirstate-tracked-key=no --run --quiet $ hg debugupgraderepo --config format.use-dirstate-tracked-hint=no --run --quiet
upgrade will perform the following actions: upgrade will perform the following actions:
requirements requirements
preserved: * (glob) preserved: * (glob)
removed: dirstate-tracked-key-v1 removed: dirstate-tracked-key-v1
no revlogs to process no revlogs to process
$ ls -1 .hg/dirstate-tracked-key $ ls -1 .hg/dirstate-tracked-hint
ls: cannot access '.hg/dirstate-tracked-key': $ENOENT$ ls: cannot access '.hg/dirstate-tracked-hint': $ENOENT$
[2] [2]
$ hg debugrequires | grep 'tracked' $ hg debugrequires | grep 'tracked'
[1] [1]
upgrade upgrade
$ hg debugupgraderepo --config format.use-dirstate-tracked-key=yes --run --quiet $ hg debugupgraderepo --config format.use-dirstate-tracked-hint=yes --run --quiet
upgrade will perform the following actions: upgrade will perform the following actions:
requirements requirements
preserved: * (glob) preserved: * (glob)
added: dirstate-tracked-key-v1 added: dirstate-tracked-key-v1
no revlogs to process no revlogs to process
$ ls -1 .hg/dirstate-tracked-key $ ls -1 .hg/dirstate-tracked-hint
.hg/dirstate-tracked-key .hg/dirstate-tracked-hint
$ hg debugrequires | grep 'tracked' $ hg debugrequires | grep 'tracked'
dirstate-tracked-key-v1 dirstate-tracked-key-v1

tests/test-upgrade-repo.t

An upgrade of a repository created with recommended settings only suggests optimizations An upgrade of a repository created with recommended settings only suggests optimizations
$ hg init empty $ hg init empty
$ cd empty $ cd empty
$ hg debugformat $ hg debugformat
format-variant repo format-variant repo
fncache: yes fncache: yes
dirstate-v2: no dirstate-v2: no
tracked-key: no tracked-hint: no
dotencode: yes dotencode: yes
generaldelta: yes generaldelta: yes
share-safe: yes share-safe: yes
sparserevlog: yes sparserevlog: yes
persistent-nodemap: no (no-rust !) persistent-nodemap: no (no-rust !)
persistent-nodemap: yes (rust !) persistent-nodemap: yes (rust !)
copies-sdc: no copies-sdc: no
revlog-v2: no revlog-v2: no
changelog-v2: no changelog-v2: no
plain-cl-delta: yes plain-cl-delta: yes
compression: zlib compression: zlib
compression-level: default compression-level: default
$ hg debugformat --verbose $ hg debugformat --verbose
format-variant repo config default format-variant repo config default
fncache: yes yes yes fncache: yes yes yes
dirstate-v2: no no no dirstate-v2: no no no
tracked-key: no no no tracked-hint: no no no
dotencode: yes yes yes dotencode: yes yes yes
generaldelta: yes yes yes generaldelta: yes yes yes
share-safe: yes yes yes share-safe: yes yes yes
sparserevlog: yes yes yes sparserevlog: yes yes yes
persistent-nodemap: no no no (no-rust !) persistent-nodemap: no no no (no-rust !)
persistent-nodemap: yes yes no (rust !) persistent-nodemap: yes yes no (rust !)
copies-sdc: no no no copies-sdc: no no no
revlog-v2: no no no revlog-v2: no no no
changelog-v2: no no no changelog-v2: no no no
plain-cl-delta: yes yes yes plain-cl-delta: yes yes yes
compression: zlib zlib zlib (no-zstd !) compression: zlib zlib zlib (no-zstd !)
compression: zlib zlib zstd (zstd !) compression: zlib zlib zstd (zstd !)
compression-level: default default default compression-level: default default default
$ hg debugformat --verbose --config format.usefncache=no $ hg debugformat --verbose --config format.usefncache=no
format-variant repo config default format-variant repo config default
fncache: yes no yes fncache: yes no yes
dirstate-v2: no no no dirstate-v2: no no no
tracked-key: no no no tracked-hint: no no no
dotencode: yes no yes dotencode: yes no yes
generaldelta: yes yes yes generaldelta: yes yes yes
share-safe: yes yes yes share-safe: yes yes yes
sparserevlog: yes yes yes sparserevlog: yes yes yes
persistent-nodemap: no no no (no-rust !) persistent-nodemap: no no no (no-rust !)
persistent-nodemap: yes yes no (rust !) persistent-nodemap: yes yes no (rust !)
copies-sdc: no no no copies-sdc: no no no
revlog-v2: no no no revlog-v2: no no no
changelog-v2: no no no changelog-v2: no no no
plain-cl-delta: yes yes yes plain-cl-delta: yes yes yes
compression: zlib zlib zlib (no-zstd !) compression: zlib zlib zlib (no-zstd !)
compression: zlib zlib zstd (zstd !) compression: zlib zlib zstd (zstd !)
compression-level: default default default compression-level: default default default
$ hg debugformat --verbose --config format.usefncache=no --color=debug $ hg debugformat --verbose --config format.usefncache=no --color=debug
format-variant repo config default format-variant repo config default
[formatvariant.name.mismatchconfig|fncache: ][formatvariant.repo.mismatchconfig| yes][formatvariant.config.special| no][formatvariant.default| yes] [formatvariant.name.mismatchconfig|fncache: ][formatvariant.repo.mismatchconfig| yes][formatvariant.config.special| no][formatvariant.default| yes]
[formatvariant.name.uptodate|dirstate-v2: ][formatvariant.repo.uptodate| no][formatvariant.config.default| no][formatvariant.default| no] [formatvariant.name.uptodate|dirstate-v2: ][formatvariant.repo.uptodate| no][formatvariant.config.default| no][formatvariant.default| no]
[formatvariant.name.uptodate|tracked-key: ][formatvariant.repo.uptodate| no][formatvariant.config.default| no][formatvariant.default| no] [formatvariant.name.uptodate|tracked-hint: ][formatvariant.repo.uptodate| no][formatvariant.config.default| no][formatvariant.default| no]
[formatvariant.name.mismatchconfig|dotencode: ][formatvariant.repo.mismatchconfig| yes][formatvariant.config.special| no][formatvariant.default| yes] [formatvariant.name.mismatchconfig|dotencode: ][formatvariant.repo.mismatchconfig| yes][formatvariant.config.special| no][formatvariant.default| yes]
[formatvariant.name.uptodate|generaldelta: ][formatvariant.repo.uptodate| yes][formatvariant.config.default| yes][formatvariant.default| yes] [formatvariant.name.uptodate|generaldelta: ][formatvariant.repo.uptodate| yes][formatvariant.config.default| yes][formatvariant.default| yes]
[formatvariant.name.uptodate|share-safe: ][formatvariant.repo.uptodate| yes][formatvariant.config.default| yes][formatvariant.default| yes] [formatvariant.name.uptodate|share-safe: ][formatvariant.repo.uptodate| yes][formatvariant.config.default| yes][formatvariant.default| yes]
[formatvariant.name.uptodate|sparserevlog: ][formatvariant.repo.uptodate| yes][formatvariant.config.default| yes][formatvariant.default| yes] [formatvariant.name.uptodate|sparserevlog: ][formatvariant.repo.uptodate| yes][formatvariant.config.default| yes][formatvariant.default| yes]
[formatvariant.name.uptodate|persistent-nodemap:][formatvariant.repo.uptodate| no][formatvariant.config.default| no][formatvariant.default| no] (no-rust !) [formatvariant.name.uptodate|persistent-nodemap:][formatvariant.repo.uptodate| no][formatvariant.config.default| no][formatvariant.default| no] (no-rust !)
[formatvariant.name.mismatchdefault|persistent-nodemap:][formatvariant.repo.mismatchdefault| yes][formatvariant.config.special| yes][formatvariant.default| no] (rust !) [formatvariant.name.mismatchdefault|persistent-nodemap:][formatvariant.repo.mismatchdefault| yes][formatvariant.config.special| yes][formatvariant.default| no] (rust !)
[formatvariant.name.uptodate|copies-sdc: ][formatvariant.repo.uptodate| no][formatvariant.config.default| no][formatvariant.default| no] [formatvariant.name.uptodate|copies-sdc: ][formatvariant.repo.uptodate| no][formatvariant.config.default| no][formatvariant.default| no]
[formatvariant.name.uptodate|revlog-v2: ][formatvariant.repo.uptodate| no][formatvariant.config.default| no][formatvariant.default| no] [formatvariant.name.uptodate|revlog-v2: ][formatvariant.repo.uptodate| no][formatvariant.config.default| no][formatvariant.default| no]
"config": false, "config": false,
"default": false, "default": false,
"name": "dirstate-v2", "name": "dirstate-v2",
"repo": false "repo": false
}, },
{ {
"config": false, "config": false,
"default": false, "default": false,
"name": "tracked-key", "name": "tracked-hint",
"repo": false "repo": false
}, },
{ {
"config": true, "config": true,
"default": true, "default": true,
"name": "dotencode", "name": "dotencode",
"repo": true "repo": true
}, },
> revlogv1 > revlogv1
> store > store
> EOF > EOF
$ hg debugformat $ hg debugformat
format-variant repo format-variant repo
fncache: no fncache: no
dirstate-v2: no dirstate-v2: no
tracked-key: no tracked-hint: no
dotencode: no dotencode: no
generaldelta: no generaldelta: no
share-safe: no share-safe: no
sparserevlog: no sparserevlog: no
persistent-nodemap: no persistent-nodemap: no
copies-sdc: no copies-sdc: no
revlog-v2: no revlog-v2: no
changelog-v2: no changelog-v2: no
plain-cl-delta: yes plain-cl-delta: yes
compression: zlib compression: zlib
compression-level: default compression-level: default
$ hg debugformat --verbose $ hg debugformat --verbose
format-variant repo config default format-variant repo config default
fncache: no yes yes fncache: no yes yes
dirstate-v2: no no no dirstate-v2: no no no
tracked-key: no no no tracked-hint: no no no
dotencode: no yes yes dotencode: no yes yes
generaldelta: no yes yes generaldelta: no yes yes
share-safe: no yes yes share-safe: no yes yes
sparserevlog: no yes yes sparserevlog: no yes yes
persistent-nodemap: no no no (no-rust !) persistent-nodemap: no no no (no-rust !)
persistent-nodemap: no yes no (rust !) persistent-nodemap: no yes no (rust !)
copies-sdc: no no no copies-sdc: no no no
revlog-v2: no no no revlog-v2: no no no
changelog-v2: no no no changelog-v2: no no no
plain-cl-delta: yes yes yes plain-cl-delta: yes yes yes
compression: zlib zlib zlib (no-zstd !) compression: zlib zlib zlib (no-zstd !)
compression: zlib zlib zstd (zstd !) compression: zlib zlib zstd (zstd !)
compression-level: default default default compression-level: default default default
$ hg debugformat --verbose --config format.usegeneraldelta=no $ hg debugformat --verbose --config format.usegeneraldelta=no
format-variant repo config default format-variant repo config default
fncache: no yes yes fncache: no yes yes
dirstate-v2: no no no dirstate-v2: no no no
tracked-key: no no no tracked-hint: no no no
dotencode: no yes yes dotencode: no yes yes
generaldelta: no no yes generaldelta: no no yes
share-safe: no yes yes share-safe: no yes yes
sparserevlog: no no yes sparserevlog: no no yes
persistent-nodemap: no no no (no-rust !) persistent-nodemap: no no no (no-rust !)
persistent-nodemap: no yes no (rust !) persistent-nodemap: no yes no (rust !)
copies-sdc: no no no copies-sdc: no no no
revlog-v2: no no no revlog-v2: no no no
changelog-v2: no no no changelog-v2: no no no
plain-cl-delta: yes yes yes plain-cl-delta: yes yes yes
compression: zlib zlib zlib (no-zstd !) compression: zlib zlib zlib (no-zstd !)
compression: zlib zlib zstd (zstd !) compression: zlib zlib zstd (zstd !)
compression-level: default default default compression-level: default default default
$ hg debugformat --verbose --config format.usegeneraldelta=no --color=debug $ hg debugformat --verbose --config format.usegeneraldelta=no --color=debug
format-variant repo config default format-variant repo config default
[formatvariant.name.mismatchconfig|fncache: ][formatvariant.repo.mismatchconfig| no][formatvariant.config.default| yes][formatvariant.default| yes] [formatvariant.name.mismatchconfig|fncache: ][formatvariant.repo.mismatchconfig| no][formatvariant.config.default| yes][formatvariant.default| yes]
[formatvariant.name.uptodate|dirstate-v2: ][formatvariant.repo.uptodate| no][formatvariant.config.default| no][formatvariant.default| no] [formatvariant.name.uptodate|dirstate-v2: ][formatvariant.repo.uptodate| no][formatvariant.config.default| no][formatvariant.default| no]
[formatvariant.name.uptodate|tracked-key: ][formatvariant.repo.uptodate| no][formatvariant.config.default| no][formatvariant.default| no] [formatvariant.name.uptodate|tracked-hint: ][formatvariant.repo.uptodate| no][formatvariant.config.default| no][formatvariant.default| no]
[formatvariant.name.mismatchconfig|dotencode: ][formatvariant.repo.mismatchconfig| no][formatvariant.config.default| yes][formatvariant.default| yes] [formatvariant.name.mismatchconfig|dotencode: ][formatvariant.repo.mismatchconfig| no][formatvariant.config.default| yes][formatvariant.default| yes]
[formatvariant.name.mismatchdefault|generaldelta: ][formatvariant.repo.mismatchdefault| no][formatvariant.config.special| no][formatvariant.default| yes] [formatvariant.name.mismatchdefault|generaldelta: ][formatvariant.repo.mismatchdefault| no][formatvariant.config.special| no][formatvariant.default| yes]
[formatvariant.name.mismatchconfig|share-safe: ][formatvariant.repo.mismatchconfig| no][formatvariant.config.default| yes][formatvariant.default| yes] [formatvariant.name.mismatchconfig|share-safe: ][formatvariant.repo.mismatchconfig| no][formatvariant.config.default| yes][formatvariant.default| yes]
[formatvariant.name.mismatchdefault|sparserevlog: ][formatvariant.repo.mismatchdefault| no][formatvariant.config.special| no][formatvariant.default| yes] [formatvariant.name.mismatchdefault|sparserevlog: ][formatvariant.repo.mismatchdefault| no][formatvariant.config.special| no][formatvariant.default| yes]
[formatvariant.name.uptodate|persistent-nodemap:][formatvariant.repo.uptodate| no][formatvariant.config.default| no][formatvariant.default| no] (no-rust !) [formatvariant.name.uptodate|persistent-nodemap:][formatvariant.repo.uptodate| no][formatvariant.config.default| no][formatvariant.default| no] (no-rust !)
[formatvariant.name.mismatchconfig|persistent-nodemap:][formatvariant.repo.mismatchconfig| no][formatvariant.config.special| yes][formatvariant.default| no] (rust !) [formatvariant.name.mismatchconfig|persistent-nodemap:][formatvariant.repo.mismatchconfig| no][formatvariant.config.special| yes][formatvariant.default| no] (rust !)
[formatvariant.name.uptodate|copies-sdc: ][formatvariant.repo.uptodate| no][formatvariant.config.default| no][formatvariant.default| no] [formatvariant.name.uptodate|copies-sdc: ][formatvariant.repo.uptodate| no][formatvariant.config.default| no][formatvariant.default| no]
[formatvariant.name.uptodate|revlog-v2: ][formatvariant.repo.uptodate| no][formatvariant.config.default| no][formatvariant.default| no] [formatvariant.name.uptodate|revlog-v2: ][formatvariant.repo.uptodate| no][formatvariant.config.default| no][formatvariant.default| no]
- all-filelogs - all-filelogs
- changelog - changelog
- manifest - manifest
$ hg debugformat -v $ hg debugformat -v
format-variant repo config default format-variant repo config default
fncache: yes yes yes fncache: yes yes yes
dirstate-v2: no no no dirstate-v2: no no no
tracked-key: no no no tracked-hint: no no no
dotencode: yes yes yes dotencode: yes yes yes
generaldelta: yes yes yes generaldelta: yes yes yes
share-safe: yes yes yes share-safe: yes yes yes
sparserevlog: yes yes yes sparserevlog: yes yes yes
persistent-nodemap: no no no (no-rust !) persistent-nodemap: no no no (no-rust !)
persistent-nodemap: yes yes no (rust !) persistent-nodemap: yes yes no (rust !)
copies-sdc: no no no copies-sdc: no no no
revlog-v2: no no no revlog-v2: no no no
- all-filelogs - all-filelogs
- changelog - changelog
- manifest - manifest
$ hg debugformat -v $ hg debugformat -v
format-variant repo config default format-variant repo config default
fncache: yes yes yes fncache: yes yes yes
dirstate-v2: no no no dirstate-v2: no no no
tracked-key: no no no tracked-hint: no no no
dotencode: yes yes yes dotencode: yes yes yes
generaldelta: yes yes yes generaldelta: yes yes yes
share-safe: yes yes yes share-safe: yes yes yes
sparserevlog: yes yes yes sparserevlog: yes yes yes
persistent-nodemap: no no no (no-rust !) persistent-nodemap: no no no (no-rust !)
persistent-nodemap: yes yes no (rust !) persistent-nodemap: yes yes no (rust !)
copies-sdc: no no no copies-sdc: no no no
revlog-v2: no no no revlog-v2: no no no
- all-filelogs - all-filelogs
- changelog - changelog
- manifest - manifest
$ hg debugformat -v $ hg debugformat -v
format-variant repo config default format-variant repo config default
fncache: yes yes yes fncache: yes yes yes
dirstate-v2: no no no dirstate-v2: no no no
tracked-key: no no no tracked-hint: no no no
dotencode: yes yes yes dotencode: yes yes yes
generaldelta: yes yes yes generaldelta: yes yes yes
share-safe: yes yes yes share-safe: yes yes yes
sparserevlog: yes yes yes sparserevlog: yes yes yes
persistent-nodemap: no no no (no-rust !) persistent-nodemap: no no no (no-rust !)
persistent-nodemap: yes yes no (rust !) persistent-nodemap: yes yes no (rust !)
copies-sdc: no no no copies-sdc: no no no
revlog-v2: no no no revlog-v2: no no no
- all-filelogs - all-filelogs
- changelog - changelog
- manifest - manifest
$ hg debugformat -v $ hg debugformat -v
format-variant repo config default format-variant repo config default
fncache: yes yes yes fncache: yes yes yes
dirstate-v2: no no no dirstate-v2: no no no
tracked-key: no no no tracked-hint: no no no
dotencode: yes yes yes dotencode: yes yes yes
generaldelta: yes yes yes generaldelta: yes yes yes
share-safe: yes yes yes share-safe: yes yes yes
sparserevlog: yes yes yes sparserevlog: yes yes yes
persistent-nodemap: no no no (no-rust !) persistent-nodemap: no no no (no-rust !)
persistent-nodemap: yes yes no (rust !) persistent-nodemap: yes yes no (rust !)
copies-sdc: no no no copies-sdc: no no no
revlog-v2: yes no no revlog-v2: yes no no
- all-filelogs - all-filelogs
- changelog - changelog
- manifest - manifest
$ hg debugformat -v $ hg debugformat -v
format-variant repo config default format-variant repo config default
fncache: yes yes yes fncache: yes yes yes
dirstate-v2: no no no dirstate-v2: no no no
tracked-key: no no no tracked-hint: no no no
dotencode: yes yes yes dotencode: yes yes yes
generaldelta: yes yes yes generaldelta: yes yes yes
share-safe: yes yes yes share-safe: yes yes yes
sparserevlog: yes yes yes sparserevlog: yes yes yes
persistent-nodemap: no no no (no-rust !) persistent-nodemap: no no no (no-rust !)
persistent-nodemap: yes yes no (rust !) persistent-nodemap: yes yes no (rust !)
copies-sdc: no no no copies-sdc: no no no
revlog-v2: no no no revlog-v2: no no no
- all-filelogs - all-filelogs
- changelog - changelog
- manifest - manifest
$ hg debugformat -v $ hg debugformat -v
format-variant repo config default format-variant repo config default
fncache: yes yes yes fncache: yes yes yes
dirstate-v2: no no no dirstate-v2: no no no
tracked-key: no no no tracked-hint: no no no
dotencode: yes yes yes dotencode: yes yes yes
generaldelta: yes yes yes generaldelta: yes yes yes
share-safe: yes yes yes share-safe: yes yes yes
sparserevlog: yes yes yes sparserevlog: yes yes yes
persistent-nodemap: no no no (no-rust !) persistent-nodemap: no no no (no-rust !)
persistent-nodemap: yes yes no (rust !) persistent-nodemap: yes yes no (rust !)
copies-sdc: no no no copies-sdc: no no no
revlog-v2: yes yes no revlog-v2: yes yes no