[virt-tools-list] [PATCH] Update hotkeys documentation in manpage

[Jonathon Jongsma]

Describe the expected behavior of the hotkey bindings in a bit more detail.
---
 man/remote-viewer.pod | 17 +++++++++++------
 man/virt-viewer.pod   | 17 +++++++++++------
 2 files changed, 22 insertions(+), 12 deletions(-)

diff --git a/man/remote-viewer.pod b/man/remote-viewer.pod
index 079def0..3b887c8 100644
--- a/man/remote-viewer.pod
+++ b/man/remote-viewer.pod
@@ -65,17 +65,22 @@ Print debugging information
 
 =item -H HOTKEYS, --hotkeys HOTKEYS
 
-Override the default hotkey bindings with B<HOTKEYS>. Where B<HOTKEYS>
-is <action1>=<hotkey1>,<action2>=<hotkey2>... Valid
-actions are: toggle-fullscreen, release-cursor, smartcard-insert and
-smartcard-remove. Examples:
+Set global hotkey bindings. By default, keyboard shortcuts only work when the
+guest display widget does not have focus.  Any actions specified in B<HOTKEYS>
+will be effective even when the guest display widget has input focus. The format
+for B<HOTKEYS> is <action1>=<key1>[+<key2>][,<action2>=<key3>[+<key4>]].
+Key-names are case-insensitive. Valid actions are: toggle-fullscreen,
+release-cursor, secure-attention, smartcard-insert and smartcard-remove.  The
+C<secure-attention> action sends a secure attention sequence (Ctrl+Alt+Del) to
+the guest. Examples:
 
   --hotkeys=toggle-fullscreen=shift+f11,release-cursor=shift+f12
 
   --hotkeys=release-cursor=ctrl+alt
 
-Note that hotkeys for which no binding is given are disabled, specifying an
-empty string disables all hotkeys.
+Note that hotkeys for which no binding is given are disabled. Although the
+hotkeys specified here are handled by the client, it is still possible to send
+these key combinations to the guest via a menu item.
 
 =item -k, --kiosk
 
diff --git a/man/virt-viewer.pod b/man/virt-viewer.pod
index fdaa631..017a37e 100644
--- a/man/virt-viewer.pod
+++ b/man/virt-viewer.pod
@@ -74,17 +74,22 @@ Print debugging information
 
 =item -H HOTKEYS, --hotkeys HOTKEYS
 
-Override the default hotkey bindings with B<HOTKEYS>. Where B<HOTKEYS> is
-<action1>=<key1>[+<key2>][,<action2>=<key3>[+<key4>]]. Key-names are
-case-insensitive, valid actions are: toggle-fullscreen, release-cursor,
-smartcard-insert and smartcard-remove. Examples:
+Set global hotkey bindings. By default, keyboard shortcuts only work when the
+guest display widget does not have focus.  Any actions specified in B<HOTKEYS>
+will be effective even when the guest display widget has input focus. The format
+for B<HOTKEYS> is <action1>=<key1>[+<key2>][,<action2>=<key3>[+<key4>]].
+Key-names are case-insensitive. Valid actions are: toggle-fullscreen,
+release-cursor, secure-attention, smartcard-insert and smartcard-remove.  The
+C<secure-attention> action sends a secure attention sequence (Ctrl+Alt+Del) to
+the guest. Examples:
 
   --hotkeys=toggle-fullscreen=shift+f11,release-cursor=shift+f12
 
   --hotkeys=release-cursor=ctrl+alt
 
-Note that hotkeys for which no binding is given are disabled, specifying an
-empty string disables all hotkeys.
+Note that hotkeys for which no binding is given are disabled. Although the
+hotkeys specified here are handled by the client, it is still possible to send
+these key combinations to the guest via a menu item.
 
 =item -k, --kiosk
 
-- 
1.8.3.1