Re-sync on upstream settings file, adding notes about specific settings.

debian/changelog

@@ -5,6 +5,7 @@ lubuntu-default-settings (0.47) UNRELEASED; urgency=medium
   * src/usr/share/lubuntu/openbox/rc.xml:
    - Force the focus when opening an application, to fix the focus when a
      terminal is launched from pcmanfm.
+   - Re-sync on upstream settings file, adding notes about specific settings.
 
  -- Julien Lavergne <gilir@ubuntu.com>  Mon, 15 Aug 2016 12:15:49 +0200
 

src/usr/share/lubuntu/openbox/rc.xml

@@ -1,11 +1,16 @@
 <?xml version="1.0" encoding="UTF-8"?>
+
 <!-- Do not edit this file, it will be overwritten on install.
         Copy the file to $HOME/.config/openbox/ instead. -->
-<openbox_config xmlns="http://openbox.org/3.4/rc" xmlns:xi="http://www.w3.org/2001/XInclude">
+
+<openbox_config xmlns="http://openbox.org/3.4/rc"
+		xmlns:xi="http://www.w3.org/2001/XInclude">
+
 <resistance>
   <strength>10</strength>
   <screen_edge_strength>20</screen_edge_strength>
 </resistance>
+
 <focus>
   <focusNew>yes</focusNew>
   <!-- always try to focus new windows when they appear. other rules do
@@ -24,7 +29,12 @@
   <!-- when followMouse is enabled, and a window is given focus by moving the
        mouse into it, also raise the window -->
 </focus>
+
 <placement>
+  <!--  Lubuntu specific : Place new windows where the mouse is
+        <monitor>Mouse</monitor>
+        <primaryMonitor>Mouse</primaryMonitor>
+  -->
   <policy>Smart</policy>
   <!-- 'Smart' or 'UnderMouse' -->
   <center>yes</center>
@@ -41,7 +51,10 @@
        following: 'Mouse' - where the mouse is, or
                   'Active' - where the active window is -->
 </placement>
+
 <theme>
+  <!--  Lubuntu specific : Theme = Lubuntu and font = Ubuntu
+  -->
   <name>Lubuntu-default</name>
   <titleLayout>NLIMC</titleLayout>
   <!--
@@ -111,6 +124,7 @@
     <!-- 'italic' or 'normal' -->
   </font>
 </theme>
+
 <desktops>
   <!-- this stuff is only used at startup, pagers allow you to change them
        during a session
@@ -120,7 +134,7 @@
 
        use obconf if you want to change these without having to log out
        and back in -->
-    <number>2</number>
+  <number>4</number>
   <firstdesk>1</firstdesk>
   <names>
     <!-- set names up here if you want to, like this:
@@ -132,7 +146,11 @@
   <!-- The number of milliseconds to show the popup for when switching
        desktops.  Set this to 0 to disable the popup. -->
 </desktops>
+
 <resize>
+  <!--  Lubuntu specific : Don't draw content on resize (too heavy).
+        <drawContents>no</drawContents> 
+  -->
   <drawContents>no</drawContents>
   <popupShow>Nonpixel</popupShow>
   <!-- 'Always', 'Never', or 'Nonpixel' (xterms and such) -->
@@ -140,6 +158,7 @@
   <!-- 'Center', 'Top', or 'Fixed' -->
   <popupFixedPosition>
     <!-- these are used if popupPosition is set to 'Fixed' -->
+
     <x>10</x>
     <!-- positive number for distance from left edge, negative number for
          distance from right edge, or 'Center' -->
@@ -148,6 +167,7 @@
          distance from bottom edge, or 'Center' -->
   </popupFixedPosition>
 </resize>
+
 <!-- You can reserve a portion of your screen where windows will not cover when
      they are maximized, or when they are initially placed.
      Many programs reserve space automatically, but you can use this in other
@@ -158,6 +178,7 @@
   <left>0</left>
   <right>0</right>
 </margins>
+
 <dock>
   <position>TopLeft</position>
   <!-- (Top|Bottom)(Left|Right|)|Top|Bottom|Left|Right|Floating -->
