From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: Drew Adams Newsgroups: gmane.emacs.bugs Subject: bug#35063: 26.1; Doc of window parameter `other-window'... Date: Sun, 31 Mar 2019 15:37:18 -0700 (PDT) Message-ID: Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="150672"; mail-complaints-to="usenet@blaine.gmane.org" To: 35063@debbugs.gnu.org Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Mon Apr 01 00:38:20 2019 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane.org Original-Received: from lists.gnu.org ([209.51.188.17]) by blaine.gmane.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:256) (Exim 4.89) (envelope-from ) id 1hAj5n-000d0a-07 for geb-bug-gnu-emacs@m.gmane.org; Mon, 01 Apr 2019 00:38:19 +0200 Original-Received: from localhost ([127.0.0.1]:35551 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hAj5l-0006tw-VB for geb-bug-gnu-emacs@m.gmane.org; Sun, 31 Mar 2019 18:38:17 -0400 Original-Received: from eggs.gnu.org ([209.51.188.92]:32780) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hAj5Y-0006sW-AE for bug-gnu-emacs@gnu.org; Sun, 31 Mar 2019 18:38:05 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1hAj5X-0001hv-B4 for bug-gnu-emacs@gnu.org; Sun, 31 Mar 2019 18:38:04 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:53288) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1hAj5X-0001hk-4g for bug-gnu-emacs@gnu.org; Sun, 31 Mar 2019 18:38:03 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1hAj5X-0006ms-0T for bug-gnu-emacs@gnu.org; Sun, 31 Mar 2019 18:38:03 -0400 X-Loop: help-debbugs@gnu.org Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sun, 31 Mar 2019 22:38:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 35063 X-GNU-PR-Package: emacs X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Original-Received: via spool by submit@debbugs.gnu.org id=B.155407185726002 (code B ref -1); Sun, 31 Mar 2019 22:38:02 +0000 Original-Received: (at submit) by debbugs.gnu.org; 31 Mar 2019 22:37:37 +0000 Original-Received: from localhost ([127.0.0.1]:38584 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hAj56-0006lK-JJ for submit@debbugs.gnu.org; Sun, 31 Mar 2019 18:37:36 -0400 Original-Received: from eggs.gnu.org ([209.51.188.92]:46528) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hAj54-0006l8-QM for submit@debbugs.gnu.org; Sun, 31 Mar 2019 18:37:35 -0400 Original-Received: from lists.gnu.org ([209.51.188.17]:53711) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1hAj4z-0001HT-K5 for submit@debbugs.gnu.org; Sun, 31 Mar 2019 18:37:29 -0400 Original-Received: from eggs.gnu.org ([209.51.188.92]:60886) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hAj4y-0006qj-Hn for bug-gnu-emacs@gnu.org; Sun, 31 Mar 2019 18:37:29 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1hAj4x-0001D4-JQ for bug-gnu-emacs@gnu.org; Sun, 31 Mar 2019 18:37:28 -0400 Original-Received: from userp2120.oracle.com ([156.151.31.85]:53440) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1hAj4x-0001Bd-7C for bug-gnu-emacs@gnu.org; Sun, 31 Mar 2019 18:37:27 -0400 Original-Received: from pps.filterd (userp2120.oracle.com [127.0.0.1]) by userp2120.oracle.com (8.16.0.27/8.16.0.27) with SMTP id x2VMY41W041072 for ; Sun, 31 Mar 2019 22:37:25 GMT DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=oracle.com; h=mime-version : message-id : date : from : sender : to : subject : content-type : content-transfer-encoding; s=corp-2018-07-02; bh=fKs/QCBIzaaJJD7QwuFbrYLwTVh10Ik/xbq69UlG+S0=; b=28eW/vEe0jTWvOb3afpgHfFGimDC7bYkLgXtTvGjAAxucw4Wrg+Vbu2TEaz5niIs6fk8 sgflTRQaLXqMQN2fIwGzxVz0LSXLi7NLY224GLTX6GrNLo/IAu6GR8DrpUP2Dmz/dT9c hr1lwtIhjbAzWcc1rrDtYTVYUXjCiOBkgJH9P+madgrYYrCSx9u7Fd03lo0QUQzxelW+ L6QUR4ywjqfPTr6Ti5n/brn7QHvJ0ICPQlxPzA6+nPRWPG3IFGpzfWPla/8DRvPfXOcX 19Go4TD3mLUdGHbXfXG/F/ZnXuTMQeuE38jo60pnD6LOZks+/Qd3V02KhEiejFROIzAa WQ== Original-Received: from aserv0021.oracle.com (aserv0021.oracle.com [141.146.126.233]) by userp2120.oracle.com with ESMTP id 2rj13put19-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Sun, 31 Mar 2019 22:37:25 +0000 Original-Received: from aserv0121.oracle.com (aserv0121.oracle.com [141.146.126.235]) by aserv0021.oracle.com (8.14.4/8.14.4) with ESMTP id x2VMbJvv025969 (version=TLSv1/SSLv3 cipher=DHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Sun, 31 Mar 2019 22:37:19 GMT Original-Received: from abhmp0015.oracle.com (abhmp0015.oracle.com [141.146.116.21]) by aserv0121.oracle.com (8.14.4/8.13.8) with ESMTP id x2VMbJTU006697 for ; Sun, 31 Mar 2019 22:37:19 GMT X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.4822.0 (x86)] X-Proofpoint-Virus-Version: vendor=nai engine=5900 definitions=9213 signatures=668685 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 priorityscore=1501 malwarescore=0 suspectscore=1 phishscore=0 bulkscore=0 spamscore=0 clxscore=1015 lowpriorityscore=0 mlxscore=0 impostorscore=0 mlxlogscore=999 adultscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.0.1-1810050000 definitions=main-1903310171 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x [generic] X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.6.x 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: 209.51.188.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:156994 Archived-At: (elisp) `Window Parameters' should be the place where the window parameters are each described. A reader should not just fall upon a cop-out description such as this: `other-window' This parameter affects the execution of `other-window' (see Cylic Window Ordering) But the real bug is that when you go to node Cyclic Window Ordering you find nothing at all describing parameter `other-window', whose doc sent you there for a real description. Arguably parameter `no-other-window' is described there: This function does not select a window that has a non-'nil' 'no-other-window' window parameter (*note Window Parameters::). But there's nothing about parameter `other-window'. Also, the first sentence of node `Window Parameters' says: This section describes how window parameters can be used to associate additional information with windows. But it doesn't seem to be mostly about that. Only the description of function `set-window-parameter' tells you "how window parameters can be used to associate additional information with windows". What's more, the node doesn't really tell you _why_ you would associate... What's that for? When would you do that? Not clear from this node, AFAICT. OK, a few of the parameter descriptions, e.g. `window-preserved-size' give an idea of what they might be used for. But most do not, do they? In GNU Emacs 26.1 (build 1, x86_64-w64-mingw32) of 2018-05-30 Repository revision: 07f8f9bc5a51f5aa94eb099f3e15fbe0c20ea1ea Windowing system distributor `Microsoft Corp.', version 10.0.17134 Configured using: `configure --without-dbus --host=3Dx86_64-w64-mingw32 --without-compress-install 'CFLAGS=3D-O2 -static -g3''