From a8dbf0e8c55a1039839849de9d05475eb2f18d79 Mon Sep 17 00:00:00 2001
From: Paul Cristian Sarbu <paul.cristian.sarbu@huawei.com>
Date: Tue, 25 Mar 2025 13:57:10 +0100
Subject: target just: Update flexible_config list and docstrings

Add the DWP variable to list of flexible_config. Also update the
documentation of the DEBUG variable.

While there, also fix a typo.
---
 TARGETS | 22 ++++++++++++++++++++--
 1 file changed, 20 insertions(+), 2 deletions(-)

(limited to 'TARGETS')

diff --git a/TARGETS b/TARGETS
index f2cd21f9..d8e88d8c 100644
--- a/TARGETS
+++ b/TARGETS
@@ -6,6 +6,7 @@
     [ "ADD_CFLAGS"
     , "ADD_CXXFLAGS"
     , "AR"
+    , "DWP"
     , "ARCH"
     , "FINAL_LDFLAGS"
     , "CC"
@@ -43,11 +44,26 @@
       , "statically linked. Boolean, default false."
       ]
     , "ENV":
-      [ "Map from strings to strings. The build environment ot be used for"
+      [ "Map from strings to strings. The build environment to be used for"
       , "build actions. Typically used to include an unusual value of PATH."
       ]
     , "FINAL_LDFLAGS": ["Compiler flags for linking the final binary."]
-    , "DEBUG": ["Boolean, default false. Whether to build a debug version."]
+    , "DEBUG":
+      [ "Map enabling and configuring the debug version."
+      , ""
+      , "The key \"USE_DEBUG_FISSION\" 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."
+      ]
     , "OS":
       [ "Operating system to build for."
       , ""
@@ -83,6 +99,7 @@
     , "ADD_CXXFLAGS"
     , "ADD_CFLAGS"
     , "AR"
+    , "DWP"
     , "ENV"
     , "FINAL_LDFLAGS"
     , "SOURCE_DATE_EPOCH"
@@ -133,6 +150,7 @@
     , "ADD_CXXFLAGS"
     , "ADD_CFLAGS"
     , "AR"
+    , "DWP"
     , "ENV"
     , "FINAL_LDFLAGS"
     , "SOURCE_DATE_EPOCH"
-- 
cgit v1.2.3