#require no-reposimplestore

  $ cat >> $HGRCPATH << EOF

  > [extensions]

  > share =

  > [format]

  > # stabilize test accross variant

  > revlog-compression=zlib

  > [storage]

  > dirstate-v2.slow-path=allow

  > EOF

store and revlogv1 are required in source

  $ hg --config format.usestore=false init no-store

  $ hg -R no-store debugupgraderepo

  abort: cannot upgrade repository; requirement missing: store

  [255]

  $ hg init no-revlogv1

  $ cat > no-revlogv1/.hg/requires << EOF

  > dotencode

  > fncache

  > generaldelta

  > store

  > EOF

  $ hg -R no-revlogv1 debugupgraderepo

  abort: cannot upgrade repository; missing a revlog version

  [255]

Cannot upgrade shared repositories

  $ hg init share-parent

  $ hg -R share-parent debugbuilddag -n .+9

  $ hg -R share-parent up tip

  10 files updated, 0 files merged, 0 files removed, 0 files unresolved

  $ hg -q share share-parent share-child

  $ hg -R share-child debugupgraderepo --config format.sparse-revlog=no

  abort: cannot use these actions on a share repository: sparserevlog

  (upgrade the main repository directly)

  [255]

Unless the action is compatible with share

  $ hg -R share-child debugupgraderepo --config format.use-dirstate-v2=yes --quiet

  requirements

     preserved: * (glob)

     added: dirstate-v2

  no revlogs to process

  $ hg -R share-child debugupgraderepo --config format.use-dirstate-v2=yes --quiet --run

  upgrade will perform the following actions:

  requirements

     preserved: * (glob)

     added: dirstate-v2

  no revlogs to process

  $ hg debugformat -R share-child dirstate-v2

  format-variant     repo

  dirstate-v2:        yes

  $ hg debugformat -R share-parent dirstate-v2

  format-variant     repo

  dirstate-v2:         no

  $ hg status --all -R share-child

  C nf0

  C nf1

  C nf2

  C nf3

  C nf4

  C nf5

  C nf6

  C nf7

  C nf8

  C nf9

  $ hg log -l 3 -R share-child

  changeset:   9:0059eb38e4a4

  tag:         tip

  user:        debugbuilddag

  date:        Thu Jan 01 00:00:09 1970 +0000

  summary:     r9

  changeset:   8:4d5be70c8130

  user:        debugbuilddag

  date:        Thu Jan 01 00:00:08 1970 +0000

  summary:     r8

  changeset:   7:e60bfe72517e

  user:        debugbuilddag

  date:        Thu Jan 01 00:00:07 1970 +0000

  summary:     r7

  $ hg status --all -R share-parent

  C nf0

  C nf1

  C nf2

  C nf3

  C nf4

  C nf5

  C nf6

  C nf7

  C nf8

  C nf9

  $ hg log -l 3 -R share-parent

  changeset:   9:0059eb38e4a4

  tag:         tip

  user:        debugbuilddag

  date:        Thu Jan 01 00:00:09 1970 +0000

  summary:     r9

  changeset:   8:4d5be70c8130

  user:        debugbuilddag

  date:        Thu Jan 01 00:00:08 1970 +0000

  summary:     r8

  changeset:   7:e60bfe72517e

  user:        debugbuilddag

  date:        Thu Jan 01 00:00:07 1970 +0000

  summary:     r7

  $ hg -R share-child debugupgraderepo --config format.use-dirstate-v2=no --quiet --run

  upgrade will perform the following actions:

  requirements

     preserved: * (glob)

     removed: dirstate-v2

  no revlogs to process

  $ hg debugformat -R share-child dirstate-v2

  format-variant     repo

  dirstate-v2:         no

  $ hg debugformat -R share-parent dirstate-v2

  format-variant     repo

  dirstate-v2:         no

  $ hg status --all -R share-child

  C nf0

  C nf1

  C nf2

  C nf3

  C nf4

  C nf5

  C nf6

  C nf7

  C nf8

  C nf9

  $ hg log -l 3 -R share-child

  changeset:   9:0059eb38e4a4

  tag:         tip

  user:        debugbuilddag

  date:        Thu Jan 01 00:00:09 1970 +0000

  summary:     r9

  changeset:   8:4d5be70c8130

  user:        debugbuilddag

  date:        Thu Jan 01 00:00:08 1970 +0000

  summary:     r8

  changeset:   7:e60bfe72517e

  user:        debugbuilddag

  date:        Thu Jan 01 00:00:07 1970 +0000

  summary:     r7

  $ hg status --all -R share-parent

  C nf0

  C nf1

  C nf2

  C nf3

  C nf4

  C nf5

  C nf6

  C nf7

  C nf8

  C nf9

  $ hg log -l 3 -R share-parent

  changeset:   9:0059eb38e4a4

  tag:         tip

  user:        debugbuilddag

  date:        Thu Jan 01 00:00:09 1970 +0000

  summary:     r9

  changeset:   8:4d5be70c8130

  user:        debugbuilddag

  date:        Thu Jan 01 00:00:08 1970 +0000

  summary:     r8

  changeset:   7:e60bfe72517e

  user:        debugbuilddag

  date:        Thu Jan 01 00:00:07 1970 +0000

  summary:     r7

