GNU bug report logs - #21809
"touch": -d option format incorrect documentation

Previous Next

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 21809 in the body.
You can then email your comments to 21809 AT debbugs.gnu.org in the normal way.

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

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

From: Rémy Fourré <remy.com <at> octave123.com>
To: bug-coreutils <at> gnu.org
Subject: "touch": -d option format incorrect documentation
Date: Sun, 1 Nov 2015 15:20:04 +0100

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

Hello,

The "touch" utility has a date option (-d).
A command such as
  touch -d 2015-10-15
works well, but the documentation (both info and man pages) calls for:
  touch -d="2015-10-15"
and this does not work.

This is just a documentation error.

Have a wonderful day.

Remy Fourre

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

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

From: Pádraig Brady <P <at> draigBrady.com>
To: Rémy Fourré <remy.com <at> octave123.com>,
 21809 <at> debbugs.gnu.org
Subject: Re: bug#21809: "touch": -d option format incorrect documentation
Date: Sun, 1 Nov 2015 18:34:31 +0000

On 01/11/15 14:20, Rémy Fourré wrote:
> Hello,
> 
> The "touch" utility has a date option (-d).
> A command such as
>   touch -d 2015-10-15
> works well, but the documentation (both info and man pages) calls for:
>   touch -d="2015-10-15"
> and this does not work.

Well not exactly.
The long format --date=.... works.
Now I do agree that the info docs have more scope for clarifying that,
and we do already for `df -T` for example:
http://www.gnu.org/software/coreutils/df

I'll patch the info docs accordingly.

thanks,
Pádraig.

Message #13 received at 21809-done <at> debbugs.gnu.org (full text, mbox):

From: Pádraig Brady <P <at> draigBrady.com>
To: Rémy Fourré <remy.com <at> octave123.com>,
 21809-done <at> debbugs.gnu.org
Subject: Re: bug#21809: "touch": -d option format incorrect documentation
Date: Sun, 1 Nov 2015 20:40:51 +0000

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

On 01/11/15 18:34, Pádraig Brady wrote:
> On 01/11/15 14:20, Rémy Fourré wrote:
>> Hello,
>>
>> The "touch" utility has a date option (-d).
>> A command such as
>>   touch -d 2015-10-15
>> works well, but the documentation (both info and man pages) calls for:
>>   touch -d="2015-10-15"
>> and this does not work.
> 
> Well not exactly.
> The long format --date=.... works.
> Now I do agree that the info docs have more scope for clarifying that,
> and we do already for `df -T` for example:
> http://www.gnu.org/software/coreutils/df
> 
> I'll patch the info docs accordingly.

There were a few more issues in this area,
which are all hopefully addressed in the attached.

thanks,
Pádraig.

[info-short-params.patch (text/x-patch, attachment)]

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

From: Bernhard Voelker <mail <at> bernhard-voelker.de>
To: 21809 <at> debbugs.gnu.org, P <at> draigBrady.com, remy.com <at> octave123.com
Subject: Re: bug#21809: "touch": -d option format incorrect documentation
Date: Mon, 2 Nov 2015 08:21:16 +0100

On 11/01/2015 09:40 PM, Pádraig Brady wrote:
> From ecf68e3e31f6794ed193d7c5c7271304b8790d79 Mon Sep 17 00:00:00 2001
> From: =?UTF-8?q?P=C3=A1draig=20Brady?= <P <at> draigBrady.com>
> Date: Sun, 1 Nov 2015 20:37:00 +0000
> Subject: [PATCH] doc: fix texinfo for short options taking a parameter
> 
> * doc/coreutils.texi: (tail invocation): Add missing -s,
> along with the existing --sleep-interval description.
> (csplit invocation): Expand --suffix to --suffix-format.
> (head invocation): Use same variable (COUNT) for -n and --head-count.
> (seq invocation): Add opindex items for all options.
> (ptx invocation): Likewise.
> Fix typo s/--flac-truncation/flag-truncation/.

Minor nit:

- Fix typo s/--flac-truncation/flag-truncation/.
+ Fix typo s/--flac-truncation/--flag-truncation/.

> (touch invocation): State explicitly that -d takes a parameter,
> which also indicates that an '=' is not to be used
> for the short option syntax.
> (ls invocation): Likewise for the -w option.
> Fixes http://bugs.gnu.org/21809

+1

Thanks & have a nice day,
Berny

Previous Next

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