GNU bug report logs - #77650
30.1; strange docstring for dired-do-touch

Please note: This is a static page, with minimal formatting, updated once a day.
Click here to see this page with the latest information and nicer formatting.

Package: emacs; Severity: minor; Reported by: Francesco Potortì <pot@HIDDEN>; Done: Eli Zaretskii <eliz@HIDDEN>; Maintainer for emacs is bug-gnu-emacs@HIDDEN.

Message received at 77650-done <at> debbugs.gnu.org:


Received: (at 77650-done) by debbugs.gnu.org; 9 Apr 2025 11:28:11 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Wed Apr 09 07:28:11 2025
Received: from localhost ([127.0.0.1]:38001 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1u2TbG-0004oW-Sm
	for submit <at> debbugs.gnu.org; Wed, 09 Apr 2025 07:28:11 -0400
Received: from eggs.gnu.org ([2001:470:142:3::10]:39644)
 by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.84_2) (envelope-from <eliz@HIDDEN>) id 1u2TbE-0004nk-N4
 for 77650-done <at> debbugs.gnu.org; Wed, 09 Apr 2025 07:28:09 -0400
Received: from fencepost.gnu.org ([2001:470:142:3::e])
 by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.90_1) (envelope-from <eliz@HIDDEN>)
 id 1u2Tb8-0008O2-1z; Wed, 09 Apr 2025 07:28:02 -0400
DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=gnu.org;
 s=fencepost-gnu-org; h=MIME-version:References:Subject:In-Reply-To:To:From:
 Date; bh=/XdpZ+AQG/moCmoxg8TTElsBZakEuvz4FxpoNIkUUas=; b=sakugPKX27Q1Mxco2wYP
 ufQsZNDtJcSEu5ad0ZXkAkVvGI+4uxPPT/XWWPo2e1CgWcYUSw8/exWQSlIKgrhYq2u3bOwaVWgcZ
 cy5ccIk+gY2UJ+0YwXaD5JA3US3b8mT34/KEDRPxXjr4WcP6n8O6DigQEyy9m8dMdkBWkxSnY9IQO
 C3AEk7DAvQUPSoUibYcoIW0DPlZWTXoljC8FuUDcsxnVOtPb/sVAal2217UltBLmpHvzsrEHQShj4
 QTqzp87fPBAw0kvyv834AMJwDJBTz5bh2pHh7k5Xg5IokxwcHMEVcoEB4eZOxbIZgMYQjymNQ8X2S
 VapVyOmRn0B5+g==;
Date: Wed, 09 Apr 2025 14:27:58 +0300
Message-Id: <86tt6xshfl.fsf@HIDDEN>
From: Eli Zaretskii <eliz@HIDDEN>
To: Francesco =?utf-8?Q?Potort=C3=AC?= <pot@HIDDEN>
In-Reply-To: <E1u2CkE-00000006uUz-1b8v@HIDDEN> (message from
 Francesco =?utf-8?Q?Potort=C3=AC?= on Tue, 08 Apr 2025 19:28:18 +0200)
Subject: Re: bug#77650: 30.1; strange docstring for dired-do-touch
References: <E1u2CkE-00000006uUz-1b8v@HIDDEN>
MIME-version: 1.0
Content-type: text/plain; charset=utf-8
Content-Transfer-Encoding: 8bit
X-Spam-Score: -2.3 (--)
X-Debbugs-Envelope-To: 77650-done
Cc: 77650-done <at> debbugs.gnu.org
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -3.3 (---)

