From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.org!.POSTED.blaine.gmane.org!not-for-mail From: Eli Zaretskii Newsgroups: gmane.emacs.bugs Subject: bug#35063: 26.1; Doc of window parameter `other-window'... Date: Sat, 06 Apr 2019 11:09:13 +0300 Message-ID: <83wok7a72u.fsf@gnu.org> References: Injection-Info: blaine.gmane.org; posting-host="blaine.gmane.org:195.159.176.226"; logging-data="250342"; mail-complaints-to="usenet@blaine.gmane.org" Cc: 35063-done@debbugs.gnu.org To: Drew Adams Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane.org@gnu.org Sat Apr 06 10:10:16 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 1hCgOz-0012xu-H4 for geb-bug-gnu-emacs@m.gmane.org; Sat, 06 Apr 2019 10:10:14 +0200 Original-Received: from localhost ([127.0.0.1]:52012 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hCgOy-0000j5-HV for geb-bug-gnu-emacs@m.gmane.org; Sat, 06 Apr 2019 04:10:12 -0400 Original-Received: from eggs.gnu.org ([209.51.188.92]:44559) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hCgOq-0000ix-LC for bug-gnu-emacs@gnu.org; Sat, 06 Apr 2019 04:10:05 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1hCgOp-0005SW-OL for bug-gnu-emacs@gnu.org; Sat, 06 Apr 2019 04:10:04 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:32977) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1hCgOp-0005S1-2m for bug-gnu-emacs@gnu.org; Sat, 06 Apr 2019 04:10:03 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1hCgOo-0004u0-R9 for bug-gnu-emacs@gnu.org; Sat, 06 Apr 2019 04:10:02 -0400 Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-To: bug-gnu-emacs@gnu.org Resent-Date: Sat, 06 Apr 2019 08:10:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: cc-closed 35063 X-GNU-PR-Package: emacs Mail-Followup-To: 35063@debbugs.gnu.org, eliz@gnu.org, drew.adams@oracle.com Original-Received: via spool by 35063-done@debbugs.gnu.org id=D35063.155453817318801 (code D ref 35063); Sat, 06 Apr 2019 08:10:02 +0000 Original-Received: (at 35063-done) by debbugs.gnu.org; 6 Apr 2019 08:09:33 +0000 Original-Received: from localhost ([127.0.0.1]:46520 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hCgOL-0004tA-3b for submit@debbugs.gnu.org; Sat, 06 Apr 2019 04:09:33 -0400 Original-Received: from eggs.gnu.org ([209.51.188.92]:58206) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1hCgOJ-0004sy-Ll for 35063-done@debbugs.gnu.org; Sat, 06 Apr 2019 04:09:32 -0400 Original-Received: from fencepost.gnu.org ([2001:470:142:3::e]:37674) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1hCgOE-00056F-7t; Sat, 06 Apr 2019 04:09:26 -0400 Original-Received: from [176.228.60.248] (port=2207 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1hCgOD-0001Qy-O9; Sat, 06 Apr 2019 04:09:26 -0400 In-reply-to: (message from Drew Adams on Sun, 31 Mar 2019 15:37:18 -0700 (PDT)) X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] 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:157254 Archived-At: > Date: Sun, 31 Mar 2019 15:37:18 -0700 (PDT) > From: Drew Adams > > (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) There's nothing wrong, per se, with having the detailed description of the parameter in a more appropriate place. It isn't a "cop-out". > 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. I added the description of other-window parameter there. > 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". I modified that sentence to not imply the actual description of the parameters must be in this section. > 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? If you read the detailed descriptions of the parameters in the context of the functions they affect, I think this question answers itself. Thanks.