Skip to content

v0.41.0

Pre-release
Pre-release

Choose a tag to compare

@Fade78 Fade78 released this 19 Aug 13:07
· 194 commits to main since this release
1417588

The old command spellings are gone

Eight names from before the CLI was reorganised are no longer commands:

Retired What to type
install init
check verify
refresh-templates template update
themes theme list
theme-info theme show <slug> for the catalogue, series theme [dir] for a series
set-theme series theme set
themes-gallery theme gallery
series-info status

They were deprecated aliases: each printed a [WARNING] and then did the work. That teaches the old spelling as readily as the new one, and the shell completion is where it showed — install was offered beside init, check beside verify, with nothing in the list to say which of the pair was the one to learn. A command that works after complaining is a command people keep typing.

They are refused, not unknown. Typing one is an error that names the form to use. An unknown token prints the whole help and leaves you to find the word; this hands it over. Nothing runs — install used to scaffold a whole series before its warning was read.

They are also gone from the completion, from --help, from the README and from the specification.

theme show <directory> goes with them

It was the last surviving shape of theme-info, the one verb that read both the catalogue and a series. Those are not the same question, and the refusal names series theme <directory>.

theme show with no argument, standing inside a series, still reads that series — that is not the inherited form, it is the habit build, verify, audit, status and clean all keep.

If you have scripts

Run them once. Any line using a retired spelling stops with a message naming its replacement, so the change is a word per line and the tool tells you which word. A .gitlab-ci.yml written by init has never used these names.