[PATCH] git-push: fix the documentation to explain all the status flags
git-push prints a flag indicating the status of each ref that was pushed, or
attempted to be pushed. The documentation did not correctly list all of the
possible flags.
---
Documentation/git-push.txt | 13 +++++++++----
1 files changed, 9 insertions(+), 4 deletions(-)
diff --git a/Documentation/git-push.txt b/Documentation/git-push.txt
index 73a921c..61b6894 100644
--- a/Documentation/git-push.txt
+++ b/Documentation/git-push.txt
@@ -176,12 +176,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 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).
+[horizontal]
+ " " (space)::: for a successfully pushed fast-forward
+ "+"::: 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
+ "="::: 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
--
1.7.0.rc1.33.g07cf0f.dirty
Larry D'Anna <larry@elder-gods.org>