bug#8782: date command

[Jim Meyering]

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 <address@hidden>

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