Pádraig Brady wrote: > I'm going with these 3. > It's a bit tricky to align --help and man output, > but this isn't too bad I think.
Thanks. > Subject: [PATCH] doc: add examples to date --help > > * src/date.c (usage): Add examples for TZ handling, > and "seconds since epoch" parsing, neither of which > were mentioned in the man page until now. s/were/was/ > Suggested-by: Rick Stanley <[email protected]> Usually, I prefer to list only names in the commit log, leaving the name-to-email mapping to THANKS.in, since a few contributors have requested that no email address be used or that a different one be substituted. If it's in a vc'd file like THANKS.in we can adjust it. Sometimes I'm impatient or lazy, and put the email address in the log. No big deal either way. > --- > src/date.c | 12 ++++++++++++ > 1 files changed, 12 insertions(+), 0 deletions(-) > > diff --git a/src/date.c b/src/date.c > index 61d4818..6439d16 100644 > --- a/src/date.c > +++ b/src/date.c > @@ -236,6 +236,18 @@ then an optional modifier, which is either\n\ > E to use the locale's alternate representations if available, or\n\ > O to use the locale's alternate numeric symbols if available.\n\ > "), stdout); > + fputs (_("\ > +\n\ > +Examples:\n\ > +Convert seconds since the epoch (1970-01-01 UTC) to a date\n\ > + $ date --date='@2147483647'\n\ > +\n\ > +Show the time on the west coast of the US (use tzselect(1) to find TZ)\n\ > + $ TZ='America/Los_Angeles' date\n\ > +\n\ > +Show the local time for 9AM next Friday on the west coast of the US\n\ > + $ date --date='TZ=\"America/Los_Angeles\" 09:00 next Fri'\n\ > +"), stdout); > emit_ancillary_info (); > } > exit (status);
