1 files changed, 78 insertions, 22 deletions
diff --git a/upstream/mageia-cauldron/man1/icewm.1 b/upstream/mageia-cauldron/man1/icewm.1
index 5d04293e..1f3926eb 100644
--- a/upstream/mageia-cauldron/man1/icewm.1
+++ b/upstream/mageia-cauldron/man1/icewm.1
@@ -55,7 +55,7 @@
 .\" ========================================================================
 .\"
 .IX Title "ICEWM 1"
-.TH ICEWM 1 2023-12-28 "icewm 3.4.5" "User Commands"
+.TH ICEWM 1 2024-05-20 "icewm 3.5.0" "User Commands"
 .\" For nroff, turn off justification.  Always turn off hyphenation; it makes
 .\" way too many mistakes in technical documents.
 .if n .ad l
@@ -210,6 +210,10 @@ it to search for configuration files.
 .IX Item "-l, --list-themes"
 \&\fBicewm\fR will search all the configuration directories for theme files
 and print a list of all found themes.
+.IP "\fB\-i\fR, \fB\-\-install\fR=\fITHEME\fR" 4
+.IX Item "-i, --install=THEME"
+Install \fITHEME\fR from icewm-extra and exit. When \fITHEME\fR is \fIlist\fR,
+print a listing of available themes to install.
 .IP "\fB\-p\fR, \fB\-\-postpreferences\fR" 4
 .IX Item "-p, --postpreferences"
 This gives a long list of all the internal \fBicewm\fR options with their
@@ -507,19 +511,72 @@ When edge switching is enabled, the current workspace can
 also be changed by bringing the drag icon to the screen edge.
 .SS "ADDRESS BAR"
 .IX Subsection "ADDRESS BAR"
