| hg-reviewers |
| Automatic diff as part of commit; lint not applicable. |
| Automatic diff as part of commit; unit tests not applicable. |
| Path | Packages | |||
|---|---|---|---|---|
| M | mercurial/helptext/internals/dirstate-v2.txt (10 lines) |
| When `share-safe` is enabled, different repositories sharing the same store | When `share-safe` is enabled, different repositories sharing the same store | ||||
| can use different dirstate formats. | can use different dirstate formats. | ||||
| Enabling `dirsate-v2` for new local repositories | Enabling `dirsate-v2` for new local repositories | ||||
| ------------------------------------------------ | ------------------------------------------------ | ||||
| When creating a new local repository such as with `hg init` or `hg clone`, | When creating a new local repository such as with `hg init` or `hg clone`, | ||||
| the `exp-dirstate-v2` boolean in the `format` configuration section | the `exp-rc-dirstate-v2` boolean in the `format` configuration section | ||||
| controls whether to use this file format. | controls whether to use this file format. | ||||
| This is disabled by default as of this writing. | This is disabled by default as of this writing. | ||||
| To enable it for a single repository, run for example:: | To enable it for a single repository, run for example:: | ||||
| $ hg init my-project --config format.exp-dirstate-v2=1 | $ hg init my-project --config format.exp-rc-dirstate-v2=1 | ||||
| Checking the format of an existing local repsitory | Checking the format of an existing local repsitory | ||||
| -------------------------------------------------- | -------------------------------------------------- | ||||
| The `debugformat` commands prints information about | The `debugformat` commands prints information about | ||||
| which of multiple optional formats are used in the current repository, | which of multiple optional formats are used in the current repository, | ||||
| including `dirstate-v2`:: | including `dirstate-v2`:: | ||||
| $ hg debugformat | $ hg debugformat | ||||
| format-variant repo | format-variant repo | ||||
| fncache: yes | fncache: yes | ||||
| dirstate-v2: yes | dirstate-v2: yes | ||||
| […] | […] | ||||
| Upgrading or downgrading an existing local repository | Upgrading or downgrading an existing local repository | ||||
| ----------------------------------------------------- | ----------------------------------------------------- | ||||
| The `debugupgrade` command does various upgrades or downgrades | The `debugupgrade` command does various upgrades or downgrades | ||||
| on a local repository | on a local repository | ||||
| based on the current Mercurial version and on configuration. | based on the current Mercurial version and on configuration. | ||||
| The same `format.exp-dirstate-v2` configuration is used again. | The same `format.exp-rc-dirstate-v2` configuration is used again. | ||||
| Example to upgrade:: | Example to upgrade:: | ||||
| $ hg debugupgrade --config format.exp-dirstate-v2=1 | $ hg debugupgrade --config format.exp-rc-dirstate-v2=1 | ||||
| Example to downgrade to `dirstate-v1`:: | Example to downgrade to `dirstate-v1`:: | ||||
| $ hg debugupgrade --config format.exp-dirstate-v2=0 | $ hg debugupgrade --config format.exp-rc-dirstate-v2=0 | ||||
| Both of this commands do nothing but print a list of proposed changes, | Both of this commands do nothing but print a list of proposed changes, | ||||
| which may include changes unrelated to the dirstate. | which may include changes unrelated to the dirstate. | ||||
| Those other changes are controlled by their own configuration keys. | Those other changes are controlled by their own configuration keys. | ||||
| Add `--run` to a command to actually apply the proposed changes. | Add `--run` to a command to actually apply the proposed changes. | ||||
| Backups of `.hg/requires` and `.hg/dirstate` are created | Backups of `.hg/requires` and `.hg/dirstate` are created | ||||
| in a `.hg/upgradebackup.*` directory. | in a `.hg/upgradebackup.*` directory. | ||||