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 <[email protected]> - 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> _______________________________________________ kde-doc-english mailing list [email protected] https://mail.kde.org/mailman/listinfo/kde-doc-english
