feat(lldb): LLDB data formatters

Author: alandefreitas

bootstrap.py

@@ -2508,6 +2508,7 @@ def generate_pretty_printer_configs(self):
                 lldbinit_content += f"# echo 'settings set target.load-cwd-lldbinit true' >> ~/.lldbinit\n"
                 lldbinit_content += f"# \n"
             lldbinit_content += f"command script import {os.path.join(self.options.llvm_src_dir, 'llvm', 'utils', 'lldbDataFormatters.py').replace(os.sep, '/')}\n"
+            lldbinit_content += f"command script import {os.path.join(self.options.mrdocs_src_dir, 'share', 'lldb', 'mrdocs_formatters.py').replace(os.sep, '/')}\n"
             with open(lldbinit_path, "w") as f:
                 f.write(lldbinit_content)
             print(f"Generated LLDB pretty printer configuration at '{lldbinit_path}'")

share/lldb/README.adoc

@@ -0,0 +1,24 @@
+= LLDB data formatters
+
+Create or modify your `.lldbinit` file to contain the following:
+
+[source,lldb]
+----
+command script import /path/share/lldb/mrdocs_formatters.py  <1>
+type category enable MrDocs                                  <2>
+----
+
+<1> Import the LLDB formatter module. LLDB will call `__lldb_init_module` inside `mrdocs_formatters.py` to register summaries and synthetic children.
+<2> Ensure the `MrDocs` type category is enabled. (The module already enables it; this line is harmless redundancy.)
+
+This pattern registers the formatters as soon as LLDB imports the module.
+
+== Hot-reload during a session (useful while editing the file)
+
+[source,lldb]
+----
+script import importlib, mrdocs_formatters; importlib.reload(mrdocs_formatters)  <1>
+----
+
+<1> Reloads the module without restarting LLDB.
+