Doc'ing new "colorsrows" option

In manpage, and (via 'tuxpaint-docs' update) in OPTIONS docs.
Also, added a bash tab-completion entry for it.
(h/t Pere for enabling the feature.)

docs/CHANGES.txt

@@ -13,6 +13,11 @@ $Id$
     ------------
     * [WIP] Larger UI buttons
       Pere Pujal i Carabantes <pere@fornol.no-ip.org>
+
+    * It's now possible to increase how many rows of buttons are shown
+      for the color palette at the bottom of the screen.
+      (Use the "colorsrows" option.)
+      Pere Pujal i Carabantes <pere@fornol.no-ip.org>
       
   * New Magic Tools:
     ----------------

docs/en/OPTIONS.txt

@@ -6,7 +6,7 @@ Options Documentation
           Copyright © 2002-2021 by various contributors; see AUTHORS.
                             http://www.tuxpaint.org/
 
-                                22 January 2021
+                                5 February 2021
 
      ----------------------------------------------------------------------
 
@@ -714,6 +714,12 @@ Windows Users
              low halves of the byte, so "#FFF" is the same as "#FFFFFF", not
              "#F0F0F0".
 
+     colorsrows=ROWS
+
+             How many rows of color palette buttons to show; useful when
+             using a large color palette (see "colorfile", above), and/or for
+             use with coarse input devices (like eyegaze trackers).
+
      lang=LANGUAGE
 
              Run Tux Paint in one of the supported languages. Possible choice

docs/en/README.txt

@@ -874,7 +874,7 @@ Using the import script, "tuxpaint-import"
        Example:
 
          $ tuxpaint-import grandma.jpg
-         grandma.jpg -> /home/username/.tuxpaint/saved/20210205160922.png
+         grandma.jpg -> /home/username/.tuxpaint/saved/20210205175230.png
          jpegtopnm: WRITING A PPM FILE
 
        The first line ("tuxpaint-import grandma.jpg") is the command to run.
@@ -916,7 +916,7 @@ Importing Pictures Manually
          * mm = Minute (two digits, "00"-"59")
          * ss = Seconds (two digits, "00"-"59")
 
-       Example: "20210205160922.png", for 5 February 2021 at 16:09:22.
+       Example: "20210205175230.png", for 5 February 2021 at 17:52:30.
 
        Place this PNG file in your Tux Paint "saved" directory/folder. (See
        above.)

docs/en/html/OPTIONS.html

@@ -25,7 +25,7 @@
       </p>
 
       <p>
-        22 January 2021      </p>
+         5 February 2021      </p>
     </center>
 
     <hr size="2"
@@ -953,6 +953,15 @@
             NOTES: You must separate decimal values with spaces, and begin hexadecimal values with a pound/number-sign character ("<code>#</code>"). In 3-digit hexadecimal, each digit is used for both the high and low halves of the byte, so "<code>#FFF</code>" is the same as "<code>#FFFFFF</code>", not "<code>#F0F0F0</code>".          </p>
         </dd>
 
+        <dt>
+          <code><b>colorsrows=<i>ROWS</i></b></code>
+        </dt>
+
+        <dd>
+          <p>
+            How many rows of color palette buttons to show; useful when using a large color palette (see "<code>colorfile</code>", above), and/or for use with coarse input devices (like eyegaze trackers).          </p>
+        </dd>
+
         <dt>
           <code><b>lang=<i>LANGUAGE</i></b></code>
         </dt>

docs/en/html/README.html

@@ -1303,7 +1303,7 @@
         <blockquote>
           <code>$ <strong>tuxpaint-import grandma.jpg</strong><br>
           grandma.jpg -&gt;
-          /home/username/.tuxpaint/saved/20210205160922.png<br>
+          /home/username/.tuxpaint/saved/20210205175230.png<br>
           jpegtopnm: WRITING A PPM FILE</code>
         </blockquote>
 
@@ -1351,7 +1351,7 @@
         </ul>
 
         <p>
-          Example: "<code>20210205160922</code>.png", for  5 February 2021 at 16:09:22.        </p>
+          Example: "<code>20210205175230</code>.png", for  5 February 2021 at 17:52:30.        </p>
 
         <p>
           Place this PNG file in your Tux Paint "<code>saved</code>" directory/folder. (See above.)        </p>