@@ -176,80 +197,52 @@
   <moveButton>Middle</moveButton>
   <!-- 'Left', 'Middle', 'Right' -->
 </dock>
+
 <keyboard>
   <chainQuitKey>C-g</chainQuitKey>
+
   <!-- Keybindings for desktop switching -->
   <keybind key="C-A-Left">
-      <action name="GoToDesktop">
+    <action name="GoToDesktop"><to>left</to><wrap>no</wrap></action>
-        <to>left</to>
-        <wrap>no</wrap>
-      </action>
   </keybind>
   <keybind key="C-A-Right">
-      <action name="GoToDesktop">
+    <action name="GoToDesktop"><to>right</to><wrap>no</wrap></action>
-        <to>right</to>
-        <wrap>no</wrap>
-      </action>
   </keybind>
   <keybind key="C-A-Up">
-      <action name="GoToDesktop">
+    <action name="GoToDesktop"><to>up</to><wrap>no</wrap></action>
-        <to>up</to>
-        <wrap>no</wrap>
-      </action>
   </keybind>
   <keybind key="C-A-Down">
-      <action name="GoToDesktop">
+    <action name="GoToDesktop"><to>down</to><wrap>no</wrap></action>
-        <to>down</to>
-        <wrap>no</wrap>
-      </action>
   </keybind>
   <keybind key="S-A-Left">
-      <action name="SendToDesktop">
+    <action name="SendToDesktop"><to>left</to><wrap>no</wrap></action>
-        <to>left</to>
-        <wrap>no</wrap>
-      </action>
   </keybind>
   <keybind key="S-A-Right">
-      <action name="SendToDesktop">
+    <action name="SendToDesktop"><to>right</to><wrap>no</wrap></action>
-        <to>right</to>
-        <wrap>no</wrap>
-      </action>
   </keybind>
   <keybind key="S-A-Up">
-      <action name="SendToDesktop">
+    <action name="SendToDesktop"><to>up</to><wrap>no</wrap></action>
-        <to>up</to>
-        <wrap>no</wrap>
-      </action>
   </keybind>
   <keybind key="S-A-Down">
-      <action name="SendToDesktop">
+    <action name="SendToDesktop"><to>down</to><wrap>no</wrap></action>
-        <to>down</to>
-        <wrap>no</wrap>
-      </action>
   </keybind>
   <keybind key="W-F1">
-      <action name="GoToDesktop">
+    <action name="GoToDesktop"><to>1</to></action>
-        <to>1</to>
-      </action>
   </keybind>
   <keybind key="W-F2">
-      <action name="GoToDesktop">
+    <action name="GoToDesktop"><to>2</to></action>
-        <to>2</to>
-      </action>
   </keybind>
   <keybind key="W-F3">
-      <action name="GoToDesktop">
+    <action name="GoToDesktop"><to>3</to></action>
-        <to>3</to>
-      </action>
   </keybind>
   <keybind key="W-F4">
-      <action name="GoToDesktop">
+    <action name="GoToDesktop"><to>4</to></action>
-        <to>4</to>
-      </action>
   </keybind>
   <keybind key="W-d">
     <action name="ToggleShowDesktop"/>
   </keybind>
+
+    <!-- Keybindings for windows -->
   <!-- Keybindings for windows -->
   <keybind key="A-F4">
     <action name="Close"/>
@@ -260,20 +253,12 @@
     <action name="Unfocus"/>
   </keybind>
   <keybind key="A-space">
-      <action name="ShowMenu">
+    <action name="ShowMenu"><menu>client-menu</menu></action>
-        <menu>client-menu</menu>
-      </action>
-    </keybind>
-    <!-- Take a screenshot of the current window with scrot when Alt+Print are pressed -->
-    <keybind key="A-Print">
-      <action name="Execute">
-        <command>lxsession-default screenshot window</command>
-      </action>
   </keybind>
+
   <!-- Keybindings for window switching -->
   <keybind key="A-Tab">
     <action name="NextWindow">
