GNU bug report logs - #29262
26.0; doc string of `find-grep-dired'

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 29262 in the body.
You can then email your comments to 29262 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: Drew Adams <drew.adams <at> oracle.com>
To: bug-gnu-emacs <at> gnu.org
Subject: 26.0; doc string of `find-grep-dired'
Date: Sat, 11 Nov 2017 13:32:37 -0800 (PST)

The doc string is not as clear as it could be.  It says:

Find files in DIR matching a regexp REGEXP and start Dired on output.
     ^^^^^        ^^^^^^^^^^^^^^^^^

What does it mean for a file to match a regexp?  This could easily be
misunderstood as the file name matching the regexp.

Please consider making the text clearer, e.g., along the lines of what
is said in the Emacs manual.  It speaks of files "that contain a match
                                                       ^^^^^^^
for REGEXP."

(And no need to repeat "regexp REGEXP".)



In GNU Emacs 26.0.90 (build 3, x86_64-w64-mingw32)
 of 2017-10-13
Repository revision: 906224eba147bdfc0514090064e8e8f53160f1d4
Windowing system distributor `Microsoft Corp.', version 6.1.7601
Configured using:
 `configure --without-dbus --host=x86_64-w64-mingw32
 --without-compress-install 'CFLAGS=-O2 -static -g3''

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

From: Eli Zaretskii <eliz <at> gnu.org>
To: Drew Adams <drew.adams <at> oracle.com>
Cc: 29262-done <at> debbugs.gnu.org
Subject: Re: bug#29262: 26.0; doc string of `find-grep-dired'
Date: Sun, 12 Nov 2017 07:05:15 +0200

> Date: Sat, 11 Nov 2017 13:32:37 -0800 (PST)
> From: Drew Adams <drew.adams <at> oracle.com>
> 
> The doc string is not as clear as it could be.  It says:
> 
> Find files in DIR matching a regexp REGEXP and start Dired on output.
>      ^^^^^        ^^^^^^^^^^^^^^^^^
> 
> What does it mean for a file to match a regexp?  This could easily be
> misunderstood as the file name matching the regexp.
> 
> Please consider making the text clearer, e.g., along the lines of what
> is said in the Emacs manual.  It speaks of files "that contain a match
>                                                        ^^^^^^^
> for REGEXP."

Thanks, fixed.

Previous Next

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