[khotkeys] doc/kcm: update khotkeys kcm docbook

[Burkhard Lück]

Git commit d5b63b4132e0295570ae92fb3ffe6de114f9c2da by Burkhard Lück.
Committed on 25/01/2017 at 14:02.
Pushed by lueck into branch 'master'.

update khotkeys kcm docbook

proofread + update
bump date + releaseinfo
replace obsolete Preset Actions with Spectacle
update/new screenshots

Differential Revision: https://phabricator.kde.org/D4246

A  +-    --    doc/kcm/document-open.png
M  +-    --    doc/kcm/groups-comment.png
M  +41   -9    doc/kcm/index.docbook
M  +-    --    doc/kcm/manage-export.png
M  +-    --    doc/kcm/settings.png
M  +-    --    doc/kcm/shortcuts-action-command.png
A  +-    --    doc/kcm/shortcuts-action-dbus.png
M  +-    --    doc/kcm/shortcuts-action-keyboard.png
M  +-    --    doc/kcm/shortcuts-trigger-keyboard.png
M  +-    --    doc/kcm/shortcuts-trigger-mouse.png

https://commits.kde.org/khotkeys/d5b63b4132e0295570ae92fb3ffe6de114f9c2da

diff --git a/doc/kcm/document-open.png b/doc/kcm/document-open.png
new file mode 100644
index 0000000..9a0ed18
Binary files /dev/null and b/doc/kcm/document-open.png differ
diff --git a/doc/kcm/groups-comment.png b/doc/kcm/groups-comment.png
index a2c0d37..f90317e 100644
Binary files a/doc/kcm/groups-comment.png and b/doc/kcm/groups-comment.png differ
diff --git a/doc/kcm/index.docbook b/doc/kcm/index.docbook
index cfebe02..e7e9387 100644
--- a/doc/kcm/index.docbook
+++ b/doc/kcm/index.docbook
@@ -24,8 +24,8 @@
 </copyright>
 <legalnotice>&FDLNotice;</legalnotice>
 
-<date>2015-04-08</date>
-<releaseinfo>Plasma 5.3</releaseinfo>
+<date>2017-01-22</date>
+<releaseinfo>Plasma 5.8</releaseinfo>
 
 <keywordset>
 <keyword>KDE</keyword>
@@ -178,7 +178,8 @@ imported file.  When disabled, the module will refuse to import the file.
 <varlistentry id="manage-filename">
 <term><guilabel>Filename</guilabel></term>
 <listitem><para>Here you may enter the filename you wish to export the
-shortcut to.  You may also select the <guibutton>Browse</guibutton> button to
+shortcut to.  You may also select the <inlinemediaobject><imageobject><imagedata
+fileref="document-open.png" format="PNG"/></imageobject></inlinemediaobject> button to
 the right of the text box to open the File dialog and select a file from there.
 </para>
 
@@ -271,8 +272,12 @@ more information, see <xref linkend="windows"/>.</para>
 into groups. These groups can be expanded by clicking the arrow beside them to
 reveal the shortcuts.</para>
 
-<para>The <guilabel>Preset Actions</guilabel> group, when expanded, reveals a
-shortcut configuration named <guilabel>PrintScreen</guilabel> which, when
+<para>By default the groups <guilabel>KMenuEdit</guilabel>, <guilabel>Konqueror
+Gestures</guilabel> and <guilabel>Examples</guilabel> are installed.
+Applications can provide additional shortcuts, ⪚ &spectacle; adds a group
+<guilabel>Screenshots</guilabel>.
+This group, when expanded, reveals several shortcut configurations like
+<guilabel>Start Screenshot Tool</guilabel> which, when
 selected, reveals section on the right side, with three tabs:</para>
 
 <sect2 id="shortcuts-comment">
@@ -291,7 +296,7 @@ which depends on the type of trigger specified:</para>
 <variablelist>
 
 <varlistentry id="shortcuts-trigger-keyboard">
-<term>Global (Keyboard) Shortcut</term>
+<term>Global Shortcut</term>
 <listitem>
 
 <para>To modify a keyboard shortcut, click on the button that contains a wrench,
@@ -416,6 +421,15 @@ local or a remote system.</para>
 <term>&DBus; Command</term>
 <listitem>
 
