bug#51288: closed (Break date SYNOPSIS into two sections)

[GNU bug Tracking System]

Your message dated Fri, 4 Feb 2022 18:25:20 -0800
with message-id <4002c706-2476-7525-4ae5-a9e89eae9939@cs.ucla.edu>
and subject line Re: bug#51288: Break date SYNOPSIS into two sections
has caused the debbugs.gnu.org bug report #51288,
regarding Break date SYNOPSIS into two sections
to be marked as done.

(If you believe you have received this mail in error, please contact
help-debbugs@gnu.org.)


-- 
51288: http://debbugs.gnu.org/cgi/bugreport.cgi?bug=51288
GNU Bug Tracking System
Contact help-debbugs@gnu.org with problems
> --- Begin Message ---
>
>
>
> Subject: 
>
> Break date SYNOPSIS into two sections
>
>
>
>
> Date: 
>
> Tue, 19 Oct 2021 21:04:11 +0800
>
>
>
>
> On the 'date' man and info pages,
>
> SYNOPSIS
>        date [OPTION]... [+FORMAT]
>        date [-u|--utc|--universal] [MMDDhhmm[[CC]YY][.ss]]
>
> Synopses:
>
>      date [OPTION]... [+FORMAT]
>      date [-u|--utc|--universal] [ MMDDhhmm[[CC]YY][.ss] ]
>
> please break these down into:
>
> printing the date:
>
>      date [OPTION]... [+FORMAT]
>
> setting the date:
>
>      date [-u|--utc|--universal] [ MMDDhhmm[[CC]YY][.ss] ]
>      date [-s|--set] DATESTR
>
> else the user in a panic to set the date, will try
> # date -s 10140110
> date: cannot set date: Invalid argument
> Mon Jan 10 00:00:00 LMT 1014
> Instead of
> $ date    10140110
>
> Only on
> (info "(coreutils) Setting the time")
> is the mystery revealed. P.S., on that page you should mention the
> MMDDhhmm... string again, not just its components.
>
>
>
> --- End Message ---

--- Begin Message --- Subject: Re: bug#51288: Break date SYNOPSIS into two sections Date: Fri, 4 Feb 2022 18:25:20 -0800 User-agent: Mozilla/5.0 (X11; Linux x86_64; rv:91.0) Gecko/20100101 Thunderbird/91.5.0 Thanks for reporting the problem. It'd be a bit of a pain to implement your suggestion exactly since the synopsis is generated automatically. However, I installed the attached to try to attack the problem of confusion that you reported.

It's been years since I set the date by hand but we might as well be clear about it, if only for nostalgia's sake.

0001-date-improve-doc.patch
Description: Text Data

--- End Message ---