summaryrefslogtreecommitdiff
path: root/devdocs/elisp/frame-titles.html
diff options
context:
space:
mode:
authorCraig Jennings <c@cjennings.net>2024-04-07 13:41:34 -0500
committerCraig Jennings <c@cjennings.net>2024-04-07 13:41:34 -0500
commit754bbf7a25a8dda49b5d08ef0d0443bbf5af0e36 (patch)
treef1190704f78f04a2b0b4c977d20fe96a828377f1 /devdocs/elisp/frame-titles.html
new repository
Diffstat (limited to 'devdocs/elisp/frame-titles.html')
-rw-r--r--devdocs/elisp/frame-titles.html14
1 files changed, 14 insertions, 0 deletions
diff --git a/devdocs/elisp/frame-titles.html b/devdocs/elisp/frame-titles.html
new file mode 100644
index 00000000..3edef4e4
--- /dev/null
+++ b/devdocs/elisp/frame-titles.html
@@ -0,0 +1,14 @@
+ <h3 class="section">Frame Titles</h3> <p>Every frame has a <code>name</code> parameter; this serves as the default for the frame title which window systems typically display at the top of the frame. You can specify a name explicitly by setting the <code>name</code> frame property. </p> <p>Normally you don’t specify the name explicitly, and Emacs computes the frame name automatically based on a template stored in the variable <code>frame-title-format</code>. Emacs recomputes the name each time the frame is redisplayed. </p> <dl> <dt id="frame-title-format">Variable: <strong>frame-title-format</strong>
+</dt> <dd><p>This variable specifies how to compute a name for a frame when you have not explicitly specified one. The variable’s value is actually a mode line construct, just like <code>mode-line-format</code>, except that the ‘<samp>%c</samp>’, ‘<samp>%C</samp>’, and ‘<samp>%l</samp>’ constructs are ignored. See <a href="mode-line-data">Mode Line Data</a>. </p></dd>
+</dl> <dl> <dt id="icon-title-format">Variable: <strong>icon-title-format</strong>
+</dt> <dd><p>This variable specifies how to compute the name for an iconified frame, when you have not explicitly specified the frame title. This title appears in the icon itself. </p></dd>
+</dl> <dl> <dt id="multiple-frames">Variable: <strong>multiple-frames</strong>
+</dt> <dd>
+<p>This variable is set automatically by Emacs. Its value is <code>t</code> when there are two or more frames (not counting minibuffer-only frames or invisible frames). The default value of <code>frame-title-format</code> uses <code>multiple-frames</code> so as to put the buffer name in the frame title only when there is more than one frame. </p> <p>The value of this variable is not guaranteed to be accurate except while processing <code>frame-title-format</code> or <code>icon-title-format</code>. </p>
+</dd>
+</dl><div class="_attribution">
+ <p class="_attribution-p">
+ Copyright &copy; 1990-1996, 1998-2022 Free Software Foundation, Inc. <br>Licensed under the GNU GPL license.<br>
+ <a href="https://www.gnu.org/software/emacs/manual/html_node/elisp/Frame-Titles.html" class="_attribution-link">https://www.gnu.org/software/emacs/manual/html_node/elisp/Frame-Titles.html</a>
+ </p>
+</div>