config option for icons in desktop menus
[mikachu/openbox.git] / data / rc.xsd
1 <?xml version="1.0" encoding="UTF-8"?>
2 <!--
3      xml Schema for the openbox windowmanager configuration file
4
5      Changes:
6      Son Aug 10 15:49:10 CEST 2003 - pch(a)myzel.net
7          restrictions added, up to current format
8      Don Aug 14 21:10:27 CEST 2003 - pch(a)myzel.net
9          up to current (from action.c,config.c)
10      Don Aug 21 23:07:30 CEST 2003 - pch(a)myzel.net
11          new element - follow
12      Mon Sep  1 00:57:55 CEST 2003 - pch(a)myzel.net
13          up to alpha7
14      Mit Sep  3 12:40:10 CEST 2003 - pch(a)myzel.net
15          up to alpha8, a little documentation
16      Mon Sep  8 11:52:07 CEST 2003 - pch(a)myzel.net
17          up to cvs 1.12
18      Mon Sep 15 14:27:42 CEST 2003 - pch(a)myzel.net
19          up to cvs 1.14
20      Die Sep 16 20:56:37 CEST 2003 - pch(a)myzel.net
21          use a namespace
22      Fri Sep 19 14:36:33 EDT 2003 - xor(a)orodu.net
23          use openbox.org for namespace
24      Mon Sep 22 02:34:53 EDT 2003 - xor(a)orodu.net
25          add the focusLast and raiseOnFocus options
26          fix some capitalization
27      Mon Sep 22 14:08:16 EDT 2003 - xor(a)orodu.net
28          update hideTimeout to hideDelay
29      Thu Apr 22 12:33:11 UTC 2004 - mikachu(a)openbox.org
30          add diffs between 3.1 and 3.2
31      Sun Oct 31 10:08:34 UTC 2004 - mikachu(a)openbox.org
32          we haven't remembered to update this changelog in a while,
33          adding desktopMenuIcons.
34 -->
35 <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"
36     targetNamespace="http://openbox.org/"
37     xmlns:ob="http://openbox.org/"
38     elementFormDefault="qualified">
39     <!--
40          root node
41       -->
42     <xs:element name="openbox_config">
43         <xs:annotation>
44             <xs:documentation>all these elements are expected in a openbox config file</xs:documentation>
45         </xs:annotation>
46         <xs:complexType>
47             <xs:sequence>
48                 <xs:element name="resistance" type="ob:resistance"/>
49                 <xs:element name="focus" type="ob:focus"/>
50                 <xs:element name="placement" type="ob:placement"/>
51                 <xs:element name="theme" type="ob:theme"/>
52                 <xs:element name="desktops" type="ob:desktops"/>
53                 <xs:element name="resize" type="ob:resize"/>
54                 <xs:element name="dock" type="ob:dock"/>
55                 <xs:element name="keyboard" type="ob:keyboard"/>
56                 <xs:element name="mouse" type="ob:mouse"/>
57                 <xs:element name="menu" type="ob:menu"/>
58             </xs:sequence>
59         </xs:complexType>
60     </xs:element>
61     <!--
62          complex types
63       -->
64     <xs:complexType name="resistance">
65         <xs:annotation>
66             <xs:documentation>defines behaviour of windows when close to eachother or the screen edge</xs:documentation>
67         </xs:annotation>
68         <xs:sequence>
69             <xs:element name="strength" type="xs:integer"/>
70             <xs:element name="screen_edge_strength" type="xs:integer"/>
71             <xs:element name="edges_hit_layers_below" type="xs:yesorno"/>
72         </xs:sequence>
73     </xs:complexType>
74     <xs:complexType name="focus">
75         <xs:annotation>
76             <xs:documentation>defines aspects of window focus</xs:documentation>
77         </xs:annotation>
78         <xs:sequence>
79             <xs:element name="focusNew" type="ob:yesorno"/>
80             <xs:element name="focusLast" type="ob:yesorno"/>
81             <xs:element name="followMouse" type="ob:yesorno"/>
82             <xs:element name="focusDelay" type="xs:integer"/>
83             <xs:element name="raiseOnFocus" type="ob:yesorno"/>
84         </xs:sequence>
85     </xs:complexType>
86     <xs:complexType name="placement">
87         <xs:annotation>
88             <xs:documentation>defines how new windows are placed</xs:documentation>
89         </xs:annotation>
90         <xs:sequence>
91             <xs:element name="policy" type="ob:placementpolicy"/>
92         </xs:sequence>
93     </xs:complexType>
94     <xs:complexType name="theme">
95         <xs:sequence>
96             <xs:element name="name" type="xs:string"/>
97             <xs:element name="titlelayout" type="xs:string"/>
98             <xs:element name="keepBorder" type="ob:yesorno"/>
99         </xs:sequence>
100     </xs:complexType>
101     <xs:complexType name="desktops">
102         <xs:sequence>
103             <xs:element name="number" type="xs:integer"/>
104             <xs:element name="names">
105                 <xs:complexType>
106                     <xs:sequence>
107                         <xs:element maxOccurs="unbounded" name="name" type="xs:string"/>
108                     </xs:sequence>
109                 </xs:complexType>
110             </xs:element>
111             <xs:element name="firstdesk" type="xs:integer"/>
112         </xs:sequence>
113     </xs:complexType>
114     <xs:complexType name="resize">
115         <xs:sequence>
116             <xs:element name="drawContents" type="ob:yesorno"/>
117             <xs:element name="popupShow" type="ob:popupshow"/>
118             <xs:element name="popupPosition" type="ob:popupposition"/>
119         </xs:sequence>
120     </xs:complexType>
121     <xs:complexType name="dock">
122         <xs:sequence>
123             <xs:element name="position" type="ob:position"/>
124             <xs:element name="stacking" type="ob:stacking"/>
125             <xs:element name="direction" type="ob:direction"/>
126             <xs:element name="floatingX" type="xs:integer"/>
127             <xs:element name="floatingY" type="xs:integer"/>
128             <xs:element name="autoHide" type="ob:yesorno"/>
129             <xs:element name="hideDelay" type="xs:integer"/>
130             <xs:element name="disktopMenuIcons" type="ob:yesorno"/>
131             <xs:element name="moveButton" type="ob:button"/>
132         </xs:sequence>
133     </xs:complexType>
134     <xs:complexType name="action">
135         <xs:sequence>
136             <xs:element minOccurs="0" name="menu" type="xs:string"/>
137             <xs:element minOccurs="0" name="desktop" type="xs:integer"/>
138             <xs:element minOccurs="0" name="follow" type="ob:yesorno"/>
139             <xs:element minOccurs="0" name="execute" type="xs:string"/>
140             <xs:element minOccurs="0" name="dialog" type="ob:yesorno"/>
141         </xs:sequence>
142         <xs:attribute name="name" type="ob:actionname" use="required"/>
143     </xs:complexType>
144     <xs:complexType name="keybind">
145         <xs:sequence>
146             <xs:element maxOccurs="unbounded" name="action" type="ob:action"/>
147         </xs:sequence>
148         <xs:attribute name="key" type="ob:keyname" use="required"/>
149     </xs:complexType>
150     <xs:complexType name="keyboard">
151         <xs:sequence>
152             <xs:element name="chainQuitKey" type="ob:keyname"/>
153             <xs:element maxOccurs="unbounded" name="keybind" type="ob:keybind"/>
154         </xs:sequence>
155     </xs:complexType>
156     <xs:complexType name="mousebind">
157         <xs:sequence>
158             <xs:element maxOccurs="unbounded" name="action" type="ob:action"/>
159         </xs:sequence>
160         <xs:attribute name="action" type="ob:mouseaction" use="required"/>
161         <xs:attribute name="button" type="ob:button" use="required"/>
162     </xs:complexType>
163     <xs:complexType name="context">
164         <xs:sequence>
165             <xs:element maxOccurs="unbounded" name="mousebind" type="ob:mousebind"/>
166         </xs:sequence>
167         <xs:attribute name="name" type="ob:contextname" use="required"/>
168     </xs:complexType>
169     <xs:complexType name="mouse">
170         <xs:sequence>
171             <xs:element name="dragThreshold" type="xs:integer"/>
172             <xs:element name="doubleClickTime" type="xs:integer"/>
173             <xs:element maxOccurs="unbounded" name="context" type="ob:context"/>
174         </xs:sequence>
175     </xs:complexType>
176     <xs:complexType name="menu">
177         <xs:sequence>
178             <xs:element maxOccurs="unbounded" name="file" type="xs:string"/>
179             <xs:element name="warpPointer" type="ob:yesorno"/>
180             <xs:element name="xorStyle" type="ob:yesorno"/>
181         </xs:sequence>
182     </xs:complexType>
183     <!--
184          simple types / restrictions
185       -->
186     <xs:simpleType name="yesorno">
187         <xs:restriction base="xs:string">
188             <xs:enumeration value="yes"/>
189             <xs:enumeration value="no"/>
190         </xs:restriction>
191     </xs:simpleType>
192     <xs:simpleType name="placementpolicy">
193         <xs:restriction base="xs:string">
194             <xs:enumeration value="Smart"/>
195             <xs:enumeration value="UnderMouse"/>
196         </xs:restriction>
197     </xs:simpleType>
198     <xs:simpleType name="popupshow">
199         <xs:restriction base="xs:string">
200             <xs:enumeration value="Always"/>
201             <xs:enumeration value="Never"/>
202             <xs:enumeration value="Nonpixel"/>
203         </xs:restriction>
204     </xs:simpleType>
205     <xs:simpleType name="popupposition">
206         <xs:restriction base="xs:string">
207             <xs:enumeration value="Top"/>
208             <xs:enumeration value="Center"/>
209         </xs:restriction>
210     </xs:simpleType>
211     <xs:simpleType name="position">
212         <xs:restriction base="xs:string">
213             <xs:enumeration value="TopLeft"/>
214             <xs:enumeration value="Top"/>
215             <xs:enumeration value="TopRight"/>
216             <xs:enumeration value="Right"/>
217             <xs:enumeration value="BottomRight"/>
218             <xs:enumeration value="Bottom"/>
219             <xs:enumeration value="BottomLeft"/>
220             <xs:enumeration value="Left"/>
221             <xs:enumeration value="Floating"/>
222         </xs:restriction>
223     </xs:simpleType>
224     <xs:simpleType name="stacking">
225         <xs:restriction base="xs:string">
226             <xs:enumeration value="Top"/>
227             <xs:enumeration value="Normal"/>
228             <xs:enumeration value="Bottom"/>
229         </xs:restriction>
230     </xs:simpleType>
231     <xs:simpleType name="direction">
232         <xs:restriction base="xs:string">
233             <xs:enumeration value="Horizontal"/>
234             <xs:enumeration value="Vertical"/>
235         </xs:restriction>
236     </xs:simpleType>
237     <xs:simpleType name="keyname">
238         <xs:restriction base="xs:string">
239             <xs:pattern value="(A-)?(S-)?(A-)?(C-)?(A-)?(S-)?(A-)?[a-zA-Z0-9]*"/>
240         </xs:restriction>
241     </xs:simpleType>
242     <xs:simpleType name="contextname">
243         <xs:restriction base="xs:string">
244             <xs:enumeration value="Desktop"/>
245             <xs:enumeration value="Client"/>
246             <xs:enumeration value="Titlebar"/>
247             <xs:enumeration value="Handle"/>
248             <xs:enumeration value="Frame"/>
249             <xs:enumeration value="TLCorner"/>
250             <xs:enumeration value="TRCorner"/>
251             <xs:enumeration value="BLCorner"/>
252             <xs:enumeration value="BRCorner"/>
253             <xs:enumeration value="Maximize"/>
254             <xs:enumeration value="AllDesktops"/>
255             <xs:enumeration value="Shade"/>
256             <xs:enumeration value="Iconify"/>
257             <xs:enumeration value="Icon"/>
258             <xs:enumeration value="Close"/>
259             <xs:enumeration value="MoveResize"/>
260         </xs:restriction>
261     </xs:simpleType>
262     <xs:simpleType name="button">
263         <xs:restriction base="xs:string">
264             <xs:enumeration value="Left"/>
265             <xs:enumeration value="Middle"/>
266             <xs:enumeration value="Right"/>
267             <xs:enumeration value="Up"/>
268             <xs:enumeration value="Down"/>
269             <xs:enumeration value="A-Left"/>
270             <xs:enumeration value="A-Middle"/>
271             <xs:enumeration value="A-Right"/>
272             <xs:enumeration value="A-Up"/>
273             <xs:enumeration value="A-Down"/>
274             <xs:enumeration value="C-A-Left"/>
275             <xs:enumeration value="C-A-Middle"/>
276             <xs:enumeration value="C-A-Right"/>
277             <xs:enumeration value="C-A-Up"/>
278             <xs:enumeration value="C-A-Down"/>
279         </xs:restriction>
280     </xs:simpleType>
281     <xs:simpleType name="mouseaction">
282         <xs:restriction base="xs:string">
283             <xs:enumeration value="Click"/>
284             <xs:enumeration value="DoubleClick"/>
285             <xs:enumeration value="Drag"/>
286             <xs:enumeration value="Press"/>
287             <xs:enumeration value="Release"/>
288         </xs:restriction>
289     </xs:simpleType>
290     <xs:simpleType name="actionname">
291         <xs:restriction base="xs:string">
292             <xs:enumeration value="Activate"/>
293             <xs:enumeration value="Close"/>
294             <xs:enumeration value="Desktop"/>
295             <xs:enumeration value="DesktopDown"/>
296             <xs:enumeration value="DesktopLast"/>
297             <xs:enumeration value="DesktopLeft"/>
298             <xs:enumeration value="DesktopNext"/>
299             <xs:enumeration value="DesktopPrevious"/>
300             <xs:enumeration value="DesktopRight"/>
301             <xs:enumeration value="DesktopUp"/>
302             <xs:enumeration value="DirectionalFocusEast"/>
303             <xs:enumeration value="DirectionalFocusNorth"/>
304             <xs:enumeration value="DirectionalFocusNortheast"/>
305             <xs:enumeration value="DirectionalFocusNorthwest"/>
306             <xs:enumeration value="DirectionalFocusSouth"/>
307             <xs:enumeration value="DirectionalFocusSoutheast"/>
308             <xs:enumeration value="DirectionalFocusSouthwest"/>
309             <xs:enumeration value="DirectionalFocusWest"/>
310             <xs:enumeration value="Execute"/>
311             <xs:enumeration value="Exit"/>
312             <xs:enumeration value="Focus"/>
313             <xs:enumeration value="GrowToEdgeEast"/>
314             <xs:enumeration value="GrowToEdgeNorth"/>
315             <xs:enumeration value="GrowToEdgeSouth"/>
316             <xs:enumeration value="GrowToEdgeWest"/>
317             <xs:enumeration value="Iconify"/>
318             <xs:enumeration value="Kill"/>
319             <xs:enumeration value="Lower"/>
320             <xs:enumeration value="MaximizeFull"/>
321             <xs:enumeration value="MaximizeHorz"/>
322             <xs:enumeration value="MaximizeVert"/>
323             <xs:enumeration value="Move"/>
324             <xs:enumeration value="MoveRelativeHorz"/>
325             <xs:enumeration value="MoveRelativeVert"/>
326             <xs:enumeration value="MoveToEdgeEast"/>
327             <xs:enumeration value="MoveToEdgeNorth"/>
328             <xs:enumeration value="MoveToEdgeSouth"/>
329             <xs:enumeration value="MoveToEdgeWest"/>
330             <xs:enumeration value="NextWindow"/>
331             <xs:enumeration value="NextWindowLinear"/>
332             <xs:enumeration value="PreviousWindow"/>
333             <xs:enumeration value="PreviousWindowLinear"/>
334             <xs:enumeration value="Raise"/>
335             <xs:enumeration value="RaiseLower"/>
336             <xs:enumeration value="Resize"/>
337             <xs:enumeration value="ResizeRelativeHorz"/>
338             <xs:enumeration value="ResizeRelativeVert"/>
339             <xs:enumeration value="Restart"/>
340             <xs:enumeration value="SendToBottomLayer"/>
341             <xs:enumeration value="SendToDesktop"/>
342             <xs:enumeration value="SendToDesktopDown"/>
343             <xs:enumeration value="SendToDesktopLeft"/>
344             <xs:enumeration value="SendToDesktopNext"/>
345             <xs:enumeration value="SendToDesktopPrevious"/>
346             <xs:enumeration value="SendToDesktopRight"/>
347             <xs:enumeration value="SendToDesktopUp"/>
348             <xs:enumeration value="SendToNormalLayer"/>
349             <xs:enumeration value="SendToTopLayer"/>
350             <xs:enumeration value="Shade"/>
351             <xs:enumeration value="ShadeLower"/>
352             <xs:enumeration value="ShowDesktop"/>
353             <xs:enumeration value="ShowMenu"/>
354             <xs:enumeration value="ToggleAlwaysOnBottom"/>
355             <xs:enumeration value="ToggleAlwaysOnTop"/>
356             <xs:enumeration value="ToggleDecorations"/>
357             <xs:enumeration value="ToggleFullscreen"/>
358             <xs:enumeration value="ToggleMaximizeFull"/>
359             <xs:enumeration value="ToggleMaximizeHorz"/>
360             <xs:enumeration value="ToggleMaximizeVert"/>
361             <xs:enumeration value="ToggleOmnipresent"/>
362             <xs:enumeration value="ToggleShade"/>
363             <xs:enumeration value="ToggleShowDesktop"/>
364             <xs:enumeration value="Unfocus"/>
365             <xs:enumeration value="UnmaximizeFull"/>
366             <xs:enumeration value="UnmaximizeHorz"/>
367             <xs:enumeration value="UnmaximizeVert"/>
368             <xs:enumeration value="Unshade"/>
369             <xs:enumeration value="UnshadeRaise"/>
370             <xs:enumeration value="UnShowDesktop"/>
371         </xs:restriction>
372     </xs:simpleType>
373 </xs:schema>