[kde-doc-english] [plasma-desktop] doc/kcontrol/mouse: Update mouse kcm docbook to 5.6
Burkhard Lück
lueck at hube-lueck.de
Wed Jun 8 03:35:54 UTC 2016
Git commit ceefda516985ed3c455ddab086bd3b3b937445d3 by Burkhard Lück.
Committed on 08/06/2016 at 03:35.
Pushed by lueck into branch 'master'.
Update mouse kcm docbook to 5.6
bump date + releaseinfo
single / double click setting was removed from dolphin / konqueror
remove Change Pointer + Automatically select icons settings, no longer in the code
change kde -> plasma
remove logitech info, support was removed with a029fb591ae6ddba5e23c5d5874afa7f2935fbd9
REVIEW:128070
M +8 -217 doc/kcontrol/mouse/index.docbook
http://commits.kde.org/plasma-desktop/ceefda516985ed3c455ddab086bd3b3b937445d3
diff --git a/doc/kcontrol/mouse/index.docbook b/doc/kcontrol/mouse/index.docbook
index b09f8e7..663883a 100644
--- a/doc/kcontrol/mouse/index.docbook
+++ b/doc/kcontrol/mouse/index.docbook
@@ -14,11 +14,11 @@
<!-- TRANS:ROLES_OF_TRANSLATORS -->
</authorgroup>
-<date>2015-04-09</date>
-<releaseinfo>Plasma 5.3</releaseinfo>
+<date>2016-06-01</date>
+<releaseinfo>Plasma 5.6</releaseinfo>
<abstract>
-<para>This is the documentation for the &kde; &systemsettings; module that configures mice and other pointing devices.
+<para>This is the documentation for the &systemsettings; module that configures mice and other pointing devices.
</para>
</abstract>
@@ -40,8 +40,6 @@ of hardware that performs a similar function.</para>
<link linkend="mouse-general">General</link>,
<link linkend="mouse-advanced">Advanced</link> and
<link linkend="mouse-navigation">Mouse Navigation</link>.
-There may also be one or more additional tabs if you have a Logitech mouse
-or trackball, providing access to special features.
</para>
<sect2 id="mouse-general">
@@ -80,46 +78,18 @@ links in most web browsers. If checked however, icons/files will be
opened with a double click, while a single click will only select the
icon or file. This is the behavior you may know from other desktops or
operating systems.</para>
-<note>
-<para>This option can be changed in the configuration dialogs of &dolphin; and &konqueror;
-on the <guilabel>Navigation</guilabel> tab as well.</para>
-</note>
</listitem>
</varlistentry>
<varlistentry>
<term><guilabel>Single-click to open files and folders</guilabel></term>
<listitem>
-<para>This is the default setting for &kde;. Clicking once on an icon
+<para>This is the default setting. Clicking once on an icon
will open it. To select you can drag around the icon(s) or <keycombo
action="simul">&Ctrl;<mousebutton>Right</mousebutton></keycombo> click,
or simply click and hold to drag it. You can also enable automatic selection of icons using the <guilabel>Automatically select icons</guilabel> check box, discussed below.</para>
</listitem>
</varlistentry>
-
-<varlistentry>
-<term><guilabel>Change pointer shape over icons</guilabel></term>
-<listitem>
-<para>When this option is checked, the shape of the mouse pointer
-changes whenever it is over an icon.</para>
-
-<tip><para>This option should be checked in most situations. It gives
-more visual feedback and says, in essence, if you click here, something
-will happen.</para></tip>
-
-</listitem>
-</varlistentry>
-
-<varlistentry>
-<term><guilabel>Automatically select icons</guilabel></term>
-<listitem>
-<para>
-As noted above, if you have <guilabel>Single-click to open files and folders</guilabel> selected, you can select icons by dragging around them, or by using <keycombo
-action="simul">&Ctrl;<mousebutton>Right</mousebutton></keycombo> click. If you routinely need to select icons, you may want to enable this check box, which will allow icons to be selected automatically by pausing over the icon. The <guilabel>Delay:</guilabel> slider determines how long is required before the automatic selection takes effect.
-</para>
-</listitem>
-</varlistentry>
-
</variablelist>
</sect2>
@@ -177,11 +147,11 @@ better for 3x.</para></tip>
<varlistentry>
<term><guilabel>Double click interval</guilabel></term>
<listitem>
-<para>This is the maximum amount of time between clicks for &kde; to
+<para>This is the maximum amount of time between clicks to
register a double click. If you click twice, and the time between those
-two clicks is less than this number, &kde; recognizes that as a double
+two clicks is less than this number, that is recognized as a double
click. If the time between these two clicks is greater than this
-number, &kde; recognizes those as two <emphasis>separate</emphasis>
+number, it is recognized as two <emphasis>separate</emphasis>
single clicks.</para>
</listitem>
</varlistentry>
@@ -201,7 +171,7 @@ pixels) specified in <guilabel>Drag start distance</guilabel></para>
</listitem>
</itemizedlist>
-&kde; will drag the selected item.</para>
+the selected item will be dragged.</para>
</listitem>
</varlistentry>
@@ -288,185 +258,6 @@ This is the slope of the acceleration curve for mouse key acceleration.
</sect2>
-<sect2 id="logitech-mouse">
-<title>Logitech Support</title>
-
-<para>
-Some Logitech USB mice support special features, such as switching to a higher resolution, or
-providing cordless status. If &kde; was built with libusb support, then you will get an additional
-tab for each supported mouse that is plugged in.
-</para>
-
-<para>
-The supported devices are:
-</para>
-<orderedlist>
-<listitem><para>Wheel Mouse Optical</para></listitem>
-<listitem><para>MouseMan Traveler</para></listitem>
-<listitem><para>MouseMan Dual Optical</para></listitem>
-<listitem><para>MX310 Optical Mouse</para></listitem>
-<listitem><para>MX510 Optical Mouse</para></listitem>
-<listitem><para>MX300 Optical Mouse</para></listitem>
-<listitem><para>MX500 Optical Mouse</para></listitem>
-<listitem><para>iFeel Mouse</para></listitem>
-<listitem><para>Mouse Receiver</para></listitem>
-<listitem><para>Dual Receiver</para></listitem>
-<listitem><para>Cordless Freedom Optical</para></listitem>
-<listitem><para>Cordless Elite Duo</para></listitem>
-<listitem><para>MX700 Optical Mouse</para></listitem>
-<listitem><para>Cordless Optical Trackman</para></listitem>
-<listitem><para>Cordless MX Duo Receiver</para></listitem>
-<listitem><para>MX100 Laser Mouse</para></listitem>
-<listitem><para>Receiver for Cordless Presenter</para></listitem>
-</orderedlist>
-
-<para>
-Not all devices support all capabilities (typically cordless devices do not
-provide resolution switching, and of course only cordless devices support
-cordless status reporting), so some parts of the tab will not be enabled for
-some mouse types.
-</para>
-
-<para>
-If the mouse supports resolution switching, the <guilabel>Sensor Resolution</guilabel>
-radio button group will be enabled, and you can switch from <guilabel>400 counts per
-inch</guilabel> to <guilabel>800 counts per inch</guilabel> and back. If you use
-<guilabel>800 counts per inch</guilabel>, the same physical movement of the mouse
-will cause a greater (roughly double) amount of motion of the cursor. This tends
-to be popular amongst gamers.
-</para>
-
-<para>
-If the mouse supports cordless reporting, the <guilabel>Battery Level</guilabel>
-and <guilabel>RF Channel</guilabel> widgets will be enabled. You can only change
-the <guilabel>RF Channel</guilabel> if your mouse has two channel support.
-</para>
-<!--FIXME outdated
-<sect3 id="logitech-perms">
-<title>Fixing permission problems on Logitech mice</title>
-
-<para>
-Because of the way USB devices work, the code that accesses the current
-status on Logitech mice needs to be able to write to the mouse. This
-should be handled by your distribution, but if not, you may need to do some
-configuration yourself.
-</para>
-
-<para>
-On a &Linux; system, you should use the hotplug system to change the ownership
-and permissions on the mouse entry in <filename>/proc/bus/usb</filename>. One
-way to do this is to create a short script
-(<filename>/etc/hotplug/usb/consoleUserPerms</filename>) that changes the ownership
-and permissions, as shown below:
-</para>
-
-<informalexample>
-<programlisting>
-<![CDATA[
-#!/bin/bash
-#
-# /etc/hotplug/usb/consoleUserPerms
-#
-# Sets up newly plugged in USB device so that the user who owns
-# the console according to pam_console can access it from user space
-#
-# Note that for this script to work, you'll need all of the following:
-# a) a line in the file /etc/hotplug/usb.usermap or another usermap file
-# in /etc/hotplug/usb/ that corresponds to the device you are using.
-# b) a setup using pam_console creates the respective lock files
-# containing the name of the respective user. You can check for that
-# by executing "echo `cat /var/{run,lock}/console.lock`" and
-# verifying the appropriate user is mentioned somewhere there.
-# c) a Linux kernel supporting hotplug and usbdevfs
-# d) the hotplug package (http://linux-hotplug.sourceforge.net/)
-#
-# In the usermap file, the first field "usb module" should be named
-# "consoleUserPerms" to invoke this script.
-#
-
-if [ "${ACTION}" = "add" ] && [ -f "${DEVICE}" ]
-then
-# New code, using lock files instead of copying /dev/console permissions
-# This also works with non-kdm logins (e.g. on a virtual terminal)
-# Idea and code from Nalin Dahyabhai <nalin at redhat.com>
- if [ -f /var/run/console.lock ]
- then
- CONSOLEOWNER=`cat /var/run/console.lock`
- elif [ -f /var/lock/console.lock ]
- then
- CONSOLEOWNER=`cat /var/lock/console.lock`
- else
- CONSOLEOWNER=
- fi
- if [ -n "$CONSOLEOWNER" ]
- then
- chmod 0000 "${DEVICE}"
- chown "$CONSOLEOWNER" "${DEVICE}"
- chmod 0600 "${DEVICE}"
- fi
-fi
-]]>
-</programlisting>
-</informalexample>
-
-<para>
-The usermap file that goes with this is
-<filename>/etc/hotplug/usb/logitechmouse.usermap</filename>, as
-shown below:
-</para>
-
-<informalexample>
-<programlisting>
-<![CDATA[
-# script match_flags idVendor idProduct bcdDevice_lo bcdDevice_hi bDeviceClass bDeviceSubClass bDeviceProtocol bInterfaceClass bInterfaceSubClass bInterfaceProtocol driver_info
-# Wheel Mouse Optical
-consoleUserPerms 0x0003 0x046d 0xc00e 0x0000 0xffff 0x00 0x00 0x00 0x00 0x00 0x00 0x00000000
-# MouseMan Traveler
-consoleUserPerms 0x0003 0x046d 0xc00f 0x0000 0xffff 0x00 0x00 0x00 0x00 0x00 0x00 0x00000000
-# MouseMan Dual Optical
-consoleUserPerms 0x0003 0x046d 0xc012 0x0000 0xffff 0x00 0x00 0x00 0x00 0x00 0x00 0x00000000
-# MX310 Optical Mouse
-consoleUserPerms 0x0003 0x046d 0xc01b 0x0000 0xffff 0x00 0x00 0x00 0x00 0x00 0x00 0x00000000
-# MX510 Optical Mouse
-consoleUserPerms 0x0003 0x046d 0xc01d 0x0000 0xffff 0x00 0x00 0x00 0x00 0x00 0x00 0x00000000
-# MX300 Optical Mouse
-consoleUserPerms 0x0003 0x046d 0xc024 0x0000 0xffff 0x00 0x00 0x00 0x00 0x00 0x00 0x00000000
-# MX500 Optical Mouse
-consoleUserPerms 0x0003 0x046d 0xc025 0x0000 0xffff 0x00 0x00 0x00 0x00 0x00 0x00 0x00000000
-# iFeel Mouse
-consoleUserPerms 0x0003 0x046d 0xc031 0x0000 0xffff 0x00 0x00 0x00 0x00 0x00 0x00 0x00000000
-# Mouse Receiver
-consoleUserPerms 0x0003 0x046d 0xc501 0x0000 0xffff 0x00 0x00 0x00 0x00 0x00 0x00 0x00000000
-# Dual Receiver
-consoleUserPerms 0x0003 0x046d 0xc502 0x0000 0xffff 0x00 0x00 0x00 0x00 0x00 0x00 0x00000000
-# Cordless Freedom Optical
-consoleUserPerms 0x0003 0x046d 0xc504 0x0000 0xffff 0x00 0x00 0x00 0x00 0x00 0x00 0x00000000
-# Cordless Elite Duo
-consoleUserPerms 0x0003 0x046d 0xc505 0x0000 0xffff 0x00 0x00 0x00 0x00 0x00 0x00 0x00000000
-# MX700 Optical Mouse
-consoleUserPerms 0x0003 0x046d 0xc506 0x0000 0xffff 0x00 0x00 0x00 0x00 0x00 0x00 0x00000000
-# Cordless Optical Trackman
-consoleUserPerms 0x0003 0x046d 0xc508 0x0000 0xffff 0x00 0x00 0x00 0x00 0x00 0x00 0x00000000
-# Cordless MX Duo Receiver
-consoleUserPerms 0x0003 0x046d 0xc50b 0x0000 0xffff 0x00 0x00 0x00 0x00 0x00 0x00 0x00000000
-# MX100 Laser Mouse
-consoleUserPerms 0x0003 0x046d 0xc50e 0x0000 0xffff 0x00 0x00 0x00 0x00 0x00 0x00 0x00000000
-# Receiver for Cordless Presenter
-consoleUserPerms 0x0003 0x046d 0xc702 0x0000 0xffff 0x00 0x00 0x00 0x00 0x00 0x00 0x00000000
-]]>
-</programlisting>
-</informalexample>
-
-<para>
-That should be all that is needed on &Linux; - just copy the files into
-<filename>/etc/hotplug/usb/</filename>, and when the mouse is
-plugged in, the ownership and permissions should be changed
-so that the user at the console can access the mouse.
-</para>
-</sect3>
--->
-</sect2>
-
</sect1>
</article>
More information about the kde-doc-english
mailing list