Note how fullscreen differs on the NS port

doc/lispref/frames.texi (Size Parameters):
doc/emacs/frames.texi (Tool Bars): Add a description of how macOS
hides the tool-bar and menu-bar in fullscreen.

diff --git a/doc/emacs/frames.texi b/doc/emacs/frames.texi
index 8984555066b322d154198e5ee392183eaf901faa..e3e59ad43acccc9e63f10d9b5a6012352e51c48a 100644 (file)
--- a/doc/emacs/frames.texi
+++ b/doc/emacs/frames.texi
@@ -1153,6 +1153,12 @@ specific tool bar style, customize the variable @code{tool-bar-style}.
 bar with the frame parameter @code{tool-bar-position}.  @xref{Frame
 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.
+
 @node Dialog Boxes
 @section Using Dialog Boxes
 @cindex dialog boxes

diff --git a/doc/lispref/frames.texi b/doc/lispref/frames.texi
index fc7956d12e35d5cee72b6f18892797972a32e680..50467d1dfd5b248db99b2df097e2c0cf5368d566 100644 (file)
--- a/doc/lispref/frames.texi
+++ b/doc/lispref/frames.texi
@@ -1602,6 +1602,10 @@ managers might not support smooth transition between the various
 full-screen or maximization states.  Customizing the variable
 @code{x-frame-normalize-before-maximize} can help to overcome that.
 
+Full-screen on macOS hides both the tool-bar and the menu-bar, however
+both will be displayed if the mouse pointer is moved to the top of the
+screen.
+
 @vindex fullscreen-restore, a frame parameter
 @item fullscreen-restore
 This parameter specifies the desired fullscreen state of the frame