GNU bug report logs - #79440
31.0.50; Docstring of dired-find-subdir confuses the values

Previous Next

Full log

View this message in rfc822 format

From: help-debbugs <at> gnu.org (GNU bug Tracking System)
To: Eli Zaretskii <eliz <at> gnu.org>
Cc: tracker <at> debbugs.gnu.org
Subject: bug#79440: closed (31.0.50; Docstring of dired-find-subdir
 confuses the values)
Date: Sat, 13 Sep 2025 10:49:02 +0000

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

Your message dated Sat, 13 Sep 2025 13:48:04 +0300
with message-id <868qiir5ln.fsf <at> gnu.org>
and subject line Re: bug#79440: 31.0.50; Docstring of dired-find-subdir confuses the values
has caused the debbugs.gnu.org bug report #79440,
regarding 31.0.50; Docstring of dired-find-subdir confuses the values
to be marked as done.

(If you believe you have received this mail in error, please contact
help-debbugs <at> gnu.org.)


-- 
79440: https://debbugs.gnu.org/cgi/bugreport.cgi?bug=79440
GNU Bug Tracking System
Contact help-debbugs <at> gnu.org with problems

[Message part 2 (message/rfc822, inline)]

From: Michael Heerdegen <michael_heerdegen <at> web.de>
To: bug-gnu-emacs <at> gnu.org
Subject: 31.0.50; Docstring of dired-find-subdir confuses the values
Date: Sat, 13 Sep 2025 08:15:30 +0200

Hello,

unless I'm somehow confused...

the docstring of dired-find-subdir says:

| If non-nil, Dired always finds a directory in a buffer of its own.
| If nil, Dired finds the directory as a subdirectory in some other buffer
| if it is present as one.

But if you look at `dired-find-buffer-nocreate', you see that it's
exactly the other way round.  Also the plain name suggests the opposite
meaning.  Look: In

0a44133e626 "(dired-find-subdir): Doc fix." (Richard M. Stallman <rms <at> gnu.org> 1994-10-26)

this part of the docstring has been changed, the docstring version
before that commit started with

| *If non-nil, Dired does not make a new buffer for a directory if it
| can be found (perhaps as subdir) in some existing Dired buffer.

which was correct.  The new version looks like a typo.  Or I just don't
understand the words of the recent version.


TIA,

Michael.

[Message part 3 (message/rfc822, inline)]

From: Eli Zaretskii <eliz <at> gnu.org>
To: michael_heerdegen <at> web.de
Cc: 79440-done <at> debbugs.gnu.org
Subject: Re: bug#79440: 31.0.50;
 Docstring of dired-find-subdir confuses the values
Date: Sat, 13 Sep 2025 13:48:04 +0300

> Date: Sat, 13 Sep 2025 08:15:30 +0200
> From:  Michael Heerdegen via "Bug reports for GNU Emacs,
>  the Swiss army knife of text editors" <bug-gnu-emacs <at> gnu.org>
> 
> 
> Hello,
> 
> unless I'm somehow confused...
> 
> the docstring of dired-find-subdir says:
> 
> | If non-nil, Dired always finds a directory in a buffer of its own.
> | If nil, Dired finds the directory as a subdirectory in some other buffer
> | if it is present as one.
> 
> But if you look at `dired-find-buffer-nocreate', you see that it's
> exactly the other way round.  Also the plain name suggests the opposite
> meaning.  Look: In
> 
> 0a44133e626 "(dired-find-subdir): Doc fix." (Richard M. Stallman <rms <at> gnu.org> 1994-10-26)
> 
> this part of the docstring has been changed, the docstring version
> before that commit started with
> 
> | *If non-nil, Dired does not make a new buffer for a directory if it
> | can be found (perhaps as subdir) in some existing Dired buffer.
> 
> which was correct.  The new version looks like a typo.  Or I just don't
> understand the words of the recent version.

Thanks, fixed on the emacs-30 branch, and closing the bug.

Previous Next

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