; Fix documentation of a recent commit

* doc/emacs/frames.texi (Frame Commands): Document
'alter-fullscreen-frames', which is a user option.  Fix indexing.

* src/frame.c (syms_of_frame) <alter-fullscreen-frames>: Doc fix.
(Bug#79756)
This commit is contained in:
Eli Zaretskii 2025-11-02 10:48:13 +02:00
parent 6d36c6b6f9
commit 69b0aa2928
2 changed files with 16 additions and 12 deletions

View file

@ -528,51 +528,55 @@ frames by specifying @dfn{frame parameters}. @xref{Frame Parameters}.
The following commands are used to delete and operate on frames:
@table @kbd
@item C-x 5 0
@kindex C-x 5 0
@findex delete-frame
@item C-x 5 0
Delete the selected frame (@code{delete-frame}). This signals an
error if there is only one frame.
@item C-x 5 u
@kindex C-x 5 u
@findex undelete-frame
@findex undelete-frame-mode
@item C-x 5 u
When @code{undelete-frame-mode} is enabled, undelete one of the 16
most recently deleted frames. Without a prefix argument, undelete the
most recently deleted frame. With a numerical prefix argument between
1 and 16, where 1 is the most recently deleted frame, undelete the
corresponding deleted frame.
@item C-z
@kindex C-z @r{(X windows)}
@item C-z
Minimize (or iconify) the selected Emacs frame
(@code{suspend-frame}). @xref{Exiting}.
@item C-x 5 o
@kindex C-x 5 o
@findex other-frame
@item C-x 5 o
Select another frame, and raise it. If you repeat this command, it
cycles through all the frames on your terminal.
@item C-x 5 1
@kindex C-x 5 1
@findex delete-other-frames
@item C-x 5 1
Delete all frames on the current terminal, except the selected one.
@item M-@key{F10}
@kindex M-F10
@findex toggle-frame-maximized
@item M-@key{F10}
Toggle the maximization state of the current frame. When a frame is
maximized, it fills the screen.
@item @key{F11}
@kindex F11
@findex toggle-frame-fullscreen
@vindex alter-fullscreen-frames
@cindex resizing full-screen frames
@item @key{F11}
Toggle full-screen mode for the current frame. (The difference
between full-screen and maximized is normally that the former
hides window manager decorations, giving slightly more screen space to
Emacs itself.)
Emacs itself.) Note that whether resizing of full-screen frames is
allowed and how Emacs handles that is controlled by the user option
@code{alter-fullscreen-frames}.
@end table
@vindex frame-resize-pixelwise

View file

@ -7509,9 +7509,9 @@ allow `make-frame' to show the current buffer even if its hidden. */);
#endif
DEFVAR_LISP ("alter-fullscreen-frames", alter_fullscreen_frames,
doc: /* How to handle requests to alter fullscreen frames.
doc: /* How to handle requests to resize fullscreen frames.
Emacs consults this option when asked to resize a fullscreen frame via
functions like 'set-frame-size' or when setting the 'width' or 'height'
functions like `set-frame-size' or when setting the \\+`width' or \\+`height'
parameter of a frame. The following values are provided:
- nil means to forward the resize request to the window manager and
@ -7520,10 +7520,10 @@ parameter of a frame. The following values are provided:
- t means to first reset the fullscreen status and then forward the
request to the window manager.
- 'inhibit' means to reject the resize request and leave the fullscreen
- \\+`inhibit' means to reject the resize request and leave the fullscreen
status unchanged.
The default is 'inhibit' on NS builds and nil everywhere else. */);
The default is \\+`inhibit' in NS builds and nil everywhere else. */);
#if defined (NS_IMPL_COCOA)
alter_fullscreen_frames = Qinhibit;