homectl: rearrange --help text with sections

We support so many verbs now, help the user with some structure
This commit is contained in:
Lennart Poettering
2025-02-28 11:07:20 +01:00
parent 0e1ede4b4b
commit 2efffd036e

View File

@@ -2988,32 +2988,36 @@ static int help(int argc, char *argv[], void *userdata) {
printf("%1$s [OPTIONS...] COMMAND ...\n\n"
"%2$sCreate, manipulate or inspect home directories.%3$s\n"
"\n%4$sCommands:%5$s\n"
"\n%4$sBasic User Manipulation Commands:%5$s\n"
" list List home areas\n"
" activate USER… Activate a home area\n"
" deactivate USER… Deactivate a home area\n"
" inspect USER… Inspect a home area\n"
" authenticate USER… Authenticate a home area\n"
" create USER Create a home area\n"
" adopt PATH… Add an existing home area on this system\n"
" register PATH… Register a user record locally\n"
" unregister USER… Unregister a user record locally\n"
" remove USER… Remove a home area\n"
" update USER Update a home area\n"
" passwd USER Change password of a home area\n"
" resize USER SIZE Resize a home area\n"
" lock USER… Temporarily lock an active home area\n"
" unlock USER… Unlock a temporarily locked home area\n"
" lock-all Lock all suitable home areas\n"
" remove USER… Remove a home area\n"
"\n%4$sAdvanced User Manipulation Commands:%5$s\n"
" activate USER… Activate a home area\n"
" deactivate USER… Deactivate a home area\n"
" deactivate-all Deactivate all active home areas\n"
" rebalance Rebalance free space between home areas\n"
" with USER [COMMAND…] Run shell or command with access to a home area\n"
" firstboot Run first-boot home area creation wizard\n"
" authenticate USER… Authenticate a home area\n"
"\n%4$sUser Migration Commands:%5$s\n"
" adopt PATH… Add an existing home area on this system\n"
" register PATH… Register a user record locally\n"
" unregister USER… Unregister a user record locally\n"
"\n%4$sSigning Keys Commands:%5$s\n"
" list-signing-keys List home signing keys\n"
" get-signing-key [NAME…] Get a named home signing key\n"
" add-signing-key FILE… Add home signing key\n"
" remove-signing-key NAME… Remove home signing key\n"
"\n%4$sLock/Unlock Commands:%5$s\n"
" lock USER… Temporarily lock an active home area\n"
" unlock USER… Unlock a temporarily locked home area\n"
" lock-all Lock all suitable home areas\n"
"\n%4$sOther Commands:%5$s\n"
" rebalance Rebalance free space between home areas\n"
" firstboot Run first-boot home area creation wizard\n"
"\n%4$sOptions:%5$s\n"
" -h --help Show this help\n"
" --version Show package version\n"