> From: Francesco Potortì <pot@HIDDEN>
> Date: Tue, 08 Apr 2025 19:28:18 +0200
> 
> This is the start of defun of dired-do-touch in dired-aux.el
> 
> (defun dired-do-touch (&optional arg)
>   "Change the timestamp of the marked (or next ARG) files.
> This calls touch.
> Type Type \\<minibuffer-local-completion-map>\\[next-history-element] \
> to pull the file attributes of the file at point
> into the minibuffer."
> 
> The last three lines of the docstring make no sense to me because:
> 
> 1. "Type" is repeated twice

That's a typo.

> 2. when I call for description of "T" in a dired buffer, those lines show as:
> 
> Type Type M-n to pull the file attributes of the file at point
> into the minibuffer.
> 
> But M-n calls clone-buffer

The intent was to tell that you can type M-n after invoking the
command.  IOW, type "T M-n".

I've now fixed this (and several similar issues in a few other doc
strings) on the emacs-30 branch, and I'm therefore closing this bug.




Notification sent to Francesco Potortì <pot@HIDDEN>:
bug acknowledged by developer. Full text available.
Reply sent to Eli Zaretskii <eliz@HIDDEN>:
You have taken responsibility. Full text available.

Message received at submit <at> debbugs.gnu.org:


Received: (at submit) by debbugs.gnu.org; 8 Apr 2025 17:29:04 +0000
From debbugs-submit-bounces <at> debbugs.gnu.org Tue Apr 08 13:29:03 2025
Received: from localhost ([127.0.0.1]:35261 helo=debbugs.gnu.org)
	by debbugs.gnu.org with esmtp (Exim 4.84_2)
	(envelope-from <debbugs-submit-bounces <at> debbugs.gnu.org>)
	id 1u2Ckx-0004oq-2H
	for submit <at> debbugs.gnu.org; Tue, 08 Apr 2025 13:29:03 -0400
Received: from lists.gnu.org ([2001:470:142::17]:36048)
 by debbugs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.84_2) (envelope-from <pot@HIDDEN>) id 1u2Ckt-0004n8-AA
 for submit <at> debbugs.gnu.org; Tue, 08 Apr 2025 13:29:00 -0400
Received: from eggs.gnu.org ([2001:470:142:3::10])
 by lists.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256)
 (Exim 4.90_1) (envelope-from <pot@HIDDEN>) id 1u2CkV-0005P4-8U
 for bug-gnu-emacs@HIDDEN; Tue, 08 Apr 2025 13:28:40 -0400
Received: from plesklin7.if2.ehiweb.it ([79.98.45.17] helo=plesklin7.ehiweb.it)
 by eggs.gnu.org with esmtps (TLS1.2:ECDHE_RSA_AES_128_GCM_SHA256:128)
 (Exim 4.90_1) (envelope-from <pot@HIDDEN>) id 1u2CkL-0002bx-P4
 for bug-gnu-emacs@HIDDEN; Tue, 08 Apr 2025 13:28:32 -0400
Received: from tucano.isti.cnr.it (tucano.isti.cnr.it [146.48.81.102])
 by plesklin7.ehiweb.it (Postfix) with ESMTPSA id 89A441C02F7
 for <bug-gnu-emacs@HIDDEN>; Tue,  8 Apr 2025 19:28:18 +0200 (CEST)
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=potorti.it;
 s=default; t=1744133298;
 bh=bMXvTa6Rt4FkWRhEM2rV8AqQg3ZF4qxIlgyrLF6buKY=;
 h=Received:From:To:Subject;
 b=pCowzYWEaKzUFnRa2RqMVvNo4sP7z9ooxLwfSbC11vyMwCxEPV9mOSXtlH517xl/8
 gPE6xN0jYbSlZB2wfcPtbembuHbFHtr9X/iffr6nU+v22mOCxuhWPv6oW9jgz6VCZq
 Sz2sr1jwFjEWrb8AJwKmYhq1lhhf+7fiP/hygt2I=
Authentication-Results: plesklin7.ehiweb.it;
 spf=pass (sender IP is 146.48.81.102) smtp.mailfrom=pot@HIDDEN
 smtp.helo=tucano.isti.cnr.it