Do not yet support downgrading treemanifest repos

  $ hg --config experimental.treemanifest=true init treemanifest

  $ hg -R treemanifest debugupgraderepo

  abort: cannot upgrade repository; requirement would be removed: treemanifest

  [255]

Cannot add treemanifest requirement during upgrade

  $ hg init disallowaddedreq

  $ hg -R disallowaddedreq --config experimental.treemanifest=true debugupgraderepo

  abort: cannot upgrade repository; do not support adding requirement: treemanifest

  [255]

An upgrade of a repository created with recommended settings only suggests optimizations

  $ hg init empty

  $ cd empty

  $ hg debugformat

  format-variant     repo

  fncache:            yes

  dirstate-v2:         no

  tracked-hint:        no

  dotencode:          yes

  generaldelta:       yes

  share-safe:         yes

  sparserevlog:       yes

  persistent-nodemap:  no (no-rust !)

  persistent-nodemap: yes (rust !)

  copies-sdc:          no

  revlog-v2:           no

  changelog-v2:        no

  plain-cl-delta:     yes

  compression:        zlib

  compression-level:  default

  $ hg debugformat --verbose

  format-variant     repo config default

  fncache:            yes    yes     yes

  dirstate-v2:         no     no      no

  tracked-hint:        no     no      no

  dotencode:          yes    yes     yes

  generaldelta:       yes    yes     yes

  share-safe:         yes    yes     yes

  sparserevlog:       yes    yes     yes

  persistent-nodemap:  no     no      no (no-rust !)

  persistent-nodemap: yes    yes      no (rust !)

  copies-sdc:          no     no      no

  revlog-v2:           no     no      no

  changelog-v2:        no     no      no

  plain-cl-delta:     yes    yes     yes

  compression:        zlib   zlib    zlib (no-zstd !)

  compression:        zlib   zlib    zstd (zstd !)

  compression-level:  default default default

  $ hg debugformat --verbose --config format.usefncache=no

  format-variant     repo config default

  fncache:            yes     no     yes

  dirstate-v2:         no     no      no

  tracked-hint:        no     no      no

  dotencode:          yes     no     yes

  generaldelta:       yes    yes     yes

  share-safe:         yes    yes     yes

  sparserevlog:       yes    yes     yes

  persistent-nodemap:  no     no      no (no-rust !)

  persistent-nodemap: yes    yes      no (rust !)

  copies-sdc:          no     no      no

  revlog-v2:           no     no      no

  changelog-v2:        no     no      no

  plain-cl-delta:     yes    yes     yes

  compression:        zlib   zlib    zlib (no-zstd !)

  compression:        zlib   zlib    zstd (zstd !)

  compression-level:  default default default

  $ hg debugformat --verbose --config format.usefncache=no --color=debug

  format-variant     repo config default

  [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|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.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|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.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|revlog-v2:         ][formatvariant.repo.uptodate|  no][formatvariant.config.default|     no][formatvariant.default|      no]

  [formatvariant.name.uptodate|changelog-v2:      ][formatvariant.repo.uptodate|  no][formatvariant.config.default|     no][formatvariant.default|      no]

  [formatvariant.name.uptodate|plain-cl-delta:    ][formatvariant.repo.uptodate| yes][formatvariant.config.default|    yes][formatvariant.default|     yes]

  [formatvariant.name.uptodate|compression:       ][formatvariant.repo.uptodate| zlib][formatvariant.config.default|   zlib][formatvariant.default|    zlib] (no-zstd !)

  [formatvariant.name.mismatchdefault|compression:       ][formatvariant.repo.mismatchdefault| zlib][formatvariant.config.special|   zlib][formatvariant.default|    zstd] (zstd !)

  [formatvariant.name.uptodate|compression-level: ][formatvariant.repo.uptodate| default][formatvariant.config.default| default][formatvariant.default| default]

  $ hg debugformat -Tjson

  [

   {

    "config": true,

    "default": true,

    "name": "fncache",

    "repo": true

   },

   {

    "config": false,

    "default": false,

    "name": "dirstate-v2",

    "repo": false

   },

   {

    "config": false,

    "default": false,

    "name": "tracked-hint",

    "repo": false

   },

   {

    "config": true,

    "default": true,

    "name": "dotencode",

    "repo": true

   },

   {

    "config": true,

    "default": true,

    "name": "generaldelta",

    "repo": true

   },

   {

    "config": true,

    "default": true,

    "name": "share-safe",

    "repo": true

   },

   {

    "config": true,

    "default": true,

    "name": "sparserevlog",

    "repo": true

   },

   {

    "config": false, (no-rust !)

    "config": true, (rust !)

    "default": false,

    "name": "persistent-nodemap",

    "repo": false (no-rust !)

    "repo": true (rust !)

   },

   {

    "config": false,

    "default": false,

    "name": "copies-sdc",

    "repo": false

   },

   {

    "config": false,

    "default": false,

    "name": "revlog-v2",

    "repo": false

   },

   {

    "config": false,

    "default": false,

    "name": "changelog-v2",

    "repo": false

   },

   {

    "config": true,

    "default": true,

    "name": "plain-cl-delta",

    "repo": true

   },

   {

    "config": "zlib",

    "default": "zlib", (no-zstd !)

    "default": "zstd", (zstd !)

    "name": "compression",

    "repo": "zlib"

   },

   {

    "config": "default",

    "default": "default",

    "name": "compression-level",

    "repo": "default"

   }

  ]

  $ hg debugupgraderepo

  (no format upgrades found in existing repository)

  performing an upgrade with "--run" will make the following changes:

  requirements

     preserved: dotencode, fncache, generaldelta, revlogv1, share-safe, sparserevlog, store (no-rust !)

     preserved: dotencode, fncache, generaldelta, persistent-nodemap, revlogv1, share-safe, sparserevlog, store (rust !)

  no revlogs to process

  additional optimizations are available by specifying "--optimize <name>":

  re-delta-parent

     deltas within internal storage will be recalculated to choose an optimal base revision where this was not already done; the size of the repository may shrink and various operations may become faster; the first time this optimization is performed could slow down upgrade execution considerably; subsequent invocations should not run noticeably slower

  re-delta-multibase

     deltas within internal storage will be recalculated against multiple base revision and the smallest difference will be used; the size of the repository may shrink significantly when there are many merges; this optimization will slow down execution in proportion to the number of merges in the repository and the amount of files in the repository; this slow down should not be significant unless there are tens of thousands of files and thousands of merges

  re-delta-all

     deltas within internal storage will always be recalculated without reusing prior deltas; this will likely make execution run several times slower; this optimization is typically not needed

  re-delta-fulladd

     every revision will be re-added as if it was new content. It will go through the full storage mechanism giving extensions a chance to process it (eg. lfs). This is similar to "re-delta-all" but even slower since more logic is involved.

  $ hg debugupgraderepo --quiet

  requirements

     preserved: dotencode, fncache, generaldelta, revlogv1, share-safe, sparserevlog, store (no-rust !)

     preserved: dotencode, fncache, generaldelta, persistent-nodemap, revlogv1, share-safe, sparserevlog, store (rust !)

  no revlogs to process

