# HG changeset patch # User Pierre-Yves David # Date 1598435474 -7200 # Node ID ac7cb1b67c9b0a312bd5ee1aeb9a38808583e265 # Parent 1a7bb3ab027e0ef13a3239347eb37bf20e4b19ec unstable-list: simplify the basic The point of the "basics" section is to summarize the semantic of the unstability and its resolution, not to get into details. Details are meant for the other sections. diff -r 1a7bb3ab027e -r ac7cb1b67c9b docs/troubles-handling.rst --- a/docs/troubles-handling.rst Mon Aug 17 16:44:13 2020 +0530 +++ b/docs/troubles-handling.rst Wed Aug 26 11:51:14 2020 +0200 @@ -169,18 +169,9 @@ It appears when a rewritten changeset got published. A phase-divergent changeset has a public predecessor. -To stabilise the situation, we need to analyse the changes introduced by the -phase-divergent changeset which succeeded the public changeset. And if there -are some file content changes which can be rebased on public changeset, will be -committed as a resolution changeset. - -If no file content changes and only metadata (author, parent, etc) is changed, -we prune phase-divergent changeset. -XXX: here we should probably inform about the metadata loss. - -In practice there are other corner cases where this is "not that simple". -For e.g. the obsolete changeset (which got published) was split over multiple -topological branches. +Solving phase divergence is done by extracting the changes made between the +public predecessors and the latest evolution of the changesets into a new +changesets, descendants of the public prédecessors. Cause of trouble ****************