From 513bfbefa29d28b086087e2c7b7b13dd37128ae0 Mon Sep 17 00:00:00 2001 From: J William Piggott Date: Sat, 17 Jun 2017 15:32:28 -0400 Subject: [PATCH] hwclock: add usage() functions heading Make a functions heading, similar to the existing options heading. * include/c.h: define USAGE_FUNCTIONS * Documentation/boilerplate.c: add USAGE_FUNCTIONS * sys-utils/hwclock.c add functions header to usage() Reviewed-by: Karel Zak Signed-off-by: J William Piggott --- Documentation/boilerplate.c | 3 +++ include/c.h | 1 + sys-utils/hwclock.c | 3 +-- 3 files changed, 5 insertions(+), 2 deletions(-) diff --git a/Documentation/boilerplate.c b/Documentation/boilerplate.c index 7da9374d47..057893bfb3 100644 --- a/Documentation/boilerplate.c +++ b/Documentation/boilerplate.c @@ -33,6 +33,9 @@ static void __attribute__((__noreturn__)) usage(FILE *out) { fputs(USAGE_HEADER, out); fprintf(out, _(" %s [options] file...\n"), program_invocation_short_name); + fputs(USAGE_FUNCTIONS, out); + fputs(_(" -s, --do-something some specific task\n"), out); + fputs(_(" -o, --do-other some different task\n"), out); fputs(USAGE_OPTIONS, out); fputs(_(" -n, --no-argument option does not use argument\n"), out); fputs(_(" --optional[=] option argument is optional\n"), out); diff --git a/include/c.h b/include/c.h index a5162b9640..b9369c1a85 100644 --- a/include/c.h +++ b/include/c.h @@ -317,6 +317,7 @@ static inline int xusleep(useconds_t usec) */ #define USAGE_HEADER _("\nUsage:\n") #define USAGE_OPTIONS _("\nOptions:\n") +#define USAGE_FUNCTIONS _("\nFunctions:\n") #define USAGE_SEPARATOR "\n" #define USAGE_HELP _(" -h, --help display this help and exit\n") #define USAGE_VERSION _(" -V, --version output version information and exit\n") diff --git a/sys-utils/hwclock.c b/sys-utils/hwclock.c index 28655b0b9a..9d6bb11c07 100644 --- a/sys-utils/hwclock.c +++ b/sys-utils/hwclock.c @@ -1208,8 +1208,7 @@ usage(const struct hwclock_control *ctl, FILE *out) fputs(USAGE_SEPARATOR, out); fputs(_(" Query or set the hardware clock\n"), out); - fputs(USAGE_SEPARATOR, out); - fputs(_("Functions:\n"), out); + fputs(USAGE_FUNCTIONS, out); fputs(_(" -r, --show read hardware clock and print result\n" " --get read hardware clock and print drift corrected result\n" " --set set the RTC to the time given with --date\n"), out); -- 2.47.3