-        <dialog>icons</dialog>
       <finalactions>
         <action name="Focus"/>
         <action name="Raise"/>
@@ -292,8 +277,7 @@
   </keybind>
   <keybind key="C-A-Tab">
     <action name="NextWindow">
-        <panels>yes</panels>
+      <panels>yes</panels><desktop>yes</desktop>
-        <desktop>yes</desktop>
       <finalactions>
         <action name="Focus"/>
         <action name="Raise"/>
@@ -301,6 +285,7 @@
       </finalactions>
     </action>
   </keybind>
+
   <!-- Keybindings for window switching with the arrow keys -->
   <keybind key="W-S-Right">
     <action name="DirectionalCycleWindows">
@@ -322,8 +307,15 @@
       <direction>down</direction>
     </action>
   </keybind>
-    <!-- Keybindings for window tiling -->
+
-    <keybind key="W-Left">        # HalfLeftScreen
+    <!-- 
+        Lubuntu specific.
+        Keybindings for window tiling
+    -->
+    <!-- 
+        # HalfLeftScreen
+    -->
+  <keybind key="W-Left">
     <action name="UnmaximizeFull"/>
     <action name="MoveResizeTo">
       <x>0</x>
@@ -332,7 +324,10 @@
       <width>50%</width>
     </action>
   </keybind>
-    <keybind key="W-Right">        # HalfRightScreen
+    <!-- 
+        # HalfRightScreen
+    -->
+  <keybind key="W-Right">
     <action name="UnmaximizeFull"/>
     <action name="MoveResizeTo">
       <x>-0</x>
@@ -341,7 +336,10 @@
       <width>50%</width>
     </action>
   </keybind>
-    <keybind key="W-Up">        # HalfUpperScreen
+    <!-- 
+        # HalfUpperScreen
+    -->
+  <keybind key="W-Up">        
     <action name="UnmaximizeFull"/>
     <action name="MoveResizeTo">
       <x>0</x>
@@ -350,7 +348,10 @@
       <height>50%</height>
     </action>
   </keybind>
-    <keybind key="W-Down">        # HalfLowerScreen
+    <!-- 
+        # HalfLowerScreen
+    -->
+  <keybind key="W-Down">        
     <action name="UnmaximizeFull"/>
     <action name="MoveResizeTo">
       <x>0</x>
@@ -359,6 +360,9 @@
       <height>50%</height>
     </action>
   </keybind>
+
+  <!--  Lubuntu specific : Keybindings -->
+
   <!-- Keybindings for running applications on Home + E -->
   <keybind key="W-e">
     <action name="Execute">
@@ -369,6 +373,7 @@
       <command>lxsession-default file_manager</command>
     </action>
   </keybind>
+
   <!-- Keybindings for running Run menu from Lxpanel on Home + R-->
   <keybind key="W-r">
     <action name="Execute">
@@ -380,6 +385,7 @@
       <command>lxsession-default launcher</command>
     </action>
   </keybind>
+
   <!-- Keybindings for running Menu from Lxpanel -->
   <keybind key="A-F1">
     <action name="Execute">
@@ -391,22 +397,26 @@
       <command>lxpanelctl menu</command>
     </action>
   </keybind>
+
   <!-- Keybindings to toggle fullscreen -->
   <keybind key="F11">
     <action name="ToggleFullscreen"/>
   </keybind>
+
   <!-- Launch task manager on Ctrl + Alt + Del-->
   <keybind key="C-A-Delete">
     <action name="Execute">
       <command>lxsession-default tasks</command>
     </action>
   </keybind>
+
   <!-- Launch a terminal on Ctrl + Alt + T-->
   <keybind key="C-A-T">
     <action name="Execute">
       <command>lxsession-default terminal</command>
     </action>
   </keybind>
+
   <!-- Launch a filemanager on Ctrl + Alt + D-->
   <keybind key="C-A-D">
     <action name="Execute">
@@ -417,12 +427,14 @@
       <command>lxsession-default file_manager</command>
     </action>
   </keybind>
