<page xmlns="http://projectmallard.org/1.0/"
      xmlns:if="http://projectmallard.org/if/1.0/"
      type="topic" style="task a11y"
      id="a11y-dwellclick-usage">

  <info>
    <link type="guide" xref="a11y-dwellclick#usage"/>

    <revision pkgversion="3.6.0" date="2012-08-20" status="review"/>

    <credit type="author">
      <name>Francesco Fumanti</name>
      <email>frfumanti@svn.gnome.org</email>
      <years>2012</years>
    </credit>

    <desc>How to use the hover click?</desc>
    <include href="legal.xml" xmlns="http://www.w3.org/2001/XInclude"/>
  </info>

    <title>Usage</title>

    <p>In order to use the <gui>Hover Click</gui>, you have to first enable it.
    Please, refer to section <link xref="a11y-dwellclick#startstop"/> for
    instructions.</p>

    <p>The <gui>Hover Click</gui> window will open, and will stay above all
    of your other windows. You can use it to choose what sort of click
    should happen when you hover. For example, if you
    select <gui>Secondary Click</gui>, you will right-click when you
    hover. After you double-click, right-click, or drag, you will be
    automatically returned to left clicking.</p>

    <p>To perform a hover click, simply hover your mouse pointer
    over an item on the screen. Then let go of the mouse and
    wait for a while; the item will be clicked for you.</p>

    <p>There is a visual feedback for the elapsing time before the click: When
    you hover your mouse pointer over an item and don't move it,
    the pointer will gradually change color. After it has fully changed color,
    the item will be clicked.</p>

    <p>You can abort a hover click anytime by moving the pointer. After a
    hover click has occurred, you have to move and stop the mouse again to
    trigger another hover click.</p>

    <p>Adjust the <gui>Delay</gui> setting to change how long you have to
    hold the mouse pointer still before the hover click occurs.</p>

    <p>You don't need to hold the mouse perfectly still when hovering to
    click. The pointer is allowed to move a little bit and will still
    click after a while. If it moves too much, however, the click will
    not happen.</p>

    <p>Adjust the <gui>Motion threshold</gui> setting to change how much
    the pointer can move and still be considered to be hovering.</p>

</page>
