[Wdocumentation] Use the command marker

[Mordante]

Summary

Use the proper marker for -Wdocumentation-deprecated-sync instead of hard-coded the backslash.

Discovered while looking at https://bugs.llvm.org/show_bug.cgi?id=43753

clang/include/clang/Basic/DiagnosticCommentKinds.td

def warn_doc_returns_attached_to_a_void_function : Warning<
   "'%select{\\|@}0%1' command used in a comment that is attached to a "
   "%select{function returning void|constructor|destructor|"
   "method returning void}2">,
   InGroup<Documentation>, DefaultIgnore;
 
 // \deprecated command
 
 def warn_doc_deprecated_not_sync : Warning<
-  "declaration is marked with '\\deprecated' command but does not have "
-  "a deprecation attribute">,
+  "declaration is marked with '%select{\\|@}0deprecated' command but does "
+  "not have a deprecation attribute">,
   InGroup<DocumentationDeprecatedSync>, DefaultIgnore;
 
 def note_add_deprecation_attr : Note<
   "add a deprecation attribute to the declaration to silence this warning">;
 
 // inline contents commands
 
 def warn_doc_inline_contents_no_argument : Warning<

clang/lib/AST/CommentSema.cpp

void Sema::checkDeprecatedCommand(const BlockCommandComment *Command) {
   if (!D)
     return;
 
   if (D->hasAttr<DeprecatedAttr>() ||
       D->hasAttr<AvailabilityAttr>() ||
       D->hasAttr<UnavailableAttr>())
     return;
 
-  Diag(Command->getLocation(),
-       diag::warn_doc_deprecated_not_sync)
-    << Command->getSourceRange();
+  Diag(Command->getLocation(), diag::warn_doc_deprecated_not_sync)
+      << Command->getSourceRange() << Command->getCommandMarker();
 
   // Try to emit a fixit with a deprecation attribute.
   if (const FunctionDecl *FD = dyn_cast<FunctionDecl>(D)) {
     // Don't emit a Fix-It for non-member function definitions.  GCC does not
     // accept attributes on them.
     const DeclContext *Ctx = FD->getDeclContext();
     if ((!Ctx || !Ctx->isRecord()) &&
         FD->doesThisDeclarationHaveABody())

clang/test/Sema/warn-documentation.cpp

 /// \deprecated
 void test_deprecated_4(int a) __attribute__((unavailable));
 
 // expected-warning@+2 {{declaration is marked with '\deprecated' command but does not have a deprecation attribute}} expected-note@+3 {{add a deprecation attribute to the declaration to silence this warning}}
 /// Aaa
 /// \deprecated
 void test_deprecated_5(int a);
 
-// expected-warning@+2 {{declaration is marked with '\deprecated' command but does not have a deprecation attribute}} expected-note@+3 {{add a deprecation attribute to the declaration to silence this warning}}
+// expected-warning@+2 {{declaration is marked with '@deprecated' command but does not have a deprecation attribute}} expected-note@+3 {{add a deprecation attribute to the declaration to silence this warning}}
 /// Aaa
-/// \deprecated
+/// @deprecated
 void test_deprecated_6(int a) {
 }
 
 // expected-warning@+2 {{declaration is marked with '\deprecated' command but does not have a deprecation attribute}}
 /// Aaa
 /// \deprecated
 template<typename T>
 void test_deprecated_7(T aaa);