Mercurial Mercurial > mercurial / changeset
summary | shortlog | changelog | graph | tags | bookmarks | branches | files | changeset | raw | help
Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
push: add more detailed explanation about "--force" to online help document
authorFUJIWARA Katsunori <foozy@lares.dti.ne.jp>
Thu, 03 Oct 2013 23:16:06 +0900
changeset 19935 4f53de036af8
parent 19934 bfc6ed892349
child 19936 8179eb28983b
push: add more detailed explanation about "--force" to online help document This patch adds more detailed explanation about "--force" to online help document of "hg push" to prevent novice users to execute "push --force" easily without understanding about problems of multiple branch heads in the repository.
mercurial/commands.py file | annotate | diff | comparison | revisions 
--- a/mercurial/commands.py	Thu Oct 03 23:16:06 2013 +0900
+++ b/mercurial/commands.py	Thu Oct 03 23:16:06 2013 +0900
@@ -4651,8 +4651,10 @@
     branch that is not present at the destination. This allows you to
     only create a new branch without forcing other changes.
 
-    Use -f/--force to override the default behavior and push all
-    changesets on all branches.
+    .. 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.
 
     If -r/--rev is used, the specified revision and all its ancestors
     will be pushed to the remote repository.
mercurial