[PATCH 0 of 6] improve help and hints, then add 'update --bookmark'

[Kevin Bullock]

On Dec 7, 2011, at 12:32 PM, Idan Kamara wrote:

> Why would you not want to move the *active* bookmark when updating to a
> descendant? When opening issue2894 this is the behavior I expected, others
> disagreed but I didn't understand the use cases in which this is undesired.


The use case is using bookmarks as a replacement for localtags (and Matt has explicitly stated he considers localtags deprecated in favor of bookmarks). Example:

Alice has done a major experimental refactoring and wants Bob to review it. She bookmarks the last non-experimental revision as 'last-stable', and the head as 'experimental'. Bob clones (with bookmarks) and updates to 'last-stable' to inspect it. He then runs `hg update` to inspect the head of Alice's work.

On no account should the 'last-stable' bookmark move in this case.

pacem in terris / мир / शान्ति / ‎‫سَلاَم‬ / 平和
Kevin R. Bullock