From 2ab0ee8ad15d9b46da9d78a307ef5552197db65d Mon Sep 17 00:00:00 2001
From: matthiasc <matthiasc>
Date: Fri, 3 Jan 2003 20:29:28 +0000
Subject: New draft.

---
 wm-spec/wm-spec.sgml | 50 +++++++++++++++++++++++++++++++-------------------
 1 file changed, 31 insertions(+), 19 deletions(-)

(limited to 'wm-spec')

diff --git a/wm-spec/wm-spec.sgml b/wm-spec/wm-spec.sgml
index f3e46cf..400ca69 100644
--- a/wm-spec/wm-spec.sgml
+++ b/wm-spec/wm-spec.sgml
@@ -1,6 +1,6 @@
 <!doctype article PUBLIC "-//OASIS//DTD DocBook V4.1//EN" [
 <!entity version "Draft version 1.3">
-<!entity date "November 27, 2002">
+<!entity date "January 3, 2003">
 ]>
 <article id="index">
 <articleinfo>
@@ -18,7 +18,11 @@
 	<sect2>
 		<title>Version</title>
 		<para>
-This is &version; of the Extended Window Manager Hints (EWMH) spec, updated &date;.
+This is &version; of the Extended Window Manager Hints (EWMH) spec, updated
+&date;. The canonical home for this document is <ulink
+url="http://www.freedesktop.org/standards/wm-spec.html">http://www.freedesktop.org</ulink>,
+which also contains directions for reporting bugs or contributing to future
+versions.
 		</para>
 	</sect2>
 	<sect2>
@@ -483,7 +487,7 @@ windows.
         <sect2>
         <title>_NET_DESKTOP_LAYOUT</title>
         <programlisting><![CDATA[
-_NET_DESKTOP_LAYOUT, orientation, x, y, starting_corner CARDINAL[4]/32
+_NET_DESKTOP_LAYOUT, orientation, columns, rows, starting_corner CARDINAL[4]/32
 ]]>
   #define _NET_WM_ORIENTATION_HORZ 0
   #define _NET_WM_ORIENTATION_VERT 1
@@ -519,19 +523,20 @@ _NET_DESKTOP_LAYOUT, orientation, x, y, starting_corner CARDINAL[4]/32
   use _NET_WM_TOPLEFT as the starting corner in this case.
   </para>
   <para>
-  The virtual desktops are arranged in a rectangle
-  with X rows and Y columns.  If X times Y does not match the total number of
-  desktops as specified by
+  The virtual desktops are arranged in a rectangle with 
+  <literal>rows</literal> rows and <literal>columns</literal> columns.
+  If <literal>rows</literal> times <literal>columns</literal> does not match 
+  the total number of desktops as specified by
   _NET_NUMBER_OF_DESKTOPS, the highest-numbered
-  workspaces are assumed to be nonexistent. Either X or Y (but not
-  both) may be specified as 0 in which case its actual value will be
-  derived from _NET_NUMBER_OF_DESKTOPS.
+  workspaces are assumed to be nonexistent. Either <literal>rows</literal> or 
+  <literal>columns</literal> (but not both) may be specified as 0 in which 
+  case its actual value will be derived from _NET_NUMBER_OF_DESKTOPS.
         </para>
         <para>
   When the orientation is _NET_WM_ORIENTATION_HORZ
   the desktops are laid out in rows, with the first desktop in the 
-  specified starting corner. So a layout with X=4 and Y=3 starting in 
-  the _NET_WM_TOPLEFT corner looks like this:
+  specified starting corner. So a layout with four columns and three rows 
+  starting in the _NET_WM_TOPLEFT corner looks like this:
 <programlisting>
  +--+--+--+--+
  | 0| 1| 2| 3|
@@ -541,8 +546,7 @@ _NET_DESKTOP_LAYOUT, orientation, x, y, starting_corner CARDINAL[4]/32
  | 8| 9|10|11|
  +--+--+--+--+
 </programlisting>
-With starting_corner _NET_WM_BOTTOMRIGHT, it looks like
-this:
+With starting_corner _NET_WM_BOTTOMRIGHT, it looks like this:
 <programlisting>
  +--+--+--+--+
  |11|10| 9| 8|
@@ -555,9 +559,8 @@ this:
 
          </para>
         <para>
-
   When the orientation is _NET_WM_ORIENTATION_VERT
-  the layout for X=4 and Y=3 starting in the _NET_WM_TOPLEFT
+  the layout with four columns and three rows starting in the _NET_WM_TOPLEFT
   corner looks like:
 
 <programlisting>
@@ -935,10 +938,10 @@ them from the list. These extension atoms MUST NOT start with the prefix
 _NET. 
       </para>
 	<para>
-_NET_WM_STATE_MODAL indicates that this is a modal dialog box.  The
-WM_TRANSIENT_FOR hint MUST be set to indicate which window the dialog is a
-modal for, or set to the root window if the dialog is a modal for its window
-group.
+_NET_WM_STATE_MODAL indicates that this is a modal dialog box.  
+If the WM_TRANSIENT_FOR hint is set to another toplevel window, the 
+dialog is modal for that window; if WM_TRANSIENT_FOR is not set or set
+to the root window the dialog is modal for its window group.
 	</para>
 	<para>
 _NET_WM_STATE_STICKY indicates that the Window Manager SHOULD keep the
@@ -1704,6 +1707,15 @@ to "Window Geometry".
 Rewrote the implementation notes on "Urgency", making it clear that
 the hint is not just about dialogs.
  			</para></listitem>
+ 			<listitem><para>
+Fixed the specification of the X and Y members of _NET_DESKTOP_LAYOUT
+and renamed them to columns and row for clarity.
+ 			</para></listitem>
+ 			<listitem><para>
+Change the description of _NET_WM_STATE_MODAL to no longer require apps to 
+break the ICCCM for group-modal windows, but still support the 
+WM_TRANSIENT_FOR=root dialect.
+ 			</para></listitem>
 	        </itemizedlist>
             </sect2>
  	    <sect2>
-- 
cgit v1.2.3-70-g09d2