From: Junio C Hamano <gitster@pobox.com>
Date: Thu, 15 Feb 2018 23:18:15 +0000 (-0800)
Subject: Merge branch 'ab/doc-cat-file-e-still-shows-errors' into maint
X-Git-Tag: v2.16.2~1
X-Git-Url: https://www.git.lorimer.id.au/gitweb.git/diff_plain/c93150cfb02257b38d0f8abcafc7de5908afbb3b?hp=d4e528ef6a00b2176e69e426be0da19c86577ffc

Merge branch 'ab/doc-cat-file-e-still-shows-errors' into maint

Doc update.

* ab/doc-cat-file-e-still-shows-errors:
cat-file doc: document that -e will return some output
---

diff --git a/Documentation/git-cat-file.txt b/Documentation/git-cat-file.txt
index fb09cd69d6..f90f09b03f 100644
--- a/Documentation/git-cat-file.txt
+++ b/Documentation/git-cat-file.txt
@@ -42,8 +42,9 @@ OPTIONS
 	<object>.
 
 -e::
-	Suppress all output; instead exit with zero status if <object>
-	exists and is a valid object.
+	Exit with zero status if <object> exists and is a valid
+	object. If <object> is of an invalid format exit with non-zero and
+	emits an error on stderr.
 
 -p::
 	Pretty-print the contents of <object> based on its type.
@@ -168,7 +169,7 @@ If `-t` is specified, one of the <type>.
 
 If `-s` is specified, the size of the <object> in bytes.
 
-If `-e` is specified, no output.
+If `-e` is specified, no output, unless the <object> is malformed.
 
 If `-p` is specified, the contents of <object> are pretty-printed.