Documentation/git-push.txt: document when --signed may fail

Like --atomic, --signed will fail if the server does not advertise the
necessary capability. In addition, it requires gpg on the client side.

Signed-off-by: Dave Borowitz <dborowitz@google.com>
Signed-off-by: Junio C Hamano <gitster@pobox.com>

diff --git a/Documentation/git-push.txt b/Documentation/git-push.txt
index 135d810b7a9b7e36d1cb06ca49c185655a655bee..da0a98d58c3203d8605f436096184264b27e1599 100644 (file)
--- a/Documentation/git-push.txt
+++ b/Documentation/git-push.txt
@@ -137,7 +137,9 @@ already exists on the remote side.
        GPG-sign the push request to update refs on the receiving
        side, to allow it to be checked by the hooks and/or be
        logged.  See linkgit:git-receive-pack[1] for the details
-       on the receiving end.
+       on the receiving end.  If the attempt to sign with `gpg` fails,
+       or if the server does not support signed pushes, the push will
+       fail.
 
 --[no-]atomic::
        Use an atomic transaction on the remote side if available.