=============================

Mutable History For Mercurial

=============================

This package supplies the ``evolve`` extension for Mercurial, which

provides several commands to mutate history and deal with the

resulting issues.

It also:

    - enables the "changeset obsolescence" feature of Mercurial

    - issues several warning messages when trouble appears in your repository

**This extension is experimental and not yet meant for production.**

You can enable it by adding the line below to the ``extensions``

section of your hgrc::

    evolve = PATH/TO/evolve-main/hgext3rd/evolve/

We recommend reading the documentation first. An online version is

available here:

    https://www.mercurial-scm.org/doc/evolution/

Or see the ``doc/`` directory for a local copy.

topic

=====

Topics are an experiment to see if maybe the workflow defined by git

branches and hg bookmarks is only partially what users want - perhaps

something that feels more like a traditional VCS branch is right, but

that it should "dissolve" upon being finished. This extension exists

to be a sandbox for that experimentation.

# install

Enable topics like any mercurial extension: download the source code to a

local directory, and add that directory to your `.hgrc`:

    [extensions]

    topics=PATH/TO/evolve-main/hgext3rd/topic/

# help

See 'hg help -e topic' for a generic help.

See 'hg help topics' and 'hg help stack' for help on specific commands.

See the 'tests/test-topic-tutorial.t' file for a quick tutorial.

Contribute

==========

Bugs are to be reported on the mercurial's bug tracker (component: evolution):

https://bz.mercurial-scm.org/buglist.cgi?component=evolution&query_format=advanced&resolution=---

Please use the patchbomb extension to send email to mercurial devel. Please

make sure to use the evolve-ext flag when doing so. You can use a command like

this:

    hg email --to mercurial-devel@mercurial-scm.org --flag evolve-ext --rev '<your patches>'

See also

https://mercurial-scm.org/wiki/ContributingChanges#Patch_descriptions

for guidelines on the patch description.

Please don't forget to update and run the tests when you fix a bug or

add a feature. To run the tests, you need a working copy of Mercurial,

say in $HGSRC:

    cd tests

    python $HGSRC/tests/run-tests.py

(evolve's stable and default branches correspond to Mercurial's stable

and default branches. So to test evolve from default, you need

Mercurial on default.)

Changelog

=========

6.0.0 --

  - drop compatibility for Mercurial < 3.8,

  - removed old (unpackaged) pushexperiment extension,

  - move all extensions in the official 'hgext3rd' namespace package,

  - add the "topic" experimental extensions.

  - officially ship 'evolve.serveronly' extensions. That extensions contains

    only the part related to exchange and is intended to be used by server.

    Using the extension will enable evolution, use 'experimental.evolution=!'

    to disable obsmarkers echange.  The old '__temporary__.advertiseobsolete'

    option is no longer supported.

5.6.1 -- 2017-02-28

 - fix a crash that sometime happened when evolving merges.

5.6.0 -- 2017-02-01

 - compatibility with Mercurial 4.1.

 - improvement of prune error message.

 - fold: require --from flag for folding revisions to working copy

 - fix crash when trying to fold an empty revision set (issue5453)

 - uncommit: preserve copy information of remaining files (issue5403)

5.5.0 -- 2016-10-30

 - The {obsolete} template now yield "obsolete" or "".

 - compatibility with Mercurial 4.0

 - Fix erroneous manifest computation when solving 'bumped' changeset.

 - split: avoid crash on empty commit (issue5191),

 - next: improve locking to avoid issue with working copy parent (issue5244)

 - prev: improve locking to avoid issue with working copy parent (issue5244)

 - evolve: fix abort suggestion to include '.' in 'hg update -C .'

5.4.1 -- 2016-08-01

 - compat with Mercurial 3.9

5.4.0 -- 2016-05-06

- Some collaboration with the topic experimental extensions,

  - hg evolve --all with consider all troubles in your current topic,

  - preserve 'topic' during evolve,

  - 'next' and 'prev' restrict themself to the current topic by default,

