Philippe Vaucher <philippe.vaucher@xxxxxxxxx> writes:
>>> What's weird about them? They are real messages issued exactly when they are described to be issued.
>>
>> The problem is surely that an explanatory line is needed to say that these are the diagnostic messages that occur in various cases. Its in 'ident.c'.
>
> I guess I'm just unfamiliar with the "Diagnostics" section of a man
> page.
Ahh, that makes your initial message understandable.
It indeed is not one of the very common and established ones, and it may
help to give it a gentler introduction.
Documentation/git-commit-tree.txt | 4 ++++
Documentation/git-var.txt | 4 ++++
2 files changed, 8 insertions(+)
diff --git a/Documentation/git-commit-tree.txt b/Documentation/git-commit-tree.txt
index cfb9906..868ad09 100644
--- a/Documentation/git-commit-tree.txt
+++ b/Documentation/git-commit-tree.txt
@@ -90,6 +90,10 @@ include::date-formats.txt[]
Diagnostics
-----------
+
+Some of the common error message the command may give upon errors are
+listed here.
+
You don't exist. Go away!::
The passwd(5) gecos field couldn't be read
Your parents must have hated you!::
diff --git a/Documentation/git-var.txt b/Documentation/git-var.txt
index 988a323..394bfa7 100644
--- a/Documentation/git-var.txt
+++ b/Documentation/git-var.txt
@@ -61,6 +61,10 @@ endif::git-default-pager[]
Diagnostics
-----------
+
+Some of the common error message the command may give upon errors are
+listed here.
+
You don't exist. Go away!::
The passwd(5) gecos field couldn't be read
Your parents must have hated you!::
--
To unsubscribe from this list: send the line "unsubscribe git" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at http://vger.kernel.org/majordomo-info.html