--optimize can be used to add optimizations

  $ hg debugupgrade --optimize 're-delta-parent'

  (no format upgrades found in existing repository)

  performing an upgrade with "--run" will make the following changes:

  requirements

     preserved: dotencode, fncache, generaldelta, revlogv1, share-safe, sparserevlog, store (no-rust !)

     preserved: dotencode, fncache, generaldelta, persistent-nodemap, revlogv1, share-safe, sparserevlog, store (rust !)

  optimisations: re-delta-parent

  re-delta-parent

     deltas within internal storage will choose a new base revision if needed

  processed revlogs:

    - all-filelogs

    - changelog

    - manifest

  additional optimizations are available by specifying "--optimize <name>":

  re-delta-multibase

     deltas within internal storage will be recalculated against multiple base revision and the smallest difference will be used; the size of the repository may shrink significantly when there are many merges; this optimization will slow down execution in proportion to the number of merges in the repository and the amount of files in the repository; this slow down should not be significant unless there are tens of thousands of files and thousands of merges

  re-delta-all

     deltas within internal storage will always be recalculated without reusing prior deltas; this will likely make execution run several times slower; this optimization is typically not needed

  re-delta-fulladd

     every revision will be re-added as if it was new content. It will go through the full storage mechanism giving extensions a chance to process it (eg. lfs). This is similar to "re-delta-all" but even slower since more logic is involved.