- remove the dangerous 'kill' alias for 'prune' (because 'hg kill -1' without

  the leading 'hg' will give you an hardtime)

- during 'hg evolve' skip unsupported merge instead of aborting

- various documentation fix and update

- hg summary now suggest 'hg evolve --continue when appropriate`

- compatibility with Mercurial 3.8 'hgext' namespace package.

- small improvement to the `hg split` instruction

- add a 'metaedit' command to rewrite changeset meta data.

5.3.0 -- 2016-02-11

- split: add a new command to split changesets,

- tests: drop our copy of 'run-tests.py' use core one instead,

- bookmark: do all bookmark movement within a transaction.

- evolve: compatibility with Mercurial 3.7

- evolve: support merge with a single obsolete parent (hg-3.7+ only)

- evolve: prevent added file to be marked as unknown if evolve fails (issue4966)

- evolve: stop relying on graftstate file for save evolve state

          (for `hg evolve --continue`)

- evolve: fix divergence resolution when it result in an empty commit

          (issue4950) (hg-3.5+ only)

- no longer lock the repository for `hg parents` (issue4895)

- updated help for the `evolve` command

5.2.1 -- 2015-11-02

- add compatibility with Mercurial 3.6

- prune: fixed possible issue with lock and bookmark

- next/prev: fixed possible issue with lock and bookmark

- add some progress data during changesets discovery

- take advantage of dirstate/transaction collaboration

5.2.0 -- 2015-06-25

- evolve: gain a --rev option to control what revisions to evolve (issue4391)

- evolve: revision are processed in the order they stack on destination

- evolve: properly skip unstable revision with non-evolved unstable parent

- evolve: gain --unstable --divergent --bumped flag to select the trouble

- evolve: issue more useful error message and hint when evolve has nothing to

          do as invocated.

- evolve: bare `hg evolve` commands now abort when multiple changesets could be

          a target.

- evolve: `hg evolve --all` only evolve changeset that will end up as

          descendant of the current working copy. The old behavior of `--all`

          in now in `--all --any`.

- evolve: add a 'experimental.evolutioncommands' for fine grained commands

          enabling

- next/prev: requires `--merge` to move with uncommitted changes

- next: significantly reword error messages

- next: add a --evolve flag to evolve aspiring children when on a head

5.1.5 -- 2015-06-23

- minor documentation cleanup

- support -i option for `hg amend` if commit supports it (3.4)

- fix the `debugrecordpruneparents` utility

- fix some possible crash during command abort (release nonexistent transaction)

- fix simple4server bug tracker URL

- compatibility with bookmark API change in future Mercurial 3.5

- prune no longer move the active bookmark for no reason (issue4559)

- evolve: stop reporting divergence base as missing when we actually have it

- significant performance improvement for all revsets.

- provide a hint of how to update to the successor of an obsolete working copy

  parent.

5.1.4 -- 2015-04-23

- significant documentation update

- fix issue4616: pulling with bundle2 would crash if common marker when

  discovered on non-served changesets.

- fix the debugobsrelsethashtree command

5.1.3 -- 2015-04-20

- discovery: fix misbehaving discovery across python version

- pull: properly install the bundle2 par generator

  (avoid sending all markers for each pull)

- commit: avoid potential deadlock (acquires wlock before lock)

- graft: avoid potential deadlock (acquires wlock before lock)

5.1.2 -- 2015-04-01

- evolve: prevent a crash in httpclient_pushobsmarkers() when pushing

5.1.1 -- 2015-03-05

- debugobsconvert: fix invalid markers during conversion

- discovery: cache some of the obs hash computation to improve performance (issue4518)

- revset: fix some crash with (issue4515)

5.1 -- 2015-01-30

- evolve: explicitly disable bookmark on evolve (issue4432)

- evolve: don't abort Mercurial on version mismatch

- compatibility with mercurial 3.3

5.0.2 -- 2014-12-14

- evolve: remove dependency to the rebase extension

