mousetweaks r4 - in trunk: . help help/C help/C/figures
- From: frfumanti svn gnome org
- To: svn-commits-list gnome org
- Subject: mousetweaks r4 - in trunk: . help help/C help/C/figures
- Date: Sun, 13 Jan 2008 16:03:11 +0000 (GMT)
Author: frfumanti
Date: Sun Jan 13 16:03:11 2008
New Revision: 4
URL: http://svn.gnome.org/viewvc/mousetweaks?rev=4&view=rev
Log:
2008-01-13 Francesco Fumanti <frfumanti svn gnome org>
* modify /trunk/help/ChangeLog
* modify /trunk/COPYING.FDL
* modify /trunk/help/C/legal.xml
* modify /trunk/help/C/mousetweaks.xml
* add /trunk/help/C/figures/mouse-a11y-add-applet-to-panel-window.png
* add /trunk/help/C/figures/mouse-a11y-ssc-delay-slider.png
* add /trunk/help/C/figures/mouse-a11y-pointer-capture-context-menu.png
* add /trunk/help/C/figures/mouse-a11y-tab.png
* add /trunk/help/C/figures/mouse-a11y-dwell-gesture-mapping.png
* add /trunk/help/C/figures/mouse-a11y-ssc-checkbox.png
* add /trunk/help/C/figures/mouse-a11y-dwell-click-type-window.png
* add /trunk/help/C/figures/mouse-a11y-pointer-capture-preferences.png
* add /trunk/help/C/figures/mouse-a11y-pointer-capture-locked.png
* add /trunk/help/C/figures/mouse-a11y-dwell-mode-choice.png
* add /trunk/help/C/figures/mouse-a11y-dwell-delay-slider.png
* add /trunk/help/C/figures/mouse-a11y-dwell-ctw-checkbox.png
* add /trunk/help/C/figures/mouse-a11y-dwell-checkbox.png
* add /trunk/help/C/figures/mouse-a11y-dwell-click-type-applet.png
* add /trunk/help/C/figures/mouse-a11y-dwell-motion-treshold.png
* delete /trunk/help/C/figures/mt-dwell-click-checkbox.png
* delete /trunk/help/C/figures/mt-dwell-click-click-type-applet.png
* delete /trunk/help/C/figures/mt-pointer-capture-locked.png
* delete /trunk/help/C/figures/mt-dwell-click-pause-time-slider.png
* delete /trunk/help/C/figures/mt-dwell-click-trigger-choice.png
* delete /trunk/help/C/figures/mt-dwell-click-ignore-movement-slider.png
* delete /trunk/help/C/figures/mt-control-panel-delay-click-enabled.png
* delete /trunk/help/C/figures/mt-pointer-capture-preferences-window.png
* delete /trunk/help/C/figures/mt-control-panel-dwell-click-enabled.png
* delete /trunk/help/C/figures/mt-add-applet-to-panel-window.png
* delete /trunk/help/C/figures/mt-dwell-click-gesture-mapping.png
* delete /trunk/help/C/figures/mt-dwell-click-click-type-window.png
* delete /trunk/help/C/figures/mt-pointer-capture-context-menu.png
* delete /trunk/help/C/figures/mt-delay-click-checkbox.png
* delete /trunk/help/C/figures/mt-delay-click-pause-time-slider.png
Update of the manual and related files to reflect the changes
performed on mousetweaks to integrate it into GNOME 2.22.
Change manual license from GFDL 1.1 to GFDL 1.2.
Added:
trunk/help/C/figures/mouse-a11y-add-applet-to-panel-window.png
- copied unchanged from r3, /trunk/help/C/figures/mt-add-applet-to-panel-window.png
trunk/help/C/figures/mouse-a11y-dwell-checkbox.png (contents, props changed)
trunk/help/C/figures/mouse-a11y-dwell-click-type-applet.png (contents, props changed)
trunk/help/C/figures/mouse-a11y-dwell-click-type-window.png (contents, props changed)
trunk/help/C/figures/mouse-a11y-dwell-ctw-checkbox.png (contents, props changed)
trunk/help/C/figures/mouse-a11y-dwell-delay-slider.png (contents, props changed)
trunk/help/C/figures/mouse-a11y-dwell-gesture-mapping.png (contents, props changed)
trunk/help/C/figures/mouse-a11y-dwell-mode-choice.png (contents, props changed)
trunk/help/C/figures/mouse-a11y-dwell-motion-treshold.png (contents, props changed)
trunk/help/C/figures/mouse-a11y-pointer-capture-context-menu.png (contents, props changed)
trunk/help/C/figures/mouse-a11y-pointer-capture-locked.png (contents, props changed)
trunk/help/C/figures/mouse-a11y-pointer-capture-preferences.png (contents, props changed)
trunk/help/C/figures/mouse-a11y-ssc-checkbox.png (contents, props changed)
trunk/help/C/figures/mouse-a11y-ssc-delay-slider.png (contents, props changed)
trunk/help/C/figures/mouse-a11y-tab.png (contents, props changed)
Removed:
trunk/help/C/figures/mt-add-applet-to-panel-window.png
trunk/help/C/figures/mt-control-panel-delay-click-enabled.png
trunk/help/C/figures/mt-control-panel-dwell-click-enabled.png
trunk/help/C/figures/mt-delay-click-checkbox.png
trunk/help/C/figures/mt-delay-click-pause-time-slider.png
trunk/help/C/figures/mt-dwell-click-checkbox.png
trunk/help/C/figures/mt-dwell-click-click-type-applet.png
trunk/help/C/figures/mt-dwell-click-click-type-window.png
trunk/help/C/figures/mt-dwell-click-gesture-mapping.png
trunk/help/C/figures/mt-dwell-click-ignore-movement-slider.png
trunk/help/C/figures/mt-dwell-click-pause-time-slider.png
trunk/help/C/figures/mt-dwell-click-trigger-choice.png
trunk/help/C/figures/mt-pointer-capture-context-menu.png
trunk/help/C/figures/mt-pointer-capture-locked.png
trunk/help/C/figures/mt-pointer-capture-preferences-window.png
Modified:
trunk/ (props changed)
trunk/COPYING.FDL
trunk/MAINTAINERS
trunk/help/C/legal.xml
trunk/help/C/mousetweaks.xml
trunk/help/ChangeLog
Modified: trunk/COPYING.FDL
==============================================================================
--- trunk/COPYING.FDL (original)
+++ trunk/COPYING.FDL Sun Jan 13 16:03:11 2008
@@ -1,7 +1,8 @@
GNU Free Documentation License
- Version 1.1, March 2000
+ Version 1.2, November 2002
- Copyright (C) 2000 Free Software Foundation, Inc.
+
+ Copyright (C) 2000,2001,2002 Free Software Foundation, Inc.
51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
Everyone is permitted to copy and distribute verbatim copies
of this license document, but changing it is not allowed.
@@ -10,12 +11,12 @@
0. PREAMBLE
The purpose of this License is to make a manual, textbook, or other
-written document "free" in the sense of freedom: to assure everyone
-the effective freedom to copy and redistribute it, with or without
-modifying it, either commercially or noncommercially. Secondarily,
-this License preserves for the author and publisher a way to get
-credit for their work, while not being considered responsible for
-modifications made by others.
+functional and useful document "free" in the sense of freedom: to
+assure everyone the effective freedom to copy and redistribute it,
+with or without modifying it, either commercially or noncommercially.
+Secondarily, this License preserves for the author and publisher a way
+to get credit for their work, while not being considered responsible
+for modifications made by others.
This License is a kind of "copyleft", which means that derivative
works of the document must themselves be free in the same sense. It
@@ -33,11 +34,15 @@
1. APPLICABILITY AND DEFINITIONS
-This License applies to any manual or other work that contains a
-notice placed by the copyright holder saying it can be distributed
-under the terms of this License. The "Document", below, refers to any
-such manual or work. Any member of the public is a licensee, and is
-addressed as "you".
+This License applies to any manual or other work, in any medium, that
+contains a notice placed by the copyright holder saying it can be
+distributed under the terms of this License. Such a notice grants a
+world-wide, royalty-free license, unlimited in duration, to use that
+work under the conditions stated herein. The "Document", below,
+refers to any such manual or work. Any member of the public is a
+licensee, and is addressed as "you". You accept the license if you
+copy, modify or distribute the work in a way requiring permission
+under copyright law.
A "Modified Version" of the Document means any work containing the
Document or a portion of it, either copied verbatim, or with
@@ -47,7 +52,7 @@
the Document that deals exclusively with the relationship of the
publishers or authors of the Document to the Document's overall subject
(or to related matters) and contains nothing that could fall directly
-within that overall subject. (For example, if the Document is in part a
+within that overall subject. (Thus, if the Document is in part a
textbook of mathematics, a Secondary Section may not explain any
mathematics.) The relationship could be a matter of historical
connection with the subject or with related matters, or of legal,
@@ -56,33 +61,40 @@
The "Invariant Sections" are certain Secondary Sections whose titles
are designated, as being those of Invariant Sections, in the notice
-that says that the Document is released under this License.
+that says that the Document is released under this License. If a
+section does not fit the above definition of Secondary then it is not
+allowed to be designated as Invariant. The Document may contain zero
+Invariant Sections. If the Document does not identify any Invariant
+Sections then there are none.
The "Cover Texts" are certain short passages of text that are listed,
as Front-Cover Texts or Back-Cover Texts, in the notice that says that
-the Document is released under this License.
+the Document is released under this License. A Front-Cover Text may
+be at most 5 words, and a Back-Cover Text may be at most 25 words.
A "Transparent" copy of the Document means a machine-readable copy,
represented in a format whose specification is available to the
-general public, whose contents can be viewed and edited directly and
+general public, that is suitable for revising the document
straightforwardly with generic text editors or (for images composed of
pixels) generic paint programs or (for drawings) some widely available
drawing editor, and that is suitable for input to text formatters or
for automatic translation to a variety of formats suitable for input
to text formatters. A copy made in an otherwise Transparent file
-format whose markup has been designed to thwart or discourage
-subsequent modification by readers is not Transparent. A copy that is
-not "Transparent" is called "Opaque".
+format whose markup, or absence of markup, has been arranged to thwart
+or discourage subsequent modification by readers is not Transparent.
+An image format is not Transparent if used for any substantial amount
+of text. A copy that is not "Transparent" is called "Opaque".
Examples of suitable formats for Transparent copies include plain
ASCII without markup, Texinfo input format, LaTeX input format, SGML
or XML using a publicly available DTD, and standard-conforming simple
-HTML designed for human modification. Opaque formats include
-PostScript, PDF, proprietary formats that can be read and edited only
-by proprietary word processors, SGML or XML for which the DTD and/or
+HTML, PostScript or PDF designed for human modification. Examples of
+transparent image formats include PNG, XCF and JPG. Opaque formats
+include proprietary formats that can be read and edited only by
+proprietary word processors, SGML or XML for which the DTD and/or
processing tools are not generally available, and the
-machine-generated HTML produced by some word processors for output
-purposes only.
+machine-generated HTML, PostScript or PDF produced by some word
+processors for output purposes only.
The "Title Page" means, for a printed book, the title page itself,
plus such following pages as are needed to hold, legibly, the material
@@ -91,6 +103,21 @@
the text near the most prominent appearance of the work's title,
preceding the beginning of the body of the text.
+A section "Entitled XYZ" means a named subunit of the Document whose
+title either is precisely XYZ or contains XYZ in parentheses following
+text that translates XYZ in another language. (Here XYZ stands for a
+specific section name mentioned below, such as "Acknowledgements",
+"Dedications", "Endorsements", or "History".) To "Preserve the Title"
+of such a section when you modify the Document means that it remains a
+section "Entitled XYZ" according to this definition.
+
+The Document may include Warranty Disclaimers next to the notice which
+states that this License applies to the Document. These Warranty
+Disclaimers are considered to be included by reference in this
+License, but only as regards disclaiming warranties: any other
+implication that these Warranty Disclaimers may have is void and has
+no effect on the meaning of this License.
+
2. VERBATIM COPYING
@@ -110,9 +137,10 @@
3. COPYING IN QUANTITY
-If you publish printed copies of the Document numbering more than 100,
-and the Document's license notice requires Cover Texts, you must enclose
-the copies in covers that carry, clearly and legibly, all these Cover
+If you publish printed copies (or copies in media that commonly have
+printed covers) of the Document, numbering more than 100, and the
+Document's license notice requires Cover Texts, you must enclose the
+copies in covers that carry, clearly and legibly, all these Cover
Texts: Front-Cover Texts on the front cover, and Back-Cover Texts on
the back cover. Both covers must also clearly and legibly identify
you as the publisher of these copies. The front cover must present
@@ -130,16 +158,15 @@
If you publish or distribute Opaque copies of the Document numbering
more than 100, you must either include a machine-readable Transparent
copy along with each Opaque copy, or state in or with each Opaque copy
-a publicly-accessible computer-network location containing a complete
-Transparent copy of the Document, free of added material, which the
-general network-using public has access to download anonymously at no
-charge using public-standard network protocols. If you use the latter
-option, you must take reasonably prudent steps, when you begin
-distribution of Opaque copies in quantity, to ensure that this
-Transparent copy will remain thus accessible at the stated location
-until at least one year after the last time you distribute an Opaque
-copy (directly or through your agents or retailers) of that edition to
-the public.
+a computer-network location from which the general network-using
+public has access to download using public-standard network protocols
+a complete Transparent copy of the Document, free of added material.
+If you use the latter option, you must take reasonably prudent steps,
+when you begin distribution of Opaque copies in quantity, to ensure
+that this Transparent copy will remain thus accessible at the stated
+location until at least one year after the last time you distribute an
+Opaque copy (directly or through your agents or retailers) of that
+edition to the public.
It is requested, but not required, that you contact the authors of the
Document well before redistributing any large number of copies, to give
@@ -163,7 +190,8 @@
B. List on the Title Page, as authors, one or more persons or entities
responsible for authorship of the modifications in the Modified
Version, together with at least five of the principal authors of the
- Document (all of its principal authors, if it has less than five).
+ Document (all of its principal authors, if it has fewer than five),
+ unless they release you from this requirement.
C. State on the Title page the name of the publisher of the
Modified Version, as the publisher.
D. Preserve all the copyright notices of the Document.
@@ -175,10 +203,10 @@
G. Preserve in that license notice the full lists of Invariant Sections
and required Cover Texts given in the Document's license notice.
H. Include an unaltered copy of this License.
-I. Preserve the section entitled "History", and its title, and add to
- it an item stating at least the title, year, new authors, and
+I. Preserve the section Entitled "History", Preserve its Title, and add
+ to it an item stating at least the title, year, new authors, and
publisher of the Modified Version as given on the Title Page. If
- there is no section entitled "History" in the Document, create one
+ there is no section Entitled "History" in the Document, create one
stating the title, year, authors, and publisher of the Document as
given on its Title Page, then add an item describing the Modified
Version as stated in the previous sentence.
@@ -189,17 +217,18 @@
You may omit a network location for a work that was published at
least four years before the Document itself, or if the original
publisher of the version it refers to gives permission.
-K. In any section entitled "Acknowledgements" or "Dedications",
- preserve the section's title, and preserve in the section all the
- substance and tone of each of the contributor acknowledgements
+K. For any section Entitled "Acknowledgements" or "Dedications",
+ Preserve the Title of the section, and preserve in the section all
+ the substance and tone of each of the contributor acknowledgements
and/or dedications given therein.
L. Preserve all the Invariant Sections of the Document,
unaltered in their text and in their titles. Section numbers
or the equivalent are not considered part of the section titles.
-M. Delete any section entitled "Endorsements". Such a section
+M. Delete any section Entitled "Endorsements". Such a section
may not be included in the Modified Version.
-N. Do not retitle any existing section as "Endorsements"
+N. Do not retitle any existing section to be Entitled "Endorsements"
or to conflict in title with any Invariant Section.
+O. Preserve any Warranty Disclaimers.
If the Modified Version includes new front-matter sections or
appendices that qualify as Secondary Sections and contain no material
@@ -208,7 +237,7 @@
list of Invariant Sections in the Modified Version's license notice.
These titles must be distinct from any other section titles.
-You may add a section entitled "Endorsements", provided it contains
+You may add a section Entitled "Endorsements", provided it contains
nothing but endorsements of your Modified Version by various
parties--for example, statements of peer review or that the text has
been approved by an organization as the authoritative definition of a
@@ -236,7 +265,7 @@
versions, provided that you include in the combination all of the
Invariant Sections of all of the original documents, unmodified, and
list them all as Invariant Sections of your combined work in its
-license notice.
+license notice, and that you preserve all their Warranty Disclaimers.
The combined work need only contain one copy of this License, and
multiple identical Invariant Sections may be replaced with a single
@@ -247,11 +276,11 @@
Make the same adjustment to the section titles in the list of
Invariant Sections in the license notice of the combined work.
-In the combination, you must combine any sections entitled "History"
-in the various original documents, forming one section entitled
-"History"; likewise combine any sections entitled "Acknowledgements",
-and any sections entitled "Dedications". You must delete all sections
-entitled "Endorsements."
+In the combination, you must combine any sections Entitled "History"
+in the various original documents, forming one section Entitled
+"History"; likewise combine any sections Entitled "Acknowledgements",
+and any sections Entitled "Dedications". You must delete all sections
+Entitled "Endorsements".
6. COLLECTIONS OF DOCUMENTS
@@ -272,18 +301,20 @@
A compilation of the Document or its derivatives with other separate
and independent documents or works, in or on a volume of a storage or
-distribution medium, does not as a whole count as a Modified Version
-of the Document, provided no compilation copyright is claimed for the
-compilation. Such a compilation is called an "aggregate", and this
-License does not apply to the other self-contained works thus compiled
-with the Document, on account of their being thus compiled, if they
-are not themselves derivative works of the Document.
+distribution medium, is called an "aggregate" if the copyright
+resulting from the compilation is not used to limit the legal rights
+of the compilation's users beyond what the individual works permit.
+When the Document is included in an aggregate, this License does not
+apply to the other works in the aggregate which are not themselves
+derivative works of the Document.
If the Cover Text requirement of section 3 is applicable to these
-copies of the Document, then if the Document is less than one quarter
-of the entire aggregate, the Document's Cover Texts may be placed on
-covers that surround only the Document within the aggregate.
-Otherwise they must appear on covers around the whole aggregate.
+copies of the Document, then if the Document is less than one half of
+the entire aggregate, the Document's Cover Texts may be placed on
+covers that bracket the Document within the aggregate, or the
+electronic equivalent of covers if the Document is in electronic form.
+Otherwise they must appear on printed covers that bracket the whole
+aggregate.
8. TRANSLATION
@@ -294,10 +325,17 @@
permission from their copyright holders, but you may include
translations of some or all Invariant Sections in addition to the
original versions of these Invariant Sections. You may include a
-translation of this License provided that you also include the
-original English version of this License. In case of a disagreement
-between the translation and the original English version of this
-License, the original English version will prevail.
+translation of this License, and all the license notices in the
+Document, and any Warranty Disclaimers, provided that you also include
+the original English version of this License and the original versions
+of those notices and disclaimers. In case of a disagreement between
+the translation and the original version of this License or a notice
+or disclaimer, the original version will prevail.
+
+If a section in the Document is Entitled "Acknowledgements",
+"Dedications", or "History", the requirement (section 4) to Preserve
+its Title (section 1) will typically require changing the actual
+title.
9. TERMINATION
@@ -335,19 +373,23 @@
the License in the document and put the following copyright and
license notices just after the title page:
- Copyright (c) YEAR YOUR NAME.
- Permission is granted to copy, distribute and/or modify this document
- under the terms of the GNU Free Documentation License, Version 1.1
- or any later version published by the Free Software Foundation;
- with the Invariant Sections being LIST THEIR TITLES, with the
- Front-Cover Texts being LIST, and with the Back-Cover Texts being LIST.
- A copy of the license is included in the section entitled "GNU
- Free Documentation License".
-
-If you have no Invariant Sections, write "with no Invariant Sections"
-instead of saying which ones are invariant. If you have no
-Front-Cover Texts, write "no Front-Cover Texts" instead of
-"Front-Cover Texts being LIST"; likewise for Back-Cover Texts.
+ Copyright (c) YEAR YOUR NAME.
+ Permission is granted to copy, distribute and/or modify this document
+ under the terms of the GNU Free Documentation License, Version 1.2
+ or any later version published by the Free Software Foundation;
+ with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.
+ A copy of the license is included in the section entitled "GNU
+ Free Documentation License".
+
+If you have Invariant Sections, Front-Cover Texts and Back-Cover Texts,
+replace the "with...Texts." line with this:
+
+ with the Invariant Sections being LIST THEIR TITLES, with the
+ Front-Cover Texts being LIST, and with the Back-Cover Texts being LIST.
+
+If you have Invariant Sections without Cover Texts, or some other
+combination of the three, merge those two alternatives to suit the
+situation.
If your document contains nontrivial examples of program code, we
recommend releasing these examples in parallel under your choice of
Modified: trunk/MAINTAINERS
==============================================================================
--- trunk/MAINTAINERS (original)
+++ trunk/MAINTAINERS Sun Jan 13 16:03:11 2008
@@ -1,6 +1,6 @@
Francesco Fumanti
-E-Mail: <frfumanti svn gnome org>
-UserID: frfumanti
+E-mail: frfumanti svn gnome org
+Userid: frfumanti
Gerd Kohlberger
E-Mail: <gerdk svn gnome org>
Added: trunk/help/C/figures/mouse-a11y-dwell-checkbox.png
==============================================================================
Binary file. No diff available.
Added: trunk/help/C/figures/mouse-a11y-dwell-click-type-applet.png
==============================================================================
Binary file. No diff available.
Added: trunk/help/C/figures/mouse-a11y-dwell-click-type-window.png
==============================================================================
Binary file. No diff available.
Added: trunk/help/C/figures/mouse-a11y-dwell-ctw-checkbox.png
==============================================================================
Binary file. No diff available.
Added: trunk/help/C/figures/mouse-a11y-dwell-delay-slider.png
==============================================================================
Binary file. No diff available.
Added: trunk/help/C/figures/mouse-a11y-dwell-gesture-mapping.png
==============================================================================
Binary file. No diff available.
Added: trunk/help/C/figures/mouse-a11y-dwell-mode-choice.png
==============================================================================
Binary file. No diff available.
Added: trunk/help/C/figures/mouse-a11y-dwell-motion-treshold.png
==============================================================================
Binary file. No diff available.
Added: trunk/help/C/figures/mouse-a11y-pointer-capture-context-menu.png
==============================================================================
Binary file. No diff available.
Added: trunk/help/C/figures/mouse-a11y-pointer-capture-locked.png
==============================================================================
Binary file. No diff available.
Added: trunk/help/C/figures/mouse-a11y-pointer-capture-preferences.png
==============================================================================
Binary file. No diff available.
Added: trunk/help/C/figures/mouse-a11y-ssc-checkbox.png
==============================================================================
Binary file. No diff available.
Added: trunk/help/C/figures/mouse-a11y-ssc-delay-slider.png
==============================================================================
Binary file. No diff available.
Added: trunk/help/C/figures/mouse-a11y-tab.png
==============================================================================
Binary file. No diff available.
Modified: trunk/help/C/legal.xml
==============================================================================
--- trunk/help/C/legal.xml (original)
+++ trunk/help/C/legal.xml Sun Jan 13 16:03:11 2008
@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="UTF-8"?>
<legalnotice id="legalnotice">
- <para> Permission is granted to copy, distribute and/or modify this document
- under the terms of the GNU Free Documentation License (GFDL), Version 1.1 or
+ <para>Permission is granted to copy, distribute and/or modify this document
+ under the terms of the GNU Free Documentation License (GFDL), Version 1.2 or
any later version published by the Free Software Foundation with no
Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts. You can
find a copy of the GFDL at this <ulink type="http"
@@ -13,7 +13,7 @@
collection, you can do so by adding a copy of the license to the manual, as
described in section 6 of the license. </para>
- <para> Many of the names used by companies to distinguish their products and
+ <para>Many of the names used by companies to distinguish their products and
services are claimed as trademarks. Where those names appear in any GNOME
documentation, and the members of the GNOME Documentation Project are made
aware of those trademarks, then the names are in capital letters or initial
Modified: trunk/help/C/mousetweaks.xml
==============================================================================
--- trunk/help/C/mousetweaks.xml (original)
+++ trunk/help/C/mousetweaks.xml Sun Jan 13 16:03:11 2008
@@ -1,23 +1,25 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE article PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
"http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd"; [
-<!ENTITY legal SYSTEM "legal.xml">
<!ENTITY appversion "0.2.6">
<!ENTITY manrevision "0.2">
<!ENTITY date "October 2007">
<!ENTITY app "<application>Mousetweaks</application>">
+
+<!ENTITY legal SYSTEM "legal.xml">
]>
<article id="index" lang="en">
<articleinfo>
<title><application>Mousetweaks</application> Manual</title>
<copyright>
- <year>2007</year>
+ <year>2007 - 2008</year>
<holder>Francesco Fumanti</holder>
</copyright>
- &legal;
+ &legal;
+
<authorgroup>
<author>
<firstname>Francesco</firstname>
@@ -25,13 +27,26 @@
<surname>Fumanti</surname>
<affiliation>
- <address><email>francesco fumanti gmx net</email> </address>
+ <address><email>frfumanti svn gnome org</email> </address>
</affiliation>
</author>
</authorgroup>
<revhistory>
<revision>
+ <revnumber>version 2.21.5</revnumber>
+
+ <date>January 2008</date>
+
+ <revdescription>
+ <para role="author">The contents of the manual have been adapted to
+ the changes applied to mousetweaks for its integration into GNOME
+ 2.22. Francesco Fumanti
+ <email>frfumanti svn gnome org</email></para>
+ </revdescription>
+ </revision>
+
+ <revision>
<revnumber>version 0.2</revnumber>
<date>November 2007</date>
@@ -56,19 +71,23 @@
</revision>
</revhistory>
- <releaseinfo>This manual describes version 0.2.6 of
- Mousetweaks.</releaseinfo>
+ <releaseinfo>This manual describes version 2.21.5 of mousetweaks and its
+ graphical user interface consisting of the accessibility tab of the mouse
+ control panel and two panel applets.</releaseinfo>
<contrib>To report a bug or make a suggestion regarding the Mousetweaks
- application or this manual, please go to Launchpad.</contrib>
+ application or this manual, please go to GNOME's Bugzilla, where where
+ mousetweaks should soon be available.</contrib>
<legalnotice>
<title>Feedback</title>
- <para>To report a bug or make a suggestion regarding the
- <application>Mousetweaks</application> application or this manual,
- please go to <ulink type="http"
- url="https://bugs.launchpad.net/mousetweaks/";>Launchpad</ulink>.</para>
+ <para>To report a bug or make a suggestion regarding <application>the
+ mousetweaks module</application> (i.e.: mouse accessibility), its user
+ interface or its manual, please use the facilities provided by the
+ <ulink type="http" url="http://bugzilla.gnome.org/";>GNOME's
+ Bugzilla</ulink>, where the corresponding module should soon be
+ available.</para>
</legalnotice>
</articleinfo>
@@ -80,46 +99,44 @@
<primary>mousetweaks</primary>
</indexterm>
- <sect1 id="mt-introduction">
+ <sect1 id="mouse-a11y-introduction">
<title>Introduction</title>
- <para>The <application>Mousetweaks</application> application provides
- mouse accessibility enhancements for the GNOME Desktop. Indeed, it offers
- the following new pointer functions to the user:</para>
+ <para>The <application>mousetweaks module</application> provides mouse
+ accessibility enhancements for the GNOME Desktop. Indeed, it offers the
+ following new functions to the user:</para>
<itemizedlist>
<listitem>
- <para>The possibility to perform a right click by holding the
- <mousebutton>left mousebutton</mousebutton> pressed while keeping the
- pointer motionless.</para>
+ <para>Simulated secondary click: it allows the user to perform a
+ secondary click (menu click) by holding down the primary mouse button
+ while keeping the pointer motionless.</para>
</listitem>
<listitem>
- <para>The possibility to perform the various clicks without pressing
- any <hardware>hardware button</hardware>.</para>
+ <para>Dwell click: it allows the user to perform the various clicks
+ without pressing any <hardware>hardware button</hardware>.</para>
</listitem>
<listitem>
- <para>The possibility to lock the pointer in a determined area of the
- panel until the user releases it by a predefined keystroke or mouse
- button.</para>
+ <para>Pointer capture: it allows the user to lock the pointer in a
+ determined area of the panel until the user releases it by a
+ predefined keystroke or mouse button.</para>
</listitem>
</itemizedlist>
</sect1>
- <sect1 id="mt-how-to-start">
- <title>How to start the features</title>
+ <sect1 id="mouse-a11y-how-to-start-features">
+ <title>How To Start The Functions</title>
- <para>The right click feature and the buttonless click feature of
- <application><application>Mousetweaks</application></application> depend
- on the mousetweaks process; however the pointer capture applet depends on
- the gnome panel. Consequently, they have to be started differently:</para>
+ <para>The simulated secondary click and the dwell click depend on the
+ mousetweaks process; however the pointer capture applet depends on the
+ gnome panel. Consequently, they have to be started differently.</para>
- <sect2 id="mt-start-right-click-feature">
- <title>Starting the right click feature</title>
+ <sect2 id="mouse-a11y-start-ssc">
+ <title>Starting The Simulated Secondary Click Function</title>
- <para>You can start the right click feature of
- <application>Mousetweaks</application> in two ways:</para>
+ <para>You can start the simulated secondary click in two ways:</para>
<itemizedlist>
<listitem>
@@ -131,64 +148,66 @@
</listitem>
</itemizedlist>
- <sect3 id="mt-start-right-click-by-menu">
- <title>Start from the graphical user interface</title>
-
- <para>Choose the menu <menuchoice>
- <guimenu>Applications</guimenu>
+ <sect3 id="mouse-a11y-start-ssc-by-gui">
+ <title>Start From The Graphical User Interface</title>
- <guisubmenu>Universal Access</guisubmenu>
-
- <guimenuitem>Mousetweaks</guimenuitem>
- </menuchoice> to open the control panel of Mousetweaks. You will get
- the following window:</para>
+ <para>The graphical user interface to start the simulated secondary
+ click is located in the accessibility tab of the mouse control panel.
+ To open it, choose the menu <menuchoice>
+ <guimenu>System</guimenu>
+
+ <guisubmenu>Preferences</guisubmenu>
+
+ <guimenuitem>Control Center</guimenuitem>
+ </menuchoice> and the Control Center will open. By clicking on Mouse
+ in the Control Center, the Mouse control panel will open and after
+ clicking on the Accessibility tab, you will see the following
+ settings:</para>
<mediaobject>
<imageobject>
- <imagedata fileref="figures/mt-control-panel-delay-click-enabled.png"
- format="PNG" />
+ <imagedata fileref="figures/mouse-a11y-tab.png" format="PNG" />
</imageobject>
<textobject>
- <para>Picture of the panel of
- <application>Mousetweaks</application></para>
+ <para>Picture of the Mouse control panel</para>
</textobject>
</mediaobject>
- <para>To start the right click feature, put a checkmark into the
- checkbox that says:</para>
+ <para>To start the simulated secondary click function, put a checkmark
+ into the checkbox that says:</para>
- <para><quote>Trigger secondary button when I hold down the primary
- button</quote></para>
+ <para><quote>Trigger secondary secondary click by holding down the
+ primary button</quote></para>
<mediaobject>
<imageobject>
- <imagedata fileref="figures/mt-delay-click-checkbox.png" />
+ <imagedata fileref="figures/mouse-a11y-ssc-checkbox.png" />
</imageobject>
<textobject>
- <para>Picture of the checkbox to start the right click
- feature</para>
+ <para>Picture of the checkbox to start the simulated secondary
+ click</para>
</textobject>
</mediaobject>
</sect3>
- <sect3 id="mt-start-right-click-by-cli">
- <title>Start from the command line</title>
+ <sect3 id="mouse-a11y-start-ssc-by-cli" label="">
+ <title>Start From The Command Line</title>
- <para>To start the right click feature from the command line, open the
- <application>Terminal</application> and type the following:</para>
+ <para>To start the simulated secondary click from the command line,
+ open the <application>Terminal</application> and type the
+ following:</para>
<para><command>mousetweaks <parameter>--enable
delay</parameter></command></para>
</sect3>
</sect2>
- <sect2 id="mt-start-buttonless-click-feature">
- <title>Starting the buttonless click feature</title>
+ <sect2 id="mouse-a11y-start-dwell">
+ <title>Starting The Dwell Click Function</title>
- <para>You can start the buttonless click feature of
- <application>Mousetweaks</application> in two ways:</para>
+ <para>You can start the dwell click function in two ways:</para>
<itemizedlist>
<listitem>
@@ -200,76 +219,77 @@
</listitem>
</itemizedlist>
- <sect3 id="mt-start-buttonless-click-by-menu">
- <title>Start from the graphical user interface</title>
-
- <para>Choose the menu <menuchoice>
- <guimenu>Applications</guimenu>
-
- <guisubmenu>Universal Access</guisubmenu>
+ <sect3 id="mouse-a11y-start-dwell-by-gui">
+ <title>Start From The Graphical User Interface</title>
- <guimenuitem>Mousetweaks</guimenuitem>
- </menuchoice> to open the control panel of Mousetweaks. You will get
- the following window:</para>
+ <para>The graphical user interface to start the dwell click is located
+ in the accessibility tab of the mouse control panel. To open it,
+ choose the menu <menuchoice>
+ <guimenu>System</guimenu>
+
+ <guisubmenu>Preferences</guisubmenu>
+
+ <guimenuitem>Control Center</guimenuitem>
+ </menuchoice> and the Control Center will open. By clicking on Mouse
+ in the Control Center, the Mouse control panel will open and after
+ clicking on the Accessibility tab, you will see the following
+ settings:</para>
<mediaobject>
<imageobject>
- <imagedata fileref="figures/mt-control-panel-dwell-click-enabled.png"
- format="PNG" />
+ <imagedata fileref="figures/mouse-a11y-tab.png" format="PNG" />
</imageobject>
<textobject>
- <para>Picture of the control panel of
- <application>Mousetweaks</application></para>
+ <para>Picture of the Mouse control panel</para>
</textobject>
</mediaobject>
- <para>To start the buttonless click feature, put a checkmark into the
+ <para>To start the dwell click function, put a checkmark into the
checkbox that says:</para>
- <para><quote>Perform different clicks without using any
- button</quote></para>
+ <para><quote>Initiate click when stopping pointer
+ movement</quote></para>
<mediaobject>
<imageobject>
- <imagedata fileref="figures/mt-dwell-click-checkbox.png" />
+ <imagedata fileref="figures/mouse-a11y-dwell-checkbox.png" />
</imageobject>
<textobject>
- <para>Picture of the checkbox to start the buttonless click
- feature</para>
+ <para>Picture of the checkbox to start the dwell click
+ function</para>
</textobject>
</mediaobject>
</sect3>
- <sect3 id="mt-start-buttonless-click-by-cli">
- <title>Start from the command line</title>
+ <sect3 id="mouse-a11y-start-dwell-by-cli">
+ <title>Start From The Command Line</title>
- <para>To start the buttonless click feature and show the click type
- window from the command line, open the
- <application>Terminal</application> and type the following:</para>
+ <para>To start the dwell click function and show the click type window
+ from the command line, open the <application>Terminal</application>
+ and type the following:</para>
<para><command>mousetweaks <parameter>--enable dwell
--show-ctw</parameter></command></para>
</sect3>
</sect2>
- <sect2 id="mt-start-pointer-capture-feature">
- <title>Starting the pointer capture feature</title>
+ <sect2 id="mouse-a11y-start-pointer-capture">
+ <title>Starting The Pointer Capture Function</title>
<para>As the pointer capture applet comes in the from of a panel applet,
its starting method has to follow the rules dictated by the GNOME panel.
- Thus, to start the pointer capture feature, you only have to install it
- on the panel and it will automatically run, regardless of the state of
- the other features of Mousetweaks.</para>
+ Thus, to start the pointer capture function, you only have to install it
+ on the panel and it will automatically run.</para>
<para>In order to add it to the panel, proceed as you do with any panel
- applet: right click on the panel to open its contextual menu, choose
- <guimenuitem>Add to Panel</guimenuitem>, and you will get the window
- showing all the applets that can be installed on the GNOME
+ applet: perform a secondary click on the panel to open its contextual
+ menu, choose <guimenuitem>Add to Panel</guimenuitem>, and you will get
+ the window showing all the applets that can be installed on the GNOME
panel.<mediaobject>
<imageobject>
- <imagedata fileref="figures/mt-add-applet-to-panel-window.png" />
+ <imagedata fileref="figures/mouse-a11y-add-applet-to-panel-window.png" />
</imageobject>
<textobject>
@@ -278,23 +298,23 @@
</textobject>
</mediaobject></para>
- <para>By double clicking on the Pointer Capture item in the Add to Panel
- window, the pointer capture applet will be added to the panel, and it
- will be working until removed.</para>
+ <para>By double clicking on the <guilabel>Pointer Capture</guilabel>
+ item in the Add to Panel window, the pointer capture applet will be
+ added to the panel, and it will be working until removed.</para>
</sect2>
</sect1>
- <sect1 id="mt-how-to-stop-features">
- <title>Quitting the features</title>
+ <sect1 id="mouse-a11y-how-to-stop-features">
+ <title>How To Quit The Functions</title>
- <para>Similar to the starting of the features, their quitting also depends
- on the feature that you want to quit.</para>
+ <para>Similar to the starting of the functions, their quitting also
+ depends on the feature that you want to quit.</para>
- <sect2 id="mt-stop-right-click-feature">
- <title>Quitting the right click feature</title>
+ <sect2 id="mouse-a11y-stop-ssc">
+ <title>Quitting The Simulated Secondary Click</title>
- <para>It is possible to quit the right click feature of
- <application>Mousetweaks</application> in two ways:</para>
+ <para>It is possible to quit the simulated secondary click in two
+ ways:</para>
<itemizedlist>
<listitem>
@@ -303,7 +323,7 @@
<mediaobject>
<imageobject>
- <imagedata fileref="figures/mt-delay-click-checkbox.png" />
+ <imagedata fileref="figures/mouse-a11y-ssc-checkbox.png" />
</imageobject>
<textobject>
@@ -313,8 +333,9 @@
</mediaobject>
<para>Please refer to <link
- linkend="mt-start-right-click-by-menu">Starting the right click
- feature from menu</link> to locate the checkbox.</para>
+ linkend="mouse-a11y-start-ssc-by-gui">Start The Simulated Secondary
+ Click From The Graphical User Interface</link> to locate the
+ checkbox.</para>
</listitem>
<listitem>
@@ -326,11 +347,10 @@
</itemizedlist>
</sect2>
- <sect2 id="mt-stop-buttonless-click-feature">
- <title>Quitting the buttonless click feature</title>
+ <sect2 id="mouse-a11y-stop-dwell">
+ <title>Quitting The Dwell Click</title>
- <para>It is possible to quit the buttonless click feature of
- <application>Mousetweaks</application> in two ways:</para>
+ <para>It is possible to quit the dwell click in two ways:</para>
<itemizedlist>
<listitem>
@@ -339,7 +359,7 @@
<mediaobject>
<imageobject>
- <imagedata fileref="figures/mt-dwell-click-checkbox.png" />
+ <imagedata fileref="figures/mouse-a11y-dwell-checkbox.png" />
</imageobject>
<textobject>
@@ -349,8 +369,8 @@
</mediaobject>
<para>Please refer to <link
- linkend="mt-start-buttonless-click-by-menu">Starting the buttonless
- click feature from menu</link> to locate the checkbox.</para>
+ linkend="mouse-a11y-start-dwell-by-gui">Start The Dwell Click From
+ The Graphical User Interface</link> to locate the checkbox.</para>
</listitem>
<listitem>
@@ -362,10 +382,10 @@
</itemizedlist>
</sect2>
- <sect2 id="mt-stop-pointer-capture-feature">
- <title>Quitting the pointer capture feature</title>
+ <sect2 id="mouse-a11y-stop-pointer-capture">
+ <title>Quitting The Pointer Capture Function</title>
- <para>As the pointer capture feature comes in the form of a panel
+ <para>As the pointer capture function comes in the form of a panel
applet, you have to quit it the same way that you do it with other
applets: perform a right click on the applet and choose
<guimenuitem>Remove From Panel</guimenuitem> from its contextual
@@ -373,7 +393,7 @@
<mediaobject>
<imageobject>
- <imagedata fileref="figures/mt-pointer-capture-context-menu.png" />
+ <imagedata fileref="figures/mouse-a11y-pointer-capture-context-menu.png" />
</imageobject>
<textobject>
@@ -384,127 +404,122 @@
</sect2>
</sect1>
- <sect1 id="mt-features-description">
- <title>Description of the features</title>
+ <sect1 id="mouse-a11y-functions-description">
+ <title>Description Of The Functions</title>
<para>The <application>Mousetweaks</application> application offers three
new pointer features to the user. These are: <itemizedlist>
<listitem>
- <para><xref linkend="mt-delay-click" /></para>
+ <para><xref linkend="mouse-a11y-ssc-description" /></para>
</listitem>
<listitem>
- <para><xref linkend="mt-dwell-click" /></para>
+ <para><xref linkend="mouse-a11y-dwell-description" /></para>
</listitem>
<listitem>
- <para><xref linkend="mt-pointer-capture" /></para>
+ <para><xref
+ linkend="mouse-a11y-pointer-capture-description" /></para>
</listitem>
- </itemizedlist><note>
- <para>The manual assumes a right-handed user: consequently, left mouse
- button indicates the primary mouse button and right mouse button
- indicates the secondary mouse button. Of course, for a left-handed
- user that has enabled the corresponding option in the Mouse control
- panel, the terms left and right have to be exchanged.</para>
- </note></para>
+ </itemizedlist></para>
- <sect2 id="mt-delay-click">
- <title>Right clicking with the left button</title>
+ <sect2 id="mouse-a11y-ssc-description">
+ <title>Simulated Secondary Click Description</title>
<para>When the user activates this feature, he will be able to perform
- right clicks by using the <mousebutton>left mouse button</mousebutton>.
- This is especially useful for users that have only one
- <mousebutton>mouse button</mousebutton> at their disposal.</para>
-
- <sect3 id="mt-delay-howto">
- <title>How does it work?</title>
-
- <para>When this feature is enabled, mousetweaks performs a right click
- at the location of the pointer, if the user keeps the
- <mousebutton>left mouse button</mousebutton> pressed without moving
+ secondary clicks by using the <mousebutton>primary mouse
+ button</mousebutton>. This is especially useful for users that have only
+ one <mousebutton>mouse button</mousebutton> at their disposal.</para>
+
+ <sect3 id="mouse-a11y-ssc-howto">
+ <title>How Does It Work?</title>
+
+ <para>When this feature is enabled, mousetweaks performs a secondary
+ click at the location of the pointer, if the user keeps the
+ <mousebutton>primary mouse button</mousebutton> pressed without moving
the pointer for a determined time.</para>
- <para>How long the user has to hold the <mousebutton>left mouse
- button</mousebutton> pressed is determined by the slider in the
- control panel of mousetweaks with the title:</para>
-
- <para><quote>Time to hold primary button</quote></para>
+ <para>How long the user has to hold the <mousebutton>primary mouse
+ button</mousebutton> pressed is determined by the delay slider under
+ the activation checkbox:</para>
<mediaobject>
<imageobject>
- <imagedata fileref="figures/mt-delay-click-pause-time-slider.png" />
+ <imagedata fileref="figures/mouse-a11y-ssc-delay-slider.png" />
</imageobject>
<textobject>
- <para>Picture showing the slider to set how long to hold the left
- button for the right click to be triggered</para>
+ <para>Picture showing the slider to set how long to hold the
+ primary button for the secondary click to be triggered</para>
</textobject>
</mediaobject>
</sect3>
- <sect3 id="mt-delay-characteristics">
- <title>Differences to the normal right button click</title>
+ <sect3 id="mouse-a11y-ssc-pecularities">
+ <title>Differences To The Normal Secondary Click</title>
- <para>As <application>Mousetweaks</application> is not able to discard
- the <mousebutton>left mouse button down</mousebutton> gesture from the
- <mousebutton>left button press</mousebutton> of the user, it issues a
- left click before issuing the right click. In other words, each right
- click performed by this feature of mousetweaks is immediately preceded
- by a left click, and this makes it behave a bit differently to the
- normal right click performed by the <mousebutton>right mouse
- button</mousebutton>. For example:</para>
+ <para>As the simulated secondary click is not able to discard the
+ <mousebutton>mouse button down</mousebutton> gesture from the
+ <mousebutton> primary button press</mousebutton> of the user, it
+ issues a primary click before issuing the secondary click. In other
+ words, each secondary click performed by this function is immediately
+ preceded by a primary click, and this makes it behave a bit
+ differently to the normal secondary click performed by the
+ <mousebutton>secondary mouse button</mousebutton>. For example:</para>
<itemizedlist>
<listitem>
- <para>It is not possible to perform a right click on multiple
- items because the left click issued before the right click
+ <para>It is not possible to perform a secondary click on multiple
+ items because the primary click issued before the secondary click
deselects the items.</para>
</listitem>
<listitem>
- <para>When this type of right click is performed on the trash icon
- on the panel, not only does the contextual menu appear, but the
- trash folder does also open. (The former is caused by the right
- click, the latter by the left click preceding the right
- click.)</para>
+ <para>When the simulated secondary click is performed on the trash
+ icon on the panel, not only does the contextual menu appear, but
+ the trash folder does also open. (The former is caused by the
+ secondary click, the latter by the primary click preceding the
+ right click.)</para>
</listitem>
</itemizedlist>
<note>
<para>It is not possible to provide a list of all diverging
behaviours, because it depends on the reaction of the application
- receiving the right click preceded by a left click.</para>
+ receiving the secondary click preceded by a primary click.</para>
</note>
- <para>Some users may also be surprised by the behaviour caused by the
- fact, that it is not possible to perform a long motionless left click
- and hold, without also doing a right click. For example:</para>
+ <para>Some users may also be surprised by the consequences of the
+ following: it is not possible to perform a long motionless primary
+ button click and hold, without also triggering the secondary click.
+ For example:</para>
<itemizedlist>
<listitem>
- <para>When doing a motionless left click and hold on the arrow of
- a scrollbar, the scrollbar jumps to the bottom after some time.
- This is in fact the normal behaviour of a right click on an arrow
- of a scrollbar.</para>
+ <para>When doing a motionless primary button click and hold on the
+ arrow of a scrollbar, the scrollbar jumps to the bottom after some
+ time. This is in fact the normal behaviour of a secondary click on
+ an arrow of a scrollbar.</para>
<tip>
<para>To work around this behaviour, simply move the pointer
- immediately after pressing the <mousebutton>mouse
- button</mousebutton>. This way
- <application>Mousetweaks</application> does not issue the right
- click.</para>
+ immediately after pressing the <mousebutton>primary mouse
+ button</mousebutton>. This way the simulated secondary click is
+ not issued.</para>
</tip>
</listitem>
</itemizedlist>
</sect3>
</sect2>
- <sect2 id="mt-dwell-click">
- <title>Clicking without the use of any hardware button</title>
+ <sect2 id="mouse-a11y-dwell-description">
+ <title>Dwell Click Description</title>
- <para>By activating this feature, users will be able to perform left
- clicks, double clicks, drag clicks and right clicks without having to
- press any <mousebutton>mouse button</mousebutton>.</para>
+ <para>There are users that cannot use any hardware button. By activating
+ the <guilabel>Dwell Click</guilabel>, they can have the mouse perform
+ the various clicks without pressing any mouse button. The click types
+ that can be performed are: single primary click, double-click, drag
+ click and secondary click.</para>
<note>
<para>When the buttonless click is active, the <mousebutton>mouse
@@ -512,48 +527,97 @@
click with the <mousebutton>mouse buttons</mousebutton>.</para>
</note>
- <sect3 id="mt-dwell-trigger-choice">
- <title>Click trigger and click type choice</title>
+ <sect3>
+ <title id="mouse-a11y-dwell-delay">Dwell Delay Setting</title>
+
+ <para>With the <guilabel>Delay</guilabel> slider, the user can
+ configure how long the pointer has to be motionless for the click to
+ be initiated.</para>
+
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="figures/mouse-a11y-dwell-delay-slider.png" />
+ </imageobject>
+
+ <textobject>
+ <para>Picture showing the delay slider of the dwell click</para>
+ </textobject>
+ </mediaobject>
+
+ <para>Details about how to complete the click and how to choose the
+ click type can be found under <link
+ linkend="mouse-a11y-dwell-modes">How To Complete Clicks And Specify
+ The Click Type</link>.</para>
+
+ <note>
+ <para>The dwell delay only works in the context of the dwell
+ click.</para>
+ </note>
+ </sect3>
+
+ <sect3 id="mouse-a11y-dwell-motion-treshold">
+ <title>Motion Treshold Setting</title>
+
+ <para>For people that have trouble to keep the mouse motionless, there
+ is the <guilabel>Motion Treshold</guilabel> slider.</para>
+
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="figures/mouse-a11y-dwell-motion-treshold.png" />
+ </imageobject>
+
+ <textobject>
+ <para>Picture showing the motion treshold slider of the dwell
+ click</para>
+ </textobject>
+ </mediaobject>
- <para>The user can choose between two methods to trigger the clicks:
- by time or by gesture. There are two radio buttons for this purpose in
- the control panel of Mousetweaks.</para>
+ <para>When the slider is set towards low, even little mouse movements
+ are considered; however, by setting a higher treshold, the mouse has
+ to traverse a bigger distance before it is considered as
+ moving.</para>
+
+ <note>
+ <para>This function only works in the context of the dwell
+ click.</para>
+ </note>
+ </sect3>
+
+ <sect3 id="mouse-a11y-dwell-modes">
+ <title>How To Complete Clicks And Specify The Click Type</title>
+
+ <para>Each time she pointer stops moving, a click is initiated. How
+ the click is completed and how the click type is chosen depends on
+ what dwell mode the user has selected. The two available modes
+ are:</para>
<mediaobject>
<imageobject>
- <imagedata fileref="figures/mt-dwell-click-trigger-choice.png" />
+ <imagedata fileref="figures/mouse-a11y-dwell-mode-choice.png" />
</imageobject>
<textobject>
- <para>Picture showing the radio buttons to select trigger
- method</para>
+ <para>Picture showing the radio buttons to select dwell
+ mode</para>
</textobject>
</mediaobject>
- <para>To select the trigger method, the user only needs to click on
- the radio button that corresponds to his desired trigger
- method.</para>
-
- <sect4>
- <title>Trigger by time</title>
-
- <para>In the trigger by time method, the Mousetweaks application
- automatically performs the click after the pointer has been
- motionless for a determined time.</para>
-
- <remark>See <link linkend="mt-dwell-time-setting">Time settings for
- buttonless clicks</link> for more information about how to set the
- time lapse that the pointer has to be motionless before performing
- the click.</remark>
-
- <para>The type of click performed depends on the selection in the
- click type window or click type applet. Have a look at the following
- picture to see the click type window and the click type
- applet:</para>
+ <para>To select the mode, the user only has to click on the radio
+ button that corresponds to his choice.</para>
+
+ <sect4 id="mouse-a11y-dwell-mode-ctw">
+ <title>Dwell Click With Automatic Click Completion And Click Type
+ Choice Beforehand</title>
+
+ <para>This mode is active when the user selects <guilabel>Choose
+ type of click beforehand</guilabel>. In fact, after the mouse has
+ been motionless for the time defined by the Delay slider, the system
+ will automatically perform the click type that is selected in the
+ Click Type Window shown here:</para>
<mediaobject>
<imageobject>
- <imagedata fileref="figures/mt-dwell-click-click-type-window.png" />
+ <imagedata fileref="figures/mouse-a11y-dwell-click-type-window.png" />
</imageobject>
<textobject>
@@ -561,65 +625,86 @@
</textobject>
</mediaobject>
+ <para>To display the click type window on the screen, the user has
+ to put a checkmark <application>in the checkbox named <quote>Show
+ click type window</quote>:</application></para>
+
<mediaobject>
<imageobject>
- <imagedata fileref="figures/mt-dwell-click-click-type-applet.png" />
+ <imagedata fileref="figures/mouse-a11y-dwell-ctw-checkbox.png" />
</imageobject>
<textobject>
- <para>Picture showing the click type applet at the right of the
- menus</para>
+ <para>Picture with the checkbox to display the click type
+ window</para>
</textobject>
</mediaobject>
- <para>To display the click type window on the screen, the user has
- to put a checkmark in the corresponding checkbox <application>in the
- control panel of Mousetweaks</application>.</para>
+ <para>After the click has occurred, the single click type will be
+ automatically restored. In order to choose another click type, the
+ user has to perform an automatic click on the
+ <guibutton>button</guibutton> in the Click Type Window that
+ corresponds to its click type choice.</para>
+
+ <para>Some users might prefer to use the <guilabel>Dwell Click panel
+ applet</guilabel> instead of the Click Type Window. The advantage of
+ the panel applet is that it does not cover any open window on the
+ desktop.</para>
+
+ <mediaobject>
+ <imageobject>
+ <imagedata fileref="figures/mouse-a11y-dwell-click-type-applet.png" />
+ </imageobject>
+
+ <textobject>
+ <para>Picture showing the click type applet at the right of the
+ gnome menus</para>
+ </textobject>
+ </mediaobject>
<para>To display the click type applet on the GNOME panel, please
follow the procedure you have to use in order to add any applet to
the GNOME panel. If you do not know how to add an applet to the
- panel, please have a look at <link
- linkend="mt-start-pointer-capture-feature">Starting the pointer
- capture feature</link>.</para>
+ panel, have a look at <link
+ linkend="mouse-a11y-start-pointer-capture">Starting The Pointer
+ Capture Function</link>.</para>
<para>The click type window and the click type applet can be used
simultaneously or each on its own.</para>
-
- <tip>
- <para>The click type applet is especially interesting for people
- that do not want to cover their desktop with the click type
- window.</para>
- </tip>
</sect4>
- <sect4>
- <title>Trigger by gesture</title>
-
- <para>In the trigger by gesture method, the shape of the pointer
- changes to the gesture shape after being motionless for a determined
- time.</para>
-
- <remark>See <link linkend="mt-dwell-time-setting">Time settings for
- buttonless clicks</link> for more information about how to set the
- time lapse that the pointer has to be motionless before its shape
- changes to the gesture shape.</remark>
-
- <para>If the user moves the pointer while it is showing the gesture
- shape, a click is performed. Moreover, the type of click performed
- depends on the direction that the user moved the pointer.</para>
-
- <para>If the user does not move the pointer while it is showing the
- gesture shape, its shape returns to the normal pointer shape and the
- user can again move the pointer without a click being
- performed.</para>
-
- <para>There is a section in the control panel of Mousetweaks for the
- user to map click type to movement direction:</para>
+ <sect4 id="mouse-a11y-dwell-mode-gestures">
+ <title>Dwell Click With Click Type Choice And Click Completion By A
+ Mouse Gesture</title>
+
+ <para>This mode is active when the user selects <guilabel>Choose
+ type of click with mouse gestures</guilabel>. In fact, after the
+ mouse has been motionless for the above predefined delay, the shape
+ of the pointer will change for a little while:</para>
+
+ <itemizedlist>
+ <listitem>
+ <para>If the user moves the mouse while it is showing the
+ alternative shape, a click is performed and the pointer returns
+ to its normal shape. The type of click performed depends on the
+ direction of the movement of the mouse.</para>
+ </listitem>
+
+ <listitem>
+ <para>If the user keeps the mouse motionless until the pointer
+ returns to its normal shape, the user can move the mouse without
+ a click being performed. The next dwell click can be performed
+ when the mouse stops moving again.</para>
+ </listitem>
+ </itemizedlist>
+
+ <para>The user also has the possibility to match click type with
+ movement direction by using the 4 <guimenu>popups</guimenu>
+ available under this mode:</para>
<mediaobject>
<imageobject>
- <imagedata fileref="figures/mt-dwell-click-gesture-mapping.png" />
+ <imagedata fileref="figures/mouse-a11y-dwell-gesture-mapping.png" />
</imageobject>
<textobject>
@@ -628,99 +713,35 @@
</textobject>
</mediaobject>
- <para>By using the <guimenu>popup</guimenu> menus, the user can set
- what direction he wants to correspond to what click type. There is
- also a <guimenuitem>Disabled</guimenuitem> menu item in each
- <guimenu>popup</guimenu>, so that user can disable the click types
- that he does not want to be performed automatically. This is
+ <para>There is also a <guimenuitem>Disabled</guimenuitem> menu item
+ in each <guimenu>popup</guimenu>. The user can select it if he does
+ not want some click types to be performed automatically. This is
especially interesting for users that have problems only with
certain click types.</para>
</sect4>
</sect3>
-
- <sect3>
- <title id="mt-dwell-time-setting">Time settings for buttonless
- clicks</title>
-
- <para>When using the buttonless click feature, the pointer has to stay
- motionless for a determined time before a click is automatically
- performed or before the pointer changes its shape to the gesture
- shape. The control panel of Mousetweaks offers the following slider to
- set the time to wait before a click is triggered:</para>
-
- <mediaobject>
- <imageobject>
- <imagedata fileref="figures/mt-dwell-click-pause-time-slider.png" />
- </imageobject>
-
- <textobject>
- <para>Picture showing the slider to set how long the pointer has
- to be motionless</para>
- </textobject>
- </mediaobject>
-
- <para>By moving the Time to Wait slider, the user can tell
- <application>Mousetweaks</application> how long the pointer has to be
- motionless before a click is automatically performed or before the
- pointer changes its shape to the gesture shape.</para>
-
- <note>
- <para>This function only works in the context of the buttonless
- click.</para>
- </note>
- </sect3>
-
- <sect3 id="mt-dwell-movement-tolerance">
- <title>Movement tolerance for buttonless clicks</title>
-
- <para>When using the buttonless click feature, the pointer has to stay
- motionless for a determined time before a click is automatically
- performed or before the pointer changes its shape to the gesture
- shape. For people who have problems to keep the pointer motionless for
- a determined time lapse, there is a slider in the control panel of
- <application>Mousetweaks</application> to make it ignore small pointer
- movements.</para>
-
- <mediaobject>
- <imageobject>
- <imagedata fileref="figures/mt-dwell-click-ignore-movement-slider.png" />
- </imageobject>
-
- <textobject>
- <para>Picture showing the slider to set the amount of pointer
- movement to ignore</para>
- </textobject>
- </mediaobject>
-
- <para>By moving this slider, the user can indicate to Mousetweaks what
- maximum movement size it has to consider as motionless.</para>
-
- <note>
- <para>This function only works in the context of the buttonless
- click.</para>
- </note>
- </sect3>
</sect2>
- <sect2 id="mt-pointer-capture">
- <title>Locking the pointer</title>
+ <sect2 id="mouse-a11y-pointer-capture-description">
+ <title>Locking The Pointer Description</title>
<para>There are people that have to use their pointing device not only
for the computer. These people would welcome a way to lock the pointer
into an area of the screen, so that they can use their pointing device
- for other tasks. The <application>Mousetweaks</application> application
- ships with an applet called Pointer Capture that creates an area on the
- panel into which the user can lock the pointer until he releases it in a
- determined way.</para>
+ for other tasks.</para>
+
+ <para>In fact, the Pointer Capture panel applet creates such an area on
+ the panel, into which the user can lock the pointer until he releases it
+ in a determined way.</para>
<remark>Have a look at <link
- linkend="mt-start-pointer-capture-feature">Starting the pointer capture
- feature</link> for instructions about how to install and remove it from
- the GNOME panel.</remark>
+ linkend="mouse-a11y-start-pointer-capture">Starting The Pointer Capture
+ Function</link> for instructions about how to install the pointer
+ capture applet on the GNOME panel.</remark>
<mediaobject>
<imageobject>
- <imagedata fileref="figures/mt-pointer-capture-context-menu.png" />
+ <imagedata fileref="figures/mouse-a11y-pointer-capture-context-menu.png" />
</imageobject>
<textobject>
@@ -729,7 +750,7 @@
</textobject>
<imageobject>
- <imagedata fileref="figures/mt-pointer-capture-locked.png" />
+ <imagedata fileref="figures/mouse-a11y-pointer-capture-locked.png" />
</imageobject>
<textobject>
@@ -744,7 +765,7 @@
<mediaobject>
<imageobject>
- <imagedata fileref="figures/mt-pointer-capture-preferences-window.png" />
+ <imagedata fileref="figures/mouse-a11y-pointer-capture-preferences.png" />
</imageobject>
<textobject>
@@ -786,7 +807,7 @@
</sect2>
</sect1>
- <sect1 id="mt-about">
+ <sect1 id="mouse-a11y-about">
<title>About <application>Mousetweaks</application></title>
<sect2>
@@ -795,24 +816,26 @@
<para><application>Mousetweaks</application> is based on a <ulink
type="https"
url="https://wiki.ubuntu.com/Accessibility/Specs/MouseTweaks";>specification</ulink>
- hosted on Launchpad and was implemented by Gerd Kohlberger (
- <email>lowfi chello at</email> ); Francesco Fumanti (
- <email>francesco fumanti gmx net</email> ) helped with testing and other
+ hosted on Launchpad. It was implemented by Gerd Kohlberger (
+ <email>gerdk svn gnome org</email> ), while I (
+ <email>frfumanti svn gnome org</email> ) helped with testing and other
things.</para>
<para>You can find more informations about Mousetweaks on <ulink
- type="https"
- url="https://launchpad.net/mousetweaks";>Launchpad</ulink>.</para>
+ type="https" url="https://launchpad.net/mousetweaks";>Launchpad</ulink>
+ and on <ulink url="http://live.gnome.org//Mousetweaks/Home";>GNOME
+ Live</ulink>.</para>
</sect2>
<sect2>
<title>Feedback</title>
- <para>To report a bug or make a suggestion regarding
- <application>Mousetweaks</application> or this manual, please use the
- facilities provided by the <ulink type="https"
- url="https://launchpad.net/mousetweaks";>Mousetweaks' pages on
- Launchpad</ulink> .</para>
+ <para>To report a bug or make a suggestion regarding <application>the
+ mousetweaks</application> module (i.e.: mouse accessibility), its user
+ interface or its manual, please use the facilities provided by the
+ <ulink type="http" url="http://bugzilla.gnome.org/";>GNOME's
+ Bugzilla</ulink>, where the corresponding module should soon be
+ available.</para>
</sect2>
<sect2>
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]
