comparison docs/evolve-faq.rst @ 492:7ecd41520dae

rename `stabilize` to `evolve`

stabilize keep being valide but as Matt still like "Changeset Evolution" as a
name evolve make more sense.

Stabilize is a bit too tight to unstable too.

491:6989d8fe4ed2

You can still use rebase to move a whole segment of the changeset graph together.

.. warning:: Beware that rebasing obsolete changesets will result in
             conflicting versions of the changesets.

Stabilize history: ``stabilize``
------------------------------------------------------------

When you rewrite (amend) a changeset with children without rewriting
those children you create *unstable* changesets and *suspended
obsolete* changesets.

When you are finished amending a given changeset, you will want to
declare it stable, in other words rebase its former descendants on its
newest version. This is not done automatically to avoid the
proliferation of useless hidden changesets.

.. warning:: ``hg stabilize`` have no --continue to use after conflict
             resolution

.. warning:: stabilization does not handle deletion yet.

.. warning:: obsolete currently relies on changesets in secret phase
              to avoid exchanging obsolete and unstable changesets.

             XXX details issue here


Fix my history afterward: ``prune -n``
------------------------------------------------------------

Sometimes you need to create an obsolete marker by hand. This may happen when

492:7ecd41520dae

You can still use rebase to move a whole segment of the changeset graph together.

.. warning:: Beware that rebasing obsolete changesets will result in
             conflicting versions of the changesets.

Stabilize history: ``evolve``
------------------------------------------------------------

When you rewrite (amend) a changeset with children without rewriting
those children you create *unstable* changesets and *suspended
obsolete* changesets.

When you are finished amending a given changeset, you will want to
declare it stable, in other words rebase its former descendants on its
newest version. This is not done automatically to avoid the
proliferation of useless hidden changesets.


Fix my history afterward: ``prune -n``
------------------------------------------------------------

Sometimes you need to create an obsolete marker by hand. This may happen when