+
   <!-- Lock the screen on Ctrl + Alt + l-->
   <keybind key="C-A-l">
     <action name="Execute">
       <command>lxsession-default lock</command>
     </action>
   </keybind>
+
   <!-- Keybinding for Volume management -->
   <keybind key="XF86AudioRaiseVolume">
       <action name="Execute">
@@ -439,6 +451,7 @@
           <command>amixer -q sset Master toggle</command>
       </action>
   </keybind>
+
   <!-- Keybinding for terminal button-->
   <keybind key="XF86WWW">
     <action name="Execute">
@@ -450,18 +463,21 @@
       <command>lxsession-default terminal</command>
     </action>
   </keybind>
+
   <!-- Keybinding for calculator button-->
   <keybind key="XF86Calculator">
     <action name="Execute">
       <command>lxsession-default calculator</command>
     </action>
   </keybind>
+
   <!-- Keybinding for computer button-->
   <keybind key="XF86MyComputer">
     <action name="Execute">
       <command>lxsession-default file_manager</command>
     </action>
   </keybind>
+
   <!-- Keybindings for Multimedia Keys and LCD Backlight (alternative when not using gnome-power-manager or xfce4-volumed) -->
   <keybind key="C-F7">
     <action name="Execute">
@@ -478,12 +494,21 @@
       <command>xbacklight -inc 10</command>
     </action>
   </keybind>
-    <!-- Launch scrot when Print is pressed -->
+
+  <!--
+      Take a screenshot of the current window with scrot when Alt+Print are pressed 
+  -->
   <keybind key="Print">
     <action name="Execute">
       <command>lxsession-default screenshot</command>
     </action>
   </keybind>
+  <keybind key="A-Print">
+    <action name="Execute">
+      <command>lxsession-default screenshot window</command>
+    </action>
+  </keybind>
+
   <!-- Launch logout when push on the shutdown button -->
   <keybind key="XF86PowerOff">
     <action name="Execute">
@@ -491,7 +516,13 @@
     </action>
   </keybind>
 </keyboard>
+
 <mouse>
+  <!--
+      Lubuntu specific : Specific mouse settings 
+        <dragThreshold>8</dragThreshold>
+        <doubleClickTime>200</doubleClickTime>
+  -->
   <dragThreshold>8</dragThreshold>
   <!-- number of pixels the mouse must move before a drag begins -->
   <doubleClickTime>200</doubleClickTime>
@@ -503,6 +534,7 @@
   <screenEdgeWarpMouse>false</screenEdgeWarpMouse>
   <!-- Set this to TRUE to move the mouse pointer across the desktop when
        switching due to hitting the edge of the screen -->
+
   <context name="Frame">
     <mousebind button="A-Left" action="Press">
       <action name="Focus"/>
@@ -514,6 +546,7 @@
     <mousebind button="A-Left" action="Drag">
       <action name="Move"/>
     </mousebind>
+
     <mousebind button="A-Right" action="Press">
       <action name="Focus"/>
       <action name="Raise"/>
@@ -522,42 +555,33 @@
     <mousebind button="A-Right" action="Drag">
       <action name="Resize"/>
     </mousebind> 
+
     <mousebind button="A-Middle" action="Press">
       <action name="Lower"/>
       <action name="FocusToBottom"/>
       <action name="Unfocus"/>
     </mousebind>
+
     <mousebind button="A-Up" action="Click">
-        <action name="GoToDesktop">
+      <action name="GoToDesktop"><to>previous</to></action>
-          <to>previous</to>
-        </action>
     </mousebind>
     <mousebind button="A-Down" action="Click">
-        <action name="GoToDesktop">
+      <action name="GoToDesktop"><to>next</to></action>
-          <to>next</to>
-        </action>
     </mousebind>
     <mousebind button="C-A-Up" action="Click">
-        <action name="GoToDesktop">
+      <action name="GoToDesktop"><to>previous</to></action>
-          <to>previous</to>
-        </action>
     </mousebind>
     <mousebind button="C-A-Down" action="Click">
-        <action name="GoToDesktop">
+      <action name="GoToDesktop"><to>next</to></action>
-          <to>next</to>
-        </action>
     </mousebind>
     <mousebind button="A-S-Up" action="Click">
