From mboxrd@z Thu Jan 1 00:00:00 1970 Path: news.gmane.io!.POSTED.ciao.gmane.io!not-for-mail From: "Basil L. Contovounesios" Newsgroups: gmane.emacs.bugs Subject: bug#40667: 26.3; (1) Emacs manual `i tool bar' (2) `tool-bar-position' Date: Fri, 17 Apr 2020 17:07:28 +0100 Message-ID: <87r1wmt7sv.fsf@tcd.ie> References: <26d88724-1a8f-4c14-8c56-3529a19acd8a@default> Mime-Version: 1.0 Content-Type: multipart/mixed; boundary="=-=-=" Injection-Info: ciao.gmane.io; posting-host="ciao.gmane.io:159.69.161.202"; logging-data="91186"; mail-complaints-to="usenet@ciao.gmane.io" User-Agent: Gnus/5.13 (Gnus v5.13) Emacs/28.0.50 (gnu/linux) Cc: 40667@debbugs.gnu.org To: Drew Adams Original-X-From: bug-gnu-emacs-bounces+geb-bug-gnu-emacs=m.gmane-mx.org@gnu.org Fri Apr 17 18:08:14 2020 Return-path: Envelope-to: geb-bug-gnu-emacs@m.gmane-mx.org Original-Received: from lists.gnu.org ([209.51.188.17]) by ciao.gmane.io with esmtps (TLS1.2:ECDHE_RSA_AES_256_GCM_SHA384:256) (Exim 4.92) (envelope-from ) id 1jPTXK-000NeI-BY for geb-bug-gnu-emacs@m.gmane-mx.org; Fri, 17 Apr 2020 18:08:14 +0200 Original-Received: from localhost ([::1]:49216 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jPTXJ-0004Lw-EC for geb-bug-gnu-emacs@m.gmane-mx.org; Fri, 17 Apr 2020 12:08:13 -0400 Original-Received: from eggs.gnu.org ([2001:470:142:3::10]:58516) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1jPTX9-0004Ko-Gv for bug-gnu-emacs@gnu.org; Fri, 17 Apr 2020 12:08:04 -0400 Original-Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1jPTX8-0004DK-9j for bug-gnu-emacs@gnu.org; Fri, 17 Apr 2020 12:08:03 -0400 Original-Received: from debbugs.gnu.org ([209.51.188.43]:58251) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1jPTX7-0004D9-Vo for bug-gnu-emacs@gnu.org; Fri, 17 Apr 2020 12:08:02 -0400 Original-Received: from Debian-debbugs by debbugs.gnu.org with local (Exim 4.84_2) (envelope-from ) id 1jPTX7-0001ub-RR for bug-gnu-emacs@gnu.org; Fri, 17 Apr 2020 12:08:01 -0400 X-Loop: help-debbugs@gnu.org 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 Original-Received: via spool by 40667-submit@debbugs.gnu.org id=B40667.15871396627323 (code B ref 40667); Fri, 17 Apr 2020 16:08:01 +0000 Original-Received: (at 40667) by debbugs.gnu.org; 17 Apr 2020 16:07:42 +0000 Original-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 Original-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 Original-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) Original-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) In-Reply-To: <26d88724-1a8f-4c14-8c56-3529a19acd8a@default> (Drew Adams's message of "Thu, 16 Apr 2020 09:31:26 -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: 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-mx.org@gnu.org Original-Sender: "bug-gnu-emacs" Xref: news.gmane.io gmane.emacs.bugs:178530 Archived-At: --=-=-= 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 --=-=-=--