GNU bug report logs - #50323
27.2; dired-do-touch documentation improvement

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 50323 in the body.
You can then email your comments to 50323 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: joshua <at> joshuao.com
To: bug-gnu-emacs <at> gnu.org
Subject: 27.2; dired-do-touch documentation improvement
Date: Wed, 01 Sep 2021 13:30:23 +0100

In section 30.7 of the emacs manual the line about dired-do-touch
doesn't really reflect what the function does (dired-do-touch doesn't
change the time to the present time, but rather to the timestamp given,
which by default is the modification time of the file)

"Touch the specified files (dired-do-touch). This means updating their
modification times to the present time. This is like the shell command
touch."

Rather, to fit in with the other lines I'd reccomend

"Touch the specified files (dired-do-touch). This means updating their
modification times to /timestamp/. This is like the shell command
touch."


Would just send a patch, but can't be bothered working out how to
contribute, apologies!

Joshua

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

From: Lars Ingebrigtsen <larsi <at> gnus.org>
To: joshua <at> joshuao.com
Cc: 50323 <at> debbugs.gnu.org
Subject: Re: bug#50323: 27.2; dired-do-touch documentation improvement
Date: Thu, 02 Sep 2021 09:49:22 +0200

joshua <at> joshuao.com writes:

> Rather, to fit in with the other lines I'd reccomend
>
> "Touch the specified files (dired-do-touch). This means updating their
> modification times to /timestamp/. This is like the shell command
> touch."

Thanks; now updated to this in Emacs 28.

-- 
(domestic pets only, the antidote for overdose, milk.)
   bloggy blog: http://lars.ingebrigtsen.no

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

From: Juri Linkov <juri <at> linkov.net>
To: Lars Ingebrigtsen <larsi <at> gnus.org>
Cc: joshua <at> joshuao.com, 50323 <at> debbugs.gnu.org
Subject: Re: bug#50323: 27.2; dired-do-touch documentation improvement
Date: Thu, 02 Sep 2021 18:52:52 +0300

>> Rather, to fit in with the other lines I'd reccomend
>>
>> "Touch the specified files (dired-do-touch). This means updating their
>> modification times to /timestamp/. This is like the shell command
>> touch."
>
> Thanks; now updated to this in Emacs 28.

It seems the original text tried to say that dired-do-touch
defaults to the present time when RET is typed in the minibuffer,
and indeed it prompt says " (default now): ".

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

From: Lars Ingebrigtsen <larsi <at> gnus.org>
To: Juri Linkov <juri <at> linkov.net>
Cc: joshua <at> joshuao.com, 50323 <at> debbugs.gnu.org
Subject: Re: bug#50323: 27.2; dired-do-touch documentation improvement
Date: Thu, 02 Sep 2021 18:03:34 +0200

Juri Linkov <juri <at> linkov.net> writes:

> It seems the original text tried to say that dired-do-touch
> defaults to the present time when RET is typed in the minibuffer,
> and indeed it prompt says " (default now): ".

Yes, but I don't think that has to be stated in the Emacs manual -- it's
obvious enough when you execute the command.

-- 
(domestic pets only, the antidote for overdose, milk.)
   bloggy blog: http://lars.ingebrigtsen.no

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

From: Eli Zaretskii <eliz <at> gnu.org>
To: Juri Linkov <juri <at> linkov.net>
Cc: joshua <at> joshuao.com, larsi <at> gnus.org, 50323 <at> debbugs.gnu.org
Subject: Re: bug#50323: 27.2; dired-do-touch documentation improvement
Date: Thu, 02 Sep 2021 19:08:14 +0300

> From: Juri Linkov <juri <at> linkov.net>
> Date: Thu, 02 Sep 2021 18:52:52 +0300
> Cc: joshua <at> joshuao.com, 50323 <at> debbugs.gnu.org
> 
> >> "Touch the specified files (dired-do-touch). This means updating their
> >> modification times to /timestamp/. This is like the shell command
> >> touch."
> >
> > Thanks; now updated to this in Emacs 28.
> 
> It seems the original text tried to say that dired-do-touch
> defaults to the present time when RET is typed in the minibuffer,
> and indeed it prompt says " (default now): ".

Thanks, fixed.

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

From: "Joshua O'Connor" <joshua <at> joshuao.com>
To: Juri Linkov <juri <at> linkov.net>, Lars Ingebrigtsen <larsi <at> gnus.org>
Cc: 50323 <at> debbugs.gnu.org
Subject: Re: bug#50323: 27.2; dired-do-touch documentation improvement
Date: Fri, 03 Sep 2021 11:51:52 +0100

Juri Linkov <juri <at> linkov.net> writes:

> It seems the original text tried to say that dired-do-touch
> defaults to the present time when RET is typed in the minibuffer,
> and indeed it prompt says " (default now): ".

Ah, perhaps I have some configuration difference then.
For me the prompt says " (default ORIGINAL_TIMESTAMP) ", which I just
assumed was the default behaviour.

Previous Next

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