From: "Basil L. Contovounesios" <contovob@tcd.ie>
To: Drew Adams <drew.adams@oracle.com>
Cc: 40667@debbugs.gnu.org
Subject: bug#40667: 26.3; (1) Emacs manual `i tool bar' (2) `tool-bar-position'
Date: Fri, 17 Apr 2020 17:07:28 +0100 [thread overview]
Message-ID: <87r1wmt7sv.fsf@tcd.ie> (raw)
In-Reply-To: <26d88724-1a8f-4c14-8c56-3529a19acd8a@default> (Drew Adams's message of "Thu, 16 Apr 2020 09:31:26 -0700 (PDT)")
[-- Attachment #1: Type: text/plain, Size: 699 bytes --]
severity 40667 minor
tags 40667 + patch
quit
Drew Adams <drew.adams@oracle.com> 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:
[-- Warning: decoded text below may be mangled, UTF-8 assumed --]
[-- Attachment #2: 0001-Use-more-specific-xrefs-to-elisp-Frame-Parameters.patch --]
[-- Type: text/x-diff, Size: 2571 bytes --]
From 300b04c4e5a2d42ea210922899d3e5542fef5e8b Mon Sep 17 00:00:00 2001
From: "Basil L. Contovounesios" <contovob@tcd.ie>
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
[-- Attachment #3: Type: text/plain, Size: 139 bytes --]
Eli, is this welcome on emacs-27? Or is it better to xref the supernode
'(elisp) Frame Parameters' for more context?
Thanks,
--
Basil
next prev parent reply other threads:[~2020-04-17 16:07 UTC|newest]
Thread overview: 4+ messages / expand[flat|nested] mbox.gz Atom feed top
2020-04-16 16:31 bug#40667: 26.3; (1) Emacs manual `i tool bar' (2) `tool-bar-position' Drew Adams
2020-04-17 16:07 ` Basil L. Contovounesios [this message]
2020-04-25 10:42 ` Eli Zaretskii
2020-04-25 11:05 ` Basil L. Contovounesios
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=87r1wmt7sv.fsf@tcd.ie \
--to=contovob@tcd.ie \
--cc=40667@debbugs.gnu.org \
--cc=drew.adams@oracle.com \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this external index
https://git.savannah.gnu.org/cgit/emacs.git
https://git.savannah.gnu.org/cgit/emacs/org-mode.git
This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.