git-push: document all the status flags used in the output
We didn't talk about '-' (deletion), '*' (addition), nor '+' (forced). Signed-off-by: Junio C Hamano <gitster@pobox.com>
Junio C Hamano committed
Feb 8, 2010 at 16:45 UTC
b7047abc1213719c225a481f9618ca5a250e6fe9
1 file changed
+10
-5
Documentation/git-push.txt
+10
-5
@@ -159,12 +159,17 @@ If --porcelain is used, then each line of the output is of the form:
159
<flag> \t <from>:<to> \t <summary> (<reason>)
160
-------------------------------
161
162
+The status of up-to-date refs is shown only if --porcelain or --verbose
163
+option is used.
164
+
165
flag::
163
- A single character indicating the status of the ref. This is
164
- blank for a successfully pushed ref, `!` for a ref that was
165
- rejected or failed to push, and '=' for a ref that was up to
166
- date and did not need pushing (note that the status of up to
167
- date refs is shown only when `git push` is running verbosely).
166
+ A single character indicating the status of the ref:
167
+(space);; for a successfully pushed fast-forward;
168
+`{plus}`;; for a successful forced update;
169
+`-`;; for a successfully deleted ref;
170
+`*`;; for a successfully pushed new ref;
171
+`!`;; for a ref that was rejected or failed to push; and
172
+`=`;; for a ref that was up to date and did not need pushing.
173
174
summary::
175
For a successfully pushed ref, the summary shows the old and new