[PATCH] D66700: [Wdocumentation] improve wording of a warning message

Mark de Wever via Phabricator via cfe-commits cfe-commits at lists.llvm.org
Sat Aug 24 03:18:32 PDT 2019


Mordante created this revision.
Mordante added reviewers: gribozavr, davezarzycki.
Mordante added a project: clang.

Based on @davezarzycki remarks in D64696 <https://reviews.llvm.org/D64696> improved the wording of the warning message.

(Note I don't have commit access)


Repository:
  rG LLVM Github Monorepo

https://reviews.llvm.org/D66700

Files:
  clang/include/clang/Basic/DiagnosticCommentKinds.td
  clang/test/Sema/warn-documentation.cpp


Index: clang/test/Sema/warn-documentation.cpp
===================================================================
--- clang/test/Sema/warn-documentation.cpp
+++ clang/test/Sema/warn-documentation.cpp
@@ -1045,49 +1045,49 @@
 void test_attach38<int>::test_attach39(int, B);
 
 // The inline comments expect a string after the command.
-// expected-warning at +1 {{'\a' command does not have an argument}}
+// expected-warning at +1 {{'\a' command does not have a valid word argument}}
 /// \a
 int test_inline_no_argument_a_bad(int);
 
 /// \a A
 int test_inline_no_argument_a_good(int);
 
-// expected-warning at +1 {{'\anchor' command does not have an argument}}
+// expected-warning at +1 {{'\anchor' command does not have a valid word argument}}
 /// \anchor
 int test_inline_no_argument_anchor_bad(int);
 
 /// \anchor A
 int test_inline_no_argument_anchor_good(int);
 
-// expected-warning at +1 {{'@b' command does not have an argument}}
+// expected-warning at +1 {{'@b' command does not have a valid word argument}}
 /// @b
 int test_inline_no_argument_b_bad(int);
 
 /// @b A
 int test_inline_no_argument_b_good(int);
 
-// expected-warning at +1 {{'\c' command does not have an argument}}
+// expected-warning at +1 {{'\c' command does not have a valid word argument}}
 /// \c
 int test_inline_no_argument_c_bad(int);
 
 /// \c A
 int test_inline_no_argument_c_good(int);
 
-// expected-warning at +1 {{'\e' command does not have an argument}}
+// expected-warning at +1 {{'\e' command does not have a valid word argument}}
 /// \e
 int test_inline_no_argument_e_bad(int);
 
 /// \e A
 int test_inline_no_argument_e_good(int);
 
-// expected-warning at +1 {{'\em' command does not have an argument}}
+// expected-warning at +1 {{'\em' command does not have a valid word argument}}
 /// \em
 int test_inline_no_argument_em_bad(int);
 
 /// \em A
 int test_inline_no_argument_em_good(int);
 
-// expected-warning at +1 {{'\p' command does not have an argument}}
+// expected-warning at +1 {{'\p' command does not have a valid word argument}}
 /// \p
 int test_inline_no_argument_p_bad(int);
 
Index: clang/include/clang/Basic/DiagnosticCommentKinds.td
===================================================================
--- clang/include/clang/Basic/DiagnosticCommentKinds.td
+++ clang/include/clang/Basic/DiagnosticCommentKinds.td
@@ -156,7 +156,7 @@
 // inline contents commands
 
 def warn_doc_inline_contents_no_argument : Warning<
-  "'%select{\\|@}0%1' command does not have an argument">,
+  "'%select{\\|@}0%1' command does not have a valid word argument">,
   InGroup<Documentation>, DefaultIgnore;
 
 // verbatim block commands


-------------- next part --------------
A non-text attachment was scrubbed...
Name: D66700.217013.patch
Type: text/x-patch
Size: 2604 bytes
Desc: not available
URL: <http://lists.llvm.org/pipermail/cfe-commits/attachments/20190824/4cbe10ae/attachment.bin>


More information about the cfe-commits mailing list