Jonas Devlieghere
d5a18603b0
The "Python API enumerators and constants" page was added by
3cae8b3329 as an explicit stop-gap: its contents were grepped out of
the headers by hand, with the few available doc strings copied over
manually. That commit noted the real fix would be a tool that parses the
enum/constant headers and emits the page automatically.
Being hand-maintained, the page drifted badly out of sync. By now it was
missing 19 enums and 60+ enumerators, still documented three values that
no longer exist, and carried stale descriptions.
Add gen-python-api-enums.py, which parses lldb-enumerations.h and
lldb-defines.h and emits the page at build time. It is pulled into
python_api_enums.md via the {build-include} directive, the same
mechanism already used for the generated settings page, so the page can
stay in sync with the source.
Enums from the separately generated SBLanguages.h (eLanguageName*) are
still not covered, matching the previous page's scope.
Assisted-by: Claude
464 B
464 B
orphan
| orphan |
|---|
| true |
% This is a sub page of the Python API docs and linked from the main API page. % The page isn't in any toctree, so silence the sphinx warnings by marking it as orphan.
% The page contents are generated at build time from lldb-enumerations.h and % lldb-defines.h by lldb/scripts/gen-python-api-enums.py. Don't edit it by hand; % update those headers instead.
:parser: myst_parser.sphinx_