|
| 1 | +If you are reading this in the git repository, the contents |
| 2 | +refer to *unreleased* changes since the last SCons release. |
| 3 | +Past official release announcements appear at: |
1 | 4 |
|
2 |
| -A new SCons release, 4.8.1, is now available on the SCons download page: |
| 5 | + https://scons.org/tag/releases.html |
| 6 | + |
| 7 | +================================================================== |
| 8 | + |
| 9 | +A new SCons release, 4.4.1, is now available on the SCons download page: |
3 | 10 |
|
4 | 11 | https://scons.org/pages/download.html
|
5 | 12 |
|
6 | 13 |
|
7 |
| -Here is a summary of the changes since 4.8.0: |
| 14 | +Here is a summary of the changes since 4.4.0: |
| 15 | + |
| 16 | +NEW FUNCTIONALITY |
| 17 | +----------------- |
| 18 | + |
| 19 | +- List new features (presumably why a checkpoint is being released) |
| 20 | + |
| 21 | +DEPRECATED FUNCTIONALITY |
| 22 | +------------------------ |
8 | 23 |
|
| 24 | +- List anything that's been deprecated since the last release |
9 | 25 |
|
10 | 26 | CHANGED/ENHANCED EXISTING FUNCTIONALITY
|
11 | 27 | ---------------------------------------
|
12 | 28 |
|
13 |
| -- env.Dump() previously accepted a single optional "key" argument. |
14 |
| - It now accepts any number of optional "key" arguments; any supplied |
15 |
| - keys will be serialized with their values in a Python dict style. |
16 |
| - As a result there is a small change in behavior: if a *single* key |
17 |
| - argument is given, where it previously would return a string containing |
18 |
| - just the value, now it will return a string that looks like a dictionary |
19 |
| - including the key. For example, from "'gcc'" to "{'CC': 'gcc'}". |
20 |
| - This should not have any impact as the result of calling Dump is |
21 |
| - intended for diagnostic output, not for use by other interfaces. |
| 29 | +- List modifications to existing features, where the previous behavior |
| 30 | + wouldn't actually be considered a bug |
22 | 31 |
|
23 | 32 | FIXES
|
24 | 33 | -----
|
25 | 34 |
|
26 |
| -- SCons 4.8.0 added an `__all__` specifier at the top of the Variables |
27 |
| - module (`Variables/__init__.py`) to control what is made available in |
28 |
| - a star import. However, there was existing usage of doing |
29 |
| - `from SCons.Variables import *` which expected the variable *types* |
30 |
| - to be avaiable. `BoolVariable`, `EnumVariable`, `ListVariable`, |
31 |
| - `PackageVariable` and `PathVariable` are added to `__all__`, |
32 |
| - so this form of import should now work again. |
33 |
| -- Fix a problem with AppendUnique and PrependUnique where a value could |
34 |
| - be erroneously removed due to a substring match. |
35 |
| -- Fix handling of ListVariable when supplying a quoted choice containing |
36 |
| - a space character (issue #4585). |
37 |
| - |
38 |
| -- On win32 platform, SCons 4.7.0 modified the determination |
39 |
| - of the output encoding of piped processes. Instead of using the default |
40 |
| - encoding, it relied on the encoding attribute of the output stream. |
41 |
| - If the encoding attribute of the output stream was set to None, |
42 |
| - it was triggering an invalid argument exception. This was the case with |
43 |
| - streams of type io.StringIO for example. |
44 |
| - This has been changed to always use the `oem` encoding which should be the |
45 |
| - encoding in the shell where the command was spawned. |
| 35 | +- List fixes of outright bugs |
46 | 36 |
|
| 37 | +IMPROVEMENTS |
| 38 | +------------ |
| 39 | + |
| 40 | +- List improvements that wouldn't be visible to the user in the |
| 41 | + documentation: performance improvements (describe the circumstances |
| 42 | + under which they would be observed), or major code cleanups |
| 43 | + |
| 44 | +PACKAGING |
| 45 | +--------- |
| 46 | + |
| 47 | +- List changes in the way SCons is packaged and/or released |
47 | 48 |
|
48 | 49 | DOCUMENTATION
|
49 | 50 | -------------
|
50 | 51 |
|
51 |
| -- Improve wording of manpage "Functions and Environment Methods" section. |
52 |
| -- Make doc function signature style more consistent - tweaks to AddOption, |
53 |
| - DefaultEnvironment and Tool,. |
54 |
| - |
| 52 | +- List any significant changes to the documentation (not individual |
| 53 | + typo fixes, even if they're mentioned in src/CHANGES.txt to give |
| 54 | + the contributor credit) |
55 | 55 |
|
56 | 56 | DEVELOPMENT
|
57 | 57 | -----------
|
58 | 58 |
|
59 |
| -- sctypes `is_*` functions given explicit return types. Python 3.13+ uses |
60 |
| - `TypeIs` for a near-equivalent of `isinstance`. Python 3.10 through 3.12 |
61 |
| - uses `TypeGuard`, a less accurate implementation but still provides |
62 |
| - usable type hinting. Python 3.9 and earlier simply returns `bool`, same |
63 |
| - as before. |
| 59 | +- List visible changes in the way SCons is developed |
64 | 60 |
|
65 | 61 | Thanks to the following contributors listed below for their contributions to this release.
|
66 | 62 | ==========================================================================================
|
67 | 63 | .. code-block:: text
|
68 | 64 |
|
69 |
| - git shortlog --no-merges -ns 4.8.0..HEAD |
70 |
| - |
71 |
| - 9 Mats Wichmann |
72 |
| - 8 William Deegan |
73 |
| - 1 SIEGRIST Anthony |
74 |
| - 1 Thaddeus Crews |
75 |
| - 1 siegria |
| 65 | + git shortlog --no-merges -ns 4.0.1..HEAD |
0 commit comments