1 <?xml version=
"1.0" encoding=
"UTF-8"?>
3 xml Schema for the openbox windowmanager configuration file
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
12 Mon Sep 1 00:57:55 CEST 2003 - pch(a)myzel.net
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
18 Mon Sep 15 14:27:42 CEST 2003 - pch(a)myzel.net
20 Die Sep 16 20:56:37 CEST 2003 - pch(a)myzel.net
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.
39 <xs:schema xmlns:
xs=
"http://www.w3.org/2001/XMLSchema"
40 targetNamespace=
"http://openbox.org/"
41 xmlns:
ob=
"http://openbox.org/"
42 elementFormDefault=
"qualified">
46 <xs:element name=
"openbox_config">
48 <xs:documentation>all these elements are expected in a openbox config file
</xs:documentation>
52 <xs:element name=
"resistance" type=
"ob:resistance"/>
53 <xs:element name=
"focus" type=
"ob:focus"/>
54 <xs:element name=
"placement" type=
"ob:placement"/>
55 <xs:element name=
"theme" type=
"ob:theme"/>
56 <xs:element name=
"desktops" type=
"ob:desktops"/>
57 <xs:element name=
"resize" type=
"ob:resize"/>
58 <xs:element name=
"dock" type=
"ob:dock"/>
59 <xs:element name=
"keyboard" type=
"ob:keyboard"/>
60 <xs:element name=
"mouse" type=
"ob:mouse"/>
61 <xs:element name=
"menu" type=
"ob:menu"/>
68 <xs:complexType name=
"resistance">
70 <xs:documentation>defines behaviour of windows when close to eachother or the screen edge
</xs:documentation>
73 <xs:element name=
"strength" type=
"xs:integer"/>
74 <xs:element name=
"screen_edge_strength" type=
"xs:integer"/>
75 <xs:element name=
"edges_hit_layers_below" type=
"xs:yesorno"/>
78 <xs:complexType name=
"focus">
80 <xs:documentation>defines aspects of window focus
</xs:documentation>
83 <xs:element name=
"focusNew" type=
"ob:yesorno"/>
84 <xs:element name=
"focusLast" type=
"ob:yesorno"/>
85 <xs:element name=
"followMouse" type=
"ob:yesorno"/>
86 <xs:element name=
"focusDelay" type=
"xs:integer"/>
87 <xs:element name=
"raiseOnFocus" type=
"ob:yesorno"/>
90 <xs:complexType name=
"placement">
92 <xs:documentation>defines how new windows are placed
</xs:documentation>
95 <xs:element name=
"policy" type=
"ob:placementpolicy"/>
98 <xs:complexType name=
"theme">
100 <xs:element name=
"name" type=
"xs:string"/>
101 <xs:element name=
"titlelayout" type=
"xs:string"/>
102 <xs:element name=
"keepBorder" type=
"ob:yesorno"/>
103 <xs:element name=
"hideDisabled" type=
"ob:yesorno"/>
106 <xs:complexType name=
"desktops">
108 <xs:element name=
"number" type=
"xs:integer"/>
109 <xs:element name=
"names">
112 <xs:element maxOccurs=
"unbounded" name=
"name" type=
"xs:string"/>
116 <xs:element name=
"firstdesk" type=
"xs:integer"/>
119 <xs:complexType name=
"resize">
121 <xs:element name=
"drawContents" type=
"ob:yesorno"/>
122 <xs:element name=
"fourCorners" type=
"ob:yesorno"/>
123 <xs:element name=
"popupShow" type=
"ob:popupshow"/>
124 <xs:element name=
"popupPosition" type=
"ob:popupposition"/>
127 <xs:complexType name=
"dock">
129 <xs:element name=
"position" type=
"ob:position"/>
130 <xs:element name=
"stacking" type=
"ob:stacking"/>
131 <xs:element name=
"direction" type=
"ob:direction"/>
132 <xs:element name=
"floatingX" type=
"xs:integer"/>
133 <xs:element name=
"floatingY" type=
"xs:integer"/>
134 <xs:element name=
"autoHide" type=
"ob:yesorno"/>
135 <xs:element name=
"hideDelay" type=
"xs:integer"/>
136 <xs:element name=
"moveButton" type=
"ob:button"/>
137 <xs:element name=
"noStrut" type=
"ob:yesorno"/>
140 <xs:complexType name=
"action">
142 <xs:element minOccurs=
"0" name=
"menu" type=
"xs:string"/>
143 <xs:element minOccurs=
"0" name=
"desktop" type=
"xs:integer"/>
144 <xs:element minOccurs=
"0" name=
"follow" type=
"ob:yesorno"/>
145 <xs:element minOccurs=
"0" name=
"execute" type=
"xs:string"/>
146 <xs:element minOccurs=
"0" name=
"group" type=
"ob:yesorno"/>
147 <xs:element minOccurs=
"0" name=
"dialog" type=
"ob:yesorno"/>
149 <xs:attribute name=
"name" type=
"ob:actionname" use=
"required"/>
151 <xs:complexType name=
"keybind">
153 <xs:element maxOccurs=
"unbounded" name=
"action" type=
"ob:action"/>
155 <xs:attribute name=
"key" type=
"ob:keyname" use=
"required"/>
157 <xs:complexType name=
"keyboard">
159 <xs:element name=
"chainQuitKey" type=
"ob:keyname"/>
160 <xs:element maxOccurs=
"unbounded" name=
"keybind" type=
"ob:keybind"/>
163 <xs:complexType name=
"mousebind">
165 <xs:element maxOccurs=
"unbounded" name=
"action" type=
"ob:action"/>
167 <xs:attribute name=
"action" type=
"ob:mouseaction" use=
"required"/>
168 <xs:attribute name=
"button" type=
"ob:button" use=
"required"/>
170 <xs:complexType name=
"context">
172 <xs:element maxOccurs=
"unbounded" name=
"mousebind" type=
"ob:mousebind"/>
174 <xs:attribute name=
"name" type=
"ob:contextname" use=
"required"/>
176 <xs:complexType name=
"mouse">
178 <xs:element name=
"dragThreshold" type=
"xs:integer"/>
179 <xs:element name=
"doubleClickTime" type=
"xs:integer"/>
180 <xs:element maxOccurs=
"unbounded" name=
"context" type=
"ob:context"/>
183 <xs:complexType name=
"menu">
185 <xs:element maxOccurs=
"unbounded" name=
"file" type=
"xs:string"/>
186 <xs:element name=
"warpPointer" type=
"ob:yesorno"/>
187 <xs:element name=
"xorStyle" type=
"ob:yesorno"/>
188 <xs:element name=
"hideDelay" type=
"xs:integer"/>
189 <xs:element name=
"desktopMenuIcons" type=
"ob:yesorno"/>
193 simple types / restrictions
195 <xs:simpleType name=
"yesorno">
196 <xs:restriction base=
"xs:string">
197 <xs:enumeration value=
"yes"/>
198 <xs:enumeration value=
"no"/>
201 <xs:simpleType name=
"placementpolicy">
202 <xs:restriction base=
"xs:string">
203 <xs:enumeration value=
"Smart"/>
204 <xs:enumeration value=
"UnderMouse"/>
207 <xs:simpleType name=
"popupshow">
208 <xs:restriction base=
"xs:string">
209 <xs:enumeration value=
"Always"/>
210 <xs:enumeration value=
"Never"/>
211 <xs:enumeration value=
"Nonpixel"/>
214 <xs:simpleType name=
"popupposition">
215 <xs:restriction base=
"xs:string">
216 <xs:enumeration value=
"Top"/>
217 <xs:enumeration value=
"Center"/>
220 <xs:simpleType name=
"position">
221 <xs:restriction base=
"xs:string">
222 <xs:enumeration value=
"TopLeft"/>
223 <xs:enumeration value=
"Top"/>
224 <xs:enumeration value=
"TopRight"/>
225 <xs:enumeration value=
"Right"/>
226 <xs:enumeration value=
"BottomRight"/>
227 <xs:enumeration value=
"Bottom"/>
228 <xs:enumeration value=
"BottomLeft"/>
229 <xs:enumeration value=
"Left"/>
230 <xs:enumeration value=
"Floating"/>
233 <xs:simpleType name=
"stacking">
234 <xs:restriction base=
"xs:string">
235 <xs:enumeration value=
"Top"/>
236 <xs:enumeration value=
"Normal"/>
237 <xs:enumeration value=
"Bottom"/>
240 <xs:simpleType name=
"direction">
241 <xs:restriction base=
"xs:string">
242 <xs:enumeration value=
"Horizontal"/>
243 <xs:enumeration value=
"Vertical"/>
246 <xs:simpleType name=
"keyname">
247 <xs:restriction base=
"xs:string">
248 <xs:pattern value=
"(A-)?(S-)?(A-)?(C-)?(A-)?(S-)?(A-)?[a-zA-Z0-9]*"/>
251 <xs:simpleType name=
"contextname">
252 <xs:restriction base=
"xs:string">
253 <xs:enumeration value=
"Desktop"/>
254 <xs:enumeration value=
"Client"/>
255 <xs:enumeration value=
"Titlebar"/>
256 <xs:enumeration value=
"Handle"/>
257 <xs:enumeration value=
"Frame"/>
258 <xs:enumeration value=
"TLCorner"/>
259 <xs:enumeration value=
"TRCorner"/>
260 <xs:enumeration value=
"BLCorner"/>
261 <xs:enumeration value=
"BRCorner"/>
262 <xs:enumeration value=
"Maximize"/>
263 <xs:enumeration value=
"AllDesktops"/>
264 <xs:enumeration value=
"Shade"/>
265 <xs:enumeration value=
"Iconify"/>
266 <xs:enumeration value=
"Icon"/>
267 <xs:enumeration value=
"Close"/>
268 <xs:enumeration value=
"MoveResize"/>
271 <xs:simpleType name=
"button">
272 <xs:restriction base=
"xs:string">
273 <xs:enumeration value=
"Left"/>
274 <xs:enumeration value=
"Middle"/>
275 <xs:enumeration value=
"Right"/>
276 <xs:enumeration value=
"Up"/>
277 <xs:enumeration value=
"Down"/>
278 <xs:enumeration value=
"A-Left"/>
279 <xs:enumeration value=
"A-Middle"/>
280 <xs:enumeration value=
"A-Right"/>
281 <xs:enumeration value=
"A-Up"/>
282 <xs:enumeration value=
"A-Down"/>
283 <xs:enumeration value=
"C-A-Left"/>
284 <xs:enumeration value=
"C-A-Middle"/>
285 <xs:enumeration value=
"C-A-Right"/>
286 <xs:enumeration value=
"C-A-Up"/>
287 <xs:enumeration value=
"C-A-Down"/>
290 <xs:simpleType name=
"mouseaction">
291 <xs:restriction base=
"xs:string">
292 <xs:enumeration value=
"Click"/>
293 <xs:enumeration value=
"DoubleClick"/>
294 <xs:enumeration value=
"Drag"/>
295 <xs:enumeration value=
"Press"/>
296 <xs:enumeration value=
"Release"/>
299 <xs:simpleType name=
"actionname">
300 <xs:restriction base=
"xs:string">
301 <xs:enumeration value=
"Activate"/>
302 <xs:enumeration value=
"Close"/>
303 <xs:enumeration value=
"Desktop"/>
304 <xs:enumeration value=
"DesktopDown"/>
305 <xs:enumeration value=
"DesktopLast"/>
306 <xs:enumeration value=
"DesktopLeft"/>
307 <xs:enumeration value=
"DesktopNext"/>
308 <xs:enumeration value=
"DesktopPrevious"/>
309 <xs:enumeration value=
"DesktopRight"/>
310 <xs:enumeration value=
"DesktopUp"/>
311 <xs:enumeration value=
"DirectionalFocusEast"/>
312 <xs:enumeration value=
"DirectionalFocusNorth"/>
313 <xs:enumeration value=
"DirectionalFocusNortheast"/>
314 <xs:enumeration value=
"DirectionalFocusNorthwest"/>
315 <xs:enumeration value=
"DirectionalFocusSouth"/>
316 <xs:enumeration value=
"DirectionalFocusSoutheast"/>
317 <xs:enumeration value=
"DirectionalFocusSouthwest"/>
318 <xs:enumeration value=
"DirectionalFocusWest"/>
319 <xs:enumeration value=
"Execute"/>
320 <xs:enumeration value=
"Exit"/>
321 <xs:enumeration value=
"Focus"/>
322 <xs:enumeration value=
"FocusToBottom"/>
323 <xs:enumeration value=
"GrowToEdgeEast"/>
324 <xs:enumeration value=
"GrowToEdgeNorth"/>
325 <xs:enumeration value=
"GrowToEdgeSouth"/>
326 <xs:enumeration value=
"GrowToEdgeWest"/>
327 <xs:enumeration value=
"Iconify"/>
328 <xs:enumeration value=
"Kill"/>
329 <xs:enumeration value=
"Lower"/>
330 <xs:enumeration value=
"MaximizeFull"/>
331 <xs:enumeration value=
"MaximizeHorz"/>
332 <xs:enumeration value=
"MaximizeVert"/>
333 <xs:enumeration value=
"Move"/>
334 <xs:enumeration value=
"MoveRelativeHorz"/>
335 <xs:enumeration value=
"MoveRelativeVert"/>
336 <xs:enumeration value=
"MoveToEdgeEast"/>
337 <xs:enumeration value=
"MoveToEdgeNorth"/>
338 <xs:enumeration value=
"MoveToEdgeSouth"/>
339 <xs:enumeration value=
"MoveToEdgeWest"/>
340 <xs:enumeration value=
"NextWindow"/>
341 <xs:enumeration value=
"NextWindowLinear"/>
342 <xs:enumeration value=
"PreviousWindow"/>
343 <xs:enumeration value=
"PreviousWindowLinear"/>
344 <xs:enumeration value=
"Raise"/>
345 <xs:enumeration value=
"RaiseLower"/>
346 <xs:enumeration value=
"Resize"/>
347 <xs:enumeration value=
"ResizeRelativeHorz"/>
348 <xs:enumeration value=
"ResizeRelativeVert"/>
349 <xs:enumeration value=
"Restart"/>
350 <xs:enumeration value=
"SendToBottomLayer"/>
351 <xs:enumeration value=
"SendToDesktop"/>
352 <xs:enumeration value=
"SendToDesktopDown"/>
353 <xs:enumeration value=
"SendToDesktopLeft"/>
354 <xs:enumeration value=
"SendToDesktopNext"/>
355 <xs:enumeration value=
"SendToDesktopPrevious"/>
356 <xs:enumeration value=
"SendToDesktopRight"/>
357 <xs:enumeration value=
"SendToDesktopUp"/>
358 <xs:enumeration value=
"SendToNormalLayer"/>
359 <xs:enumeration value=
"SendToTopLayer"/>
360 <xs:enumeration value=
"Shade"/>
361 <xs:enumeration value=
"ShadeLower"/>
362 <xs:enumeration value=
"ShowDesktop"/>
363 <xs:enumeration value=
"ShowMenu"/>
364 <xs:enumeration value=
"ToggleAlwaysOnBottom"/>
365 <xs:enumeration value=
"ToggleAlwaysOnTop"/>
366 <xs:enumeration value=
"ToggleDecorations"/>
367 <xs:enumeration value=
"ToggleFullscreen"/>
368 <xs:enumeration value=
"ToggleMaximizeFull"/>
369 <xs:enumeration value=
"ToggleMaximizeHorz"/>
370 <xs:enumeration value=
"ToggleMaximizeVert"/>
371 <xs:enumeration value=
"ToggleOmnipresent"/>
372 <xs:enumeration value=
"ToggleShade"/>
373 <xs:enumeration value=
"ToggleShowDesktop"/>
374 <xs:enumeration value=
"Unfocus"/>
375 <xs:enumeration value=
"UnmaximizeFull"/>
376 <xs:enumeration value=
"UnmaximizeHorz"/>
377 <xs:enumeration value=
"UnmaximizeVert"/>
378 <xs:enumeration value=
"Unshade"/>
379 <xs:enumeration value=
"UnshadeRaise"/>
380 <xs:enumeration value=
"UnShowDesktop"/>