+<screenshot id="screenshot-shortcuts-action-dbus">
+<screeninfo>Modifying a &DBus; Action</screeninfo>
+<mediaobject>
+<imageobject><imagedata fileref="shortcuts-action-dbus.png" format="PNG"/></imageobject>
+<textobject><phrase>The Action tab for a &DBus; command.</phrase></textobject>
+<caption><para>Modifying a &DBus; action.</para></caption>
+</mediaobject>
+</screenshot>
+
 <para>The following options are provided that allow you to specify a &DBus;
 method to be performed:</para>
 
@@ -424,23 +438,41 @@ method to be performed:</para>
 <varlistentry id="shortcuts-action-dbus-application">
 <term><guilabel>Remote application</guilabel></term>
 <listitem><para>The service name of the remote application the method is to
-be performed on, for instance <userinput>org.kde.kate</userinput> if you wanted
-to perform it on the &kate; Advanced Text Editor.</para></listitem>
+be performed on, for instance <userinput>org.kde.spectacle</userinput> if you wanted
+to perform it on the &spectacle; screenshots utility.</para></listitem>
 </varlistentry>
 
 <varlistentry id="shortcuts-action-dbus-object">
 <term><guilabel>Remote object</guilabel></term>
 <listitem><para>The path to the remote object the method is to be performed on,
-for instance <userinput>/Document/1</userinput>, if you wanted to perform it on
+for instance <userinput>/</userinput> for screenshot actions using &spectacle;
+or <userinput>/Document/1</userinput>, if you wanted to perform it on
 the first document opened in &kate;.</para></listitem>
 </varlistentry>
 
 <varlistentry id="shortcuts-action-dbus-function">
 <term><guilabel>Function</guilabel></term>
 <listitem><para>The name of the &DBus; method to be called, for instance
+<userinput>Fullscreen</userinput> if you wanted to take a fullscreen screenshot or
 <userinput>print</userinput> if you wanted to print the document.</para></listitem>
 </varlistentry>
 
+<varlistentry id="shortcuts-action-dbus-arguments">
+<term><guilabel>Arguments</guilabel></term>
+<listitem><para>Enter additional arguments for the &DBus; method to be called.</para></listitem>
+</varlistentry>
+
+<varlistentry id="shortcuts-action-dbus-call">
+<term><guilabel>Call</guilabel></term>
+<listitem><para>Use this button to verify that the action works as expected.</para></listitem>
+</varlistentry>
+
+<varlistentry id="shortcuts-action-dbus-launch-dbus-browser">
+<term><guilabel>Launch D-Bus Browser</guilabel></term>
+<listitem><para>Launch the application <application>QDBusViewer</application>
+so browse the &DBus; methods and arguments for a running application.</para></listitem>
+</varlistentry>
+
 </variablelist>
 
 <para>For more information on &DBus;, see the
diff --git a/doc/kcm/manage-export.png b/doc/kcm/manage-export.png
index 6d9d6d4..dac8a90 100644
Binary files a/doc/kcm/manage-export.png and b/doc/kcm/manage-export.png differ
diff --git a/doc/kcm/settings.png b/doc/kcm/settings.png
index f8c46d3..aae5cf0 100644
Binary files a/doc/kcm/settings.png and b/doc/kcm/settings.png differ
diff --git a/doc/kcm/shortcuts-action-command.png b/doc/kcm/shortcuts-action-command.png
index b854806..a8cef98 100644
Binary files a/doc/kcm/shortcuts-action-command.png and b/doc/kcm/shortcuts-action-command.png differ
diff --git a/doc/kcm/shortcuts-action-dbus.png b/doc/kcm/shortcuts-action-dbus.png
new file mode 100644
index 0000000..f5201fa
Binary files /dev/null and b/doc/kcm/shortcuts-action-dbus.png differ
diff --git a/doc/kcm/shortcuts-action-keyboard.png b/doc/kcm/shortcuts-action-keyboard.png
index a35f73e..214414a 100644
Binary files a/doc/kcm/shortcuts-action-keyboard.png and b/doc/kcm/shortcuts-action-keyboard.png differ
diff --git a/doc/kcm/shortcuts-trigger-keyboard.png b/doc/kcm/shortcuts-trigger-keyboard.png
index b21116f..c6734a8 100644
Binary files a/doc/kcm/shortcuts-trigger-keyboard.png and b/doc/kcm/shortcuts-trigger-keyboard.png differ
diff --git a/doc/kcm/shortcuts-trigger-mouse.png b/doc/kcm/shortcuts-trigger-mouse.png
index d57ffb5..42c2bbc 100644
Binary files a/doc/kcm/shortcuts-trigger-mouse.png and b/doc/kcm/shortcuts-trigger-mouse.png differ