GNU bug report logs -
#31858
27.0; doc of `window-toggle-side-windows'
Previous Next
Reported by: Drew Adams <drew.adams <at> oracle.com>
Date: Sat, 16 Jun 2018 12:36:02 UTC
Severity: minor
Found in version 27.0
Done: Eli Zaretskii <eliz <at> gnu.org>
Bug is archived. No further changes may be made.
Full log
View this message in rfc822 format
Drew Adams <drew.adams <at> oracle.com> writes:
>> > AFAICT, neither the doc string nor the manual says what toggling the
>> > side windows DOES or MEANS. Just what behavior or appearance is
>> > toggled? What happens when a side window is - or all side windows are
>> > toggled?
>>
>> That's strange. I found answers to those questions in the doc string:
>>
>> If FRAME has at least one side window, save FRAME’s state in the
>> FRAME’s ‘window-state’ frame parameter and delete all side
^^^^^^^^^^^^^^^
>> windows on FRAME afterwards. Otherwise, if FRAME has a
^^^^^^^^^^^^^^^^
>> ‘window-state’ parameter, use that to restore any side windows on
^^^^^^^^^^^^^^^^^^^^^^^^^^^
>> FRAME leaving FRAME’s main window alone. Signal an error if
^^^^^
>> FRAME has no side window and no saved state is found.
>>
>> So I don't understand what is missing there. Could you be more
>> specific regarding the problems you see in this text?
>
> The doc should say that the function deletes all side windows
> of FRAME, or it restores all such previously deleted side windows.
Seems like it does say that?
> There currently is no statement of just what gets toggled.
?
> The toggling behavior is described, but what's not said is
> that it is the presence/existence/validity (pick the right
> term) of the side windows that is toggled.
It's the first sentence of the quoted paragraph: "If FRAME has at least
one side window..."
This bug report was last modified 7 years and 32 days ago.
Previous Next
GNU bug tracking system
Copyright (C) 1999 Darren O. Benham,
1997,2003 nCipher Corporation Ltd,
1994-97 Ian Jackson.