From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED!not-for-mail From: Noam Postavsky Newsgroups: gmane.emacs.bugs Subject: bug#31858: 27.0; doc of `window-toggle-side-windows' Date: Sat, 16 Jun 2018 19:18:03 -0400 Message-ID: <87in6itj6c.fsf@gmail.com> References: <65951719-2046-44e9-8946-692a7a15d6d0@default> <837emyzofh.fsf@gnu.org> <294e533a-0cd8-417f-b83c-f40c2ebb8ed9@default> 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 1529191030 30502 195.159.176.226 (16 Jun 2018 23:17:10 GMT) X-Complaints-To: usenet@blaine.gmane.org NNTP-Posting-Date: Sat, 16 Jun 2018 23:17:10 +0000 (UTC) User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/26.1 (gnu/linux) Cc: 31858@debbugs.gnu.org To: Drew Adams Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sun Jun 17 01:17: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 1fUKRM-0007lt-2z for geb-bug-gnu-emacs@m.gmane.org; Sun, 17 Jun 2018 01:17:04 +0200 Original-Received: from localhost ([::1]:53152 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fUKTT-00010k-6D for geb-bug-gnu-emacs@m.gmane.org; Sat, 16 Jun 2018 19:19:15 -0400 Original-Received: from eggs.gnu.org ([2001:4830:134:3::10]:47834) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fUKTJ-00010f-RO for bug-gnu-emacs@gnu.org; Sat, 16 Jun 2018 19:19:06 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1fUKTG-00064s-LW for bug-gnu-emacs@gnu.org; Sat, 16 Jun 2018 19:19:05 -0400 Original-Received: from debbugs.gnu.org ([208.118.235.43]:44398) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1fUKTG-00064m-Gu for bug-gnu-emacs@gnu.org; Sat, 16 Jun 2018 19:19:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1fUKTG-0006bj-Ac for bug-gnu-emacs@gnu.org; Sat, 16 Jun 2018 19:19:02 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Noam Postavsky Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 16 Jun 2018 23:19:02 +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.152919109225332 (code B ref 31858); Sat, 16 Jun 2018 23:19:02 +0000 Original-Received: (at 31858) by debbugs.gnu.org; 16 Jun 2018 23:18:12 +0000 Original-Received: from localhost ([127.0.0.1]:52295 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fUKSS-0006aW-9s for submit@debbugs.gnu.org; Sat, 16 Jun 2018 19:18:12 -0400 Original-Received: from mail-io0-f176.google.com ([209.85.223.176]:45613) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1fUKSQ-0006aJ-O9 for 31858@debbugs.gnu.org; Sat, 16 Jun 2018 19:18:11 -0400 Original-Received: by mail-io0-f176.google.com with SMTP id l25-v6so13752719ioh.12 for <31858@debbugs.gnu.org>; Sat, 16 Jun 2018 16:18:10 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20161025; h=from:to:cc:subject:references:date:in-reply-to:message-id :user-agent:mime-version:content-transfer-encoding; bh=HibT0AZ1wDSC6O7qD/GWF1+SN4MRKD0iHuzPhk606aU=; b=HfJ2zIIkWRJvd3IpaXspI1p2OMt0ij2nlYN0b6uk+Cax+LVyHITicYZyW2qUrcWfUd RiQWkNm+O2sG/AEXrU9fGBRyICpVf/hxOfnc34hjZwtpe8NJ6ie1NwBOpAHc1oKXq/Yk V97StEB2rhyCVz1DiRcoYLVrrxOgPxMljvWqXi2flcZ40+hjqLtrVif77AWFdzdtu7Dd uh7sC8vC6tocG80FCR2xXln8x5wPgwxrK3sNSScvy03qd1aeUMJsKhByBoNZ4Wy6o6ai hDwLiX1s+B/sY8eyLYQQoeCTB5/KBNAN+c2k/vVgBUfwjFDal4ahT+pDtGibrJZzrZTQ huzA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:references:date:in-reply-to :message-id:user-agent:mime-version:content-transfer-encoding; bh=HibT0AZ1wDSC6O7qD/GWF1+SN4MRKD0iHuzPhk606aU=; b=YahPsnquF4P2IeaZHzCG/5f9AUqWEfGstQA7c71w9TqTzd/KKKYF6ntRRKpGoXdwbv 2deWP4MB8DHcHNi1H2eBd00wGO21oInC4x4E1rViQWWy09K5bcxyOfSFF7XpozgOcgTE /VciHVGjDubno0urkNXrqcb7NVyC64J33YArW4qgKyBbmfWcxbdlDSTl/wPpDmKf1Qbr /A8qoaWHw6GQwA2UYKpbdeeyfXozehkywPnnDYy5gChD3QKRBwgxb4kxsJ033ryYnqFZ 3Ng+/L0CyaiauciQ7YRZqieiH7l4DkCqyhYi1NokNZUqcZumWRVqhqUJ9kKnnX612eNI FjXw== X-Gm-Message-State: APt69E3EgGBEfHhv38+P4jJLzAapYAOYRUTMwdC4ppVhjLz/3GkFMvBk KZZdQOb3BGUmbnqt6mofA1kT3/LS X-Google-Smtp-Source: ADUXVKLCoGNUFt7/CdZ3uBDnK9LI2LzpV2RSRDObnbU6ovMnefRqRW5bh9lBDQ0/r6x3LhwfSWUyHA== X-Received: by 2002:a6b:da15:: with SMTP id x21-v6mr5885057iob.179.1529191085234; Sat, 16 Jun 2018 16:18:05 -0700 (PDT) Original-Received: from zebian (cbl-45-2-119-34.yyz.frontiernetworks.ca. [45.2.119.34]) by smtp.googlemail.com with ESMTPSA id p130-v6sm4587883ioe.81.2018.06.16.16.18.04 (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256); Sat, 16 Jun 2018 16:18:04 -0700 (PDT) In-Reply-To: <294e533a-0cd8-417f-b83c-f40c2ebb8ed9@default> (Drew Adams's message of "Sat, 16 Jun 2018 16:11:14 -0700 (PDT)") 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:147548 Archived-At: Drew Adams 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? >>=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 t= he >> FRAME=E2=80=99s =E2=80=98window-state=E2=80=99 frame parameter and del= ete 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. 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..."