From 305c7e95a1d3f06a5387b176a8c83e6df0566530 Mon Sep 17 00:00:00 2001 From: Paul Cristian Sarbu Date: Tue, 25 Mar 2025 13:51:31 +0100 Subject: rules CC proto: Update docstring for DEBUG variable ...to reflect the value change from boolean to map. Behavior of the proto rules remains the same, as only the truth value of the variable is currently being taken into account. --- CC/proto/RULES | 18 +++++++++++++++++- 1 file changed, 17 insertions(+), 1 deletion(-) (limited to 'CC/proto/RULES') diff --git a/CC/proto/RULES b/CC/proto/RULES index 07b2dad..dc9d66c 100644 --- a/CC/proto/RULES +++ b/CC/proto/RULES @@ -76,7 +76,23 @@ ] , "HOST_ARCH": ["The architecture on which the build actions are carried out."] - , "DEBUG": ["Compute the debug-stage, needed for local debugging."] + , "DEBUG": + [ "Map configuring the debug-stage, needed for local debugging." + , "If non-empty, debug mode is enabled." + , "" + , "The key \"USE_DEBUG_FISSION\" expects a flag which enables debug" + , "fission, but does not add any flags. Explicitly setting it to a false" + , "value is needed to enable regular debug mode." + , "The key \"FISSION_CONFIG\" expects a map configuring debug fission." + , " - subkey \"USE_SPLIT_DWARF\" expects a flag that, if true, adds the" + , "-gsplit-dwarf compile flag." + , " - subkey \"DWARF_VERSION\" expects a string that adds the" + , "-gdwarf- compile flag." + , " - subkey \"USE_GDB_INDEX\" expects a flag that, if true, adds the" + , "-Wl,--gdb-index linker flag." + , " - subkey \"USE_DEBUG_TYPES_SECTION\" expects a flag that, if true," + , "adds the -fdebug-types-section compile flag." + ] } , "imports": { "base-provides": ["./", "..", "defaults-base-provides"] -- cgit v1.2.3