Merge branch 'icewm-1-4-BRANCH'

man/icesh.pod

@@ -14,8 +14,7 @@
 
 =head1 DESCRIPTION
 
-B<icesh> provides commands to directly interact with the L<icewm(1)> window
-manager.  There are two types of commands:
+B<icesh> provides two types of commands:
 
 =over
 
@@ -40,7 +39,7 @@ This can be used in scripts and in L<icewm-keys(5)>
 to define your own window management hotkeys.  For example, to
 immediately close all xterm windows do C<icesh -c xterm close>.
 
-There are about seven C<SELECT OPTIONS> to select windows.
+There are about ten C<SELECT OPTIONS> to select windows.
 They start with a minus sign '-' or with a plus sign '+'.
 The first starts a new selection. The second adds more
 windows to an existing selection.
@@ -76,46 +75,57 @@ If needed, they can be repeated for successive actions.
 
 =over
 
-=item B<-w>, B<-window>, B<+w>, B<+window> I<WINDOW_ID>
-
-Specifies the identifier of the window, I<WINDOW_ID>, for which the
-action applies.  Special identifiers are B<root> for the root window
-and B<focus> for the currently focused window.
-The option with minus sign replaces the existing selection.
-With a plus sign the window is added to an existing selection.
-
-=item B<-r>, B<-root>, B<+r>, B<+root>
+=item B<-a>, B<-all>
 
-Is equivalent to B<-window> B<root> and selects the root window.
-The option with minus sign replaces the existing selection with
-the root window. With a plus sign the root window is added to
-an existing selection.
+Selects all client windows of the window manager.
 
 =item B<-f>, B<-focus>, B<+f>, B<+focus>
 
-Is equivalent to B<-window> B<focus> and selects the focused window.
+Selects the application window which is currently focused.
 The option with minus sign replaces the existing selection with
 the focused window. With a plus sign the focused window is added to
 an existing selection.
 
-=item B<-a>, B<-all>
+=item B<+g>, B<+group>
 
-Selects all client windows of the window manager.
+Extend the current selection with client windows which
+belong to the same application window group.
+
+=item B<-r>, B<-root>, B<+r>, B<+root>
+
+Selects the root window.
+The option with minus sign replaces the existing selection with
+the root window. With a plus sign the root window is added to
+an existing selection.
 
 =item B<-s>, B<-shown>
 
-Selects all clients which are on the current workspace.
+Selects all client windows which are on the current workspace.
 
 =item B<-t>, B<-top>
 
 Selects all toplevel windows from the display unconditionally.
 This includes windows which have never been mapped and windows
 with the override redirect bit set to evade management.
 
+=item B<-w>, B<-window>, B<+w>, B<+window> I<WINDOW_ID>
+
+Specifies the identifier of the window, I<WINDOW_ID>, for which the
+action applies.  Special identifiers are B<root> for the root window
+and B<focus> for the currently focused window.
+The option with minus sign replaces the existing selection.
+With a plus sign the window is added to an existing selection.
+
 =item B<-x>, B<-xembed>
 
 Selects all windows which are embedded using the I<XEMBED> protocol.
 
+=item B<+C>, B<+Class>
+
+Extend the current selection with client windows that
+have a similar WM_CLASS property, which specifies the
+resource instance and the class name.
+
 =item B<-D>, B<-Dockapps>
 
 Selects all Dockapp applications which are managed by icewm.
@@ -375,7 +385,7 @@ taskbar.
 
 Resize window by I<WIDTH> by I<HEIGHT> pixels. If I<WIDTH> or I<HEIGHT>
 ends with a percent sign C<%>, then they refer to a percentage of the
-current window size. For instance, C<sizeto 50% 200> increases the width
+current window size. For instance, C<sizeby 50% 200> increases the width
 by 50% and increases the height by 200 pixels.
 
 =item B<move> I<X> I<Y>
@@ -563,6 +573,8 @@ Top, bottom, left, and right are indices of the I<icesh xinerama> command.
 
 Observe the selected windows and report any changes. This includes
 focus, visibility, position, size and all window properties.
+To monitor all of the protocol request messages that client applications
+may send to icewm, also spy on the root window.
 
 =back
 

man/icesound.pod

@@ -80,11 +80,11 @@ Please prefer one of the B<-A>, B<-O> or B<-S> options.
 
 =item B<-O>, B<--oss>=I<DEVICE>
 
-Specifies the OSS device (default: C<default>).
+Specifies the OSS device (default: F</dev/dsp>).
 
 =item B<-A>, B<--alsa>=I<DEVICE>
 
-Specifies the ALSA device (default: F</dev/dsp>).
+Specifies the ALSA device (default: C<default>).
 
 =item B<-z>, B<--snooze>=I<MILLISECONDS>
 

man/icewm-preferences.pod

@@ -635,7 +635,8 @@ Favour Xft fonts over core X11 fonts where possible.
 
 =item B<MailBoxPath>=""
 
-Mailbox path (use \$MAIL instead).
+A colon separated list of paths of your mailboxes.
+If this is empty, $MAILPATH or $MAIL is used instead.
 
 Path to a mbox file. Remote mail boxes are accessed by specifying an URL
 using the Common Internet Scheme Syntax (RFC 1738):
@@ -986,7 +987,8 @@ themes from selection.
 
 =item B<MailBoxPath>=""
 
-Mailbox path (use \$MAIL instead).
+A colon separated list of paths of your mailboxes.
+If this is empty, $MAILPATH or $MAIL is used instead.
 
 =back
 

man/icewm-winoptions.pod

@@ -231,9 +231,10 @@ input focus to I<Chrome> pop-ups and asks to close them immediately.
   google-chrome.pop-up.startClose: 1
   google-chrome.pop-up.startMinimized: 1
 
-IceWM doesn't support dockapps, but this can be emulated.
-A dockapp should appear on all workspaces, have no decorations,
-and be always visible in a fixed location.
+IceWM places dockapps in a container automatically, but for those
+which fail to comply with the protocol it can also be emulated.
+An emulated dockapp should appear on all workspaces, have
+no decorations, and always be visible in a fixed location.
 
   wmtime.wmtime.allWorkspaces: 1
   wmtime.wmtime.ignoreTaskBar: 1