From: Lennart Poettering <lennart@poettering.net>
Date: Fri, 28 Feb 2025 10:07:20 +0000 (+0100)
Subject: homectl: rearrange --help text with sections
X-Git-Tag: v258-rc1~1143^2~2
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=2efffd036e6ebbb95f9f47eb5cfe32787235b371;p=thirdparty%2Fsystemd.git

homectl: rearrange --help text with sections

We support so many verbs now, help the user with some structure
---

diff --git a/src/home/homectl.c b/src/home/homectl.c
index e51a39c470b..291ce8eaf17 100644
--- a/src/home/homectl.c
+++ b/src/home/homectl.c
@@ -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"