per app settings
[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      Thu Nov  4 12:07:08 UTC 2004 - mikachu(a)openbox.org
35          Add fourCorners to resize context.
36      Sat Feb 12 01:57:16 UTC 2005 - mikachu(a)openbox.org
37          Add the group option to raise/lower stuff.
38      Sun Sep 25 14:44:21 UTC 2005 - mikachu(a)openbox.org
39          Add showDelay for the dock
40 -->
41 <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"
42     targetNamespace="http://openbox.org/"
43     xmlns:ob="http://openbox.org/"
44     elementFormDefault="qualified">
45     <!--
46          root node
47       -->
48     <xs:element name="openbox_config">
49         <xs:annotation>
50             <xs:documentation>all these elements are expected in a openbox config file</xs:documentation>
51         </xs:annotation>
52         <xs:complexType>
53             <xs:sequence>
54                 <xs:element name="resistance" type="ob:resistance"/>
55                 <xs:element name="focus" type="ob:focus"/>
56                 <xs:element name="placement" type="ob:placement"/>
57                 <xs:element name="theme" type="ob:theme"/>
58                 <xs:element name="desktops" type="ob:desktops"/>
59                 <xs:element name="resize" type="ob:resize"/>
60                 <xs:element name="dock" type="ob:dock"/>
61                 <xs:element name="keyboard" type="ob:keyboard"/>
62                 <xs:element name="mouse" type="ob:mouse"/>
63                 <xs:element name="menu" type="ob:menu"/>
64                 <xs:element name="applications" type="ob:applications"/>
65             </xs:sequence>
66         </xs:complexType>
67     </xs:element>
68     <!--
69          complex types
70       -->
71     <xs:complexType name="resistance">
72         <xs:annotation>
73             <xs:documentation>defines behaviour of windows when close to eachother or the screen edge</xs:documentation>
74         </xs:annotation>
75         <xs:sequence>
76             <xs:element name="strength" type="xs:integer"/>
77             <xs:element name="screen_edge_strength" type="xs:integer"/>
78             <xs:element name="edges_hit_layers_below" type="xs:yesorno"/>
79         </xs:sequence>
80     </xs:complexType>
81     <xs:complexType name="focus">
82         <xs:annotation>
83             <xs:documentation>defines aspects of window focus</xs:documentation>
84         </xs:annotation>
85         <xs:sequence>
86             <xs:element name="focusNew" type="ob:yesorno"/>
87             <xs:element name="focusLast" type="ob:yesorno"/>
88             <xs:element name="followMouse" type="ob:yesorno"/>
89             <xs:element name="focusDelay" type="xs:integer"/>
90             <xs:element name="raiseOnFocus" type="ob:yesorno"/>
91         </xs:sequence>
92     </xs:complexType>
93     <xs:complexType name="placement">
94         <xs:annotation>
95             <xs:documentation>defines how new windows are placed</xs:documentation>
96         </xs:annotation>
97         <xs:sequence>
98             <xs:element name="policy" type="ob:placementpolicy"/>
99         </xs:sequence>
100     </xs:complexType>
101     <xs:complexType name="theme">
102         <xs:sequence>
103             <xs:element name="name" type="xs:string"/>
104             <xs:element name="titlelayout" type="xs:string"/>
105             <xs:element name="keepBorder" type="ob:yesorno"/>
106             <xs:element name="hideDisabled" type="ob:yesorno"/>
107         </xs:sequence>
108     </xs:complexType>
109     <xs:complexType name="desktops">
110         <xs:sequence>
111             <xs:element name="number" type="xs:integer"/>
112             <xs:element name="names">
113                 <xs:complexType>
114                     <xs:sequence>
115                         <xs:element maxOccurs="unbounded" name="name" type="xs:string"/>
116                     </xs:sequence>
117                 </xs:complexType>
118             </xs:element>
119             <xs:element name="firstdesk" type="xs:integer"/>
120         </xs:sequence>
121     </xs:complexType>
122     <xs:complexType name="resize">
123         <xs:sequence>
124             <xs:element name="drawContents" type="ob:yesorno"/>
125             <xs:element name="fourCorners" type="ob:yesorno"/>
126             <xs:element name="popupShow" type="ob:popupshow"/>
127             <xs:element name="popupPosition" type="ob:popupposition"/>
128         </xs:sequence>
129     </xs:complexType>
130     <xs:complexType name="dock">
131         <xs:sequence>
132             <xs:element name="position" type="ob:position"/>
133             <xs:element name="stacking" type="ob:stacking"/>
134             <xs:element name="direction" type="ob:direction"/>
135             <xs:element name="floatingX" type="xs:integer"/>
136             <xs:element name="floatingY" type="xs:integer"/>
137             <xs:element name="autoHide" type="ob:yesorno"/>
138             <xs:element name="hideDelay" type="xs:integer"/>
139             <xs:element name="showDelay" type="xs:integer"/>
140             <xs:element name="moveButton" type="ob:button"/>
141             <xs:element name="noStrut" type="ob:yesorno"/>
142         </xs:sequence>
143     </xs:complexType>
144     <xs:complexType name="action">
145         <xs:sequence>
146             <xs:element minOccurs="0" name="menu" type="xs:string"/>
147             <xs:element minOccurs="0" name="desktop" type="xs:integer"/>
148             <xs:element minOccurs="0" name="follow" type="ob:yesorno"/>
149             <xs:element minOccurs="0" name="execute" type="xs:string"/>
150             <xs:element minOccurs="0" name="group" type="ob:yesorno"/>
151             <xs:element minOccurs="0" name="dialog" type="ob:yesorno"/>
152         </xs:sequence>
153         <xs:attribute name="name" type="ob:actionname" use="required"/>
154     </xs:complexType>
155     <xs:complexType name="keybind">
156         <xs:sequence>
157             <xs:element maxOccurs="unbounded" name="action" type="ob:action"/>
158         </xs:sequence>
159         <xs:attribute name="key" type="ob:keyname" use="required"/>
160     </xs:complexType>
161     <xs:complexType name="keyboard">
162         <xs:sequence>
163             <xs:element name="chainQuitKey" type="ob:keyname"/>
164             <xs:element maxOccurs="unbounded" name="keybind" type="ob:keybind"/>
165         </xs:sequence>
166     </xs:complexType>
167     <xs:complexType name="mousebind">
168         <xs:sequence>
169             <xs:element maxOccurs="unbounded" name="action" type="ob:action"/>
170         </xs:sequence>
171         <xs:attribute name="action" type="ob:mouseaction" use="required"/>
172         <xs:attribute name="button" type="ob:button" use="required"/>
173     </xs:complexType>
174     <xs:complexType name="context">
175         <xs:sequence>
176             <xs:element maxOccurs="unbounded" name="mousebind" type="ob:mousebind"/>
177         </xs:sequence>
178         <xs:attribute name="name" type="ob:contextname" use="required"/>
179     </xs:complexType>
180     <xs:complexType name="mouse">
181         <xs:sequence>
182             <xs:element name="dragThreshold" type="xs:integer"/>
183             <xs:element name="doubleClickTime" type="xs:integer"/>
184             <xs:element maxOccurs="unbounded" name="context" type="ob:context"/>
185         </xs:sequence>
186     </xs:complexType>
187     <xs:complexType name="menu">
188         <xs:sequence>
189             <xs:element maxOccurs="unbounded" name="file" type="xs:string"/>
190             <xs:element name="warpPointer" type="ob:yesorno"/>
191             <xs:element name="xorStyle" type="ob:yesorno"/>
192             <xs:element name="hideDelay" type="xs:integer"/>
193             <xs:element name="desktopMenuIcons" type="ob:yesorno"/>
194         </xs:sequence>
195     </xs:complexType>
196     <xs:complexType name="position">
197         <xs:sequence>
198             <xs:element name="x" type="xs:string"/>
199             <xs:element name="y" type="xs:string"/>
200         </xs:sequence>
201     </xs:complexType>
202     <xs:complexType name="application">
203         <xs:sequence>
204             <xs:element name="decor" type="xs:string"/>
205             <xs:element name="focus" type="xs:string"/>
206             <xs:element name="position" type="ob:position"/>
207             <xs:element name="head" type="xs:string"/>
208             <xs:element name="layer" type="xs:string"/>
209             <xs:element name="desktop" type="xs:integer"/>
210         </xs:sequence>
211         <xs:attribute name="name" type="xs:string" use="required"/>
212     </xs:complexType>
213     <xs:complexType name="applications">
214         <xs:sequence>
215             <xs:element maxOccurs="unboundd" name="application" type="ob:application"/>
216         </xs:sequence>
217     </xs:complexType>
218     <!--
219          simple types / restrictions
220       -->
221     <xs:simpleType name="yesorno">
222         <xs:restriction base="xs:string">
223             <xs:enumeration value="yes"/>
224             <xs:enumeration value="no"/>
225         </xs:restriction>
226     </xs:simpleType>
227     <xs:simpleType name="placementpolicy">
228         <xs:restriction base="xs:string">
229             <xs:enumeration value="Smart"/>
230             <xs:enumeration value="UnderMouse"/>
231         </xs:restriction>
232     </xs:simpleType>
233     <xs:simpleType name="popupshow">
234         <xs:restriction base="xs:string">
235             <xs:enumeration value="Always"/>
236             <xs:enumeration value="Never"/>
237             <xs:enumeration value="Nonpixel"/>
238         </xs:restriction>
239     </xs:simpleType>
240     <xs:simpleType name="popupposition">
241         <xs:restriction base="xs:string">
242             <xs:enumeration value="Top"/>
243             <xs:enumeration value="Center"/>
244         </xs:restriction>
245     </xs:simpleType>
246     <xs:simpleType name="position">
247         <xs:restriction base="xs:string">
248             <xs:enumeration value="TopLeft"/>
249             <xs:enumeration value="Top"/>
250             <xs:enumeration value="TopRight"/>
251             <xs:enumeration value="Right"/>
252             <xs:enumeration value="BottomRight"/>
253             <xs:enumeration value="Bottom"/>
254             <xs:enumeration value="BottomLeft"/>
255             <xs:enumeration value="Left"/>
256             <xs:enumeration value="Floating"/>
257         </xs:restriction>
258     </xs:simpleType>
259     <xs:simpleType name="stacking">
260         <xs:restriction base="xs:string">
261             <xs:enumeration value="Top"/>
262             <xs:enumeration value="Normal"/>
263             <xs:enumeration value="Bottom"/>
264         </xs:restriction>
265     </xs:simpleType>
266     <xs:simpleType name="direction">
267         <xs:restriction base="xs:string">
268             <xs:enumeration value="Horizontal"/>
269             <xs:enumeration value="Vertical"/>
270         </xs:restriction>
271     </xs:simpleType>
272     <xs:simpleType name="keyname">
273         <xs:restriction base="xs:string">
274             <xs:pattern value="(A-)?(S-)?(A-)?(C-)?(A-)?(S-)?(A-)?[a-zA-Z0-9]*"/>
275         </xs:restriction>
276     </xs:simpleType>
277     <xs:simpleType name="contextname">
278         <xs:restriction base="xs:string">
279             <xs:enumeration value="Desktop"/>
280             <xs:enumeration value="Client"/>
281             <xs:enumeration value="Titlebar"/>
282             <xs:enumeration value="Handle"/>
283             <xs:enumeration value="Frame"/>
284             <xs:enumeration value="TLCorner"/>
285             <xs:enumeration value="TRCorner"/>
286             <xs:enumeration value="BLCorner"/>
287             <xs:enumeration value="BRCorner"/>
288             <xs:enumeration value="Maximize"/>
289             <xs:enumeration value="AllDesktops"/>
290             <xs:enumeration value="Shade"/>
291             <xs:enumeration value="Iconify"/>
292             <xs:enumeration value="Icon"/>
293             <xs:enumeration value="Close"/>
294             <xs:enumeration value="MoveResize"/>
295         </xs:restriction>
296     </xs:simpleType>
297     <xs:simpleType name="button">
298         <xs:restriction base="xs:string">
299             <xs:enumeration value="Left"/>
300             <xs:enumeration value="Middle"/>
301             <xs:enumeration value="Right"/>
302             <xs:enumeration value="Up"/>
303             <xs:enumeration value="Down"/>
304             <xs:enumeration value="A-Left"/>
305             <xs:enumeration value="A-Middle"/>
306             <xs:enumeration value="A-Right"/>
307             <xs:enumeration value="A-Up"/>
308             <xs:enumeration value="A-Down"/>
309             <xs:enumeration value="C-A-Left"/>
310             <xs:enumeration value="C-A-Middle"/>
311             <xs:enumeration value="C-A-Right"/>
312             <xs:enumeration value="C-A-Up"/>
313             <xs:enumeration value="C-A-Down"/>
314         </xs:restriction>
315     </xs:simpleType>
316     <xs:simpleType name="mouseaction">
317         <xs:restriction base="xs:string">
318             <xs:enumeration value="Click"/>
319             <xs:enumeration value="DoubleClick"/>
320             <xs:enumeration value="Drag"/>
321             <xs:enumeration value="Press"/>
322             <xs:enumeration value="Release"/>
323         </xs:restriction>
324     </xs:simpleType>
325     <xs:simpleType name="actionname">
326         <xs:restriction base="xs:string">
327             <xs:enumeration value="Activate"/>
328             <xs:enumeration value="Close"/>
329             <xs:enumeration value="Desktop"/>
330             <xs:enumeration value="DesktopDown"/>
331             <xs:enumeration value="DesktopLast"/>
332             <xs:enumeration value="DesktopLeft"/>
333             <xs:enumeration value="DesktopNext"/>
334             <xs:enumeration value="DesktopPrevious"/>
335             <xs:enumeration value="DesktopRight"/>
336             <xs:enumeration value="DesktopUp"/>
337             <xs:enumeration value="DirectionalFocusEast"/>
338             <xs:enumeration value="DirectionalFocusNorth"/>
339             <xs:enumeration value="DirectionalFocusNortheast"/>
340             <xs:enumeration value="DirectionalFocusNorthwest"/>
341             <xs:enumeration value="DirectionalFocusSouth"/>
342             <xs:enumeration value="DirectionalFocusSoutheast"/>
343             <xs:enumeration value="DirectionalFocusSouthwest"/>
344             <xs:enumeration value="DirectionalFocusWest"/>
345             <xs:enumeration value="Execute"/>
346             <xs:enumeration value="Exit"/>
347             <xs:enumeration value="Focus"/>
348             <xs:enumeration value="FocusToBottom"/>
349             <xs:enumeration value="GrowToEdgeEast"/>
350             <xs:enumeration value="GrowToEdgeNorth"/>
351             <xs:enumeration value="GrowToEdgeSouth"/>
352             <xs:enumeration value="GrowToEdgeWest"/>
353             <xs:enumeration value="Iconify"/>
354             <xs:enumeration value="Kill"/>
355             <xs:enumeration value="Lower"/>
356             <xs:enumeration value="MaximizeFull"/>
357             <xs:enumeration value="MaximizeHorz"/>
358             <xs:enumeration value="MaximizeVert"/>
359             <xs:enumeration value="Move"/>
360             <xs:enumeration value="MoveRelativeHorz"/>
361             <xs:enumeration value="MoveRelativeVert"/>
362             <xs:enumeration value="MoveToEdgeEast"/>
363             <xs:enumeration value="MoveToEdgeNorth"/>
364             <xs:enumeration value="MoveToEdgeSouth"/>
365             <xs:enumeration value="MoveToEdgeWest"/>
366             <xs:enumeration value="MoveToCenter"/>
367             <xs:enumeration value="NextWindow"/>
368             <xs:enumeration value="NextWindowLinear"/>
369             <xs:enumeration value="PreviousWindow"/>
370             <xs:enumeration value="PreviousWindowLinear"/>
371             <xs:enumeration value="Raise"/>
372             <xs:enumeration value="RaiseLower"/>
373             <xs:enumeration value="Resize"/>
374             <xs:enumeration value="ResizeRelativeHorz"/>
375             <xs:enumeration value="ResizeRelativeVert"/>
376             <xs:enumeration value="Restart"/>
377             <xs:enumeration value="SendToBottomLayer"/>
378             <xs:enumeration value="SendToDesktop"/>
379             <xs:enumeration value="SendToDesktopDown"/>
380             <xs:enumeration value="SendToDesktopLeft"/>
381             <xs:enumeration value="SendToDesktopNext"/>
382             <xs:enumeration value="SendToDesktopPrevious"/>
383             <xs:enumeration value="SendToDesktopRight"/>
384             <xs:enumeration value="SendToDesktopUp"/>
385             <xs:enumeration value="SendToNormalLayer"/>
386             <xs:enumeration value="SendToTopLayer"/>
387             <xs:enumeration value="Shade"/>
388             <xs:enumeration value="ShadeLower"/>
389             <xs:enumeration value="ShowDesktop"/>
390             <xs:enumeration value="ShowMenu"/>
391             <xs:enumeration value="ToggleAlwaysOnBottom"/>
392             <xs:enumeration value="ToggleAlwaysOnTop"/>
393             <xs:enumeration value="ToggleDecorations"/>
394             <xs:enumeration value="ToggleFullscreen"/>
395             <xs:enumeration value="ToggleMaximizeFull"/>
396             <xs:enumeration value="ToggleMaximizeHorz"/>
397             <xs:enumeration value="ToggleMaximizeVert"/>
398             <xs:enumeration value="ToggleOmnipresent"/>
399             <xs:enumeration value="ToggleShade"/>
400             <xs:enumeration value="ToggleShowDesktop"/>
401             <xs:enumeration value="Unfocus"/>
402             <xs:enumeration value="UnmaximizeFull"/>
403             <xs:enumeration value="UnmaximizeHorz"/>
404             <xs:enumeration value="UnmaximizeVert"/>
405             <xs:enumeration value="Unshade"/>
406             <xs:enumeration value="UnshadeRaise"/>
407             <xs:enumeration value="UnShowDesktop"/>
408         </xs:restriction>
409     </xs:simpleType>
410 </xs:schema>