modern form of the option

  $ hg debugupgrade --optimize re-delta-parent

  (no format upgrades found in existing repository)

  performing an upgrade with "--run" will make the following changes:

  requirements

     preserved: dotencode, fncache, generaldelta, revlogv1, share-safe, sparserevlog, store (no-rust !)

     preserved: dotencode, fncache, generaldelta, persistent-nodemap, revlogv1, share-safe, sparserevlog, store (rust !)

  optimisations: re-delta-parent

  re-delta-parent

     deltas within internal storage will choose a new base revision if needed

  processed revlogs:

    - all-filelogs

    - changelog

    - manifest

  additional optimizations are available by specifying "--optimize <name>":

  re-delta-multibase

     deltas within internal storage will be recalculated against multiple base revision and the smallest difference will be used; the size of the repository may shrink significantly when there are many merges; this optimization will slow down execution in proportion to the number of merges in the repository and the amount of files in the repository; this slow down should not be significant unless there are tens of thousands of files and thousands of merges

  re-delta-all

     deltas within internal storage will always be recalculated without reusing prior deltas; this will likely make execution run several times slower; this optimization is typically not needed

  re-delta-fulladd

     every revision will be re-added as if it was new content. It will go through the full storage mechanism giving extensions a chance to process it (eg. lfs). This is similar to "re-delta-all" but even slower since more logic is involved.

  $ hg debugupgrade --optimize re-delta-parent --quiet

  requirements

     preserved: dotencode, fncache, generaldelta, revlogv1, share-safe, sparserevlog, store (no-rust !)

     preserved: dotencode, fncache, generaldelta, persistent-nodemap, revlogv1, share-safe, sparserevlog, store (rust !)

  optimisations: re-delta-parent

  processed revlogs:

    - all-filelogs

    - changelog