GNU bug report logs - #55401
date man page

Previous Next

To reply to this bug, email your comments to 55401 AT debbugs.gnu.org.

Toggle the display of automated, internal messages from the tracker.

Message #5 received at submit <at> debbugs.gnu.org (full text, mbox):

From: t0th <south.minds <at> gmail.com>
To: bug-coreutils <at> gnu.org
Subject: date man page
Date: Fri, 13 May 2022 16:10:44 -0300

[Message part 1 (text/plain, inline)]

Man page of date command should make explicit that -d and -r options are
mutually exclusive.

date -d -3 minutes -r tmp.txt "+%Y%m%d_%H%M"
date: the options to specify dates for printing are mutually exclusive

[Message part 2 (text/html, inline)]

Message #8 received at 55401 <at> debbugs.gnu.org (full text, mbox):

From: Pádraig Brady <P <at> draigBrady.com>
To: t0th <south.minds <at> gmail.com>, 55401 <at> debbugs.gnu.org
Subject: Re: bug#55401: date man page
Date: Sat, 14 May 2022 01:42:37 +0100

[Message part 1 (text/plain, inline)]

On 13/05/2022 20:10, t0th wrote:
> Man page of date command should make explicit that -d and -r options are
> mutually exclusive.

Right.  More accurately, we might have a sentence to say that:
"All options to specify the date to display are mutually exclusive.
I.e.: --date, --file, --reference, --resolution".
However...

> date -d -3 minutes -r tmp.txt "+%Y%m%d_%H%M"
> date: the options to specify dates for printing are mutually exclusive

As you've seen, one might expect to be able to combine, as -d can be relative.
So theoretically we could support this (with the attached),
to honor the relative adjustment, but give precedence to a non relative date.

  $ src/date -r src/ls.c -d '-3 minutes'
  Fri 15 Apr 2022 16:30:53 IST
  $ src/date -r src/ls.c -d '1/1/2022'
  Sat 01 Jan 2022 00:00:00 GMT

In fact touch(1) behaves like this, which suggests date(1) should also.
From the info docs for the touch --reference option:

 "--reference
  Use the times of the reference FILE instead of the current time.
  If this option is combined with the --date=TIME
  (-d TIME) option, the reference FILES's time is
  the origin for any relative TIMEs given, but is otherwise ignored."

BTW, one might also expect that multiple -d options might combine like this,
however currently we silently ignore multiple -d (or -s) options.
The attached also at least warns about this with --debug:

  $ date --debug -d '15/4/2022' -d '-3 minutes'
  date: discarding previous -d: ‘15/4/2022’
  date: parsed relative part: -3 minutes
  ...

cheers,
Pádraig

[date-d-r.patch (text/x-patch, attachment)]

Message #11 received at 55401 <at> debbugs.gnu.org (full text, mbox):

From: Pádraig Brady <P <at> draigBrady.com>
To: t0th <south.minds <at> gmail.com>, 55401 <at> debbugs.gnu.org
Subject: Re: bug#55401: date man page
Date: Sun, 24 Jul 2022 21:06:34 +0100

[Message part 1 (text/plain, inline)]

On 14/05/2022 01:42, Pádraig Brady wrote:
> On 13/05/2022 20:10, t0th wrote:
>> Man page of date command should make explicit that -d and -r options are
>> mutually exclusive.
> 
> Right.  More accurately, we might have a sentence to say that:
> "All options to specify the date to display are mutually exclusive.
> I.e.: --date, --file, --reference, --resolution".

I've pushed the attached 2 patches
to document the current situation at least.

cheers,
Padraig

[date-exclusive-help.patch (text/x-patch, attachment)]

[date-multiple-debug.patch (text/x-patch, attachment)]

Previous Next

GNU bug tracking system
Copyright (C) 1999 Darren O. Benham, 1997,2003 nCipher Corporation Ltd, 1994-97 Ian Jackson.