summaryrefslogtreecommitdiff
path: root/Documentation
diff options
context:
space:
mode:
authorLarry D'Anna <larry@elder-gods.org>2009-06-22 21:10:01 -0400
committerJunio C Hamano <gitster@pobox.com>2009-06-27 22:26:58 -0700
commit1965ff744a7e4cdefcc467991182b779f3c9d0e8 (patch)
tree8e33d618c136bbd758b621f6f0b30f23c1a1f321 /Documentation
parent4f2b15ce88b70dd9e269517a9903864393ca873b (diff)
downloadgit-1965ff744a7e4cdefcc467991182b779f3c9d0e8.tar.gz
add --porcelain option to git-push
If --porcelain is used git-push will produce machine-readable output. The output status line for each ref will be tab-separated and sent to stdout instead of stderr. The full symbolic names of the refs will be given. For example $ git push --dry-run --porcelain master :foobar 2>/dev/null \ | perl -pe 's/\t/ TAB /g' = TAB refs/heads/master:refs/heads/master TAB [up to date] - TAB :refs/heads/foobar TAB [deleted] Signed-off-by: Larry D'Anna <larry@elder-gods.org> Signed-off-by: Junio C Hamano <gitster@pobox.com>
Diffstat (limited to 'Documentation')
-rw-r--r--Documentation/git-push.txt11
1 files changed, 11 insertions, 0 deletions
diff --git a/Documentation/git-push.txt b/Documentation/git-push.txt
index fd53c49fb8..2653388fd8 100644
--- a/Documentation/git-push.txt
+++ b/Documentation/git-push.txt
@@ -85,6 +85,11 @@ nor in any Push line of the corresponding remotes file---see below).
--dry-run::
Do everything except actually send the updates.
+--porcelain::
+ Produce machine-readable output. The output status line for each ref
+ will be tab-separated and sent to stdout instead of stderr. The full
+ symbolic names of the refs will be given.
+
--tags::
All refs under `$GIT_DIR/refs/tags` are pushed, in
addition to refspecs explicitly listed on the command
@@ -148,6 +153,12 @@ representing the status of a single ref. Each line is of the form:
<flag> <summary> <from> -> <to> (<reason>)
-------------------------------
+If --porcelain is used, then each line of the output is of the form:
+
+-------------------------------
+ <flag> \t <from>:<to> \t <summary> (<reason>)
+-------------------------------
+
flag::
A single character indicating the status of the ref. This is
blank for a successfully pushed ref, `!` for a ref that was