-        <action name="SendToDesktop">
+      <action name="SendToDesktop"><to>previous</to></action>
-          <to>previous</to>
-        </action>
     </mousebind>
     <mousebind button="A-S-Down" action="Click">
-        <action name="SendToDesktop">
+      <action name="SendToDesktop"><to>next</to></action>
-          <to>next</to>
-        </action>
     </mousebind>
   </context>
+
   <context name="Titlebar">
     <mousebind button="Left" action="Drag">
       <action name="Move"/>
@@ -565,6 +589,7 @@
     <mousebind button="Left" action="DoubleClick">
       <action name="ToggleMaximize"/>
     </mousebind>
+
     <mousebind button="Up" action="Click">
       <action name="if">
         <shaded>no</shaded>
@@ -586,60 +611,57 @@
       </action>
     </mousebind>
   </context>
+
   <context name="Titlebar Top Right Bottom Left TLCorner TRCorner BRCorner BLCorner">
     <mousebind button="Left" action="Press">
       <action name="Focus"/>
       <action name="Raise"/>
       <action name="Unshade"/>
     </mousebind>
+
     <mousebind button="Middle" action="Press">
       <action name="Lower"/>
       <action name="FocusToBottom"/>
       <action name="Unfocus"/>
     </mousebind>
+
     <mousebind button="Right" action="Press">
       <action name="Focus"/>
       <action name="Raise"/>
-        <action name="ShowMenu">
+      <action name="ShowMenu"><menu>client-menu</menu></action>
-          <menu>client-menu</menu>
-        </action>
     </mousebind>
   </context>
+
   <context name="Top">
     <mousebind button="Left" action="Drag">
-        <action name="Resize">
+      <action name="Resize"><edge>top</edge></action>
-          <edge>top</edge>
-        </action>
     </mousebind>
   </context>
+
   <context name="Left">
     <mousebind button="Left" action="Drag">
-        <action name="Resize">
+      <action name="Resize"><edge>left</edge></action>
-          <edge>left</edge>
-        </action>
     </mousebind>
   </context>
+
   <context name="Right">
     <mousebind button="Left" action="Drag">
-        <action name="Resize">
+      <action name="Resize"><edge>right</edge></action>
-          <edge>right</edge>
-        </action>
     </mousebind>
   </context>
+
   <context name="Bottom">
     <mousebind button="Left" action="Drag">
-        <action name="Resize">
+      <action name="Resize"><edge>bottom</edge></action>
-          <edge>bottom</edge>
-        </action>
     </mousebind>
+
     <mousebind button="Right" action="Press">
       <action name="Focus"/>
       <action name="Raise"/>
-        <action name="ShowMenu">
+      <action name="ShowMenu"><menu>client-menu</menu></action>
-          <menu>client-menu</menu>
-        </action>
     </mousebind>
   </context>
+
   <context name="TRCorner BRCorner TLCorner BLCorner">
     <mousebind button="Left" action="Press">
       <action name="Focus"/>
@@ -650,6 +672,7 @@
       <action name="Resize"/>
     </mousebind>
   </context>
+
   <context name="Client">
     <mousebind button="Left" action="Press">
       <action name="Focus"/>
@@ -664,23 +687,21 @@
       <action name="Raise"/>
     </mousebind>
   </context>
+
   <context name="Icon">
     <mousebind button="Left" action="Press">
       <action name="Focus"/>
       <action name="Raise"/>
       <action name="Unshade"/>
-        <action name="ShowMenu">
+      <action name="ShowMenu"><menu>client-menu</menu></action>
-          <menu>client-menu</menu>
-        </action>
     </mousebind>
     <mousebind button="Right" action="Press">
       <action name="Focus"/>
       <action name="Raise"/>
-        <action name="ShowMenu">
+      <action name="ShowMenu"><menu>client-menu</menu></action>
-          <menu>client-menu</menu>
-        </action>
     </mousebind>
   </context>
+
   <context name="AllDesktops">
     <mousebind button="Left" action="Press">
       <action name="Focus"/>
