From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.bugs Subject: bug#31858: 27.0; doc of `window-toggle-side-windows' Date: Sat, 16 Jun 2018 16:11:14 -0700 (PDT) Message-ID: <294e533a-0cd8-417f-b83c-f40c2ebb8ed9@default> References: <65951719-2046-44e9-8946-692a7a15d6d0@default> <837emyzofh.fsf@gnu.org> NNTP-Posting-Host: blaine.gmane.org Mime-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable X-Trace: blaine.gmane.org 1529190611 27558 195.159.176.226 (16 Jun 2018 23:10:11 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Sat, 16 Jun 2018 23:10:11 +0000 (UTC) Cc: 31858@debbugs.gnu.org To: Eli Zaretskii Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sun Jun 17 01:10:06 2018 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([208.118.235.17]) by blaine.gmane.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fUKKb-000729-N5 for geb-bug-gnu-emacs@m.gmane.org; Sun, 17 Jun 2018 01:10:05 +0200 Original-Received: from localhost ([::1]:53138 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fUKMi-0008TR-Td for geb-bug-gnu-emacs@m.gmane.org; Sat, 16 Jun 2018 19:12:16 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:46965) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fUKMX-0008T8-Hd for bug-gnu-emacs@gnu.org; Sat, 16 Jun 2018 19:12:06 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1fUKMU-00034n-AQ for bug-gnu-emacs@gnu.org; Sat, 16 Jun 2018 19:12:05 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:44390) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1fUKMU-00034h-6D for bug-gnu-emacs@gnu.org; Sat, 16 Jun 2018 19:12:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1fUKMU-0004SS-0U for bug-gnu-emacs@gnu.org; Sat, 16 Jun 2018 19:12:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 16 Jun 2018 23:12:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 31858 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: Original-Received: via spool by 31858-submit@debbugs.gnu.org id=B31858.152919068517092 (code B ref 31858); Sat, 16 Jun 2018 23:12:01 +0000 Original-Received: (at 31858) by debbugs.gnu.org; 16 Jun 2018 23:11:25 +0000 Original-Received: from localhost ([127.0.0.1]:52287 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fUKLt-0004Rc-BK for submit@debbugs.gnu.org; Sat, 16 Jun 2018 19:11:25 -0400 Original-Received: from userp2120.oracle.com ([156.151.31.85]:59018) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fUKLr-0004RO-Er for 31858@debbugs.gnu.org; Sat, 16 Jun 2018 19:11:23 -0400 Original-Received: from pps.filterd (userp2120.oracle.com [127.0.0.1]) by userp2120.oracle.com (8.16.0.22/8.16.0.22) with SMTP id w5GNAXNP029799; Sat, 16 Jun 2018 23:11:17 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=mime-version : message-id : date : from : sender : to : cc : subject : references : in-reply-to : content-type : content-transfer-encoding; s=corp-2017-10-26; bh=AwYpgdecoYFMq+cJgJ/rKXhBc3mmIWLU+/+5j3qnz98=; b=hsn4gLR8aHeee8ZYVFPmsBjcDkw3WGulsIBxCz9u3VMZxzMPBV+u01HVL6xxdpsCIDQE dvFUgwUnyMJF9LpQJgtD+KrWhWcIH/z0zRX2ZZMYuq9ZZCmA6h7eGU1XC4jGInzFe41+ DUGTsGWFyYHhiOfRToOV+mHq0SxCErIoUozYrOu3+SOa64Paw/tw0dWivu/CTM1fB+zk I0rlNrlYR3KOVGisUQdN/VDhSRqmQyT/6c3iymKgRkYTakDpzrqSrjp8HLsYceJGyVoA O6Ipn9oH+RtBKGVtxkyeOv7SDlPKkS20ntYk78WWUrN/yRCAJzpjheWe/fIbwrj1UPYU Uw== Original-Received: from aserv0021.oracle.com (aserv0021.oracle.com [141.146.126.233]) by userp2120.oracle.com with ESMTP id 2jmu6xh0w8-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Sat, 16 Jun 2018 23:11:17 +0000 Original-Received: from aserv0122.oracle.com (aserv0122.oracle.com [141.146.126.236]) by aserv0021.oracle.com (8.14.4/8.14.4) with ESMTP id w5GNBGMl010238 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK); Sat, 16 Jun 2018 23:11:16 GMT Original-Received: from abhmp0007.oracle.com (abhmp0007.oracle.com [141.146.116.13]) by aserv0122.oracle.com (8.14.4/8.14.4) with ESMTP id w5GNBGDt019127; Sat, 16 Jun 2018 23:11:16 GMT In-Reply-To: <837emyzofh.fsf@gnu.org> X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.4690.0 (x86)] X-Proofpoint-Virus-Version: vendor=nai engine=5900 definitions=8926 signatures=668702 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 suspectscore=0 malwarescore=0 phishscore=0 bulkscore=0 spamscore=0 mlxscore=0 mlxlogscore=794 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1805220000 definitions=main-1806160280 X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 208.118.235.43 X-BeenThere: bug-gnu-emacs@gnu.org List-Id: "Bug reports for GNU Emacs, the Swiss army knife of text editors" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.org gmane.emacs.bugs:147546 Archived-At: > > 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? >=20 > That's strange. I found answers to those questions in the doc string: >=20 > If FRAME has at least one side window, save FRAME=E2=80=99s state in th= e > FRAME=E2=80=99s =E2=80=98window-state=E2=80=99 frame parameter and dele= te all side > windows on FRAME afterwards. Otherwise, if FRAME has a > =E2=80=98window-state=E2=80=99 parameter, use that to restore any side = windows on > FRAME leaving FRAME=E2=80=99s main window alone. Signal an error if > FRAME has no side window and no saved state is found. >=20 > 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. 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.