Skip to content

Commit fb86fb9

Browse files
authored
Update CHANGELOG.md for 2.16.0
1 parent 1d24865 commit fb86fb9

File tree

1 file changed

+48
-3
lines changed

1 file changed

+48
-3
lines changed

CHANGELOG.md

Lines changed: 48 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,52 @@
1616
checklist for a CLI release, you can edit here. But then
1717
you know what to do).
1818
-->
19+
## Release 2.16.0 (2024-01-16)
20+
21+
### New Features
22+
23+
- Users specifying extra tracing configurations may now use the `GetRegisteredMatchers(languageId)` Lua function to retrieve the existing table of matchers registered to a given language.
24+
25+
### Improvements
26+
27+
- The `Experimental` flag has been removed from all packaging and related commands.
28+
- The RA pretty-printer omits names of internal RA nodes and pretty-prints
29+
binary unions with nested internal unions as n-ary unions. VS Code extension
30+
v1.11.0 or newer is required to compute join order badness metrics in VS Code
31+
for the new RA format.
32+
33+
34+
### Potentially breaking changes
35+
36+
- The Python extractor will no longer extract dependencies by default. See https://github.blog/changelog/2023-07-12-code-scanning-with-codeql-no-longer-installs-python-dependencies-automatically-for-new-users/ for more context. In versions until 2.17.0, it will be possible to restore the old behavior by setting `CODEQL_EXTRACTOR_PYTHON_FORCE_ENABLE_LIBRARY_EXTRACTION_UNTIL_2_17_0=1`.
37+
- The `--ram` option to `codeql database run-queries` and other
38+
commands that execute queries is now interpreted more strictly.
39+
Previously it was mostly a rough hint for how much memory to use,
40+
and the actual memory footprint of the CodeQL process could be
41+
hundreds of megabytes higher. From this release, CodeQL tries harder
42+
to keep its _total_ memory consumption during evaluation below the
43+
given limit.
44+
45+
The new behavior yields more predictable memory use, but since it
46+
works by allocating less RAM, it can lead to more use of _disk_
47+
storage for intermediate results compared to earlier releases with
48+
the same `--ram` value, and consequently a slight performance
49+
loss. In rare cases, for large databases, analysis may fail with a
50+
Java `OutOfMemoryError`.
51+
52+
The cure for this is to increase `--ram` to be closer to the amount
53+
of memory actually available for CodeQL. As a rule of thumb, it will
54+
usually be possible to increase the value of `--ram` by 700 MB or
55+
more, without actually using more resources than release 2.15.x
56+
would with the old setting. An exact amount cannot stated, however,
57+
since the actual memory footprint in earlier releases depended on
58+
factors such as the size of the databases that were not fully taken
59+
into account.
60+
61+
If you use the CodeQL Action, you do not need to do anything unless
62+
you have manually overridden the Action's RAM setting. The Action
63+
will automatically select a `--ram` setting that matches the version
64+
of the CLI it uses.
1965

2066
## Release 2.15.5 (2023-12-20)
2167

@@ -33,7 +79,7 @@
3379

3480
- Fixed an issue where CodeQL would sometimes incorrectly report that no files
3581
were scanned when running on Windows.
36-
This affected the human-readable summary produced by `codeql database analyze`
82+
This affected the human-readable summary produced by `codeql database analyze`
3783
and `codeql database interpret-results`, but did not impact the file coverage
3884
information produced in the SARIF output and displayed on the tool status page.
3985
- When analyzing Swift codebases, CodeQL build tracing will now ignore the
@@ -44,8 +90,7 @@
4490

4591
### New features
4692

47-
- Java 21 is now fully supported, including support for new language features such as
48-
pattern switches and record patterns.
93+
- Java 21 is now fully supported, including support for new language features such as pattern switches and record patterns.
4994

5095
### Improvements
5196

0 commit comments

Comments
 (0)