[PATCH 2 of 3 V4] push: add more detailed explanation about "--force" to online help document

[Matt Mackall]

On Thu, 2013-10-03 at 23:53 +0900, FUJIWARA Katsunori wrote:
> # HG changeset patch
> # User FUJIWARA Katsunori <foozy at lares.dti.ne.jp>
> # Date 1380809766 -32400
> #      Thu Oct 03 23:16:06 2013 +0900
> # Node ID 49339a7e52914e9abbedcfce4f1906f6997dc0c8
> # Parent  ba230978adae2a1b1c55cadc768ee5d3d71f687e
> push: add more detailed explanation about "--force" to online help document
...
> +    Although you can override the default behavior and push all
> +    changesets on all branches by -f/--force, pushing new heads in
> +    particular is usually a mistake. Before pushing with --force, you
> +    should ask the owner of the destination repository for the policy
> +    about multiple heads in it.

I've queued these, thanks, but I've rewritten this message:

+    .. note::
+      Extra care should be used with the -f/--force option,
+      which will push all new heads on all branches, an action which will
+      almost always cause confusion for collaborators.

-- 
Mathematics is the supreme nostalgia of our time.