5.0.1 -- 2014-11-25

- amend: fix --logfile argument

- evolve: preserve branch change when evolving

- evolve: fix potential crash while solving `bumped` changesets.

- uncommit: abort when rev specifies the current changeset

- evolve: various message improvement

- evolve: fix selection of changeset to evolve from the middle of a stack (issue4434)

- evolve: make next/prev only move bookmarks optionally

- evolve: tell user which "base of divergent changeset" is not found

5.0.0 -- 2014-10-22

- drop compat with Mercurial pre 3.2

- uncommit: add a --rev argument

- evolve: add a `working directory now at xxxxxxxxxx` message

- evolve: automatically translate obsolete hashes when evolving

- properly skip marker creating if patch apply cleanly

- prune: work around a massive slowdown from lazy revset

- grab: "fix" the grab alias on window

- fix an issue where prune performance were quadratic with the number of

  changesets pruned.

- pull: use discovery to pull less obsmarkers through bundle2

4.1.0 -- 2014-08-08

- amend: add -D/--current-date option

- amend: add -U/--current-user option

- evolve: add a --tool option

- evolve: add a --confirm option

- mark "commit -o", "graft -o" and "graft -O" as deprecated since they are

  unlikely to eventually make it into core.

- push obsmarkers and phases in the same transaction than changesets

  (when using hg >= 3.1 and bundle2-exp is enabled)

- hide message about the obsolescence marker exchange behind a

  `experimental.verbose-obsolescence-exchange` variable (default to False).

4.0.1 -- 2014-08-08

- createmarkers() accept an iterable (for compat with other extension)

4.0.0 -- 2014-06-03

- require Mercurial version 3.0.1 or above

- some compatibility fixes with future 3.1.0

- deprecated `gup` and `gdown` in favor of prev and next

- record parent of pruned parent at prune time

- added a `debugobsstorestat` command to gather data on obsmarker content.

- added a `debugrecordpruneparents` command to upgrade existing prune marker

  with parent information. Please run it once per repo after upgrading.

- improvement to obsolescence marker exchange:

  - added progress when pushing obsmarkers

  - added multiple output during obsolescence markers exchange

  - only push markers relevant to pushed subset

  - add a new experimental way to exchange marker (when server support):

    - added progress when pulling obsmarkers

    - only pull markers relevant to pulled subset

    - avoid exchanging common markers in some case

    - use bundle2 as transport when available.

 - add a hook related to the new commands

3.3.2 -- 2014-05-14

