usage.c: don't copy/paste the same comment three times

In ee4512ed481 (trace2: create new combined trace facility,
2019-02-22) we started with two copies of this comment,
0ee10fd1296 (usage: add trace2 entry upon warning(), 2020-11-23) added
a third. Let's instead add an earlier comment that applies to all
these mostly-the-same functions.

Signed-off-by: Ævar Arnfjörð Bjarmason <avarab@gmail.com>
Signed-off-by: Junio C Hamano <gitster@pobox.com>

diff --git a/usage.c b/usage.c
index 1b206de36d6e1cb7799fce728c2a37e310479223..c7d233b0de9538951c5f3d47aa165d900034c02b 100644 (file)
--- a/usage.c
+++ b/usage.c
@@ -55,12 +55,13 @@ static NORETURN void usage_builtin(const char *err, va_list params)
        exit(129);
 }
 
+/*
+ * We call trace2_cmd_error_va() in the below functions first and
+ * expect it to va_copy 'params' before using it (because an 'ap' can
+ * only be walked once).
+ */
 static NORETURN void die_builtin(const char *err, va_list params)
 {
-       /*
-        * We call this trace2 function first and expect it to va_copy 'params'
-        * before using it (because an 'ap' can only be walked once).
-        */
        trace2_cmd_error_va(err, params);
 
        vreportf("fatal: ", err, params);
@@ -70,10 +71,6 @@ static NORETURN void die_builtin(const char *err, va_list params)
 
 static void error_builtin(const char *err, va_list params)
 {
-       /*
-        * We call this trace2 function first and expect it to va_copy 'params'
-        * before using it (because an 'ap' can only be walked once).
-        */
        trace2_cmd_error_va(err, params);
 
        vreportf("error: ", err, params);
@@ -81,10 +78,6 @@ static void error_builtin(const char *err, va_list params)
 
 static void warn_builtin(const char *warn, va_list params)
 {
-       /*
-        * We call this trace2 function first and expect it to va_copy 'params'
-        * before using it (because an 'ap' can only be walked once).
-        */
        trace2_cmd_error_va(warn, params);
 
        vreportf("warning: ", warn, params);