@@ -691,6 +712,7 @@
       <action name="ToggleOmnipresent"/>
     </mousebind>
   </context>
+
   <context name="Shade">
     <mousebind button="Left" action="Press">
       <action name="Focus"/>
@@ -700,6 +722,7 @@
       <action name="ToggleShade"/>
     </mousebind>
   </context>
+
   <context name="Iconify">
     <mousebind button="Left" action="Press">
       <action name="Focus"/>
@@ -709,6 +732,7 @@
       <action name="Iconify"/>
     </mousebind>
   </context>
+
   <context name="Maximize">
     <mousebind button="Left" action="Press">
       <action name="Focus"/>
@@ -729,16 +753,13 @@
       <action name="ToggleMaximize"/>
     </mousebind>
     <mousebind button="Middle" action="Click">
-        <action name="ToggleMaximize">
+      <action name="ToggleMaximize"><direction>vertical</direction></action>
-          <direction>vertical</direction>
-        </action>
     </mousebind>
     <mousebind button="Right" action="Click">
-        <action name="ToggleMaximize">
+      <action name="ToggleMaximize"><direction>horizontal</direction></action>
-          <direction>horizontal</direction>
-        </action>
     </mousebind>
   </context>
+
   <context name="Close">
     <mousebind button="Left" action="Press">
       <action name="Focus"/>
@@ -749,37 +770,28 @@
       <action name="Close"/>
     </mousebind>
   </context>
+
   <context name="Desktop">
     <mousebind button="Up" action="Click">
-        <action name="GoToDesktop">
+      <action name="GoToDesktop"><to>previous</to></action>
-          <to>previous</to>
-        </action>
     </mousebind>
     <mousebind button="Down" action="Click">
-        <action name="GoToDesktop">
+      <action name="GoToDesktop"><to>next</to></action>
-          <to>next</to>
-        </action>
     </mousebind>
+
     <mousebind button="A-Up" action="Click">
-        <action name="GoToDesktop">
+      <action name="GoToDesktop"><to>previous</to></action>
-          <to>previous</to>
-        </action>
     </mousebind>
     <mousebind button="A-Down" action="Click">
-        <action name="GoToDesktop">
+      <action name="GoToDesktop"><to>next</to></action>
-          <to>next</to>
-        </action>
     </mousebind>
     <mousebind button="C-A-Up" action="Click">
-        <action name="GoToDesktop">
+      <action name="GoToDesktop"><to>previous</to></action>
-          <to>previous</to>
-        </action>
     </mousebind>
     <mousebind button="C-A-Down" action="Click">
-        <action name="GoToDesktop">
+      <action name="GoToDesktop"><to>next</to></action>
-          <to>next</to>
-        </action>
     </mousebind>
+
     <mousebind button="Left" action="Press">
       <action name="Focus"/>
       <action name="Raise"/>
@@ -789,47 +801,39 @@
       <action name="Raise"/>
     </mousebind>
   </context>
+
   <context name="Root">
     <!-- Menus -->
     <mousebind button="Middle" action="Press">
-        <action name="ShowMenu">
+      <action name="ShowMenu"><menu>client-list-combined-menu</menu></action>
-          <menu>client-list-combined-menu</menu>
-        </action>
     </mousebind> 
     <mousebind button="Right" action="Press">
-        <action name="ShowMenu">
+      <action name="ShowMenu"><menu>root-menu</menu></action>
-          <menu>root-menu</menu>
-        </action>
     </mousebind>
   </context>
+
   <context name="MoveResize">
     <mousebind button="Up" action="Click">
-        <action name="GoToDesktop">
+      <action name="GoToDesktop"><to>previous</to></action>
-          <to>previous</to>
-        </action>
     </mousebind>
     <mousebind button="Down" action="Click">
-        <action name="GoToDesktop">
+      <action name="GoToDesktop"><to>next</to></action>
-          <to>next</to>
-        </action>
     </mousebind>
     <mousebind button="A-Up" action="Click">
