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

Previous Next

To reply to this bug, email your comments to 79440 AT debbugs.gnu.org.
There is no need to reopen the bug first.

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

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

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 #10 received at 79440-done <at> debbugs.gnu.org (full text, mbox):

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.

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

From: Michael Heerdegen <michael_heerdegen <at> web.de>
To: Eli Zaretskii <eliz <at> gnu.org>
Cc: 79440-done <at> debbugs.gnu.org
Subject: Re: bug#79440: 31.0.50; Docstring of dired-find-subdir confuses the
 values
Date: Sun, 14 Sep 2025 04:28:21 +0200

Eli Zaretskii <eliz <at> gnu.org> writes:

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

LGTM, thank you.


Michael.

Previous Next

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