summaryrefslogtreecommitdiff
path: root/CC
diff options
context:
space:
mode:
Diffstat (limited to 'CC')
-rw-r--r--CC/proto/RULES18
1 files changed, 17 insertions, 1 deletions
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-<value> 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"]