From unknown Sat Aug 16 18:44:04 2025 X-Loop: help-debbugs@gnu.org Subject: bug#40667: 26.3; (1) Emacs manual `i tool bar' (2) `tool-bar-position' Resent-From: Drew Adams Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Thu, 16 Apr 2020 16:32:02 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: report 40667 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: 40667@debbugs.gnu.org X-Debbugs-Original-To: bug-gnu-emacs@gnu.org Received: via spool by submit@debbugs.gnu.org id=B.158705470217449 (code B ref -1); Thu, 16 Apr 2020 16:32:02 +0000 Received: (at submit) by debbugs.gnu.org; 16 Apr 2020 16:31:42 +0000 Received: from localhost ([127.0.0.1]:39222 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1jP7QT-0004XN-Jk for submit@debbugs.gnu.org; Thu, 16 Apr 2020 12:31:41 -0400 Received: from lists.gnu.org ([209.51.188.17]:38921) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1jP7QR-0004XA-IJ for submit@debbugs.gnu.org; Thu, 16 Apr 2020 12:31:40 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:58501) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jP7QQ-0004H2-F0 for bug-gnu-emacs@gnu.org; Thu, 16 Apr 2020 12:31:39 -0400 X-Spam-Checker-Version: SpamAssassin 3.3.2 (2011-06-06) on eggs.gnu.org X-Spam-Level: X-Spam-Status: No, score=-1.5 required=5.0 tests=BAYES_50,RCVD_IN_DNSWL_MED autolearn=disabled version=3.3.2 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1jP7QO-00052a-9Q for bug-gnu-emacs@gnu.org; Thu, 16 Apr 2020 12:31:37 -0400 Received: from userp2120.oracle.com ([156.151.31.85]:55040) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1jP7QN-0004rG-Kl for bug-gnu-emacs@gnu.org; Thu, 16 Apr 2020 12:31:36 -0400 Received: from pps.filterd (userp2120.oracle.com [127.0.0.1]) by userp2120.oracle.com (8.16.0.42/8.16.0.42) with SMTP id 03GGRvJA141172 for ; Thu, 16 Apr 2020 16:31:28 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-2020-01-29; bh=5Ph140YZnKJOOj10/A6LSl5n+UXlGUR/keDQkGwJyXE=; b=LldlKJMY2vTGw45ALmUA79niXFvY6UDUncpwj/5AxuMCdSY8Eij3ox2OoGpz0wCIMOm+ lh/adE6r/FI7/+6gHfxziQa4UtYVCyStmrwOMGbQYEY3LXBI4nXR+bYegGN0PoTTvtGk ABjNK5NAf7xipdn4CB8HqcRU15nUoGjm8GfxTMwmDCyb2fvw8WU+dgD7lYCe/YQuK330 SgreUyTDYqHKwZtR3dX/Ftwd1gpIhrM8PF9AOn4qp5esWr9Jsu07CxStAppGuon2vYmI kdxVgc2pJvLPv+OxUWKjyIgdVG1VVZS69NXFIW69H0EylV8er2CCQ8vrN4nExFFibhCy Ig== Received: from userp3030.oracle.com (userp3030.oracle.com [156.151.31.80]) by userp2120.oracle.com with ESMTP id 30emejj9w0-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Thu, 16 Apr 2020 16:31:28 +0000 Received: from pps.filterd (userp3030.oracle.com [127.0.0.1]) by userp3030.oracle.com (8.16.0.42/8.16.0.42) with SMTP id 03GGRtT4128996 for ; Thu, 16 Apr 2020 16:31:28 GMT Received: from aserv0122.oracle.com (aserv0122.oracle.com [141.146.126.236]) by userp3030.oracle.com with ESMTP id 30dyp04y61-1 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=OK) for ; Thu, 16 Apr 2020 16:31:28 +0000 Received: from abhmp0017.oracle.com (abhmp0017.oracle.com [141.146.116.23]) by aserv0122.oracle.com (8.14.4/8.14.4) with ESMTP id 03GGVQZd019708 for ; Thu, 16 Apr 2020 16:31:27 GMT MIME-Version: 1.0 Message-ID: <26d88724-1a8f-4c14-8c56-3529a19acd8a@default> Date: Thu, 16 Apr 2020 09:31:26 -0700 (PDT) From: Drew Adams X-Priority: 3 X-Mailer: Oracle Beehive Extensions for Outlook 2.0.1.9.1 (1003210) [OL 16.0.4966.0 (x86)] Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: quoted-printable X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9593 signatures=668686 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 mlxlogscore=999 suspectscore=1 malwarescore=0 phishscore=0 spamscore=0 adultscore=0 mlxscore=0 bulkscore=0 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2003020000 definitions=main-2004160116 X-Proofpoint-Virus-Version: vendor=nai engine=6000 definitions=9593 signatures=668686 X-Proofpoint-Spam-Details: rule=notspam policy=default score=0 malwarescore=0 impostorscore=0 mlxscore=0 suspectscore=1 lowpriorityscore=0 spamscore=0 mlxlogscore=999 bulkscore=0 adultscore=0 phishscore=0 clxscore=1015 priorityscore=1501 classifier=spam adjust=0 reason=mlx scancount=1 engine=8.12.0-2003020000 definitions=main-2004160116 X-detected-operating-system: by eggs.gnu.org: GNU/Linux 3.x [generic] [fuzzy] X-Received-From: 156.151.31.85 X-Spam-Score: 0.3 (/) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -0.7 (/) 1. Suggestion: have `i tool bar RET' send you to node `Tool Bars', not to node `Table of Resources'. Someone looking for info about the Emacs tool bar is not necessarily looking for info about X Resources. 2. In node (emacs) `Tool Bars' there is a link to (elisp) `Frame Parameters', for info about parameter `tool-bar-position'. But that node doesn't present that parameter. Suggestion: change that link, to point to node `Layout Parameters'. That's where that parameter is covered. In GNU Emacs 26.3 (build 1, x86_64-w64-mingw32) of 2019-08-29 Repository revision: 96dd0196c28bc36779584e47fffcca433c9309cd Windowing system distributor `Microsoft Corp.', version 10.0.18362 Configured using: `configure --without-dbus --host=3Dx86_64-w64-mingw32 --without-compress-install 'CFLAGS=3D-O2 -static -g3'' From unknown Sat Aug 16 18:44:04 2025 X-Loop: help-debbugs@gnu.org Subject: bug#40667: 26.3; (1) Emacs manual `i tool bar' (2) `tool-bar-position' Resent-From: "Basil L. Contovounesios" Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Fri, 17 Apr 2020 16:08:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 40667 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: To: Drew Adams Cc: 40667@debbugs.gnu.org Received: via spool by 40667-submit@debbugs.gnu.org id=B40667.15871396627323 (code B ref 40667); Fri, 17 Apr 2020 16:08:01 +0000 Received: (at 40667) by debbugs.gnu.org; 17 Apr 2020 16:07:42 +0000 Received: from localhost ([127.0.0.1]:41564 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1jPTWn-0001tw-M4 for submit@debbugs.gnu.org; Fri, 17 Apr 2020 12:07:42 -0400 Received: from mail-ed1-f46.google.com ([209.85.208.46]:40264) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1jPTWk-0001tb-PU for 40667@debbugs.gnu.org; Fri, 17 Apr 2020 12:07:39 -0400 Received: by mail-ed1-f46.google.com with SMTP id d16so1860726edq.7 for <40667@debbugs.gnu.org>; Fri, 17 Apr 2020 09:07:38 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=tcd-ie.20150623.gappssmtp.com; s=20150623; h=from:to:cc:subject:references:date:in-reply-to:message-id :user-agent:mime-version; bh=aXHGVfWF9SZXvXywVPbqXhWOvKlphFH1CX5ff1qw0UI=; b=toPEWNAZ8S5X6MuGTkbPceQG5kYm9Ri2A2vjOT8V3jfDZSpWblDa2IoUQ4lCXH2s2Y kYefSR6SUN9757M2kXpvoBM/pAAsaYN3TGbw41SFsvqFN9lA8F6AyQjO+CRuyloKGqna Wn7+CnEJppqXUys2ul9DFDOwGd38xkJoFe36Gy2SaomkAbwcbK9EvFsadwbNObHmgM82 hcMxvTbSPpPykhJVd2vCyeSC3SYPTioIPX/a/VC3t9lEwWiYRUePsDAYNU8OguokTZ46 EIfTUrM1sEEJBILfU2u3AtJVfVBmAES3EYHc3HC/jyGLFdyD7s5CdBV9WtO+EOKovnPX Xleg== 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; bh=aXHGVfWF9SZXvXywVPbqXhWOvKlphFH1CX5ff1qw0UI=; b=eondgZT2RSxxi+cGZJhbeqkGOJPQrIXSnOIgB6FVshoTaTHfdBpW3KbHluhlUPns7y g4buXENf7KGMYskfQVWaUgRI2nCtOryRSaJFbwcjGadXYIW9Jta9K8FrLBDnZnaJ6gdj cvO0jVm0AD2rSuBP3GY5tBCI/rQO5rO+SerIAOZgSFJM5y0fLlUiZIJiPignXMJkQEAT TRy3JvaA1vPqtRa8DA8MvKRHiGJe45KeCJJRAVVgss7W31nStUanmlOvfLbwbP1aXsuq nhVEP9pEvH/uYXB8PSXgPsGGsDN6+aU5J7fCOqRULj1eAatxp+zyRZ41/ddMRLWK0l5k 1dFA== X-Gm-Message-State: AGi0PubOcGHY9JCKpMcjnQr3eV8vA6Mwlhs/qsLkQEbhufaN9rXvpgK7 N7so4ggAqvUJpskGf9a3UAwtcA== X-Google-Smtp-Source: APiQypLV23SjfC54Q1LHg6SZYWLyGkwwoyK3iVM5Tzi9X8TGDsumUTG84l+D1pHm49KtzjVqyeEXlg== X-Received: by 2002:a50:c20a:: with SMTP id n10mr3825056edf.319.1587139652153; Fri, 17 Apr 2020 09:07:32 -0700 (PDT) Received: from localhost ([2a02:8084:20e2:c380:1f68:7ff5:120d:64e]) by smtp.gmail.com with ESMTPSA id j5sm2973461edh.4.2020.04.17.09.07.29 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 17 Apr 2020 09:07:29 -0700 (PDT) From: "Basil L. Contovounesios" References: <26d88724-1a8f-4c14-8c56-3529a19acd8a@default> Date: Fri, 17 Apr 2020 17:07:28 +0100 In-Reply-To: <26d88724-1a8f-4c14-8c56-3529a19acd8a@default> (Drew Adams's message of "Thu, 16 Apr 2020 09:31:26 -0700 (PDT)") Message-ID: <87r1wmt7sv.fsf@tcd.ie> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/28.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="=-=-=" X-Spam-Score: -0.8 (/) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.8 (-) --=-=-= Content-Type: text/plain severity 40667 minor tags 40667 + patch quit Drew Adams writes: > 1. Suggestion: have `i tool bar RET' send you to node `Tool Bars', not to > node `Table of Resources'. This is already fixed in Emacs 27/28. > 2. In node (emacs) `Tool Bars' there is a link to (elisp) `Frame > Parameters', for info about parameter `tool-bar-position'. But that > node doesn't present that parameter. Suggestion: change that link, to > point to node `Layout Parameters'. That's where that parameter is > covered. It's not just tool-bar-position; the Emacs manual contains at least three other references to the supernode '(elisp) Frame Parameters' rather than more specific subnodes: --=-=-= Content-Type: text/x-diff Content-Disposition: inline; filename=0001-Use-more-specific-xrefs-to-elisp-Frame-Parameters.patch >From 300b04c4e5a2d42ea210922899d3e5542fef5e8b Mon Sep 17 00:00:00 2001 From: "Basil L. Contovounesios" Date: Fri, 17 Apr 2020 16:56:19 +0100 Subject: [PATCH] Use more specific xrefs to (elisp)Frame Parameters * doc/emacs/frames.texi (Scroll Bars, Tool Bars): Cross-reference more specific subnodes of "(elisp) Frame Parameters". (Bug#40667) --- doc/emacs/frames.texi | 17 +++++++++-------- 1 file changed, 9 insertions(+), 8 deletions(-) diff --git a/doc/emacs/frames.texi b/doc/emacs/frames.texi index 7a583b96bb..e3655edcc4 100644 --- a/doc/emacs/frames.texi +++ b/doc/emacs/frames.texi @@ -1027,7 +1027,7 @@ Scroll Bars You can also use the X resource @samp{verticalScrollBars} to enable or disable the scroll bars (@pxref{Resources}). To control the scroll bar width, change the @code{scroll-bar-width} frame parameter -(@pxref{Frame Parameters,,, elisp, The Emacs Lisp Reference Manual}). +(@pxref{Layout Parameters,,, elisp, The Emacs Lisp Reference Manual}). @vindex scroll-bar-adjust-thumb-portion @cindex overscrolling @@ -1092,7 +1092,7 @@ Scroll Bars You can also use the X resource @samp{horizontalScrollBars} to enable or disable horizontal scroll bars (@pxref{Resources}). To control the scroll bar height, change the @code{scroll-bar-height} frame parameter -(@pxref{Frame Parameters,,, elisp, The Emacs Lisp Reference Manual}). +(@pxref{Layout Parameters,,, elisp, The Emacs Lisp Reference Manual}). @node Window Dividers @section Window Dividers @@ -1229,14 +1229,15 @@ Tool Bars @cindex Tool Bar position You can also control the placement of the tool bar for the GTK+ tool -bar with the frame parameter @code{tool-bar-position}. @xref{Frame -Parameters,,, elisp, The Emacs Lisp Reference Manual}. +bar with the frame parameter @code{tool-bar-position} (@pxref{Layout +Parameters,,, elisp, The Emacs Lisp Reference Manual}). NS builds consider the tool bar to be a window decoration, and -therefore do not display it when a window is undecorated. @xref{Frame -Parameters,,, elisp, The Emacs Lisp Reference Manual}. On macOS the -tool bar is hidden when the frame is put into fullscreen, but can be -displayed by moving the mouse pointer to the top of the screen. +therefore do not display it when a window is undecorated +(@pxref{Management Parameters,,, elisp, The Emacs Lisp Reference +Manual}). On macOS the tool bar is hidden when the frame is put into +fullscreen, but can be displayed by moving the mouse pointer to the +top of the screen. @node Tab Bars @section Tab Bars -- 2.25.1 --=-=-= Content-Type: text/plain Eli, is this welcome on emacs-27? Or is it better to xref the supernode '(elisp) Frame Parameters' for more context? Thanks, -- Basil --=-=-=-- From unknown Sat Aug 16 18:44:04 2025 X-Loop: help-debbugs@gnu.org Subject: bug#40667: 26.3; (1) Emacs manual `i tool bar' (2) `tool-bar-position' Resent-From: Eli Zaretskii Original-Sender: "Debbugs-submit" Resent-CC: bug-gnu-emacs@gnu.org Resent-Date: Sat, 25 Apr 2020 10:43:01 +0000 Resent-Message-ID: Resent-Sender: help-debbugs@gnu.org X-GNU-PR-Message: followup 40667 X-GNU-PR-Package: emacs X-GNU-PR-Keywords: patch To: "Basil L. Contovounesios" Cc: 40667@debbugs.gnu.org, drew.adams@oracle.com Received: via spool by 40667-submit@debbugs.gnu.org id=B40667.15878113761391 (code B ref 40667); Sat, 25 Apr 2020 10:43:01 +0000 Received: (at 40667) by debbugs.gnu.org; 25 Apr 2020 10:42:56 +0000 Received: from localhost ([127.0.0.1]:58707 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1jSIGu-0000ML-CM for submit@debbugs.gnu.org; Sat, 25 Apr 2020 06:42:56 -0400 Received: from eggs.gnu.org ([209.51.188.92]:35944) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1jSIGs-0000M0-5g for 40667@debbugs.gnu.org; Sat, 25 Apr 2020 06:42:54 -0400 Received: from fencepost.gnu.org ([2001:470:142:3::e]:51523) by eggs.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jSIGm-0004HH-B2; Sat, 25 Apr 2020 06:42:48 -0400 Received: from [176.228.60.248] (port=3207 helo=home-c4e4a596f7) by fencepost.gnu.org with esmtpsa (TLS1.2:RSA_AES_256_CBC_SHA1:256) (Exim 4.82) (envelope-from ) id 1jSIGl-0006XJ-Ho; Sat, 25 Apr 2020 06:42:48 -0400 Date: Sat, 25 Apr 2020 13:42:37 +0300 Message-Id: <834kt7978i.fsf@gnu.org> From: Eli Zaretskii In-Reply-To: <87r1wmt7sv.fsf@tcd.ie> (contovob@tcd.ie) References: <26d88724-1a8f-4c14-8c56-3529a19acd8a@default> <87r1wmt7sv.fsf@tcd.ie> X-Spam-Score: -2.3 (--) X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -3.3 (---) > From: "Basil L. Contovounesios" > Date: Fri, 17 Apr 2020 17:07:28 +0100 > Cc: 40667@debbugs.gnu.org > > > 2. In node (emacs) `Tool Bars' there is a link to (elisp) `Frame > > Parameters', for info about parameter `tool-bar-position'. But that > > node doesn't present that parameter. Suggestion: change that link, to > > point to node `Layout Parameters'. That's where that parameter is > > covered. > > It's not just tool-bar-position; the Emacs manual contains at least > three other references to the supernode '(elisp) Frame Parameters' > rather than more specific subnodes: I'm not sure I agree with Drew's suggestion, and therefore with your suggested changes. From the context, it seems to me that the intent is to let the readers understand what the frame parameters are in general, not to let them read on the specific frame parameter being discussed (the text there doesn't say anything new for the reader). > Eli, is this welcome on emacs-27? Or is it better to xref the supernode > '(elisp) Frame Parameters' for more context? I think it's better as it is now, yes. From debbugs-submit-bounces@debbugs.gnu.org Sat Apr 25 07:05:22 2020 Received: (at control) by debbugs.gnu.org; 25 Apr 2020 11:05:22 +0000 Received: from localhost ([127.0.0.1]:58880 helo=debbugs.gnu.org) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1jSIcc-0000z8-Bc for submit@debbugs.gnu.org; Sat, 25 Apr 2020 07:05:22 -0400 Received: from mail-wr1-f68.google.com ([209.85.221.68]:37125) by debbugs.gnu.org with esmtp (Exim 4.84_2) (envelope-from ) id 1jSIca-0000yk-Hf for control@debbugs.gnu.org; Sat, 25 Apr 2020 07:05:21 -0400 Received: by mail-wr1-f68.google.com with SMTP id k1so14591425wrx.4 for ; Sat, 25 Apr 2020 04:05:20 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=tcd-ie.20150623.gappssmtp.com; s=20150623; h=from:to:cc:subject:references:date:in-reply-to:message-id :user-agent:mime-version; bh=k7r0hEyskgoqiieONRxOpAGvyNfZujrtZ1SNHrHHT6U=; b=DTCbzAxZMismCUhpSwPi54+t8JQQeVMXnyzlVYtmHSCYpqEU5y6wJMqaZpVzHyU8rQ Yz3DATgDUdCinKrWVlW1/dp2ihqeausJHRxhzvKry2zZVnFekVFO81eu+UAcjAJBIscO NGmoTup4+auyA55EfsxVR5TlOLAkM2oLs83jguhTjMjPRWcB1kPwctZcbcM/drKeEXy0 E6/wyza4ghrv1BXw6km00czOPUgJbJ3mE5P5Y1Y/D+g5cmrqw32XXhbHx/F7MzXjNIY3 V8Q8taGsLbc1lEiw55999ONBXRsKuR3gnKvXqHkdluI3Bd1bwZCD8HKUWOel4cyZUxJK m6ig== 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; bh=k7r0hEyskgoqiieONRxOpAGvyNfZujrtZ1SNHrHHT6U=; b=h5Opj2YOa69StmwpTZ7N3xY/3cJecFJ5+ZxR7jphs7P7+Zz5N1z+4pAum8VA8OVta8 X5qqD9E41xEaJRUuIIJy052csBzzFS49hze6VsNNU3xnMd0s4s8dk/SnHc4oWqbH0vuI 9L5DPI9spa3vBLGgr4LMy75LbXsvxit2/ve8EZt1wRU/kTcgZ2zA3vAyC3J8LoGbCFxJ szhg3+p+BgunywAXvNKdWyiWuhBSKIaJrZSSTpyZXoTAUv2TO9UE7rBAsbdTnOAuX3XE qGeJXwks3YjJbuFcm2sHGZHa+LQVeQnaYuUFqIgHFwkSRZoc23HMNHNU2/ud/snW4ye5 uD9w== X-Gm-Message-State: AGi0Pua49awcFKF5n814YfdD30zj30p+LWNldsPE3w5/jj5iuYn9fFFd H9WDc/DnhWjaj3Q756EprUrWQw== X-Google-Smtp-Source: APiQypLfu+F2qduOqUNjfUiCtGRx4Xb5eTsZ2KPGJbZktoRXwG70wStyzZtaxsmbzWguIRJ2gEB8Xw== X-Received: by 2002:a05:6000:8b:: with SMTP id m11mr16710311wrx.168.1587812714653; Sat, 25 Apr 2020 04:05:14 -0700 (PDT) Received: from localhost ([2a02:8084:20e2:c380:92bd:1bfd:38fc:fae2]) by smtp.gmail.com with ESMTPSA id i13sm12167236wro.50.2020.04.25.04.05.13 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sat, 25 Apr 2020 04:05:13 -0700 (PDT) From: "Basil L. Contovounesios" To: Eli Zaretskii Subject: Re: bug#40667: 26.3; (1) Emacs manual `i tool bar' (2) `tool-bar-position' References: <26d88724-1a8f-4c14-8c56-3529a19acd8a@default> <87r1wmt7sv.fsf@tcd.ie> <834kt7978i.fsf@gnu.org> Date: Sat, 25 Apr 2020 12:05:12 +0100 In-Reply-To: <834kt7978i.fsf@gnu.org> (Eli Zaretskii's message of "Sat, 25 Apr 2020 13:42:37 +0300") Message-ID: <87lfmjhllj.fsf@tcd.ie> User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/28.0.50 (gnu/linux) MIME-Version: 1.0 Content-Type: text/plain X-Spam-Score: 0.0 (/) X-Debbugs-Envelope-To: control Cc: 40667-done@debbugs.gnu.org, drew.adams@oracle.com X-BeenThere: debbugs-submit@debbugs.gnu.org X-Mailman-Version: 2.1.18 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: debbugs-submit-bounces@debbugs.gnu.org Sender: "Debbugs-submit" X-Spam-Score: -1.0 (-) tags 40667 wontfix close 40667 quit Eli Zaretskii writes: >> From: "Basil L. Contovounesios" >> Date: Fri, 17 Apr 2020 17:07:28 +0100 >> Cc: 40667@debbugs.gnu.org >> >> > 2. In node (emacs) `Tool Bars' there is a link to (elisp) `Frame >> > Parameters', for info about parameter `tool-bar-position'. But that >> > node doesn't present that parameter. Suggestion: change that link, to >> > point to node `Layout Parameters'. That's where that parameter is >> > covered. >> >> It's not just tool-bar-position; the Emacs manual contains at least >> three other references to the supernode '(elisp) Frame Parameters' >> rather than more specific subnodes: > > I'm not sure I agree with Drew's suggestion, and therefore with your > suggested changes. From the context, it seems to me that the intent > is to let the readers understand what the frame parameters are in > general, not to let them read on the specific frame parameter being > discussed (the text there doesn't say anything new for the reader). > >> Eli, is this welcome on emacs-27? Or is it better to xref the supernode >> '(elisp) Frame Parameters' for more context? > > I think it's better as it is now, yes. Fine with me, so I'm closing this report. -- Basil