GNU bug report logs - #50518
Minor doc bug: pop-up-frames

Previous Next

Package: emacs;

Reported by: meedstrom <at> teknik.io

Date: Sat, 11 Sep 2021 14:16:01 UTC

Severity: minor

Tags: fixed

Fixed in version 28.1

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 50518 in the body.
You can then email your comments to 50518 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#50518; Package emacs. (Sat, 11 Sep 2021 14:16:01 GMT) Full text and rfc822 format available.
Acknowledgement sent to meedstrom <at> teknik.io:
New bug report received and forwarded. Copy sent to bug-gnu-emacs <at> gnu.org. (Sat, 11 Sep 2021 14:16:01 GMT) Full text and rfc822 format available.

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

From: meedstrom <at> teknik.io
To: bug-gnu-emacs <at> gnu.org
Subject: Minor doc bug: pop-up-frames
Date: Sat, 11 Sep 2021 14:15:21 +0000

The variable pop-up-frames is not marked obsolete nor does the
docstring say it exists for backward compatibility -- only the
Info manual says it.  As a result, it's an unnecessary confusing
factor while you are exploring the display-buffer machinery.

--
Martin Edström
Information forwarded to bug-gnu-emacs <at> gnu.org:
bug#50518; Package emacs. (Sat, 11 Sep 2021 16:44:02 GMT) Full text and rfc822 format available.

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

From: martin rudalics <rudalics <at> gmx.at>
To: meedstrom <at> teknik.io, 50518 <at> debbugs.gnu.org
Subject: Re: bug#50518: Minor doc bug: pop-up-frames
Date: Sat, 11 Sep 2021 18:43:32 +0200

> The variable pop-up-frames is not marked obsolete nor does the
> docstring say it exists for backward compatibility -- only the
> Info manual says it.  As a result, it's an unnecessary confusing
> factor while you are exploring the display-buffer machinery.

`pop-up-frames' is semi-obsolete.  Making it obsolete would give too
many warnings - it's way too often used in our code base.

The Info manual says that "This variable is provided mainly for backward
compatibility."  It should not be used in new code because there is no
guarantee that it will work - newer functions might not pay attention to
it.

martin
Information forwarded to bug-gnu-emacs <at> gnu.org:
bug#50518; Package emacs. (Sat, 11 Sep 2021 17:51:02 GMT) Full text and rfc822 format available.

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

From: meedstrom <at> teknik.io
To: "martin rudalics" <rudalics <at> gmx.at>, 50518 <at> debbugs.gnu.org
Subject: Re: bug#50518: Minor doc bug: pop-up-frames
Date: Sat, 11 Sep 2021 17:50:53 +0000

I understand, don't mark it obsolete, but the docstring should say something about not using it in new code.

September 11, 2021 4:43 PM, "martin rudalics" <rudalics <at> gmx.at> wrote:

>> The variable pop-up-frames is not marked obsolete nor does the
> 
>> docstring say it exists for backward compatibility -- only the
>> Info manual says it. As a result, it's an unnecessary confusing
>> factor while you are exploring the display-buffer machinery.
> 
> `pop-up-frames' is semi-obsolete. Making it obsolete would give too
> many warnings - it's way too often used in our code base.
> 
> The Info manual says that "This variable is provided mainly for backward
> compatibility." It should not be used in new code because there is no
> guarantee that it will work - newer functions might not pay attention to
> it.
> 
> martin
Information forwarded to bug-gnu-emacs <at> gnu.org:
bug#50518; Package emacs. (Sun, 12 Sep 2021 09:21:01 GMT) Full text and rfc822 format available.

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

From: martin rudalics <rudalics <at> gmx.at>
To: meedstrom <at> teknik.io, 50518 <at> debbugs.gnu.org
Subject: Re: bug#50518: Minor doc bug: pop-up-frames
Date: Sun, 12 Sep 2021 11:19:49 +0200

> I understand, don't mark it obsolete, but the docstring should say something about not using it in new code.

I've tried to do that for this and a few related options now.  Please have a
look.

martin
Information forwarded to bug-gnu-emacs <at> gnu.org:
bug#50518; Package emacs. (Mon, 13 Sep 2021 08:03:03 GMT) Full text and rfc822 format available.

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

From: martin rudalics <rudalics <at> gmx.at>
To: meedstrom <at> teknik.io
Cc: 50518 <at> debbugs.gnu.org
Subject: Re: bug#50518: Minor doc bug: pop-up-frames
Date: Mon, 13 Sep 2021 10:01:58 +0200

tags 50518 fixed
close 50518 28.1
quit

> Looks great! Thanks for your work :)

OK.  Trying to close this bug then.

Thanks, martin
Added tag(s) fixed. Request was from martin rudalics <rudalics <at> gmx.at> to control <at> debbugs.gnu.org. (Mon, 13 Sep 2021 08:03:03 GMT) Full text and rfc822 format available.
bug marked as fixed in version 28.1, send any further explanations to 50518 <at> debbugs.gnu.org and meedstrom <at> teknik.io Request was from martin rudalics <rudalics <at> gmx.at> to control <at> debbugs.gnu.org. (Mon, 13 Sep 2021 08:03:03 GMT) Full text and rfc822 format available.
bug archived. Request was from Debbugs Internal Request <help-debbugs <at> gnu.org> to internal_control <at> debbugs.gnu.org. (Mon, 11 Oct 2021 11:24:05 GMT) Full text and rfc822 format available.
This bug report was last modified 3 years and 254 days ago.

Previous Next

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