Documenting mouse accessibility and onscreen keyboard options.

Normalizing those options ('-' instead of '_' in their names, like other opts.)

docs/CHANGES.txt

@@ -48,6 +48,21 @@ $Id$
     * Added support for building under Haiku OS
       Scott McCreary <scottmc@users.sourceforge.net>
 
+  * Accessibility Improvements:
+    ---------------------------
+    * Added a mouse accessibility mode to avoid the need to drag the mouse.
+      ("--mouse-accessibility")
+      by Ankit Choudary <ankit.goaldecided@gmail.com> (GSOC 2009)
+      with integration and fixes by
+      Pere Pujal i Carabantes <pere@fornol.no-ip.org>
+
+    * Added an option to display an on-screen keyboard when using the
+      'Text' and 'Label' tools. (Experimental.)
+      ("--onscreen-keyboard")
+      by Ankit Choudary <ankit.goaldecided@gmail.com> (GSOC 2009)
+      with integration and fixes by
+      Pere Pujal i Carabantes <pere@fornol.no-ip.org>
+
   * Other Improvements:
     -------------------
     * Tux Paint (in windowed mode) now only centers itself if
@@ -55,15 +70,8 @@ $Id$
       the SDL_VIDEO_WINDOW_POS environment variable.
       (SourceForge Bug #3138446)
 
-    * Adding a mouse mode to avoid the need to drag the mouse.
-      FIXME: Explain
-      by Ankit Choudary <ankit.goaldecided@gmail.com>
-
-    * Allowing to paint with the keyboard.
-      FIXME: Explain
-      by Ankit Choudary.
-
     * Creating thumbnails for the starters we provide.
+      (Speeds up 'New' dialog appearance.)
       Pere Pujal i Carabantes <pere@fornol.no-ip.org>
 
     * On systems where Pango is used for UI text rendering, Tux Paint now

docs/OPTIONS.txt

@@ -9,7 +9,7 @@ Options Documentation
                            bill@newbreedsoftware.com
                             http://www.tuxpaint.org/
 
-                                January 12, 2011
+                                 April 13, 2011
 
      ----------------------------------------------------------------------
 
@@ -369,6 +369,15 @@ Windows Users
                This can be useful for people who prefer things right-to-left,
                rather than left-to-right.
 
+       mouse-accessibility=yes
+               In this mode, instead of clicking, dragging and releasing
+               (e.g., to draw), you click, move, and click again to end the
+               motion.
+
+       onscreen-keyboard=yes
+               Presents a clickable on-screen keyboard when using the Text
+               and Label tools.
+
        stampsize=SIZE
 
                Use this option to force Tux Paint to set the starting size of
@@ -767,6 +776,8 @@ Windows Users
          --nostampcontrols
          --nomagiccontrols
          --nolabel
+         --mouse-accessibility
+         --onscreen-keyboard
          --sysfonts
          --alllocalefonts
          --mirrorstamps

docs/html/OPTIONS.html

@@ -23,7 +23,7 @@ New Breed Software</p>
 <a href="http://www.tuxpaint.org/">http://www.tuxpaint.org/</a></p>
 
 
-<p>January 12, 2011</p>
+<p>April 13, 2011</p>
 
 
 </center>
@@ -460,6 +460,18 @@ New Breed Software</p>
     rather than left-to-right.</p>
   </dd>
 
+  <dt><code><b>mouse-accessibility=yes</b></code></dt>
+  <dd>
+    In this mode, instead of clicking, dragging and releasing
+    (e.g., to draw), you click, move, and click again to end the motion.
+  </dd>
+
+  <dt><code><b>onscreen-keyboard=yes</b></code></dt>
+  <dd>
+    Presents a clickable on-screen keyboard when using the <b>Text</b> and
+    <b>Label</b> tools.
+  </dd>
+
   <dt><code><b>stampsize=<i>SIZE</i></b></code></dt>
   <dd>
     <p>Use this option to force Tux&nbsp;Paint to set the starting size of
@@ -1182,6 +1194,8 @@ New Breed Software</p>
     --nostampcontrols<br>
     --nomagiccontrols<br>
     --nolabel<br>
+    --mouse-accessibility<br>
+    --onscreen-keyboard<br>
     --sysfonts<br>
     --alllocalefonts<br>
     --mirrorstamps<br>

src/manpage/tuxpaint.1

@@ -1,5 +1,5 @@
-.\" tuxpaint.1 - 2011.01.12
-.TH TUXPAINT 1 "12 January 2011" "0.9.22" "Tux Paint"
+.\" tuxpaint.1 - 2011.04.13
+.TH TUXPAINT 1 "13 April 2011" "0.9.22" "Tux Paint"
 .SH NAME
 tuxpaint -- "Tux Paint", a drawing program for young children.
 
@@ -63,6 +63,10 @@ tuxpaint -- "Tux Paint", a drawing program for young children.
 .br
 [\-\-mirrorstamps]
 .br
+[\-\-mouse-accessibility]
+.br
+[\-\-onscreen-keyboard]
+.br
 [\-\-stampsize=\fISIZE\fP]
 .br
 [\-\-keyboard]
@@ -362,6 +366,16 @@ With \fImirrorstamps\fP set, stamps which can be mirrored will appear
 mirrored by default.  This can be useful when used by people who prefer
 things right-to-left over left-to-right.
 
+.TP 8
+.B \-\-mouse-accessibility
+In this mode, instead of clicking, dragging and releasing (e.g., to draw),
+you click, move, and click again to end the motion.
+
+.TP 8
+.B \-\-onscreen-keyboard
+Presents a clickable on-screen keyboard when using the \fIText\fP and
+\fILabel\fP tools.
+
 .TB 8
 .B \-\-stampsize=\fIsize\fP \-\-stampsize=default
 Sets the default size of all stamps, relative to their possible sizes

src/parse.gperf

@@ -153,8 +153,8 @@ version,            IMM(version)
 wheelmouse,          POSBOOL(wheely)
 windowed,            NEGBOOL(fullscreen)
 windowsize,          MULTI(parsertmp_windowsize)
-mouse_accessibility, POSBOOL(mouseaccessibility)
-onscreen_keyboard,  POSBOOL(onscreen_keyboard)
+mouse-accessibility, POSBOOL(mouseaccessibility)
+onscreen-keyboard,   POSBOOL(onscreen_keyboard)
 %%
 
 void parse_one_option(struct cfginfo *restrict tmpcfg, const char *str, const char *opt, const char *restrict src)

src/tuxpaint-completion.bash

@@ -60,6 +60,8 @@ _tuxpaint()
 			-l --lang -L --locale \
 			--nosysconfig \
 			--nolockfile \
+			--mouse-accessibility \
+			--onscreen-keyboard \
 			--colorfile' -- $cur ) ) 
 # We don't accept filenames on the command-line yet -bjk 2009.09.09
 #        else