[nongnu] elpa/git-commit c080f124d7 2/4: magit-git-debug: Extend documentation

[ELPA Syncer]

branch: elpa/git-commit
commit c080f124d7932a6de5b209c1535dd6f0b6daf634
Author: Jonas Bernoulli <jonas@bernoul.li>
Commit: Jonas Bernoulli <jonas@bernoul.li>

    magit-git-debug: Extend documentation
---
 docs/magit.org    | 9 +++++++++
 docs/magit.texi   | 9 +++++++++
 lisp/magit-git.el | 8 +++++++-
 3 files changed, 25 insertions(+), 1 deletion(-)

diff --git a/docs/magit.org b/docs/magit.org
index ed7dfb8ed0..b894855dbb 100644
--- a/docs/magit.org
+++ b/docs/magit.org
@@ -1840,6 +1840,15 @@ sections are available.  There is one additional command.
   This is only intended for debugging purposes.  Do not enable this
   permanently, that would negatively affect performance.
 
+  This is only intended for debugging purposes.  Do not enable this
+  permanently, that would negatively affect performance.  Also note
+  that just because git exits with a non-zero exit status and prints
+  an error message that usually doesn't mean that it is an error as
+  far as Magit is concerned, which is another reason we usually hide
+  these error messages.  Whether some error message is relevant in
+  the context of some unexpected behavior has to be judged on a case
+  by case basis.
+
 - Variable: magit-process-extreme-logging ::
 
   This option controls whether ~magit-process-file~ logs to the
diff --git a/docs/magit.texi b/docs/magit.texi
index 86dbf3e154..b28d823a4f 100644
--- a/docs/magit.texi
+++ b/docs/magit.texi
@@ -2379,6 +2379,15 @@ then at least its standard error is inserted into this 
buffer.
 
 This is only intended for debugging purposes.  Do not enable this
 permanently, that would negatively affect performance.
+
+This is only intended for debugging purposes.  Do not enable this
+permanently, that would negatively affect performance.  Also note
+that just because git exits with a non-zero exit status and prints
+an error message that usually doesn't mean that it is an error as
+far as Magit is concerned, which is another reason we usually hide
+these error messages.  Whether some error message is relevant in
+the context of some unexpected behavior has to be judged on a case
+by case basis.
 @end defvar
 
 @defvar magit-process-extreme-logging
diff --git a/lisp/magit-git.el b/lisp/magit-git.el
index 773ef6111b..82617a246e 100644
--- a/lisp/magit-git.el
+++ b/lisp/magit-git.el
@@ -276,7 +276,13 @@ option is non-nil and git returns with a non-zero exit 
status,
 then at least its standard error is inserted into this buffer.
 
 This is only intended for debugging purposes.  Do not enable this
-permanently, that would negatively affect performance.
+permanently, that would negatively affect performance.  Also note
+that just because git exits with a non-zero exit status and prints
+an error message that usually doesn't mean that it is an error as
+far as Magit is concerned, which is another reason we usually hide
+these error messages.  Whether some error message is relevant in
+the context of some unexpected behavior has to be judged on a case
+by case basis.
 
 Also see `magit-process-extreme-logging'.")