GNU bug report logs - #20533
25.0.50; doc string of `other-buffer': FRAME

Previous Next

Package: emacs;

Reported by: Drew Adams <drew.adams <at> oracle.com>

Date: Fri, 8 May 2015 17:34:02 UTC

Severity: wishlist

Found in version 25.0.50

Done: martin rudalics <rudalics <at> gmx.at>

Bug is archived. No further changes may be made.

To add a comment to this bug, you must first unarchive it, by sending
a message to control AT debbugs.gnu.org, with unarchive 20533 in the body.
You can then email your comments to 20533 AT debbugs.gnu.org in the normal way.

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

View this report as an mbox folder, status mbox, maintainer mbox

Report forwarded to bug-gnu-emacs <at> gnu.org:
bug#20533; Package emacs. (Fri, 08 May 2015 17:34:02 GMT) Full text and rfc822 format available.
Acknowledgement sent to Drew Adams <drew.adams <at> oracle.com>:
New bug report received and forwarded. Copy sent to bug-gnu-emacs <at> gnu.org. (Fri, 08 May 2015 17:34:02 GMT) Full text and rfc822 format available.

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: 25.0.50; doc string of `other-buffer': FRAME
Date: Fri, 8 May 2015 10:33:13 -0700 (PDT)

The description in (elisp)Buffer List is OK.  But the doc string is not.
The doc string says:
 If the optional third argument FRAME is non-nil, use that frame's...
It is meaningless to say "that frame" - what frame?

It should say something like what the manual says.  E.g., "... use
FRAME's...".  Or (better) "If non-nil, FRAME is the frame used...".
IOW, non-nil is not enough; FRAME must be a frame if not nil.


In GNU Emacs 25.0.50.1 (i686-pc-mingw32)
 of 2014-10-20 on LEG570
Bzr revision: 118168 rgm <at> gnu.org-20141020195941-icp42t8ttcnud09g
Windowing system distributor `Microsoft Corp.', version 6.1.7601
Configured using:
 `configure --enable-checking=yes,glyphs CPPFLAGS=-DGLYPH_DEBUG=1'
Reply sent to martin rudalics <rudalics <at> gmx.at>:
You have taken responsibility. (Wed, 20 May 2015 09:50:03 GMT) Full text and rfc822 format available.
Notification sent to Drew Adams <drew.adams <at> oracle.com>:
bug acknowledged by developer. (Wed, 20 May 2015 09:50:04 GMT) Full text and rfc822 format available.

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

From: martin rudalics <rudalics <at> gmx.at>
To: Drew Adams <drew.adams <at> oracle.com>, 20533-done <at> debbugs.gnu.org
Subject: Re: bug#20533: 25.0.50; doc string of `other-buffer': FRAME
Date: Wed, 20 May 2015 11:49:39 +0200

> The description in (elisp)Buffer List is OK.  But the doc string is not.
> The doc string says:
>   If the optional third argument FRAME is non-nil, use that frame's...
> It is meaningless to say "that frame" - what frame?
>
> It should say something like what the manual says.  E.g., "... use
> FRAME's...".  Or (better) "If non-nil, FRAME is the frame used...".
> IOW, non-nil is not enough; FRAME must be a frame if not nil.

Should be fixed with commit 31d58d4..0c5fa36 on master/trunk.
Bug closed.

Thanks for the report, martin
bug archived. Request was from Debbugs Internal Request <help-debbugs <at> gnu.org> to internal_control <at> debbugs.gnu.org. (Wed, 17 Jun 2015 11:24:05 GMT) Full text and rfc822 format available.
This bug report was last modified 10 years and 8 days ago.

Previous Next

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