A man page for regression testing tools/MT-Unsafe.py

Includes expected output.

Author: andrew-aitchison

test/tools/MT-Unsafe.3

@@ -0,0 +1,69 @@
+.TH MT-Unsafe 3 2026-06-21 "CppCheck" "CppCheck Developer Tools"
+.SH NAME
+MT-Unsafe.py
+
+.SH DESCRIPTION
+This man page does
+.BI not
+document real functions
+(although some of the functions it names
+.I are
+real).
+
+This man page is test data for the
+.BI tools/MT-Unsafe.py
+script, which is used to convert man pages into data for the
+.B cppcheck
+addon
+.I threadsafety.py\fR.
+The output should match
+.I test/tools/MT-Unsafe.3.expected\fR.
+E.g.:
+
+.I tools/MT-Unsafe.py test/tools/MT-Unsafe.3 | diff - test/tools/MT-Unsafe.3.expected
+should produce no output.
+
+.\ .SH SEE ALSO
+
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+
+.TS
+allbox;
+lbx lb lb
+l l l.
+Interface	Attribute	Value
+T{
+.na
+.nh
+.BR elf_flagelf (),\~elf_flagehdr(),\~elf_flagphdr(),\~elf_flagscn(),\~elf_flagshdr(),\~elf_flagdata()
+T}	Thread safety	MT-Unsafe
+T{
+.na
+.nh
+.BR safe_function (),\~second_safe_function(),third_function()
+T}	Thread safety	MT-Safe
+T{
+.na
+.nh
+.BR race_function (),
+.BR second_race_function ()
+T}	Thread safety	MT-Unsafe race:argument
+.TE
+
+
+.\ .SH STANDARDS
+
+.\ .SH HISTORY
+.\ Original version Andrew C. Aitchison 2026-06-21
+
+.SH AUTHORS
+.PP
+\fBAndrew Aitchison\fR <\&github@aitchison\&.me\&.uk\&>
+.RS 4
+Wrote MT-Unsafe.py and this man page\&.
+.RE
+.SH COPYRIGHT
+Copyright (C) 2026 Cppcheck team.
+.\ .SH NOTES

test/tools/MT-Unsafe.3.expected

@@ -0,0 +1,15 @@
+{
+    # Types marked MT-Unsafe
+    '',
+    'race:argument',
+    # APIs marked MT-Unsafe
+    'elf_flagdata',
+    'elf_flagehdr',
+    'elf_flagelf',
+    'elf_flagphdr',
+    'elf_flagscn',
+    'elf_flagshdr',
+    'race_function',
+    'second_race_function',
+}
+

tools/MT-Unsafe.py

@@ -97,14 +97,15 @@ def man_search(manpage):
             dprint(1, 'function_names 1a:\n\t%s\n' % (function_names))
             function_names = function_names.replace(r'\n', '')
             dprint(1, 'function_names 2:\n\t%s\n' % (function_names))
-            function_names = re.sub(r"[~() ']+", '', function_names)
+            function_names = re.sub(r"[~() '\\\n]+", '', function_names)
             dprint(1, 'function_names 3:\n\t%s\n' % (function_names))
             function_names = re.split(',', function_names)
             dprint(1, 'function_names split:\n\t%s\n' % (function_names))
 
             for fn in function_names:
                 if fn:
                     apis.add(fn)
+                    dprint(1, 'added function "%s"' % fn)
 
         if 'MT-Unsafe' in lineread:
             resUnsafe = re.search("MT-Unsafe\\s+(.*)(\\n\'|$)", lineread)