From 3533623c4a007df80d57fe2dbc47d7e40d85041c Mon Sep 17 00:00:00 2001 From: Alan Third Date: Wed, 19 Apr 2017 20:36:40 +0100 Subject: Note frame documentation exceptions for NS builds * doc/lispref/frames.texi (Management Parameters, Child Frames): Note NS differences. --- doc/lispref/frames.texi | 20 ++++++++++++++------ 1 file changed, 14 insertions(+), 6 deletions(-) (limited to 'doc/lispref/frames.texi') diff --git a/doc/lispref/frames.texi b/doc/lispref/frames.texi index 8fc4d7d6497..bed7873fe3f 100644 --- a/doc/lispref/frames.texi +++ b/doc/lispref/frames.texi @@ -1894,6 +1894,9 @@ display has been suspended via window manager settings. Under X, Emacs uses the Motif window manager hints to turn off decorations. Some window managers may not honor these hints. +NS builds consider the tool bar to be a decoration, and therefore hide +it on an undecorated frame. + @vindex override-redirect, a frame parameter @item override-redirect @cindex override redirect frames @@ -2846,6 +2849,10 @@ is resized, the relative position of the child frame remains unaltered. Hence, resizing either of these frames can hide or reveal parts of the child frame. + NS builds do not clip child frames at the parent frame's edges, +allowing them to be positioned so they do not obscure the parent +frame while still being visible themselves. + Usually, moving a parent frame moves along all its child frames and their descendants as well, keeping their relative positions unaltered. The hook @code{move-frame-functions} (@pxref{Frame Position}) is run for @@ -2856,12 +2863,13 @@ its parent. In this case, the position respective to the lower or right native edge of the parent frame is usually lost. A visible child frame always appears on top of its parent frame thus -obscuring parts of it. This is comparable to the window-system window -of a top-level frame which also always appears on top of its parent -window---the desktop's root window. When a parent frame is iconified or -made invisible (@pxref{Visibility of Frames}), its child frames are made -invisible. When a parent frame is deiconified or made visible, its -child frames are made visible. When a parent frame is about to be +obscuring parts of it, except on NS builds where it may be positioned +beneath the parent. This is comparable to the window-system window of +a top-level frame which also always appears on top of its parent +window---the desktop's root window. When a parent frame is iconified +or made invisible (@pxref{Visibility of Frames}), its child frames are +made invisible. When a parent frame is deiconified or made visible, +its child frames are made visible. When a parent frame is about to be deleted, (@pxref{Deleting Frames}) its child frames are recursively deleted before it. -- cgit v1.2.1