ericonr
/
util-linux
mirror of https://github.com/ericonr/util-linux.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

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 <kzak@redhat.com>
Signed-off-by: J William Piggott <elseifthen@gmx.com>
This commit is contained in:
J William Piggott 2017-06-17 15:32:28 -04:00
parent 7d9a866d1b
commit 513bfbefa2
3 changed files with 5 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

3
Documentation/boilerplate.c
View File

@ -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[=<arg>] option argument is optional\n"), out);

1
include/c.h
View File

@ -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")

3
sys-utils/hwclock.c
View File

@ -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);