system tray orientation hint

[Mark McLoughlin]

Hi,
	Nearly 18 months ago I suggested the addition of an orienation hint to
the system tray and then subsequently forgot all about it. Here's the
original message:

  https://listman.redhat.com/archives/xdg-list/2003-April/msg00021.html

	The hint is needed for tray icons who wish to scale to the width/height
of the panel, and therefore need to know whether the panel is vertically
or horizontally orientated.

	I'll commit soon unless there are any objections. Fernando (who
reminded me about this) has already volunteered to write the KDE
patch :-)

Thanks,
Mark.

Index: systemtray-spec.xml
===================================================================
RCS file: /cvs/systemtray/systemtray-spec/systemtray-spec.xml,v
retrieving revision 1.1
diff -u -p -r1.1 systemtray-spec.xml
--- systemtray-spec.xml	9 Jul 2003 14:18:06 -0000	1.1
+++ systemtray-spec.xml	23 Nov 2004 13:13:24 -0000
@@ -5,8 +5,8 @@
 <article id="index">
   <articleinfo>
     <title>System Tray Protocol Specification</title>
-    <releaseinfo>Version 0.1</releaseinfo>
-    <date>19 September 2002</date>
+    <releaseinfo>Version 0.2</releaseinfo>
+    <date>23 November 2004</date>
     <authorgroup>
       <author>
 	<firstname>Havoc</firstname>
@@ -256,6 +256,32 @@ _NET_WM_ICON CARDINAL[][2+n]/32
 
   </sect1>
 
+  <sect1 id="manager-hints">
+    <title>Tray manager hints</title>
+    <para>
+The tray manager should set the following hints on the selection
+owner window.
+    </para>
+
+    <sect2>
+      <title>_NET_SYSTEM_TRAY_ORIENTATION</title>
+      <programlisting><![CDATA[
+_NET_SYSTEM_TRAY_ORIENTATION orientation CARDINAL/32
+]]>
+  #define _NET_SYSTEM_TRAY_ORIENTATION_HORZ 0
+  #define _NET_SYSTEM_TRAY_ORIENTATION_VERT 1
+      </programlisting>
+
+      <para>
+The property should be set by the tray manager to indicate the current
+orientation of the tray. Tray icons may use this hint in order to
+maintain the icon's aspect ratio and also as an indication of how the
+icon contents should be laid out.
+      </para>
+
+    </sect2>
+  </sect1>
+
   <sect1 id="balloon">
     <title>Balloon messages</title>
     <para>
@@ -327,6 +353,18 @@ _NET_WM_ICON CARDINAL[][2+n]/32
   <appendix id="changes">
     <title>Change history</title>
     <formalpara>
+      <title>Version 0.2, 23 November 2004, Mark McLoughlin</title>    
+      <para>
+	<itemizedlist>
+	  <listitem>
+	    <para>
+              Added the _NET_SYSTEM_TRAY_ORIENTATION hint.
+	    </para>
+	  </listitem>
+	</itemizedlist>
+      </para>
+    </formalpara>
+    <formalpara>
       <title>Version 0.1, 20 April 2002, Havoc Pennington</title>    
       <para>
 	<itemizedlist>