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

Previous Next

Full log

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

Previous Next

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