bug#72825: [PATCH] Fix the doc on setting tool-bar-mode at startup

[Krystian Samp <samp.krystian@gmail.com>]

[-- Attachment #1.1: Type: text/plain, Size: 574 bytes --]

Tags: patch

Emacs info doc states: "To control the use of tool bars at startup,
customize the variable `tool-bar-mode`."

`describe-variable` for `tool-bar-mode` states: "Setting this variable
directly does not take effect;" and suggests to customize it through a call
to `tool-bar-mode` function.

The latter seems to be the correct way. Setting `tool-bar-mode` variable in
init.el has no effect, but calling (tool-bar-mode -1) does work as
expected. Therefore, the patch changes the Emacs info doc to also suggest
customization through a function call.

Thanks,
Krystian

[-- Attachment #1.2: Type: text/html, Size: 722 bytes --]

[-- Attachment #2: 0001-Fix-the-doc-on-setting-tool-bar-mode-at-startup.patch --]
[-- Type: application/octet-stream, Size: 910 bytes --]

From c0ef9595302f0d7d581d5d6f4d883e0dee1e28ee Mon Sep 17 00:00:00 2001
From: Krystian Samp <samp.krystian@gmail.com>
Date: Mon, 26 Aug 2024 00:13:37 +0200
Subject: [PATCH] Fix the doc on setting tool-bar-mode at startup

---
 doc/emacs/frames.texi | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doc/emacs/frames.texi b/doc/emacs/frames.texi
index b5f2c5f5e84..ab046126293 100644
--- a/doc/emacs/frames.texi
+++ b/doc/emacs/frames.texi
@@ -1316,7 +1316,7 @@ prevent this replacement from happening, customize the variable
 @vindex tool-bar-mode
   To toggle the use of tool bars, type @kbd{M-x tool-bar-mode}.  This
 command applies to all frames, including frames yet to be created.  To
-control the use of tool bars at startup, customize the variable
+control the use of tool bars at startup, call the function
 @code{tool-bar-mode}.
 
 @vindex tool-bar-style
-- 
2.39.3 (Apple Git-146)