summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--doc/Makefile.am2
-rw-r--r--doc/dialogs.txt32
2 files changed, 33 insertions, 1 deletions
diff --git a/doc/Makefile.am b/doc/Makefile.am
index f2c0073..043a127 100644
--- a/doc/Makefile.am
+++ b/doc/Makefile.am
@@ -1,2 +1,2 @@
-EXTRA_DIST=theme-format.txt metacity-theme.dtd
+EXTRA_DIST=theme-format.txt metacity-theme.dtd dialogs.txt
diff --git a/doc/dialogs.txt b/doc/dialogs.txt
new file mode 100644
index 0000000..1a28e6a
--- /dev/null
+++ b/doc/dialogs.txt
@@ -0,0 +1,32 @@
+Dialogs which have no transient parent or root window being
+their tranisent parent are the ones which will be visible in
+the tasklist.
+
+All such dialogs will be *always* on top of the window
+group i.e they would transients for the whole group.
+
+
+1) Modal dialogs
+
+
+ * If you wish to open another window from a modal dialog
+
+ open *only* a modal dialog and set it's transient parent.
+
+
+2) Normal dialog
+
+
+ without transient parent
+
+ * If you wish to open another window from a normal dialog
+
+ open either a normal dialog or a modal dialog only.
+ Set the transient parent for the child dialog if you do not
+ want them to be transient for all the other windows in the group.
+
+ with transient parent
+
+ * If you wish to open another window from a normal dialog
+
+ you could open any type of window.