doc/git-howto: Replace "git push" example by one with dry-run
authorMichael Niedermayer <michael@niedermayer.cc>
Mon, 3 Aug 2015 09:56:31 +0000 (11:56 +0200)
committerMichael Niedermayer <michael@niedermayer.cc>
Mon, 3 Aug 2015 17:33:46 +0000 (19:33 +0200)
I do not think having "git push" as example is a good idea.
The command has a very high chance of pushing things which are unwanted to be
pushed

Reviewed-by: Carl Eugen Hoyos <cehoyos@ag.or.at>
Signed-off-by: Michael Niedermayer <michael@niedermayer.cc>
doc/git-howto.texi

index b7b5d43..b3c8ff0 100644 (file)
@@ -326,10 +326,12 @@ faulty commit disappear from the history.
 @section Pushing changes to remote trees
 
 @example
-git push
+git push origin master --dry-run
 @end example
 
-Will push the changes to the default remote (@var{origin}).
+Will simulate a push of the local master branch to the default remote
+(@var{origin}). And list which branches and ranges or commits would have been
+pushed.
 Git will prevent you from pushing changes if the local and remote trees are
 out of sync. Refer to @ref{Updating the source tree to the latest revision}.