diff options
| author | Kirill Primak <vyivel@eclair.cafe> | 2022-03-04 00:34:51 +0300 |
|---|---|---|
| committer | Simon Ser <contact@emersion.fr> | 2022-04-06 06:33:51 +0000 |
| commit | 9b25b514c455ff3cbd237c721e150fe834d20977 (patch) | |
| tree | 6907e939cebfebaabfd230717bc827f53f924ba7 /stable | |
| parent | db85bc1467e5f7f24e34f19f743abe15384edf3b (diff) | |
xdg-shell: clarify setting the parent to an unmapped toplevel
Signed-off-by: Kirill Primak <vyivel@eclair.cafe>
Diffstat (limited to 'stable')
| -rw-r--r-- | stable/xdg-shell/xdg-shell.xml | 18 |
1 files changed, 9 insertions, 9 deletions
diff --git a/stable/xdg-shell/xdg-shell.xml b/stable/xdg-shell/xdg-shell.xml index c5b0476..f4b23c5 100644 --- a/stable/xdg-shell/xdg-shell.xml +++ b/stable/xdg-shell/xdg-shell.xml @@ -615,19 +615,19 @@ Set the "parent" of this surface. This surface should be stacked above the parent surface and all other ancestor surfaces. - Parent windows should be set on dialogs, toolboxes, or other + Parent surfaces should be set on dialogs, toolboxes, or other "auxiliary" surfaces, so that the parent is raised when the dialog is raised. - Setting a null parent for a child window removes any parent-child - relationship for the child. Setting a null parent for a window which - currently has no parent is a no-op. + Setting a null parent for a child surface unsets its parent. Setting + a null parent for a surface which currently has no parent is a no-op. - If the parent is unmapped then its children are managed as - though the parent of the now-unmapped parent has become the - parent of this surface. If no parent exists for the now-unmapped - parent then the children are managed as though they have no - parent surface. + Only mapped surfaces can have child surfaces. Setting a parent which + is not mapped is equivalent to setting a null parent. If a surface + becomes unmapped, its children's parent is set to the parent of + the now-unmapped surface. If the now-unmapped surface has no parent, + its children's parent is unset. If the now-unmapped surface becomes + mapped again, its parent-child relationship is not restored. </description> <arg name="parent" type="object" interface="xdg_toplevel" allow-null="true"/> </request> |