* bug#50518: Minor doc bug: pop-up-frames
@ 2021-09-11 14:15 meedstrom--- via Bug reports for GNU Emacs, the Swiss army knife of text editors
2021-09-11 16:43 ` martin rudalics
2021-09-11 17:50 ` meedstrom--- via Bug reports for GNU Emacs, the Swiss army knife of text editors
0 siblings, 2 replies; 5+ messages in thread
From: meedstrom--- via Bug reports for GNU Emacs, the Swiss army knife of text editors @ 2021-09-11 14:15 UTC (permalink / raw)
To: 50518
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
^ permalink raw reply [flat|nested] 5+ messages in thread
* bug#50518: Minor doc bug: pop-up-frames
2021-09-11 14:15 bug#50518: Minor doc bug: pop-up-frames meedstrom--- via Bug reports for GNU Emacs, the Swiss army knife of text editors
@ 2021-09-11 16:43 ` martin rudalics
2021-09-11 17:50 ` meedstrom--- via Bug reports for GNU Emacs, the Swiss army knife of text editors
1 sibling, 0 replies; 5+ messages in thread
From: martin rudalics @ 2021-09-11 16:43 UTC (permalink / raw)
To: meedstrom, 50518
> 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
^ permalink raw reply [flat|nested] 5+ messages in thread
* bug#50518: Minor doc bug: pop-up-frames
2021-09-11 14:15 bug#50518: Minor doc bug: pop-up-frames meedstrom--- via Bug reports for GNU Emacs, the Swiss army knife of text editors
2021-09-11 16:43 ` martin rudalics
@ 2021-09-11 17:50 ` meedstrom--- via Bug reports for GNU Emacs, the Swiss army knife of text editors
2021-09-12 9:19 ` martin rudalics
[not found] ` <9c69aa21f67b3bda7276d6a1e3fc40f4@teknik.io>
1 sibling, 2 replies; 5+ messages in thread
From: meedstrom--- via Bug reports for GNU Emacs, the Swiss army knife of text editors @ 2021-09-11 17:50 UTC (permalink / raw)
To: martin rudalics, 50518
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@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
^ permalink raw reply [flat|nested] 5+ messages in thread
* bug#50518: Minor doc bug: pop-up-frames
2021-09-11 17:50 ` meedstrom--- via Bug reports for GNU Emacs, the Swiss army knife of text editors
@ 2021-09-12 9:19 ` martin rudalics
[not found] ` <9c69aa21f67b3bda7276d6a1e3fc40f4@teknik.io>
1 sibling, 0 replies; 5+ messages in thread
From: martin rudalics @ 2021-09-12 9:19 UTC (permalink / raw)
To: meedstrom, 50518
> 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
^ permalink raw reply [flat|nested] 5+ messages in thread
* bug#50518: Minor doc bug: pop-up-frames
[not found] ` <9c69aa21f67b3bda7276d6a1e3fc40f4@teknik.io>
@ 2021-09-13 8:01 ` martin rudalics
0 siblings, 0 replies; 5+ messages in thread
From: martin rudalics @ 2021-09-13 8:01 UTC (permalink / raw)
To: meedstrom; +Cc: 50518
tags 50518 fixed
close 50518 28.1
quit
> Looks great! Thanks for your work :)
OK. Trying to close this bug then.
Thanks, martin
^ permalink raw reply [flat|nested] 5+ messages in thread
end of thread, other threads:[~2021-09-13 8:01 UTC | newest]
Thread overview: 5+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2021-09-11 14:15 bug#50518: Minor doc bug: pop-up-frames meedstrom--- via Bug reports for GNU Emacs, the Swiss army knife of text editors
2021-09-11 16:43 ` martin rudalics
2021-09-11 17:50 ` meedstrom--- via Bug reports for GNU Emacs, the Swiss army knife of text editors
2021-09-12 9:19 ` martin rudalics
[not found] ` <9c69aa21f67b3bda7276d6a1e3fc40f4@teknik.io>
2021-09-13 8:01 ` martin rudalics
Code repositories for project(s) associated with this public inbox
https://git.savannah.gnu.org/cgit/emacs.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).