btrfs-progs: help: print multiple syntax schemas on separate lines
authorDavid Sterba <dsterba@suse.com>
Tue, 17 Oct 2017 17:39:47 +0000 (19:39 +0200)
committerDavid Sterba <dsterba@suse.com>
Tue, 14 Nov 2017 14:59:00 +0000 (15:59 +0100)
The help string for some commands could be split to more lines for
clarity, eg. as is now in the receive command. The 'btrfs help' listing
should indent all the lines properly, similar the command specific
help with "usage:'.

The syntax of the first help string line is to separate all command
usage schemas by "\n".

Signed-off-by: David Sterba <dsterba@suse.com>
help.c

diff --git a/help.c b/help.c
index 99097db..311a432 100644 (file)
--- a/help.c
+++ b/help.c
@@ -128,12 +128,32 @@ static int do_usage_one_command(const char * const *usagestr,
                                unsigned int flags, FILE *outf)
 {
        int pad = 4;
+       const char *prefix = "usage: ";
+       const char *pad_listing = "    ";
 
        if (!usagestr || !*usagestr)
                return -1;
 
-       fprintf(outf, "%s%s", (flags & USAGE_LISTING) ? "    " : "usage: ",
-               *usagestr++);
+       if (flags & USAGE_LISTING)
+               prefix = pad_listing;
+
+       fputs(prefix, outf);
+       if (strchr(*usagestr, '\n') == NULL) {
+               fputs(*usagestr, outf);
+       } else {
+               const char *c = *usagestr;
+               const char *nprefix = "       ";
+
+               if (flags & USAGE_LISTING)
+                       nprefix = pad_listing;
+
+               for (c = *usagestr; *c; c++) {
+                       fputc(*c, outf);
+                       if (*c == '\n')
+                               fputs(nprefix, outf);
+               }
+       }
+       usagestr++;
 
        /* a short one-line description (mandatory) */
        if ((flags & USAGE_SHORT) == 0)