Re: [PATCH] git-push: fix the documentation to explain all the status flags
From: Junio C Hamano <hidden>
Date: 2016-06-15 22:48:12
Larry D'Anna [off-list ref] writes:
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. ---
Thanks. I assume it is Ok to copy your sign-off from your other messages ;-)
quoted hunk
@@ -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
Both [horizontal] and three colons are something we never have used in the existing documentation set. How confident are you that various versions of deployed AsciiDoc people would use all support this? I am not _complaining_; I am just being cautious to see if I have to look into the issue myself (if your answer is "not at all") or not (otherwise).
+ "+"::: 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