From 6969e43b14a91124b98e4b0bd4d34a736123fe0b Mon Sep 17 00:00:00 2001 From: Dmitri Gribenko Date: Sun, 23 Jun 2013 23:33:14 +0000 Subject: [PATCH] Documentation parsing: recognize \relates, \related, \relatesonly, \relatedonly so that -Wdocumentation-unknown-command does not warn on these commands. Fixes PR16092. git-svn-id: https://llvm.org/svn/llvm-project/cfe/trunk@184676 91177308-0d34-0410-b5e6-96231b3b80d8 --- include/clang/AST/CommentCommands.td | 5 +++++ test/Sema/warn-documentation.cpp | 19 +++++++++++++++++++ 2 files changed, 24 insertions(+) diff --git a/include/clang/AST/CommentCommands.td b/include/clang/AST/CommentCommands.td index 8c88494e9a..56944add2a 100644 --- a/include/clang/AST/CommentCommands.td +++ b/include/clang/AST/CommentCommands.td @@ -200,6 +200,11 @@ def Mainpage : VerbatimLineCommand<"mainpage">; def Subpage : VerbatimLineCommand<"subpage">; def Ref : VerbatimLineCommand<"ref">; +def Relates : VerbatimLineCommand<"relates">; +def Related : VerbatimLineCommand<"related">; +def RelatesAlso : VerbatimLineCommand<"relatesalso">; +def RelatedAlso : VerbatimLineCommand<"relatedalso">; + //===----------------------------------------------------------------------===// // DeclarationVerbatimLineCommand //===----------------------------------------------------------------------===// diff --git a/test/Sema/warn-documentation.cpp b/test/Sema/warn-documentation.cpp index 8eb21a60a0..21b8dcb0d2 100644 --- a/test/Sema/warn-documentation.cpp +++ b/test/Sema/warn-documentation.cpp @@ -588,6 +588,25 @@ int test4; ///< \brief ///< \author Aaa +class TestRelates {}; + +/// \relates TestRelates +/// \brief Aaa +void test_relates_1(); + +/// \related TestRelates +/// \brief Aaa +void test_relates_2(); + +/// \relatesalso TestRelates +/// \brief Aaa +void test_relates_3(); + +/// \relatedalso TestRelates +/// \brief Aaa +void test_relates_4(); + + // Check that we attach the comment to the declaration during parsing in the // following cases. The test is based on the fact that we don't parse // documentation comments that are not attached to anything. -- 2.50.1