docs/es_ES.UTF-8/OPTIONS.txt

@@ -6,7 +6,7 @@ Options Documentation
           Copyright © 2002-2021 by various contributors; see AUTHORS.
                             http://www.tuxpaint.org/
 
-                                 22 enero 2021
+                                 5 febrero 2021
 
      ----------------------------------------------------------------------
 
@@ -714,6 +714,12 @@ Windows Users
              low halves of the byte, so "#FFF" is the same as "#FFFFFF", not
              "#F0F0F0".
 
+     colorsrows=ROWS
+
+             How many rows of color palette buttons to show; useful when
+             using a large color palette (see "colorfile", above), and/or for
+             use with coarse input devices (like eyegaze trackers).
+
      lang=LANGUAGE
 
              Run Tux Paint in one of the supported languages. Possible choice

docs/es_ES.UTF-8/html/OPTIONS.html

@@ -25,7 +25,7 @@
       </p>
 
       <p>
-        22 enero 2021      </p>
+         5 febrero 2021      </p>
     </center>
 
     <hr size="2"
@@ -953,6 +953,15 @@
             NOTES: You must separate decimal values with spaces, and begin hexadecimal values with a pound/number-sign character ("<code>#</code>"). In 3-digit hexadecimal, each digit is used for both the high and low halves of the byte, so "<code>#FFF</code>" is the same as "<code>#FFFFFF</code>", not "<code>#F0F0F0</code>".          </p>
         </dd>
 
+        <dt>
+          <code><b>colorsrows=<i>ROWS</i></b></code>
+        </dt>
+
+        <dd>
+          <p>
+            How many rows of color palette buttons to show; useful when using a large color palette (see "<code>colorfile</code>", above), and/or for use with coarse input devices (like eyegaze trackers).          </p>
+        </dd>
+
         <dt>
           <code><b>lang=<i>LANGUAGE</i></b></code>
         </dt>

docs/fr_FR.UTF-8/OPTIONS.txt

@@ -6,7 +6,7 @@ Options Documentation
           Copyright © 2002-2021 by various contributors; see AUTHORS.
                             http://www.tuxpaint.org/
 
-                                22 janvier 2021
+                                 5 février 2021
 
      ----------------------------------------------------------------------
 
@@ -714,6 +714,12 @@ Windows Users
              low halves of the byte, so "#FFF" is the same as "#FFFFFF", not
              "#F0F0F0".
 
+     colorsrows=ROWS
+
+             How many rows of color palette buttons to show; useful when
+             using a large color palette (see "colorfile", above), and/or for
+             use with coarse input devices (like eyegaze trackers).
+
      lang=LANGUAGE
 
              Run Tux Paint in one of the supported languages. Possible choice

docs/fr_FR.UTF-8/html/OPTIONS.html

@@ -25,7 +25,7 @@
       </p>
 
       <p>
-        22 janvier 2021      </p>
+         5 février 2021      </p>
     </center>
 
     <hr size="2"
@@ -953,6 +953,15 @@
             NOTES: You must separate decimal values with spaces, and begin hexadecimal values with a pound/number-sign character ("<code>#</code>"). In 3-digit hexadecimal, each digit is used for both the high and low halves of the byte, so "<code>#FFF</code>" is the same as "<code>#FFFFFF</code>", not "<code>#F0F0F0</code>".          </p>
         </dd>
 
+        <dt>
+          <code><b>colorsrows=<i>ROWS</i></b></code>
+        </dt>
+
+        <dd>
+          <p>
+            How many rows of color palette buttons to show; useful when using a large color palette (see "<code>colorfile</code>", above), and/or for use with coarse input devices (like eyegaze trackers).          </p>
+        </dd>
+
         <dt>
           <code><b>lang=<i>LANGUAGE</i></b></code>
         </dt>

docs/gl_ES.UTF-8/OPTIONS.txt

@@ -6,7 +6,7 @@ Documentación de opcións
     Copyright © 2002-2021 por varios colaboradores; vexa AUTORES (AUTHORS).
                             http://www.tuxpaint.org/
 
-                                22 Xaneiro 2021
+                                5 Febreiro 2021
 
      ----------------------------------------------------------------------
 
