CTAN update: expltools

Vít Starý Novotný submitted an update to the

                     expltools

package.

Version:  2026-03-04
License:  lppl1.3c gpl2+

Summary description:  Development tools for expl3 programmers

Announcement text:
----------------------------------------------------------------------
 
 ## expltools 2026-03-04

 ### explcheck v0.18.0

 #### Enhancements

 This version of explcheck has made the following new enhancements:

 - In human-readable output, mention that further issues may be reported after
   fixing the current errors after we have failed fast. (reported by @dbitouze
   and @muzimuzhi in #170 and #171, fixed in #175)

 - Add more support for flow analysis. (#176)

   This adds support for the following issues from Section 5.1 of the document
   titled [_Warnings and errors for the expl3 analysis tool_][warnings-and-errors]:

    1. E505 (Calling an undefined function)

   Flow analysis is now enabled by default for all package files with at least 95%
   code understanding.

 - In issue W419 (Using an undeclared variable or constant), also report
   undeclared usages through `V`- and `v`-type arguments. (#176)

 - Support the plain TeX `\newtoks` command and the corresponding deprecated
   expl3 function `\toks_new:N`. (#176)

 - Support separate command-line options `--long-option value` in addition to
   `--long-option=value`. (contributed by @muzimuzhi in #178)

 - Deprecate the command-line options `--group-files={true|false|auto}` and
   `--make-at-letter={true|false|auto}`. Add the valueless options
   `--make-at-letter`, `--make-at-other`, `--group-files`, and
   `--no-group-files`. (#178)

   The expected usage is now as follows:

   - `--make-at-letter` instead of `--make-at-letter=true`
   - `--make-at-other` instead of `--make-at-letter=false`
   - `--group-files` instead of `--group-files=true`
   - `--no-group-files` instead of `--group-files=false`
   - no option instead of `--make-at-letter=auto` and `--group-files=auto` (default)

   The deprecated options are scheduled for removal in version 1.0.0.

 #### Code understanding

 This version of explcheck introduces the following changes to code understanding
 and to how it evaluates its own level of confidence:

 - Add support for `\cs_undefine:N`. (#176)
 - Treat simple constant and variable definitions, as well as message texts, as
   well-understood. (#176)
 - Consider `FUNCTION_CALL` statements high-confidence and well-understood only
   if there are no potential low-confidence definitions of the called control
   function. (#176)

 These changes have had a mixed effect on the [code coverage][]. Overall, it has
 remained mostly stable, but coverage on the current TeX Live 2025 snapshot
 (2026-02-19) now rounds to 19%, down from the previous 20%.

  [code coverage]: https://witiko.github.io/Expl3-Linter-11/#code-coverage

 #### Fixes

 This version of explcheck has fixed the following bugs:

 - Fix an integer overflow in function `format_pathname()`. (reported by
   @muzimuzhi in #163, fixed in 776eb72)
 - Fix a failure to load TOML files whose last line is a comment without
   a trailing newline. (reported by @Chipsterjulien in jonstoler/lua-toml#27
   and by @muzimuzhi in #165, fixed in #166)
 - Record control sequence name usage and definitions in unanalyzed arguments.
   (reported by @dbitouze in #170 and #173, fixed in #174)
 - Do not produce warning S204 (Missing stylistic whitespaces) for repeated
   begin group (`{{`) or end group (`}}`). (discovered in witiko/markdown#623,
   fixed in #177)

 #### Documentation

 This version of explcheck has made the following improvements to the documentation:

 - Document that `% noqa` at the top of a file silences issues everywhere.
   (f1528f1)

 #### Continuous integration

 This version of explcheck has made the following changes to our continuous
 integration:

 - Run LuaLS even if Luacheck failed. (95f71a1)
 - Run one additional process to reduce the problem of idle CPUs near the end
   while one worker grinds a difficult task. (#174, 19ceb45)
 - Increase the time limit for running explcheck over the entire TeX Live
   from 3 to 5 minutes. (#176)
 - Migrate from `TeX-Live/setup-texlive-action@v3` to `zauguin/install-texlive@v4`.
   (drafted by @koppor in koppor#1 and independently suggested by @muzimuzhi and
   @gucci-on-fleek in #178, added in #181)
 - Bump `actions/upload-artifact` from 6 to 7. (contributed by @dependabot in #179)
 - Bump `actions/download-artifact` from 7 to 8. (contributed by @dependabot in #180)

----------------------------------------------------------------------

The package’s Catalogue entry can be viewed at
   https://ctan.org/pkg/expltools

The package’s files themselves can be inspected at
   https://mirrors.ctan.org/support/expltools/

------------------------------------------------------------------------

   Thanks for the upload.

     For the CTAN Team
    Petra Rübe-Pugliese

------------------------------------------------------------------------

CTAN is run entirely by volunteers and supported by TeX user groups.
Please join a user group or donate to one, see https://ctan.org/lugs
_______________________________________________
ctan-ann mailing list -- [email protected]
To unsubscribe send an email to [email protected]