<!DOCTYPE REFENTRY PUBLIC "-//Sun Microsystems//DTD DocBook V3.0-Based SolBook Subset V2.0//EN" [

<!--ArborText, Inc., 1988-1999, v.4002-->

<!ENTITY cmd "mousetweaks">

<!ENTITY % commonents SYSTEM "smancommon.ent">

%commonents;

<!ENTITY % booktitles SYSTEM "booktitles.ent">

%booktitles;

<!ENTITY suncopy "Copyright (c) 2008 Sun Microsystems, Inc. All Rights Reserved.">

]>

<?Pub UDT _bookmark _target>

<?Pub Inc>

<refentry id="mousetweaks-1">

<refmeta>

<refentrytitle>&cmd;</refentrytitle>

<manvolnum>1</manvolnum>

<refmiscinfo class="date">29 Oct 2008</refmiscinfo>

<refmiscinfo class="sectdesc">&man1;</refmiscinfo>

<refmiscinfo class="software">&release;</refmiscinfo>

<refmiscinfo class="arch">generic</refmiscinfo>

<refmiscinfo class="copyright">&suncopy;</refmiscinfo>

</refmeta>

<indexterm><primary>&cmd;</primary></indexterm>

<refnamediv id="mousetweaks-1-name">

<refname>&cmd;</refname>

<refpurpose>Accessibility enhancements for the mouse</refpurpose>

</refnamediv>

<refsect1 id="mousetweaks-1-syno">

<title>SYNOPSIS</title>

<cmdsynopsis><command>&cmd;</command>

<arg choice="opt"><option>-enable-dwell</option></arg>

<arg choice="opt"><option>-enable-secondary</option></arg>

<arg choice="opt"><option>-dwell-time=<replaceable>FLOAT</replaceable></option></arg>

<arg choice="opt"><option>-secondary-time=<replaceable>FLOAT</replaceable></option></arg>

<arg choice="opt"><option>m|--dwell-mode=<replaceable>STRING</replaceable></option></arg>

<arg choice="opt"><option>c|--show-ctw</option></arg>

<arg choice="opt"><option>x|--ctw-x=<replaceable>INT</replaceable></option></arg>

<arg choice="opt"><option>y|--ctw-y=<replaceable>INT</replaceable></option></arg>

<arg choice="opt"><option>t|--threshold=<replaceable>INT</replaceable></option></arg>

<arg choice="opt"><option>a|--animate-cursor</option></arg>

<arg choice="opt"><option>s|--shutdown</option></arg>

<arg choice="opt"><option>?|--help</option></arg>

</cmdsynopsis>

</refsect1>

<refsect1 id="mousetweaks-1-desc">

<title>DESCRIPTION</title>

<para>

mousetweaks is a daemon that provides various mouse features for the GNOME

desktop. It depends on the Assistive Technology Service Provider Interface

(AT-SPI).

<para>

</refsect1>

<refsect1 id="mousetweaks-1-opti">

<title>OPTION</title>

<variablelist termlength="wholeline">

<varlistentry>

<term><filename>--enable-dwell</filename></term>

<listitem><para>

Automatically perform mouse clicks without using a physical button.

</para></listitem></varlistentry>

<varlistentry>

<term><filename>--enable-secondary</filename></term>

<listitem><para>

Trigger the secondary mouse button when the primary mouse button is held down

for a specified amount of time.

</para></listitem></varlistentry>

<varlistentry>

<term><filename>--dwell-time=FLOAT</filename></term>

<listitem><para>

Time to keep the pointer motionless before a dwell click is performed. Range:

0.2 - 3.0 seconds.

</para></listitem></varlistentry>

<varlistentry>

<term><filename>--secondary-time=FLOAT</filename></term>

<listitem><para>

Time to hold the primary mouse button before a simulated secondary click is

performed. Range: 0.5 - 3.0 seconds.

</para></listitem></varlistentry>

<varlistentry>

<term><filename>-m, --dwell-mode=STRING</filename></term>

<listitem><para>

Select a dwelling mode. Available arguments are: window, gesture

</para>

<para>

WINDOW:Select the active click type from a window or a panel applet.

</para>

<para>