-        <action name="GoToDesktop">
+      <action name="GoToDesktop"><to>previous</to></action>
-          <to>previous</to>
-        </action>
     </mousebind>
     <mousebind button="A-Down" action="Click">
-        <action name="GoToDesktop">
+      <action name="GoToDesktop"><to>next</to></action>
-          <to>next</to>
-        </action>
     </mousebind>
   </context>
 </mouse>
+
 <menu>
   <!-- You can specify more than one menu file in here and they are all loaded,
      just don't make menu ids clash or, well, it'll be kind of pointless -->
-    <!-- default menu file (or custom one in $HOME/.config/openbox/) -->
+  <!-- Lubuntu specific : Default menu of Lubuntu -->
   <file>/usr/share/lubuntu/openbox/menu.xml</file>
+  <!-- default menu file (or custom one in $HOME/.config/openbox/) -->
   <file>menu.xml</file>
 
   <hideDelay>200</hideDelay>
@@ -848,12 +852,13 @@
      if this is a negative value, then the delay is infinite and the
      submenu will not be hidden until a different submenu is opened -->
   <applicationIcons>yes</applicationIcons>
-    <!-- controls if icons appear in the client-list-(combined-)menu -->
+  <!-- Lubuntu specific : Show applications icons if openbox is build with this support -->
   <manageDesktops>yes</manageDesktops>
   <!-- show the manage desktops section in the client-list-(combined-)menu -->
   <showIcons>yes</showIcons>
-    <!-- show icons on the menu -->
+  <!-- controls if icons appear in the client-list-(combined-)menu -->
 </menu>
+
 <applications>
 <!--
   # this is an example with comments through out. use these to make your
@@ -863,9 +868,11 @@
 
   <application name="the window's _OB_APP_NAME property (see obxprop)"
               class="the window's _OB_APP_CLASS property (see obxprop)"
+          groupname="the window's _OB_APP_GROUP_NAME property (see obxprop)"
+         groupclass="the window's _OB_APP_GROUP_CLASS property (see obxprop)"
                role="the window's _OB_APP_ROLE property (see obxprop)"
               title="the window's _OB_APP_TITLE property (see obxprop)"
-               type="the window's _OB_APP_TYPE property (see obxprop)..
+               type="the window's _OB_APP_TYPE property (see obxprob)..
                       (if unspecified, then it is 'dialog' for child windows)">
   # you may set only one of name/class/role/title/type, or you may use more
   # than one together to restrict your matches.
@@ -898,14 +905,25 @@
       # applications who refuse to behave
       <x>center</x>
       # a number like 50, or 'center' to center on screen. use a negative number
-      # to start from the right (or bottom for <y>), ie -50 is 50 pixels from the
+      # to start from the right (or bottom for <y>), ie -50 is 50 pixels from
-      # right edge (or bottom).
+      # the right edge (or bottom). use 'default' to specify using value
+      # provided by the application, or chosen by openbox, instead.
       <y>200</y>
       <monitor>1</monitor>
       # specifies the monitor in a xinerama setup.
       # 1 is the first head, or 'mouse' for wherever the mouse is
     </position>
 
+    <size>
+      # the size to make the window.
+      <width>20</width>
+      # a number like 20, or 'default' to use the size given by the application.
+      # you can use fractions such as 1/2 or percentages such as 75% in which
+      # case the value is relative to the size of the monitor that the window
+      # appears on.
+      <height>30%</height>
+    </size>
+
     <focus>yes</focus>
     # if the window should try be given focus when it appears. if this is set
     # to yes it doesn't guarantee the window will be given focus. some
@@ -936,13 +954,16 @@
 
   # end of the example
 -->
+
   <!-- Option to maximize all normal window when launched-->
   <!--
   <application type="normal">
     <maximized>true</maximized>
   </application>
   -->
-    <!--    Focus all applications launched
+  <!--    
+        Lubuntu specific :
+        Focus all applications launched
         Usefull when launching applications, like terminal from pcmanfm
   -->
   <application class="*">
@@ -950,4 +971,5 @@
   </application>
 
 </applications>
+
 </openbox_config>