This is an archive of the discontinued Mercurial Phabricator instance.

Differential D6900

upgrade: document DELTAREUSEFULLADD in revlog.clone
ClosedPublic

Authored by marmoute on Sep 27 2019, 4:22 PM.

Details

Reviewers
indygreg
Group Reviewers
hg-reviewers
Commits
rHG6510c7830838: upgrade: document DELTAREUSEFULLADD in revlog.clone
Summary

The documentation of the debugupgraderepo command was updated when
re-delta-fulladd was introduced. However, the docstring of the revlog.clone
method was not.

Diff Detail

Repository
rHG Mercurial
Lint
Automatic diff as part of commit; lint not applicable.
Unit
Automatic diff as part of commit; unit tests not applicable.

Event Timeline

marmoute created this revision.Sep 27 2019, 4:22 PM
indygreg accepted this revision.Sep 28 2019, 4:17 PM
This revision is now accepted and ready to land.Sep 28 2019, 4:17 PM
marmoute added a commit: rHG6510c7830838: upgrade: document DELTAREUSEFULLADD in revlog.clone.Sep 28 2019, 4:28 PM
Closed by commit rHG6510c7830838: upgrade: document DELTAREUSEFULLADD in revlog.clone (authored by marmoute). · Explain Why
This revision was automatically updated to reflect the committed changes.

Revision Contents
Changeset List

Diff 16669

mercurial/revlog.py

DELTAREUSESAMEREVS DELTAREUSESAMEREVS
Deltas will be reused if the destination revlog would pick the same Deltas will be reused if the destination revlog would pick the same
revisions for the delta. This mode strikes a balance between speed revisions for the delta. This mode strikes a balance between speed
and optimization. and optimization.
DELTAREUSENEVER DELTAREUSENEVER
Deltas will never be reused. This is the slowest mode of execution. Deltas will never be reused. This is the slowest mode of execution.
This mode can be used to recompute deltas (e.g. if the diff/delta This mode can be used to recompute deltas (e.g. if the diff/delta
algorithm changes). algorithm changes).
DELTAREUSEFULLADD
Revision will be re-added as if their were new content. This is
slower than DELTAREUSEALWAYS but allow more mechanism to kicks in.
eg: large file detection and handling.
Delta computation can be slow, so the choice of delta reuse policy can Delta computation can be slow, so the choice of delta reuse policy can
significantly affect run time. significantly affect run time.
The default policy (``DELTAREUSESAMEREVS``) strikes a balance between The default policy (``DELTAREUSESAMEREVS``) strikes a balance between
two extremes. Deltas will be reused if they are appropriate. But if the two extremes. Deltas will be reused if they are appropriate. But if the
delta could choose a better revision, it will do so. This means if you delta could choose a better revision, it will do so. This means if you
are converting a non-generaldelta revlog to a generaldelta revlog, are converting a non-generaldelta revlog to a generaldelta revlog,