popups fixes. if the text for the popup is empty now, there wont be extra padding...

[chaz/openbox] / data / rc.xml.in

diff --git a/data/rc.xml.in b/data/rc.xml.in
index 28ec2ff18ad0c0e0c93f76ac8487b27f78b66b08..66880d7fb7e3a2339aa94f681053069e8240e061 100644 (file)
--- a/data/rc.xml.in
+++ b/data/rc.xml.in
@@ -47,32 +47,47 @@
   <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>
 
@@ -80,6 +95,8 @@
   <number>4</number>
   <firstdesk>1</firstdesk>
   <names>
+    <!-- the desktop names are only set at startup, pagers allow you to
+        change them during a session -->
     <name>desktop one</name>
     <name>desktop two</name>
     <name>desktop three</name>
@@ -97,11 +114,12 @@
 
 <dock>
   <position>TopLeft</position>
-  <!-- (Top|Bottom)(Left|Right|)|Left|Right|Floating -->
+  <!-- (Top|Bottom)(Left|Right|)|Top|Bottom|Left|Right|Floating -->
   <floatingX>0</floatingX>
   <floatingY>0</floatingY>
   <noStrut>no</noStrut>
   <stacking>Above</stacking>
+  <!-- 'Above', 'Normal', or 'Below' -->
   <direction>Vertical</direction>
   <!-- 'Vertical' or 'Horizontal' -->
   <autoHide>no</autoHide>
@@ -407,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>