GESTURE:Perform clicks by moving in different directions after the cursor

changes its shape.

</para>

</listitem></varlistentry>

<varlistentry>

<term><filename>-c, --show-ctw</filename></term>

<listitem><para>

Show the click-type window. Only useful in combination with dwell-mode=window.

</para></listitem></varlistentry>

<varlistentry>

<term><filename>-x, --ctw-x=INT</filename></term>

<listitem><para>

X Position of the click-type window on screen.

</para></listitem></varlistentry>

<varlistentry>

<term><filename>-y, --ctw-y=INT</filename></term>

<listitem><para>

Y Position of the click-type window on screen.

</para></listitem></varlistentry>

<varlistentry>

<term><filename>-t, --threshold=INT</filename></term>

<listitem><para>

Ignore small pointer movements. Range 0 - 30 pixels.

</para></listitem></varlistentry>

<varlistentry>

<term><filename>-a, --animate-cursor</filename></term>

<listitem><para>

Show elapsed time as cursor overlay.

</para></listitem></varlistentry>

<varlistentry>

<term><filename>-s, --shutdown</filename></term>

<listitem><para>

Stop the mousetweaks daemon.

</para></listitem></varlistentry>

</variablelist>

</refsect1>

<refsect1 id="mousetweaks-1-attr">

<title>ATTRIBUTES</title>

<para>See

<olink targetdocent="REFMAN5" localinfo="attributes-5">

<citerefentry><refentrytitle>attributes</refentrytitle>

<manvolnum>5</manvolnum></citerefentry>

</olink>

for descriptions of the following attributes:

</para>

<informaltable frame="all">

<tgroup cols="2" colsep="1" rowsep="1">

<colspec colname="COLSPEC0" colwidth="1*">

<colspec colname="COLSPEC1" colwidth="1*">

<thead>

<row>

<entry align="center" valign="middle">ATTRIBUTE TYPE</entry>

<entry align="center" valign="middle">ATTRIBUTE VALUE</entry>

</row>

</thead>

<tbody>

<row>

<entry><para>Availability</para></entry>

<entry><para>gnome/accessibility/mousetweaks</para></entry>

</row>

<row>

<entry colname="COLSPEC0"><para>Interface stability</para></entry>

<entry colname="COLSPEC1"><para>Volatile</para></entry>

</row>

</tbody>

</tgroup>

</informaltable>

</refsect1>

<refsect1 id="mousetweaks-1-file">

<title>FILES</title>

<variablelist termlength="wholeline">

<varlistentry>

<term><filename>~/.mousetweaks.pid</filename></term>

<listitem><para>The daemon creates a lock file in the users home directory to keep track.</para></listitem>

</varlistentry>

</variablelist>

</refsect1>

<refsect1 id="mousetweaks-1-also">

<title>SEE ALSO</title>

<para>

<citerefentry><refentrytitle>attributes</refentrytitle><manvolnum>5</manvolnum></citerefentry>,

<citerefentry><refentrytitle>dwell-click-applet</refentrytitle><manvolnum>1</manvolnum></citerefentry>,

<citerefentry><refentrytitle>pointer-capture-applet</refentrytitle><manvolnum>1</manvolnum></citerefentry>,

Assistive Technology Service Provider Interface (AT-SPI)

</para>

<para>

the homepage of Mousetweaks :

<itemizedlist mark='none'>

<listitem>

<para><olink>http://live.gnome.org/Mousetweaks/Home</olink></para>

</listitem>

</para>

</refsect1>

<refsect1 id="mousetweaks-1-bugs">

<title>BUGS</title>

<para>

Report bugs to <olink>http://bugzilla.gnome.org/</olink>

</para>

</refsect1>

<refsect1 id="mousetweaks-1-lice">

<title>LICENSE</title>

<para>

Licenced under the GNU General Public License v3 or later.

</para>

</refsect1>

<refsect1 id="mousetweaks-1-hist">

<title>HISTORY</title>

<para>

mousetweaks was written by Gerd Kohlberger (lowfi@chello.at)

</para>

<para>

October 29 2008:

This man pages was modified by Yue Wang (Yue.Wang@Sun.COM).

</para>

</refsect1>

</refentry>