From: Abderrahim Kitouni <abderrahim.kitouni@codethink.co.uk>
Date: Sun, 10 Sep 2023 22:41:35 +0000 (+0100)
Subject: update-dbus-docs: don't consider mentions in the History
X-Git-Tag: v255-rc1~494^2
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=refs%2Fpull%2F29150%2Fhead;p=thirdparty%2Fsystemd.git

update-dbus-docs: don't consider mentions in the History

Being mentioned in the History section as added in a specific version isn't
enough to consider a member documented.
---

diff --git a/tools/update-dbus-docs.py b/tools/update-dbus-docs.py
index d6438a5daf9..b3466bc1108 100755
--- a/tools/update-dbus-docs.py
+++ b/tools/update-dbus-docs.py
@@ -141,10 +141,16 @@ def print_interface(iface, *, prefix, file, print_boring, only_interface, declar
         print(f'''{prefix}}};''', file=file)
 
 def document_has_elem_with_text(document, elem, item_repr):
-    predicate = f".//{elem}" # [text() = 'foo'] doesn't seem supported :(
+    predicate = f".//{elem}[. = '{item_repr}']"
+
+    # Ignore mentions in the History section
+    history = document.find(".//refsect1[title = 'History']")
+    history_mentions = history.findall(predicate) if history else []
+
     for loc in document.findall(predicate):
-        if loc.text == item_repr:
-            return True
+        if loc in history_mentions:
+            continue
+        return True
     return False
 
 def check_documented(document, declarations, stats):