[all-commits] [llvm/llvm-project] d5a186: [lldb][docs] Generate the Python API enums page fr...

[Jonas Devlieghere via All-commits]

  Branch: refs/heads/main
  Home:   https://github.com/llvm/llvm-project
  Commit: d5a18603b0d825fbe743f299dc3ee226be789f49
      https://github.com/llvm/llvm-project/commit/d5a18603b0d825fbe743f299dc3ee226be789f49
  Author: Jonas Devlieghere <jonas at devlieghere.com>
  Date:   2026-06-10 (Wed, 10 Jun 2026)

  Changed paths:
    M lldb/docs/CMakeLists.txt
    M lldb/docs/python_api_enums.md
    A lldb/scripts/gen-python-api-enums.py

  Log Message:
  -----------
  [lldb][docs] Generate the Python API enums page from headers (#202780)

The "Python API enumerators and constants" page was added by
3cae8b33297b 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



To unsubscribe from these emails, change your notification settings at https://github.com/llvm/llvm-project/settings/notifications