Received-SPF: pass (plesklin7.ehiweb.it: connection is authenticated)
Received: from pot by tucano.isti.cnr.it with local (Exim 4.98.2)
 (envelope-from <pot@HIDDEN>) id 1u2CkE-00000006uUz-1b8v
 for bug-gnu-emacs@HIDDEN; Tue, 08 Apr 2025 19:28:18 +0200
From: =?utf-8?Q?Francesco_Potort=C3=AC?= <pot@HIDDEN>
Date: Tue, 08 Apr 2025 19:28:18 +0200
To: bug-gnu-emacs@HIDDEN
Subject: 30.1; strange docstring for dired-do-touch
X-Debbugs-Cc: 
MIME-Version: 1.0
Content-Type: text/plain
X-fingerprint: 4B02 6187 5C03 D6B1 2E31  7666 09DF 2DC9 BE21 6115
Message-Id: <E1u2CkE-00000006uUz-1b8v@HIDDEN>
X-PPP-Message-ID: <174413329868.2653189.17454847559980443418@HIDDEN>
X-PPP-Vhost: potorti.it
Received-SPF: pass client-ip=79.98.45.17; envelope-from=pot@HIDDEN;
 helo=plesklin7.ehiweb.it
X-Spam_score_int: -16
X-Spam_score: -1.7
X-Spam_bar: -
X-Spam_report: (-1.7 / 5.0 requ) BAYES_00=-1.9, DKIM_INVALID=0.1,
 DKIM_SIGNED=0.1, RCVD_IN_VALIDITY_CERTIFIED_BLOCKED=0.001,
 RCVD_IN_VALIDITY_RPBL_BLOCKED=0.001, SPF_HELO_NONE=0.001,
 SPF_PASS=-0.001 autolearn=no autolearn_force=no
X-Spam_action: no action
X-Spam-Score: 0.0 (/)
X-Debbugs-Envelope-To: submit
X-BeenThere: debbugs-submit <at> debbugs.gnu.org
X-Mailman-Version: 2.1.18
Precedence: list
List-Id: <debbugs-submit.debbugs.gnu.org>
List-Unsubscribe: <https://debbugs.gnu.org/cgi-bin/mailman/options/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=unsubscribe>
List-Archive: <https://debbugs.gnu.org/cgi-bin/mailman/private/debbugs-submit/>
List-Post: <mailto:debbugs-submit <at> debbugs.gnu.org>
List-Help: <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=help>
List-Subscribe: <https://debbugs.gnu.org/cgi-bin/mailman/listinfo/debbugs-submit>, 
 <mailto:debbugs-submit-request <at> debbugs.gnu.org?subject=subscribe>
Errors-To: debbugs-submit-bounces <at> debbugs.gnu.org
Sender: "Debbugs-submit" <debbugs-submit-bounces <at> debbugs.gnu.org>
X-Spam-Score: -1.0 (-)

This is the start of defun of dired-do-touch in dired-aux.el

(defun dired-do-touch (&optional arg)
  "Change the timestamp of the marked (or next ARG) files.
This calls touch.
Type Type \\<minibuffer-local-completion-map>\\[next-history-element] \
to pull the file attributes of the file at point
into the minibuffer."

The last three lines of the docstring make no sense to me because:

1. "Type" is repeated twice
2. when I call for description of "T" in a dired buffer, those lines show as:

Type Type M-n to pull the file attributes of the file at point
into the minibuffer.

But M-n calls clone-buffer




Acknowledgement sent to Francesco Potortì <pot@HIDDEN>:
New bug report received and forwarded. Copy sent to bug-gnu-emacs@HIDDEN. Full text available.
Report forwarded to bug-gnu-emacs@HIDDEN:
bug#77650; Package emacs. Full text available.
Please note: This is a static page, with minimal formatting, updated once a day.
Click here to see this page with the latest information and nicer formatting.
Last modified: Wed, 9 Apr 2025 11:30:02 UTC

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