https://github.com/Michael137 created https://github.com/llvm/llvm-project/pull/141610
This is still leftover from the days when the libc++ and libstdc++ formatters were both written in python and in separate categories. Since then we group libstdc++ and libc++ formatters into the same cateogry. This patch removes references to the obsolete `gnu-libstdc++` category from the docs (and a test). See [this thread](https://github.com/llvm/llvm-project/pull/140761#discussion_r2099762155) for more context >From 012023ef991140b773a81b73c6b22f9ddff719d9 Mon Sep 17 00:00:00 2001 From: Michael Buch <michaelbuc...@gmail.com> Date: Tue, 27 May 2025 15:29:58 +0100 Subject: [PATCH] [lldb][docs][NFC] Remove references to obsolete gnu-libstdc++ category This is still leftover from the days when the libc++ and libstdc++ formatters were both written in python and in separate categories. Since then we group libstdc++ and libc++ formatters into the same cateogry. This patch removes references to the obsolete `gnu-libstdc++` category from the docs (and a test). See [this thread](https://github.com/llvm/llvm-project/pull/140761#discussion_r2099762155) for more context --- lldb/docs/use/variable.rst | 14 ++++++-------- .../TestDataFormatterDisabling.py | 2 -- 2 files changed, 6 insertions(+), 10 deletions(-) diff --git a/lldb/docs/use/variable.rst b/lldb/docs/use/variable.rst index 22c1fd64c4a96..c9bf76b0d4964 100644 --- a/lldb/docs/use/variable.rst +++ b/lldb/docs/use/variable.rst @@ -1209,16 +1209,15 @@ Categories ---------- Categories are a way to group related formatters. For instance, LLDB itself -groups the formatters for the libstdc++ types in a category named -gnu-libstdc++. Basically, categories act like containers in which to store -formatters for a same library or OS release. +groups the formatters for STL types in a category named cpluspus. Basically, +categories act like containers in which to store formatters for a same library +or OS release. By default, several categories are created in LLDB: - default: this is the category where every formatter ends up, unless another category is specified - objc: formatters for basic and common Objective-C types that do not specifically depend on macOS -- gnu-libstdc++: formatters for std::string, std::vector, std::list and std::map as implemented by libstdcpp -- libcxx: formatters for std::string, std::vector, std::list and std::map as implemented by libcxx +- cplusplus: formatters for STL types (currently only libc++ and libstdc++ are supported). Enabled when debugging C++ targets. - system: truly basic types for which a formatter is required - AppKit: Cocoa classes - CoreFoundation: CF classes @@ -1246,12 +1245,11 @@ that the search order is: - AppKit - CoreServices - CoreGraphics -- gnu-libstdc++ -- libcxx +- cplusplus - VectorTypes - system -As said, gnu-libstdc++ and libcxx contain formatters for C++ STL data types. +As said, cplusplus contain formatters for C++ STL data types. system contains formatters for char* and char[], which reflect the behavior of older versions of LLDB which had built-in formatters for these types. Because now these are formatters, you can even replace them with your own if so you diff --git a/lldb/test/API/functionalities/data-formatter/data-formatter-disabling/TestDataFormatterDisabling.py b/lldb/test/API/functionalities/data-formatter/data-formatter-disabling/TestDataFormatterDisabling.py index e4214f17fb642..20f49e02adcea 100644 --- a/lldb/test/API/functionalities/data-formatter/data-formatter-disabling/TestDataFormatterDisabling.py +++ b/lldb/test/API/functionalities/data-formatter/data-formatter-disabling/TestDataFormatterDisabling.py @@ -46,8 +46,6 @@ def cleanup(): # Execute the cleanup function during test case tear down. self.addTearDownHook(cleanup) - # self.runCmd('type category enable system VectorTypes libcxx gnu-libstdc++ CoreGraphics CoreServices AppKit CoreFoundation objc default', check=False) - self.expect( "type category list", substrs=[ _______________________________________________ lldb-commits mailing list lldb-commits@lists.llvm.org https://lists.llvm.org/cgi-bin/mailman/listinfo/lldb-commits