@@ -736,6 +736,12 @@ Usuarios de Windows
              low halves of the byte, so "#FFF" is the same as "#FFFFFF", not
              "#F0F0F0".
 
+     colorsrows=ROWS
+
+             How many rows of color palette buttons to show; useful when
+             using a large color palette (see "colorfile", above), and/or for
+             use with coarse input devices (like eyegaze trackers).
+
      lang=IDIOMA
 
              Run Tux Paint in one of the supported languages. Possible choice

docs/gl_ES.UTF-8/html/OPTIONS.html

@@ -25,7 +25,7 @@
       </p>
 
       <p>
-        22 Xaneiro 2021      </p>
+         5 Febreiro 2021      </p>
     </center>
 
     <hr size="2"
@@ -953,6 +953,15 @@
             NOTES: You must separate decimal values with spaces, and begin hexadecimal values with a pound/number-sign character ("<code>#</code>"). In 3-digit hexadecimal, each digit is used for both the high and low halves of the byte, so "<code>#FFF</code>" is the same as "<code>#FFFFFF</code>", not "<code>#F0F0F0</code>".          </p>
         </dd>
 
+        <dt>
+          <code><b>colorsrows=<i>ROWS</i></b></code>
+        </dt>
+
+        <dd>
+          <p>
+            How many rows of color palette buttons to show; useful when using a large color palette (see "<code>colorfile</code>", above), and/or for use with coarse input devices (like eyegaze trackers).          </p>
+        </dd>
+
         <dt>
           <code><b>lang=<i>IDIOMA</i></b></code>
         </dt>

src/manpage/tuxpaint.1

@@ -1,5 +1,5 @@
-.\" tuxpaint.1 - 2021.01.18
+.\" tuxpaint.1 - 2021.02.05
-.TH TUXPAINT 1 "18 January 2021" "0.9.26" "Tux Paint"
+.TH TUXPAINT 1 "5 February 2021" "0.9.26" "Tux Paint"
 .SH NAME
 tuxpaint -- "Tux Paint", a drawing program for young children.
 
@@ -71,6 +71,8 @@ tuxpaint -- "Tux Paint", a drawing program for young children.
 .br
 [\-\-mirrorstamps]
 .br
+[\-\-colorsrows=ROWS]
+.br
 [\-\-mouse-accessibility]
 .br
 [\-\-onscreen-keyboard]
@@ -450,6 +452,12 @@ text which can be altered or moved later.
 List solid (blank) colors at the end, or beginning (default) of the
 options displayed when using the \fINew\fP tool to start a new picture.
 
+.TP 8
+.B \-\-colorsrows=\fIrows\fP
+How many rows of color palette buttons to show; useful when using
+a large color palette, and/or for use with coarse input devices
+(like eyegaze trackers).
+
 .TP 8
 .B \-\-mirrorstamps \-\-dontmirrorstamps
 With \fImirrorstamps\fP set, stamps which can be mirrored will appear

src/parse.gperf

@@ -164,7 +164,7 @@ wheelmouse,          POSBOOL(wheely)
 windowed,            NEGBOOL(fullscreen)
 windowsize,          MULTI(parsertmp_windowsize)
 buttonsize,          MULTI(button_size)
-colorsrows,           MULTI(colors_rows)
+colorsrows,          MULTI(colors_rows)
 mouse-accessibility, POSBOOL(mouseaccessibility)
 onscreen-keyboard,   POSBOOL(onscreen_keyboard)
 onscreen-keyboard-layout,         MULTI(onscreen_keyboard_layout)

src/tuxpaint-completion.bash

@@ -3,7 +3,7 @@
 # Bill Kendrick <bill@newbreedsoftware.com>; http://www.tuxpaint.org/
 # Based on inkscape's completion file, by allali@univ-mlv.fr
 #
-# Last modified 2021-01-23
+# Last modified 2021-02-05
 #
 # $Id$
 
@@ -48,6 +48,7 @@ _tuxpaint()
 			--outlines --nooutlines \
 			--stamps --nostamps \
                         --newcolorsfirst --newcolorslast \
+                        --colorsrows= \
 			--sysfonts --nosysfonts \
 			--nostampcontrols --stampcontrols \
 			--nomagiccontrols --magiccontrols \