]> git.ipfire.org Git - thirdparty/gcc.git/commitdiff
contrib: Set check-params-in-docs.py to skip tables of values of a param
authorFilip Kastl <fkastl@suse.cz>
Wed, 18 Sep 2024 14:38:30 +0000 (16:38 +0200)
committerFilip Kastl <fkastl@suse.cz>
Wed, 18 Sep 2024 14:38:30 +0000 (16:38 +0200)
Currently check-params-in-docs.py reports extra params being listed in
invoke.texi.  However, those aren't actual params but items in a table of
possible values of the aarch64-autove-preference param.

This patch changes check-params-in-docs.py to ignore similar tables.

contrib/ChangeLog:

* check-params-in-docs.py: Skip tables of values of a param.
Remove code that skips items beginning with a number.

Signed-off-by: Filip Kastl <fkastl@suse.cz>
contrib/check-params-in-docs.py

index ccdb8d721696e4dbb7c6f1659f1abbe23943bb98..102f0e64e98995c875523d1d59f82397a843c7b2 100755 (executable)
@@ -66,14 +66,23 @@ texi = takewhile(lambda x: '@node Instrumentation Options' not in x, texi)
 texi = list(texi)[1:]
 
 texi_params = []
+skip = False
 for line in texi:
+    # Skip @table @samp sections of manual where values of a param are usually
+    # listed
+    if skip:
+        if line.startswith('@end table'):
+            skip = False
+        continue
+    elif line.startswith('@table @samp'):
+        skip = True
+        continue
+
     for token in ('@item ', '@itemx '):
         if line.startswith(token):
             texi_params.append(line[len(token):])
             break
 
-# Skip digits
-texi_params = [x for x in texi_params if not x[0].isdigit()]
 # Skip target-specific params
 texi_params = [x for x in texi_params if not target_specific(x)]