[clang-tidy] Update documentation for 'fileScopeAsmDecl'

Author: capitan-davide

clang/docs/LibASTMatchersReference.html

@@ -828,9 +828,14 @@ <h2 id="decl-matchers">Node Matchers</h2>
 <tr><td>Matcher&lt;<a href="https://clang.llvm.org/doxygen/classclang_1_1Decl.html">Decl</a>&gt;</td><td class="name" onclick="toggle('fileScopeAsmDecl0')"><a name="fileScopeAsmDecl0Anchor">fileScopeAsmDecl</a></td><td>Matcher&lt;<a href="https://clang.llvm.org/doxygen/classclang_1_1FileScopeAsmDecl.html">FileScopeAsmDecl</a>&gt;...</td></tr>
 <tr><td colspan="4" class="doc" id="fileScopeAsmDecl0"><pre>Matches top level asm declarations.
 
- __asm__("nop");
+Given
+   __asm("nop");
+   void f() {
+     __asm("mov al, 2");
+   }
 fileScopeAsmDecl()
-  matches '__asm__("nop")'
+  matches '__asm("nop")',
+  but not '__asm("mov al, 2")'.
 </pre></td></tr>
 
 

clang/include/clang/ASTMatchers/ASTMatchers.h

@@ -2480,11 +2480,16 @@ extern const internal::VariadicDynCastAllOfMatcher<Stmt, AsmStmt> asmStmt;
 
 /// Matches top level asm declarations.
 ///
+/// Given
 /// \code
-///  __asm__("nop");
+///    __asm("nop");
+///    void f() {
+///      __asm("mov al, 2");
+///    }
 /// \endcode
 /// fileScopeAsmDecl()
-///   matches '__asm__("nop")'
+///   matches '__asm("nop")',
+///   but not '__asm("mov al, 2")'.
 extern const internal::VariadicDynCastAllOfMatcher<Decl, FileScopeAsmDecl>
     fileScopeAsmDecl;
 

clang/unittests/ASTMatchers/ASTMatchersNodeTest.cpp

@@ -1182,7 +1182,7 @@ TEST_P(ASTMatchersTest, PredefinedExpr) {
 TEST_P(ASTMatchersTest, FileScopeAsmDecl) {
   EXPECT_TRUE(matches("__asm(\"nop\");", fileScopeAsmDecl()));
   EXPECT_TRUE(
-      notMatches("void foo() { __asm(\"mov al, 2\"); }", fileScopeAsmDecl()));
+      notMatches("void f() { __asm(\"mov al, 2\"); }", fileScopeAsmDecl()));
 }
 
 TEST_P(ASTMatchersTest, AsmStatement) {