-If \fBEnableAddressBar\fR=1 then \fBKeySysAddressBar\fR=\f(CW\*(C`Alt+Ctrl+Space\*(C'\fR
-activates the address bar in the task bar.
-If \fBShowAddressBar\fR=1 it is always shown. This is a command-line in
-the task bar where a shell command can be typed.
-Pressing \f(CW\*(C`Enter\*(C'\fR will execute the command.
-\&\fBAddressBarCommand\fR=\f(CW\*(C`/bin/sh\*(C'\fR will be used to execute the command.
-On \f(CW\*(C`Control+Enter\*(C'\fR the command is executed in a terminal
+The task bar contains a command-line prompt called the address bar,
+if \fBEnableAddressBar\fR=1. It is always shown when \fBShowAddressBar\fR=1,
+otherwise it is activated by \fBKeySysAddressBar\fR=\f(CW\*(C`Alt+Ctrl+Space\*(C'\fR.
+In it a shell command can be typed, which is executed by the
+\&\fBAddressBarCommand\fR=\f(CW\*(C`/bin/sh\*(C'\fR when pressing \f(CW\*(C`Enter\*(C'\fR.
+On \f(CW\*(C`Control+Enter\*(C'\fR this command is executed in a new terminal
 as given by \fBTerminalCommand\fR.
-The address bar maintains a history that is navigable by the \fIUp\fR
-and \fIDown\fR keys.
-It supports command completion using \f(CW\*(C`Tab\*(C'\fR or \f(CW\*(C`Ctrl+I\*(C'\fR.
-A rich set of editing operations is supported,
-including cut\-/copy\-/paste\-operations.
+.PP
+Commands are executed relative to the working directory of icewm.
+This can be shown by executing \f(CW\*(C`pwd\*(C'\fR. It can be changed using the \f(CW\*(C`cd\*(C'\fR
+command. Without argument it defaults to the home directory. With one
+argument it is changed. This argument is expanded when it starts with a
+dollar or tilde. When it is equal to \f(CW\*(C`\-\*(C'\fR, it reverts to the previous
+directory.
+.PP
+The address bar has a history that is navigable by \fIUp\fR and \fIDown\fR.
+It supports file completion using \f(CW\*(C`Tab\*(C'\fR or \f(CW\*(C`Ctrl+I\*(C'\fR, cut/copy/paste
+and these editing operations:
+.IP "Ctrl+a: select all" 4
+.IX Item "Ctrl+a: select all"
+.PD 0
+.IP "Ctrl+backslash: deselect all" 4
+.IX Item "Ctrl+backslash: deselect all"
+.IP "Ctrl+u: delete selected or to line start" 4
+.IX Item "Ctrl+u: delete selected or to line start"
+.IP "Ctrl+v: paste selected" 4
+.IX Item "Ctrl+v: paste selected"
+.IP "Ctrl+w: delete selected or previous word" 4
+.IX Item "Ctrl+w: delete selected or previous word"
+.IP "Ctrl+x: cut selection" 4
+.IX Item "Ctrl+x: cut selection"
+.IP "Ctrl+c: copy selection" 4
+.IX Item "Ctrl+c: copy selection"
+.IP "Ctrl+i: completion" 4
+.IX Item "Ctrl+i: completion"
+.IP "Ctrl+Left: back a word" 4
+.IX Item "Ctrl+Left: back a word"
+.IP "Ctrl+Right: forward a word" 4
+.IX Item "Ctrl+Right: forward a word"
+.IP "Ctrl+Shift+Backspace: delete to beginning" 4
+.IX Item "Ctrl+Shift+Backspace: delete to beginning"
+.IP "Ctrl+Shift+Delete: delete to end" 4
+.IX Item "Ctrl+Shift+Delete: delete to end"
+.IP "Ctrl+Delete: delete word" 4
+.IX Item "Ctrl+Delete: delete word"
+.IP "Ctrl+Backspace: delete previous word" 4
+.IX Item "Ctrl+Backspace: delete previous word"
+.IP "Shift+Delete: cut selection" 4
+.IX Item "Shift+Delete: cut selection"
+.IP "Shift+Insert: paste selected" 4
+.IX Item "Shift+Insert: paste selected"
+.IP "Tab: completion" 4
+.IX Item "Tab: completion"
+.IP "Left: move cursor left" 4
+.IX Item "Left: move cursor left"
+.IP "Right: move cursor right" 4
+.IX Item "Right: move cursor right"
+.IP "Home: move cursor to line start" 4
+.IX Item "Home: move cursor to line start"
+.IP "End: move cursor to line end" 4
+.IX Item "End: move cursor to line end"
+.IP "Delete: delete next character" 4
+.IX Item "Delete: delete next character"
+.IP "Backspace: delete previous character" 4
+.IX Item "Backspace: delete previous character"
+.PD
 .SS "WINDOW LIST"
 .IX Subsection "WINDOW LIST"
 The window list window shows a list of all workspaces. For each
@@ -639,7 +696,7 @@ the option \fBKeyboardLayouts\fR to a comma-separated list of your
 preferred keyboard layouts. For example:
 .PP
 .Vb 1
-\& KeyboardLayouts="de","fr","jp"
+\&  KeyboardLayouts = "de", "fr", "jp"
 .Ve
 .PP
 A keyboard layout can simply be a name. Usually this is a two-letter
@@ -1300,14 +1357,13 @@ two are the \fIx\-hotspot\fR and the \fIy\-hotspot\fR. These define which point
 in the XPM image is the sensitive point for the mouse pointer.
 .IP \fIicons\fR 4
 .IX Item "icons"
-Contains icons that are used to identify applications.  Usually these
-files are in the XPM format, but the PNG and SVG image formats are also
-supported.  The names of icon files may follow a specific naming
-pattern, like \fIapp_32x32.xpm\fR.  They start with a base name, usually
-this is just a single word.  Then follows an underscore, followed by a
-size specification in the format \f(CW\*(C`SIZExSIZE\*(C'\fR.  This is followed by a
-dot and the file extension, where the extension denotes the icon image
-format.  Common sizes are 16, 32 and 48 for small, large and huge icons.
+Contains icons for applications and keyboard layouts. These can be in
+XPM, PNG or SVG format.  The filename of an \fIapplication icon\fR may
+follow a specific naming pattern, like \fIapp_32x32.xpm\fR.  They start
+with a base name, which usually is just a single word.  Then follows
+an underscore, followed by a size specification, as in \f(CW\*(C`SIZExSIZE\*(C'\fR.
+This is followed by a dot and the file extension, where the extension
+denotes the icon image format.  Common sizes are 16, 32 and 48.
 This depends on the respective \f(CW\*(C`IconSize\*(C'\fR preferences options.
 .IP \fIledclock\fR 4
 .IX Item "ledclock"