let you match per-app settings based on the window type
[dana/openbox.git] / data / rc.xsd
1 <?xml version="1.0" encoding="UTF-8"?> <!-- -*- nxml -*- -->
2
3 <!-- XML Schema for the Openbox window manager configuration file -->
4
5 <xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema"
6     targetNamespace="http://openbox.org/4.0/rc"
7     xmlns:ob="http://openbox.org/4.0/rc"
8     elementFormDefault="qualified">
9     <!--
10          root node
11       -->
12     <xsd:element name="openbox_config">
13         <xsd:annotation>
14             <xsd:documentation>all these elements are expected in a openbox config file</xsd:documentation>
15         </xsd:annotation>
16         <xsd:complexType>
17             <xsd:element name="resistance" type="ob:resistance"/>
18             <xsd:element name="focus" type="ob:focus"/>
19             <xsd:element name="placement" type="ob:placement"/>
20             <xsd:element name="theme" type="ob:theme"/>
21             <xsd:element name="desktops" type="ob:desktops"/>
22             <xsd:element name="resize" type="ob:resize"/>
23             <xsd:element name="dock" type="ob:dock"/>
24             <xsd:element name="keyboard" type="ob:keyboard"/>
25             <xsd:element name="mouse" type="ob:mouse"/>
26             <xsd:element name="menu" type="ob:menu"/>
27             <xsd:element name="applications" type="ob:applications"/>
28         </xsd:complexType>
29     </xsd:element>
30     <!--
31          complex types
32       -->
33     <xsd:complexType name="resistance">
34         <xsd:annotation>
35             <xsd:documentation>defines behaviour of windows when close to each other or the screen edge</xsd:documentation>
36         </xsd:annotation>
37         <xsd:element minOccurs="0" name="strength" type="xsd:integer"/>
38         <xsd:element minOccurs="0" name="screen_edge_strength" type="xsd:integer"/>
39     </xsd:complexType>
40     <xsd:complexType name="focus">
41         <xsd:annotation>
42             <xsd:documentation>defines aspects of window focus</xsd:documentation>
43         </xsd:annotation>
44         <xsd:element minOccurs="0" name="focusNew" type="ob:bool"/>
45         <xsd:element minOccurs="0" name="focusLast" type="ob:bool"/>
46         <xsd:element minOccurs="0" name="followMouse" type="ob:bool"/>
47         <xsd:element minOccurs="0" name="underMouse" type="ob:bool"/>
48         <xsd:element minOccurs="0" name="focusDelay" type="xsd:integer"/>
49         <xsd:element minOccurs="0" name="raiseOnFocus" type="ob:bool"/>
50     </xsd:complexType>
51     <xsd:complexType name="placement">
52         <xsd:annotation>
53             <xsd:documentation>defines how new windows are placed</xsd:documentation>
54         </xsd:annotation>
55         <xsd:element name="policy" type="ob:placementpolicy"/>
56         <xsd:element name="center" type="ob:bool"/>
57         <xsd:element name="monitor" type="ob:placementmonitor"/>
58     </xsd:complexType>
59     <xsd:complexType name="margins">
60         <xsd:annotation>
61             <xsd:documentation>defines desktop margins</xsd:documentation>
62         </xsd:annotation>
63         <xsd:element minOccurs="0" name="top" type="xsd:integer"/>
64         <xsd:element minOccurs="0" name="left" type="xsd:integer"/>
65         <xsd:element minOccurs="0" name="right" type="xsd:integer"/>
66         <xsd:element minOccurs="0" name="bottom" type="xsd:integer"/>
67     </xsd:complexType>              
68     <xsd:complexType name="theme">
69         <xsd:element minOccurs="0" name="name" type="xsd:string"/>
70         <xsd:element minOccurs="0" name="titleLayout" type="xsd:string"/>
71         <xsd:element minOccurs="0" name="keepBorder" type="ob:bool"/>
72         <xsd:element minOccurs="0" name="animateIconify" type="ob:bool"/>
73         <xsd:element minOccurs="0" name="font" type="ob:font"/>
74     </xsd:complexType>
75     <xsd:complexType name="font">
76         <xsd:element minOccurs="0" name="name" type="xsd:string"/>
77         <xsd:element minOccurs="0" name="size" type="xsd:integer"/>
78         <xsd:element minOccurs="0" name="weight" type="ob:fontweight"/>
79         <xsd:element minOccurs="0" name="slant" type="ob:fontslant"/>
80         <xsd:attribute name="place" type="ob:fontplace" use="required"/>
81     </xsd:complexType>
82     <xsd:complexType name="desktops">
83         <xsd:annotation>
84             <xsd:documentation>defines the number and names of desktops</xsd:documentation>
85         </xsd:annotation>
86         <xsd:element minOccurs="0" name="number" type="xsd:integer"/>
87         <xsd:element minOccurs="0" name="firstdesk" type="xsd:integer"/>
88         <xsd:element minOccurs="0" name="names">
89             <xsd:complexType>
90                 <xsd:element maxOccurs="unbounded" name="name" type="xsd:string"/>
91             </xsd:complexType>
92         </xsd:element>
93         <xsd:element minOccurs="0" name="popupTime" type="xsd:integer"/>
94     </xsd:complexType>
95     <xsd:complexType name="resize">
96         <xsd:element minOccurs="0" name="drawContents" type="ob:bool"/>
97         <xsd:element minOccurs="0" name="popupShow" type="ob:popupshow"/>
98         <xsd:element minOccurs="0" name="popupPosition" type="ob:popupposition"/>
99         <xsd:element minOccurs="0" name="popupPosition" type="ob:popupfixedposition"/>
100     </xsd:complexType>
101     <xsd:complexType name="popupfixedposition">
102         <xsd:element minOccurs="0" name="x" type="ob:center_or_int"/>
103         <xsd:element minOccurs="0" name="y" type="ob:center_or_int"/>
104     </xsd:complexType>
105     <xsd:complexType name="dock">
106         <xsd:element minOccurs="0" name="position" type="ob:dock_position"/>
107         <xsd:element minOccurs="0" name="floatingX" type="xsd:integer"/>
108         <xsd:element minOccurs="0" name="floatingY" type="xsd:integer"/>
109         <xsd:element minOccurs="0" name="noStrut" type="ob:bool"/>
110         <xsd:element minOccurs="0" name="stacking" type="ob:layer"/>
111         <xsd:element minOccurs="0" name="direction" type="ob:direction"/>
112         <xsd:element minOccurs="0" name="autoHide" type="ob:bool"/>
113         <xsd:element minOccurs="0" name="hideDelay" type="xsd:integer"/>
114         <xsd:element minOccurs="0" name="showDelay" type="xsd:integer"/>
115         <xsd:element minOccurs="0" name="moveButton" type="ob:button"/>
116     </xsd:complexType>
117     <xsd:complexType name="action">
118         <xsd:element minOccurs="0" name="execute" type="xsd:string"/>
119         <xsd:element minOccurs="0" name="command" type="xsd:string"/>
120         <xsd:element minOccurs="0" name="menu" type="xsd:string"/>
121         <xsd:element minOccurs="0" name="delta" type="xsd:integer"/>
122         <xsd:element minOccurs="0" name="x" type="xsd:integer"/>
123         <xsd:element minOccurs="0" name="y" type="xsd:integer"/>
124         <xsd:element minOccurs="0" name="left" type="xsd:integer"/>
125         <xsd:element minOccurs="0" name="right" type="xsd:integer"/>
126         <xsd:element minOccurs="0" name="up" type="xsd:integer"/>
127         <xsd:element minOccurs="0" name="down" type="xsd:integer"/>
128         <xsd:element minOccurs="0" name="desktop" type="xsd:integer"/>
129         <xsd:element minOccurs="0" name="wrap" type="ob:bool"/>
130         <xsd:element minOccurs="0" name="follow" type="ob:bool"/>
131         <xsd:element minOccurs="0" name="dialog" type="ob:bool"/>
132         <xsd:element minOccurs="0" name="panels" type="ob:bool"/>
133         <xsd:element minOccurs="0" name="here" type="ob:bool"/>
134         <xsd:element minOccurs="0" name="linear" type="ob:bool"/>
135         <xsd:element minOccurs="0" name="group" type="ob:bool"/>
136         <xsd:attribute name="name" type="ob:actionname" use="required"/>
137     </xsd:complexType>
138     <xsd:complexType name="keybind">
139         <xsd:choice>
140             <xsd:element maxOccurs="unbounded" name="action" type="ob:action"/>
141             <xsd:element maxOccurs="unbounded" name="keybind" type="ob:keybind"/>
142         </xsd:choice>
143         <xsd:attribute name="chroot" type="ob:bool"/>
144         <xsd:attribute name="key" type="ob:keyname" use="required"/>
145     </xsd:complexType>
146     <xsd:complexType name="keyboard">
147         <xsd:element minOccurs="0" name="chainQuitKey" type="ob:keyname"/>
148         <xsd:element maxOccurs="unbounded" name="keybind" type="ob:keybind"/>
149     </xsd:complexType>
150     <xsd:complexType name="mousebind">
151         <xsd:element maxOccurs="unbounded" name="action" type="ob:action"/>
152         <xsd:attribute name="action" type="ob:mouseaction" use="required"/>
153         <xsd:attribute name="button" type="ob:button" use="required"/>
154     </xsd:complexType>
155     <xsd:complexType name="context">
156         <xsd:element maxOccurs="unbounded" name="mousebind" type="ob:mousebind"/>
157         <xsd:attribute name="name" type="ob:contextname" use="required"/>
158     </xsd:complexType>
159     <xsd:complexType name="mouse">
160         <xsd:element minOccurs="0" name="dragThreshold" type="xsd:integer"/>
161         <xsd:element minOccurs="0" name="doubleClickTime" type="xsd:integer"/>
162         <xsd:element minOccurs="0" name="screenEdgeWarpTime" type="xsd:integer"/>
163         <xsd:element maxOccurs="unbounded" name="context" type="ob:context"/>
164     </xsd:complexType>
165     <xsd:complexType name="menu">
166         <xsd:element maxOccurs="unbounded" name="file" type="xsd:string"/>
167         <xsd:element minOccurs="0" name="hideDelay" type="xsd:integer"/>
168         <xsd:element minOccurs="0" name="middle" type="ob:bool"/>
169         <xsd:element minOccurs="0" name="submenuShowDelay" type="xsd:integer"/>
170         <xsd:element minOccurs="0" name="applicationIcons" type="ob:bool"/>
171         <xsd:element minOccurs="0" name="manageDesktops" type="ob:bool"/>
172     </xsd:complexType>
173     <xsd:complexType name="window_position">
174         <xsd:element name="x" type="ob:center_or_int"/>
175         <xsd:element name="y" type="ob:center_or_int"/>
176         <xsd:element name="monitor" type="ob:mouse_or_int"/>    
177         <xsd:element minOccurs="0" name="head" type="xsd:string"/>
178         <xsd:attribute name="force" type="ob:bool"/>
179     </xsd:complexType>
180     <xsd:complexType name="application">
181         <xsd:element minOccurs="0" name="decor" type="xsd:bool"/>
182         <xsd:element minOccurs="0" name="shade" type="ob:bool"/>
183         <xsd:element minOccurs="0" name="position" type="ob:window_position"/>
184         <xsd:element minOccurs="0" name="focus" type="xsd:string"/>
185         <xsd:element minOccurs="0" name="desktop" type="xsd:integer"/>
186         <xsd:element minOccurs="0" name="layer" type="ob:layer"/>
187         <xsd:element minOccurs="0" name="iconic" type="ob:bool"/>
188         <xsd:element minOccurs="0" name="skip_pager" type="ob:bool"/>
189         <xsd:element minOccurs="0" name="skip_taskbar" type="ob:bool"/>
190         <xsd:element minOccurs="0" name="fullscreen" type="ob:bool"/>
191         <xsd:element minOccurs="0" name="maximized" type="ob:maximization"/>
192         <xsd:attribute name="role" type="xsd:string"/>
193         <xsd:attribute name="type" type="ob:clienttype"/>
194         <!-- at least one of these must be present -->
195         <xsd:attribute name="name" type="xsd:string"/>
196         <xsd:attribute name="class" type="xsd:string"/>
197     </xsd:complexType>
198     <xsd:complexType name="applications">
199         <xsd:element minOccurs="0" maxOccurs="unbounded" name="application" type="ob:application"/>
200     </xsd:complexType>
201     <!--
202          simple types / restrictions
203       -->
204     <xsd:simpleType name="actionname">
205         <xsd:restriction base="xsd:string">
206             <xsd:enumeration value="AddDesktop"/>
207             <xsd:enumeration value="BreakChroot"/>
208             <xsd:enumeration value="Close"/>
209             <xsd:enumeration value="Debug"/>
210             <xsd:enumeration value="Decorate"/>
211             <xsd:enumeration value="DirectionalCycleWindows"/>
212             <xsd:enumeration value="DirectionalTargetWindow"/>
213             <xsd:enumeration value="Execute"/>
214             <xsd:enumeration value="Exit"/>
215             <xsd:enumeration value="Focus"/>
216             <xsd:enumeration value="FocusToBottom"/>
217             <xsd:enumeration value="GoToDesktop"/>
218             <xsd:enumeration value="GrowToEdge"/>
219             <xsd:enumeration value="Iconify"/>
220             <xsd:enumeration value="If"/>
221             <xsd:enumeration value="Kill"/>
222             <xsd:enumeration value="Lower"/>
223             <xsd:enumeration value="Maximize"/>
224             <xsd:enumeration value="Move"/>
225             <xsd:enumeration value="MoveRelative"/>
226             <xsd:enumeration value="MoveResizeTo"/>
227             <xsd:enumeration value="MoveToEdge"/>
228             <xsd:enumeration value="NextWindow"/>
229             <xsd:enumeration value="PreviousWindow"/>
230             <xsd:enumeration value="Raise"/>
231             <xsd:enumeration value="RaiseLower"/>
232             <xsd:enumeration value="Reconfigure"/>
233             <xsd:enumeration value="RemoveDesktop"/>
234             <xsd:enumeration value="Resize"/>
235             <xsd:enumeration value="ResizeRelative"/>
236             <xsd:enumeration value="Restart"/>
237             <xsd:enumeration value="SendToDesktop"/>
238             <xsd:enumeration value="SendToLayer"/>
239             <xsd:enumeration value="Shade"/>
240             <xsd:enumeration value="ShowMenu"/>
241             <xsd:enumeration value="ToggleAlwaysOnBottom"/>
242             <xsd:enumeration value="ToggleAlwaysOnTop"/>
243             <xsd:enumeration value="ToggleDecorations"/>
244             <xsd:enumeration value="ToggleDockAutoHide"/>
245             <xsd:enumeration value="ToggleFullscreen"/>
246             <xsd:enumeration value="ToggleMaximize"/>
247             <xsd:enumeration value="ToggleOmnipresent"/>
248             <xsd:enumeration value="ToggleShade"/>
249             <xsd:enumeration value="ToggleShowDesktop"/>
250             <xsd:enumeration value="Undecorate"/>
251             <xsd:enumeration value="Unfocus"/>
252             <xsd:enumeration value="Unmaximize"/>
253             <xsd:enumeration value="Unshade"/>
254         </xsd:restriction>
255     </xsd:simpleType>
256     <xsd:simpleType name="clienttype">
257         <xsd:restriction base="xsd:string">
258             <xsd:enumeration value="desktop"/>
259             <xsd:enumeration value="dock"/>
260             <xsd:enumeration value="toolbar"/>
261             <xsd:enumeration value="menu"/>
262             <xsd:enumeration value="splash"/>
263             <xsd:enumeration value="utility"/>
264             <xsd:enumeration value="dialog"/>
265             <xsd:enumeration value="normal"/>
266         </xsd:restriction>
267     </xsd:simpleType>
268     <xsd:simpleType name="bool">
269         <!-- this is copied to maximization.  Keep that in sync. -->
270         <xsd:restriction base="xsd:string">
271             <xsd:enumeration value="yes"/>
272             <xsd:enumeration value="no"/>
273             <xsd:enumeration value="true"/>
274             <xsd:enumeration value="false"/>
275             <xsd:enumeration value="on"/>
276             <xsd:enumeration value="off"/>
277         </xsd:restriction>
278     </xsd:simpleType>
279     <xsd:simpleType name="fontplace">
280         <xsd:restriction base="xsd:string">
281             <xsd:enumeration value="ActiveWindow"/>
282             <xsd:enumeration value="InactiveWindow"/>
283             <xsd:enumeration value="MenuHeader"/>
284             <xsd:enumeration value="MenuItem"/>
285             <xsd:enumeration value="OnScreenDisplay"/>
286         </xsd:restriction>
287     </xsd:simpleType>
288     <xsd:simpleType name="fontweight">
289         <xsd:restriction base="xsd:string">
290             <xsd:enumeration value="normal"/>
291             <xsd:enumeration value="bold"/>
292         </xsd:restriction>
293     </xsd:simpleType>
294     <xsd:simpleType name="fontslant">
295         <xsd:restriction base="xsd:string">
296             <xsd:enumeration value="normal"/>
297             <xsd:enumeration value="italic"/>
298             <xsd:enumeration value="opaque"/>
299         </xsd:restriction>
300     </xsd:simpleType>
301     <xsd:simpleType name="button">
302         <xsd:restriction base="xsd:string">
303             <!-- FIXME what??? -->
304             <xsd:enumeration value="Left"/>
305             <xsd:enumeration value="Middle"/>
306             <xsd:enumeration value="Right"/>
307             <xsd:enumeration value="Up"/>
308             <xsd:enumeration value="Down"/>
309             <xsd:enumeration value="A-Left"/>
310             <xsd:enumeration value="A-Middle"/>
311             <xsd:enumeration value="A-Right"/>
312             <xsd:enumeration value="A-Up"/>
313             <xsd:enumeration value="A-Down"/>
314             <xsd:enumeration value="C-A-Left"/>
315             <xsd:enumeration value="C-A-Middle"/>
316             <xsd:enumeration value="C-A-Right"/>
317             <xsd:enumeration value="C-A-Up"/>
318             <xsd:enumeration value="C-A-Down"/>
319         </xsd:restriction>
320     </xsd:simpleType>
321     <xsd:simpleType name="center_or_int">
322         <xsd:restriction base="xsd:string">
323             <!-- ob: atoi($_) unless $_ eq 'center'; -->
324             <!-- I think the regexp DTRT WRT atoi. -->
325             <xsd:pattern value="center|0|[1-9][0-9]*"/>
326         </xsd:restriction>
327     </xsd:simpleType>
328     <xsd:simpleType name="mouse_or_int">
329         <xsd:restriction base="xsd:string">
330             <!-- ob: atoi($_) unless $_ eq 'center'; -->
331             <!-- I think the regexp DTRT WRT atoi. -->
332             <xsd:pattern value="mouse|0|[1-9][0-9]*"/>
333         </xsd:restriction>
334     </xsd:simpleType>
335     <xsd:simpleType name="contextname">
336         <xsd:restriction base="xsd:string">
337             <xsd:enumeration value="Desktop"/>
338             <xsd:enumeration value="Root"/>
339             <xsd:enumeration value="Client"/>
340             <xsd:enumeration value="Titlebar"/>
341             <xsd:enumeration value="Frame"/>
342             <xsd:enumeration value="TLCorner"/>
343             <xsd:enumeration value="TRCorner"/>
344             <xsd:enumeration value="BLCorner"/>
345             <xsd:enumeration value="BRCorner"/>
346             <xsd:enumeration value="Top"/>
347             <xsd:enumeration value="Left"/>
348             <xsd:enumeration value="Right"/>
349             <xsd:enumeration value="Bottom"/>
350             <xsd:enumeration value="Maximize"/>
351             <xsd:enumeration value="AllDesktops"/>
352             <xsd:enumeration value="Shade"/>
353             <xsd:enumeration value="Iconify"/>
354             <xsd:enumeration value="Icon"/>
355             <xsd:enumeration value="Close"/>
356             <xsd:enumeration value="MoveResize"/>
357         </xsd:restriction>
358     </xsd:simpleType>
359     <xsd:simpleType name="direction">
360         <xsd:restriction base="xsd:string">
361             <xsd:enumeration value="Horizontal"/>
362             <xsd:enumeration value="Vertical"/>
363         </xsd:restriction>
364     </xsd:simpleType>
365     <xsd:simpleType name="dock_position">
366         <xsd:restriction base="xsd:string">
367             <xsd:enumeration value="TopLeft"/>
368             <xsd:enumeration value="Top"/>
369             <xsd:enumeration value="TopRight"/>
370             <xsd:enumeration value="Right"/>
371             <xsd:enumeration value="BottomRight"/>
372             <xsd:enumeration value="Bottom"/>
373             <xsd:enumeration value="BottomLeft"/>
374             <xsd:enumeration value="Left"/>
375             <xsd:enumeration value="Floating"/>
376         </xsd:restriction>
377     </xsd:simpleType>
378     <xsd:simpleType name="keyname">
379         <xsd:restriction base="xsd:string">
380             <!-- FIXME: M, Mod2, Mod5 in addition to S, A, C -->
381             <!-- how do we do all substrings and permutations? -->
382             <xsd:pattern value="(A-)?(S-)?(A-)?(C-)?(A-)?(S-)?(A-)?[a-zA-Z0-9]*"/>
383         </xsd:restriction>
384     </xsd:simpleType>
385     <xsd:simpleType name="layer">
386         <xsd:restriction base="xsd:string">
387             <xsd:enumeration value="Above"/>
388             <xsd:enumeration value="Normal"/>
389             <xsd:enumeration value="Below"/>
390         </xsd:restriction>
391     </xsd:simpleType>
392     <xsd:simpleType name="maximization">
393         <xsd:restriction base="xsd:string">
394             <xsd:enumeration value="Horizontal"/>
395             <xsd:enumeration value="Vertical"/>
396             <!-- this is a copy of ob:bool.  Keep it in sync. -->
397             <xsd:enumeration value="yes"/>
398             <xsd:enumeration value="no"/>
399             <xsd:enumeration value="true"/>
400             <xsd:enumeration value="false"/>
401             <xsd:enumeration value="on"/>
402             <xsd:enumeration value="off"/>
403         </xsd:restriction>
404     </xsd:simpleType>
405     <xsd:simpleType name="mouseaction">
406         <xsd:restriction base="xsd:string">
407             <xsd:enumeration value="Click"/>
408             <xsd:enumeration value="DoubleClick"/>
409             <xsd:enumeration value="Drag"/>
410             <xsd:enumeration value="Press"/>
411             <xsd:enumeration value="Release"/>
412         </xsd:restriction>
413     </xsd:simpleType>
414     <xsd:simpleType name="placementpolicy">
415         <xsd:restriction base="xsd:string">
416             <xsd:enumeration value="Smart"/>
417             <xsd:enumeration value="UnderMouse"/>
418         </xsd:restriction>
419     </xsd:simpleType>
420     <xsd:simpleType name="placementmonitor">
421         <xsd:restriction base="xsd:string">
422             <xsd:enumeration value="Any"/>
423             <xsd:enumeration value="Mouse"/>
424             <xsd:enumeration value="Active"/>
425         </xsd:restriction>
426     </xsd:simpleType>
427     <xsd:simpleType name="popupposition">
428         <xsd:restriction base="xsd:string">
429             <xsd:enumeration value="Top"/>
430             <xsd:enumeration value="Center"/>
431         </xsd:restriction>
432     </xsd:simpleType>
433     <xsd:simpleType name="popupshow">
434         <xsd:restriction base="xsd:string">
435             <xsd:enumeration value="Always"/>
436             <xsd:enumeration value="Never"/>
437             <xsd:enumeration value="Nonpixel"/>
438         </xsd:restriction>
439     </xsd:simpleType>
440 </xsd:schema>