v3.5.3: Zsh default completion and negated flag help fixes

A small patch release with two fixes for the generated zsh completion init and CLI help rendering.

Fixed

• zsh: preserve options for default completion (#693 by @jdx, fixes #692). The _usage_default_complete handler emitted by usage generate completion-init zsh called emulate -L zsh, which reset shell options before falling back to _files for non-usage commands. With nomatch re-enabled, zsh treated internal tags like *:globbed-files as real globs, producing errors such as no matches found: *:globbed-files when completing things like emacs <TAB>. The generated init now runs setopt localoptions nonomatch extendedglob immediately after emulate -L zsh, so the _files fallback sees the option state it expects. Re-run usage generate completion-init zsh and reload your shell to pick up the fix.

• docs: show negated flags in CLI help (#694 by @jdx). Boolean flags declared with a negate alias previously rendered only the positive form in usage CLI help output. They now render as --flag / --no-flag in both short and long help, and the help column width is calculated from the displayed usage so descriptions stay aligned:

  Flags:
    --compress / --no-compress  Compress output
    --verbose                   Verbose output
  

Full Changelog: v3.5.2...v3.5.3

💚 Sponsor usage

usage is built by @jdx at en.dev — an independent developer-tooling studio behind mise, aube, hk, and more. Work on usage is funded by sponsorships.

If usage powers CLI specs, docs, or completions for a tool you maintain or use, please consider sponsoring at en.dev. Every sponsorship helps the project stay independent and moving.