[clang] [ASTMatchers][Docs] print ignoring message only when class was not documented before (PR #203783)

Baranov Victor via cfe-commits cfe-commits at lists.llvm.org
Sun Jun 14 12:03:59 PDT 2026


https://github.com/vbvictor created https://github.com/llvm/llvm-project/pull/203783

None

>From 595fe2b07f2b0941c307537d9560fb43772b6bfc Mon Sep 17 00:00:00 2001
From: Victor Baranov <bar.victor.2002 at gmail.com>
Date: Sun, 14 Jun 2026 22:03:44 +0300
Subject: [PATCH] [ASTMatchers][Docs] print ignoring message only when class
 was not documented before

---
 clang/docs/tools/dump_ast_matchers.py | 5 ++++-
 1 file changed, 4 insertions(+), 1 deletion(-)

diff --git a/clang/docs/tools/dump_ast_matchers.py b/clang/docs/tools/dump_ast_matchers.py
index 5db6826070934..5bd7b728a1c56 100755
--- a/clang/docs/tools/dump_ast_matchers.py
+++ b/clang/docs/tools/dump_ast_matchers.py
@@ -521,7 +521,10 @@ def act_on_decl(declaration, comment, allowed_types):
             if not result_types:
                 if not comment:
                     # Only overloads don't have their own doxygen comments; ignore those.
-                    print('Ignoring "%s"' % name)
+                    # Warn if this name was never successfully documented.
+                    # Overloads of an already-documented matcher are expected.
+                    if ids[name] == 0:
+                        print('Ignoring "%s"' % name)
                 else:
                     print('Cannot determine result type for "%s"' % name)
             else:



More information about the cfe-commits mailing list