X-Git-Url: https://git.brokenzipper.com/gitweb?a=blobdiff_plain;f=data%2Frc.xml.in;h=35cc4cfb21ca1705c6eaa971fa6d448ba722a2b8;hb=aae4f66f68b32c8ad2760eeb12ebb9cb3d44602a;hp=be2b806dc76a8ff329979355e7f05d4b71c94250;hpb=c51373c20148422f1fd35a748c3cf18826496034;p=chaz%2Fopenbox

diff --git a/data/rc.xml.in b/data/rc.xml.in
index be2b806d..35cc4cfb 100644
--- a/data/rc.xml.in
+++ b/data/rc.xml.in
@@ -47,36 +47,53 @@
   <font place="ActiveWindow">
     <name>sans</name>
     <size>7</size>
+    <!-- font size in points -->
     <weight>bold</weight>
+    <!-- 'bold' or 'normal' -->
     <slant>normal</slant>
+    <!-- 'italic' or 'normal' -->
   </font>
   <font place="InactiveWindow">
     <name>sans</name>
     <size>7</size>
+    <!-- font size in points -->
     <weight>bold</weight>
+    <!-- 'bold' or 'normal' -->
     <slant>normal</slant>
+    <!-- 'italic' or 'normal' -->
   </font>
   <font place="MenuHeader">
     <name>sans</name>
     <size>8</size>
+    <!-- font size in points -->
     <weight>bold</weight>
+    <!-- 'bold' or 'normal' -->
     <slant>normal</slant>
+    <!-- 'italic' or 'normal' -->
   </font>
   <font place="MenuItem">
     <name>sans</name>
     <size>9</size>
+    <!-- font size in points -->
     <weight>bold</weight>
+    <!-- 'bold' or 'normal' -->
     <slant>normal</slant>
+    <!-- 'italic' or 'normal' -->
   </font>
   <font place="OnScreenDisplay">
     <name>sans</name>
     <size>9</size>
+    <!-- font size in points -->
     <weight>bold</weight>
+    <!-- 'bold' or 'normal' -->
     <slant>normal</slant>
+    <!-- 'italic' or 'normal' -->
   </font>
 </theme>
 
 <desktops>
+  <!-- this stuff is only used at startup, pagers allow you to change them
+       during a session -->
   <number>4</number>
   <firstdesk>1</firstdesk>
   <names>
@@ -408,38 +425,69 @@
 
   <!-- default menu file (or custom one in $HOME/.config/openbox/) -->
   <file>menu.xml</file>
-  <warpPointer>yes</warpPointer>
-  <xorStyle>yes</xorStyle>
   <hideDelay>250</hideDelay>
   <middle>no</middle>
   <submenuShowDelay>0</submenuShowDelay>
-  <desktopMenuIcons>yes</desktopMenuIcons>
-  <!-- -->
+  <applicationIcons>yes</applicationIcons>
 </menu>
 
+<!-- this section is commented out.. remove this and the ending comment if you
+     want to use it -->
 <applications>
-<!--
-  <application name="this application does not exist">
+  <!-- the name or the class can be set, or both. this is used to match
+       windows when they appear
+
+       role can optionally be set, and only as much as you provide will be 
+       checked to see if it matches, eg. if you set role="abc" and the window's
+       role is actually "abcde" it would match.
+ -->
+  <application name="first element of window's WM_CLASS property (see xprop)"
+              class="second element of window's WM_CLASS property (see xprop)"
+               role="the window's WM_WINDOW_ROLE property (see xprop)">
+
+    <!-- each element can be left out or set to 'default' to specify to not 
+         change that attribute of the window -->
+
     <decor>yes</decor>
+
     <shade>no</shade>
+
     <position>
+      <!-- the position is only used if both an x and y coordinate are provided
+           (and not set to 'default') -->
       <x>center</x>
+      <!-- a number or 'center' to center on screen -->
       <y>200</y>
+      <!-- a number or 'center' to center on screen -->
+      <monitor>1</monitor>
+      <!-- specifies the monitor in a xinerama setup.
+           1 is the first head, or 'mouse' for wherever the mouse is -->
     </position>
+
     <focus>yes</focus>
+    <!-- if the window should try be given focus when it appears -->
+
     <desktop>1</desktop>
-    <head>0</head>
-    # specifies xinerama head
+    <!-- 1 is the first desktop, 'all' for all desktops -->
+
     <layer>normal</layer>
-    # 'above', 'normal', or 'below'
+    <!-- 'above', 'normal', or 'below' -->
+
     <iconic>no</iconic>
+
     <skip_pager>no</skip_pager>
+    <!-- asks to not be shown in pagers -->
+
     <skip_taskbar>no</skip_taskbar>
+    <!-- asks to not be shown in taskbars. window cycling actions will also
+         skip past such windows -->
+
     <fullscreen>yes</fullscreen>
+
     <maximized>true</maximized>
-    # 'Horizontal', 'Vertical' or boolean (yes/no/on/off/true/false)
+    <!-- 'Horizontal', 'Vertical' or boolean (yes/no/on/off/true/false) -->
   </application>
- -->
 </applications>
+ -->
 
 </openbox_config>