- fix a bug where evolve were creating changeset with 2 parents on windows

  (fix issues #16, #35 and #42)

- adds a --obsolete flag to import (requires Mercurial 3.0)

- prune: update to successor rather than parent when pruning '.' with -s

- fold: add missing --message and --logfile option

- fold: add squash as an alias

3.3.1 -- 2014-04-23

- various language fix

- active bookmark now move when using prev/next (#37)

- fix some preservation of rename information on evolve (#33)

- abort when evolve tries to move a node on top of itself (will helps on the #35 front)

- fold: enable --date and --user options

3.3.0 -- 2014-03-04

- raise Mercurial's minimal requirement to 2.7

- drop `latercomer` and `conflicting` compatibility. Those old alias are

  deprecated for a long time now.

- add verbose hint about how to handle corner case by hand.

  This should help people until evolve is able to to it itself.

- removed the qsync extension. The only user I knew about (logilab) is not

  using it anymore. It not compatible with coming Mercurial version 2.9.

- add progress indicator for long evolve command

- report troubles creation from `hg import`

3.2.0 -- 2013-11-15

- conform to the Mercurial custom of lowercase messages

- added a small extension to experiment with obsolescence marker push

- amend: drop the deprecated note option

- amend: use core mechanism for amend (fix multiple bugs)

- parents command: add "working directory parent is obsolete" message

- evolve command: allow updating to the successor if the parent is

  obsolete

- gdown and gup commands: add next and previous alias, respectively

- make grab aliases compatible with Mercurial 2.8

- Tested with 2.6, 2.7 and 2.8

3.1.0 -- 2013-02-11

- amend: drop deprecated --change option for amend

- alias: add a grab alias to be used instead of graft -O

- touch: add a --duplicate option to *not* obsolete the old version

- touch: fix touching multiple revision at the same time

- evolve: add a --all option

- prune: various minor improvements

- prune: add option to prune a specific bookmark

- prune: add -u and -d option to control metadata

3.0.0 -- 2013-02-02

- compatibility with 2.5

2.2.0 --

- make evolve smarter at picking next troubled to solved without --any

2.1.0 -- 2012-12-03

- qsync fixes

- have qfold ask for commit message

2.0.0 -- 2012-10-26

- compat with mercurial 2.4

1.1.0 -- 2012-10-26

- fix troubles creation reporting from rebase

- rename latecomer to bumped

- renamed conflicting to divergent

- smarter divergent handling

1.0.2 -- 2012-09-19

- fix hg fold bug

- fix hg pull --rebase

- fix detection of conflict with external tools

- adapt to core movement (caches and --amend)

1.0.1 -- 2012-08-31

- documentation improvement

- fix a performance bug with hgweb

1.0 -- 2012-08-29

- Align with Mercurial version 2.3 (drop 2.2 support).

- stabilize handle killed parent

- stabilize handle late comer

- stabilize handle conflicting

- stabilize get a --continue switch

- merge and update ignore extinct changeset in most case.

- new "troubled()" revset

- summary now reports troubles changesets

- new touch command

- new fold command

- new basic olog alias

- rebase refuse to work on public changeset again

- rebase explicitly state that there is nothing to rebase because everything is

  extinct() when that happen.

- amend now cleanly abort when --change switch is misused

0.7 -- 2012-08-06

- hook: work around insanely huge value in obsolete pushkey call

- pushkey: properly handle abort during obsolete markers push

- amend: wrap the whole process in a single transaction.

- evolve: tweak and add EOL to kill warning

- obsolete: fix doc, rebase no longer aborts with --keep

- obsolete/evolve: fix grammar in prerequisite messages

- evolve: avoid duplication in graft wrapper

- evolve: graft --continue is optional, test

0.6 -- 2012-07-31

- obsolete: change warning output to match mercurial core on

- qsync: ignore nonexistent nodes

- make compat server both compatible with "dump" and "dump%i" version

0.5 -- 2012-07-16

- obsolete: Detect conflicting changeset!

- obsolete: adapt to core: marker are written in transaction now

- evolve: add the solve alias to obsolete

- doc: big update of terms and summary of the concept

- evolve: switch the official name for "kill" to prune

0.4.1 -- 2012-07-10

- [convert] properly exclude null successors from conversion

- Ignore buggy marker in newerversion

0.4.0 -- 2012-07-06

- obsolete: public changeset are no longer latecomer.

- obsolete: move to official binary format

- adapt for new mercurial

- obsolete: we are not compatible with 2.1 any more

0.3.0 -- 2012-06-27

- obsolete:  Add "latecomer" error detection (stabilize does not handle resolution yet)

- evolve:    Introduce a new `uncommit` command to remove change from a changeset

- rebase:    allow the use of --keep again

- commit:    --amend option create obsolete marker (but still strip)

- obsolete:  fewer marker are created when collapsing revision.

- revset:    add, successors(), allsuccessors(), precursors(), allprecursors(),

             latecomer() and hidden()

- evolve:    add `prune` alias to `kill`.

- stabilize: clearly state that stabilize does not handle conflict

- template:  add an {obsolete} keyword

0.2.0 -- 2012-06-20

- stabilize: improve choice of the next changeset to stabilize

- stabilize: improve resolution of several corner case

- rebase:    handle removing empty changesets

- rebase:    handle --collapse

- evolve:   add `obsolete` alias to `kill`

- evolve:   add `evolve` alias to `stabilize`