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