From 920995698df14de2fdf8916d5781bf0c0c382bee 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. --- rules/CC/proto/RULES | 18 +++++++++++++++++- 1 file changed, 17 insertions(+), 1 deletion(-) (limited to 'rules') diff --git a/rules/CC/proto/RULES b/rules/CC/proto/RULES index 07b2dad8..dc9d66cf 100644 --- a/rules/CC/proto/RULES +++ b/rules/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