Code

git-push: document all the status flags used in the output
authorJunio C Hamano <gitster@pobox.com>
Tue, 9 Feb 2010 00:45:21 +0000 (16:45 -0800)
committerJunio C Hamano <gitster@pobox.com>
Tue, 9 Feb 2010 00:49:00 +0000 (16:49 -0800)
We didn't talk about '-' (deletion), '*' (addition), nor '+' (forced).

Signed-off-by: Junio C Hamano <gitster@pobox.com>
Documentation/git-push.txt

index 2653388fd8f5fac9292ece83a116accdf0978902..5d21ca8850124c3b4de8869cef1ce235b466eae5 100644 (file)
@@ -159,12 +159,17 @@ If --porcelain is used, then each line of the output is of the form:
  <flag> \t <from>:<to> \t <summary> (<reason>)
 -------------------------------
 
+The status of up-to-date refs is shown only if --porcelain or --verbose
+option is used.
+
 flag::
-       A single character indicating the status of the ref. This is
-       blank for a successfully pushed ref, `!` for a ref that was
-       rejected or failed to push, and '=' for a ref that was up to
-       date and did not need pushing (note that the status of up to
-       date refs is shown only when `git push` is running verbosely).
+       A single character indicating the status of the ref:
+(space);; for a successfully pushed fast-forward;
+`{plus}`;; for a successful forced update;
+`-`;; for a successfully deleted ref;
+`*`;; for a successfully pushed new ref;
+`!`;; for a ref that was rejected or failed to push; and
+`=`;; for a ref that was up to date and did not need pushing.
 
 summary::
        For a successfully pushed ref, the summary shows the old and new