seL4/manual/tools
Gerwin Klein deec818829 manual: gracefully handle dangling references
Recent doxygen versions generate references for constants that are named
in the text. Since we do not produce a constant table in the manual
(neither markdown nor tex), these references point to nowhere and
produce a KeyError in the ref_dict on lookup.

The corresponding xml nodes are of this form:

<ref kindref="member"
     refid="include_2sel4_2constants_8h_1a9a3...">seL4_TCBFlag</ref>

Ignore such dangling references and return the content (seL4_TCBFlag in
the example) instead. Run text escape on the content to cover
underscores etc in LaTeX.

Does not produce a warning since we expect this to be normal behaviour.

Signed-off-by: Gerwin Klein <gerwin.klein@proofcraft.systems>
2025-07-31 10:14:10 +10:00
..
gen_env.py Convert license tags to SPDX identifiers 2020-03-09 13:21:49 +08:00
gen_invocations.py gen_invocations: handle undefined values 2025-07-07 08:50:47 +10:00
libsel4_tools manual: Added libsel4 tools library to manual dir 2016-11-29 14:30:02 +11:00
parse_doxygen_xml.py manual: gracefully handle dangling references 2025-07-31 10:14:10 +10:00