summaryrefslogtreecommitdiffstats
path: root/RELEASE.txt
diff options
context:
space:
mode:
authorMats Wichmann <mats@linux.com>2024-07-12 14:22:20 (GMT)
committerMats Wichmann <mats@linux.com>2024-07-12 23:02:23 (GMT)
commitcfe50b5e406226aeaff4a0027a8fdd2b9634273a (patch)
tree7470e2a190ceeffafe148d85973080ca961eb0c7 /RELEASE.txt
parentb4260a7a82fd31ebdc2445c03e69e10b71bbfe70 (diff)
downloadSCons-cfe50b5e406226aeaff4a0027a8fdd2b9634273a.zip
SCons-cfe50b5e406226aeaff4a0027a8fdd2b9634273a.tar.gz
SCons-cfe50b5e406226aeaff4a0027a8fdd2b9634273a.tar.bz2
Enhancement: Dump() takes multiple args now
env.Dump previously either printed the whole dict of construction variables (with no args), or a single value (with one variable name argument). Now it takes a varargs specifier so you can give any number of consvar names. All returned strings are now in dict form, including the single-arg case which previously just returned the value matching the key, not a dict with a key:value pair. This is a slight ABI change, but should not affect any actual scripts since the output is intended for human consumption, not for programmatic use - env.Dictionary() can be used to fetch construction vars for programmatic use (in fact, Dump is a consumer of Dictionary's output). Signed-off-by: Mats Wichmann <mats@linux.com>
Diffstat (limited to 'RELEASE.txt')
-rw-r--r--RELEASE.txt15
1 files changed, 11 insertions, 4 deletions
diff --git a/RELEASE.txt b/RELEASE.txt
index 5845e56..b29ecbd 100644
--- a/RELEASE.txt
+++ b/RELEASE.txt
@@ -26,8 +26,15 @@ DEPRECATED FUNCTIONALITY
CHANGED/ENHANCED EXISTING FUNCTIONALITY
---------------------------------------
-- List modifications to existing features, where the previous behavior
- wouldn't actually be considered a bug
+- env.Dump() previously accepted a single optional "key" argument.
+ It now accepts any number of optional "key" arguments; any supplied
+ keys will be serialized with their values in a Python dict style.
+ As a result there is a small change in behavior: if a *single* key
+ argument is given, where it previously would return a string containing
+ just the value, now it will return a string that looks like a dictionary
+ including the key. For example, from "'gcc'" to "{'CC': 'gcc'}".
+ This should not have any impact as the result of calling Dump is
+ intended for diagnostic output, not for use by other interfaces.
FIXES
-----
@@ -38,8 +45,8 @@ IMPROVEMENTS
------------
- List improvements that wouldn't be visible to the user in the
- documentation: performance improvements (describe the circumstances
- under which they would be observed), or major code cleanups
+documentation: performance improvements (describe the circumstances
+under which they would be observed), or major code cleanups
PACKAGING
---------