Syncing docs (README + EXTENDING) re: Text/Label "paste"

docs/CHANGES.txt

@@ -14,7 +14,6 @@ https://tuxpaint.org/
       a new line is created.  If text goes beyond the bottom of the
       canvas, the text is truncated there.
       - TODO: Improve word-wrapping (word-based, not character)
-      - TODO: Mention the feature in documentation
       Closes https://sourceforge.net/p/tuxpaint/feature-requests/95/
       Bill Kendrick <bill@newbreedsoftware.com>
 
@@ -29,6 +28,12 @@ https://tuxpaint.org/
       h/t Thomas Klausner for mentioning it.
       Bill Kendrick <bill@newbreedsoftware.com>
 
+  * Documentation updates:
+    ----------------------
+    * More complete description of Text & Label tools' on-screen keyboard
+      in README documentation.
+      Bill Kendrick <bill@newbreedsoftware.com>
+
   * Ports & Building:
     -----------------
     + Don't use Linux-specific invocation of "install"; use "mkdir" & "cp"

docs/en/EXTENDING.txt

@@ -5,7 +5,7 @@
         Copyright © 2002-2024 by various contributors; see AUTHORS.txt.
                              https://tuxpaint.org/
 
-                               October 10, 2024
+                               December 25, 2024
 
 +-----------------------------------------+
 |            Table of Contents            |
@@ -958,11 +958,11 @@ source code ("/src/im.c"), and requires updates to the Makefile, to ensure the
 On-screen Keyboard
 
 As of version 0.9.22, Tux Paint's 'Text' and 'Label' tools can present an
-on-screen keyboard that allows the pointer (via a mouse, eye-tracking systems,
+on-screen keyboard that allows the pointer (via a mouse, touch screen,
-etc.) to be used to input characters. Files that describe the layout and
+eye-tracking systems, etc.) to be used to input characters. Files that describe
-available keys are stored in Tux Paint "osk" directory. Each keyboard layout is
+the layout and available keys are stored in Tux Paint "osk" directory. Each
-defined by a number of files (some of which may be shared by different
+keyboard layout is defined by a number of files (some of which may be shared by
-layouts).
+different layouts).
 
 We'll use the QWERTY keyboard as an example:
 
@@ -979,7 +979,7 @@ and key mappings.
 
 ⚙ Note: Blank lines within the ".layout" file will be ignored, as will any text
 following a "#" (pound/hash) character — it can be used to denote comments, as
-seen in the example above.
+seen in the example below.
 
 The "keyboardlist" line describes which layouts to switch to, when the user
 clicks the left and right buttons on the keyboard. (See below.)
@@ -996,6 +996,9 @@ been pressed (one each for: no modifiers, [Shift], [AltGr], and [Shift] +
 (use "1") or [AltGr] (alternate graphics) key (use "2"), or not at all (use
 "0").
 
+The "NEWLINE" keyword is used to indicate the end of one row of the keyboard,
+and thus subsequent key layout descriptions will be beginning on a new row.
+
     WIDTH 15
     HEIGHT 5
 
@@ -1031,10 +1034,14 @@ been pressed (one each for: no modifiers, [Shift], [AltGr], and [Shift] +
     KEY 64 2.0 Alt Alt Alt Alt 0
 
     # Space
-    KEY 65 7.0 SPACE SPACE SPACE SPACE 0
+    KEY 65 5.0 SPACE SPACE SPACE SPACE 0
 
+    # AltGr
     KEY 108 2.0 AltGr AltGr AltGr AltGr 0
 
+    # Paste
+    KEY 143 2.0 Paste Paste Paste Paste 0
+
     # Arrow to right will change to the next keyboard
     KEY 1 1.0 -> -> -> -> 0
 
@@ -1048,6 +1055,11 @@ described below.
   * 1 — next layout (per the layout file's "keyboardlist" setting)
   * 2 — previous layout (per the layout file's "keyboardlist" setting)
 
+📜 Starting with Tux Paint 0.9.35, the XF86Paste keysym (value 143) can be used
+to initiate a copy/paste clipboard buffer "paste" event. See the "Paste" key in
+the keyboard layout files. (Pasting via a physical keyboard is initiated using
+the [Control] + [V] key combination.
+
             ### Keymap file ("us-intl-altgr-dead-keys.keymap") ###
 
 This file defines which numeric keycodes (seen in the keyboard layout files,

docs/en/README.txt

@@ -6,7 +6,7 @@
         Copyright © 2002-2024 by various contributors; see AUTHORS.txt.
                              https://tuxpaint.org/
 
-                               October 25, 2024
+                               December 25, 2024
 
 +-------------------------------------------------+
 |                Table of Contents                |
@@ -103,6 +103,9 @@ See COPYING.txt for the full text of the GPL license.
     Better behavior when clicking/tapping and dragging hue/saturation box and
     value slider.
      
+→ Text clipboard paste support ←
+    The "Text" and "Label" tools support pasting the copy/paste clipboard.
+     
 
 See CHANGES.txt for the complete list of changes.
 
@@ -489,6 +492,13 @@ e."Text" and "Label" Tools ←
     to the left. (This can be useful to create a line of text with mixed
     colors, fonts, styles and sizes.)
 
+    Text from the clipboard (copy/paste buffer) can be inserted with the "Text"
+    and "Label" tools by pressing the [Control] + [V] key combination on a
+    physical keyboard, or clicking the "Paste" button in Tux Paint's on-screen
+    keyboard. The text will wrap to the next line if it hits the right edge of
+    the canvas. If the text hits the bottom of the canvas, the pasting will
+    abort, truncating the text.
+
     Clicking elsewhere in the picture while the text entry is still active
     causes the current line of text to move to that location (where you can
     continue editing it).
@@ -527,6 +537,9 @@ e."Text" and "Label" Tools ←
         Tool" in Tux Paint Config. or running Tux Paint with the "nolabel"
         option).
 
+        📜 The ability to paste text from the clipboard was added in Tux Paint
+        0.9.35
+
 
          
     → International Character Input ←
@@ -560,7 +573,37 @@ e."Text" and "Label" Tools ←
 
         An optional on-screen keyboard is available for the Text and Label
         tools, which can provide a variety of layouts and character composition
-        (e.g., composing "a" and "e" into "æ").
+        (e.g., composing "a" and "e" into "æ"). Run Tux Paint with the
+        "--onscreen-keyboard" option, or enable that setting in Tux Paint's
+        configuration file, to enable it. Multiple layouts are offered
+        (currently "QWERTY" and "ABC"), which the user can switch between.
+        Additional configuration options allow specifying a default layout, as
+        well as preventing the layout from being changed.
+
+        The on-screen keyboard appears at the bottom or top of the Tux Paint
+        window, obscuring part of the canvas, depending on where the text
+        insertion cursor is placed. Along with alphabetic, numeric, and some
+        punctuation keys, the keyboard provides:
+          @ A "Backspace" key (⇐) to remove the previous character
+          @ A "Carriage Return" ("Return"/"Enter") key (⏎) to end the current
+            input and begin a new one on the following line (below and to the
+            left)
+          @ A "Tab" key (⇔) to end the current input and begin a new one at the
+            current cursor position
+          @ A "Shift" key (⇑) to shift alphabetic keys from lowercase to
+            uppercase, access more punctuation, etc.
+          @ A "Caps Lock" key (⤒) to toggle permanent shifting of alphabetic
+            keys from lowercase to uppercase (click it again to disable caps
+            lock)
+          @ A "Compose" key ("Cmp"), to initiate character composition (e.g.,
+            click "Cmp", "a", "e" to produce an "æ" character)
+          @ An "Alternate Graphics" key ("AltGr") to access additional
+            characters (e.g., "¿", "ß", etc.)
+          @ An "Alternate" key ("Alt")
+          @ A "Paste" key to paste the current clipboard's text into the Text
+            or Label tool
+          @ Left and right arrows (← & →) to access different on-screen
+            keyboard layouts
 
         ⚙ See the "Options" and "Extending Tux Paint" documentation for more
         information.

docs/en/html/EXTENDING.html

@@ -100,7 +100,7 @@
           </p>
     
           <p>
-            October 10, 2024          </p>
+            December 25, 2024          </p>
         </center>
       </header>
 
@@ -1118,7 +1118,7 @@
       </header>
 
       <p>
-        As of version 0.9.22, Tux Paint's 'Text' and 'Label' tools can present an on-screen keyboard that allows the pointer (via a mouse, eye-tracking systems, etc.) to be used to input characters. Files that describe the layout and available keys are stored in Tux Paint "<code>osk</code>" directory. Each keyboard layout is defined by a number of files (some of which may be shared by different layouts).      </p>
+        As of version 0.9.22, Tux Paint's 'Text' and 'Label' tools can present an on-screen keyboard that allows the pointer (via a mouse, touch screen, eye-tracking systems, etc.) to be used to input characters. Files that describe the layout and available keys are stored in Tux Paint "<code>osk</code>" directory. Each keyboard layout is defined by a number of files (some of which may be shared by different layouts).      </p>
       <p>
         We'll use the QWERTY keyboard as an example:      </p>
       
@@ -1142,7 +1142,7 @@
         </blockquote>
 
         <p class="note">
-          <span title="Configuration option">&#9881;</span>          <strong>Note:</strong> Blank lines within the "<code>.layout</code>" file will be ignored, as will any text following a "<code>#</code>" (pound/hash) character — it can be used to denote comments, as seen in the example above.        </p>
+          <span title="Configuration option">&#9881;</span>          <strong>Note:</strong> Blank lines within the "<code>.layout</code>" file will be ignored, as will any text following a "<code>#</code>" (pound/hash) character — it can be used to denote comments, as seen in the example below.        </p>
 
         <p>
           The "<code>keyboardlist</code>" line describes which layouts to switch to, when the user clicks the left and right buttons on the keyboard. (See below.)        </p>
@@ -1157,6 +1157,9 @@
         <p>
           This describes how big the keyboard is (as a "width × height" grid), and lists each key with its numeric keycode (see the "<code>keymap</code>" file, below), the width it should be drawn at (typically "<code>1.0</code>", to take one space on the keyboard, but in the example below, notice the "<code>TAB</code>" and "<code>SPACE</code>" keys are much wider), the character or text to display on the key, depending on which modifier keys have been pressed (one each for: no modifiers, <b><code>[Shift]</code></b>, <b><code>[AltGr]</code></b>, and <b><code>[Shift]</code></b> + <b><code>[AltGr]</code></b>), and finally whether or not the key is affected by the <b><code>[CapsLock]</code></b> key (use "<code>1</code>") or <b><code>[AltGr]</code></b> (alternate graphics) key (use "<code>2</code>"), or not at all (use "<code>0</code>").        </p>
 
+        <p>
+          The "<code>NEWLINE</code>" keyword is used to indicate the end of one row of the keyboard, and thus subsequent key layout descriptions will be beginning on a new row.        </p>
+
         <blockquote>
           <p>
             <code>WIDTH 15<br>
@@ -1193,10 +1196,14 @@
             KEY 64 2.0 Alt Alt Alt Alt 0<br>
             <br>
             # Space<br>
-            KEY 65 7.0 SPACE SPACE SPACE SPACE 0<br>
+            KEY 65 5.0 SPACE SPACE SPACE SPACE 0<br>
             <br>
+            # AltGr<br>
             KEY 108 2.0 AltGr AltGr AltGr AltGr 0<br>
             <br>
+            # Paste<br>
+            KEY 143 2.0 Paste Paste Paste Paste 0<br>
+            <br>
             # Arrow to right will change to the next keyboard<br>
             KEY 1 1.0 -&gt; -&gt; -&gt; -&gt; 0</code>
           </p>
@@ -1221,6 +1228,10 @@
             <code>2</code> —
                 previous layout (per the layout file's "<code>keyboardlist</code>" setting)          </li>
         </ul>
+
+        <p class="note">
+          <span title="Version variation">&#128220;</span>          Starting with Tux Paint 0.9.35, the <code>XF86Paste</code> keysym (value 143) can be used to initiate a copy/paste clipboard buffer "paste" event. See the "Paste" key in the keyboard layout files. (Pasting via a physical keyboard is initiated using the <code>[Control]</code> + <code>[V]</code> key combination.        </p>
+
       </section><!-- H2: Keyboard layout file ("qwerty.h_layout") -->
 
       <section><!-- H2: Keymap file ("us-intl-altgr-dead-keys.keymap") -->

docs/en/html/README.html

@@ -102,7 +102,7 @@
           </p>
 
           <p>
-            October 25, 2024          </p>
+            December 25, 2024          </p>
         </center>
       </header>
       <table border="2"
@@ -230,6 +230,9 @@
     <dl>
   <dt>Improved color picker</dt>
   <dd>Better behavior when clicking/tapping and dragging hue/saturation box and value slider.</dd>
+
+  <dt>Text clipboard paste support</dt>
+  <dd>The "Text" and "Label" tools support pasting the copy/paste clipboard.</dd>
 </dl>
 
     <p>
@@ -819,6 +822,9 @@
   <p>
     Alternatively, press <strong><code>[Tab]</code></strong> and the text will be drawn onto the picture, but the cursor will move to the right of the text, rather than down a line, and to the left. (This can be useful to create a line of text with mixed colors, fonts, styles and sizes.)  </p>
 
+  <p>
+    Text from the clipboard (copy/paste buffer) can be inserted with the "Text" and "Label" tools by pressing the <strong><code>[Control]</code> + <code>[V]</code></strong> key combination on a physical keyboard, or clicking the "<strong>Paste</strong>" button in Tux Paint's on-screen keyboard.  The text will wrap to the next line if it hits the right edge of the canvas.  If the text hits the bottom of the canvas, the pasting will abort, truncating the text.  </p>
+
   <p>
     Clicking elsewhere in the picture while the text entry is still active causes the current line of text to move to that location (where you can continue editing it).  </p>
 
@@ -849,6 +855,9 @@
 
       <p class="note">
         <span title="Configuration option">&#9881;</span>        The <strong>Label</strong> tool can be disabled (e.g., by selecting "Disable 'Label' Tool" in <em>Tux Paint Config.</em> or running <em>Tux Paint</em> with the "<code>nolabel</code>" option).      </p>
+
+      <p class="note">
+        <span title="Version variation">&#128220;</span>        The ability to paste text from the clipboard was added in Tux Paint 0.9.35      </p>
     </dd>
 
     <dt>
@@ -886,7 +895,23 @@
 
     <dd>
       <p>
-        An optional on-screen keyboard is available for the Text and Label tools, which can provide a variety of layouts and character composition (e.g., composing "a" and "e" into "æ").      </p>
+        An optional on-screen keyboard is available for the Text and Label tools, which can provide a variety of layouts and character composition (e.g., composing "a" and "e" into "æ").  Run Tux Paint with the "<code>--onscreen-keyboard</code>" option, or enable that setting in Tux Paint's configuration file, to enable it.  Multiple layouts are offered (currently "QWERTY" and "ABC"), which the user can switch between.  Additional configuration options allow specifying a default layout, as well as preventing the layout from being changed.      </p>
+
+      <p>
+        The on-screen keyboard appears at the bottom or top of the Tux Paint window, obscuring part of the canvas, depending on where the text insertion cursor is placed.  Along with alphabetic, numeric, and some punctuation keys, the keyboard provides:        <ul>
+          <li>A "Backspace" key (&#8656;) to remove the previous character</li>
+          <li>A "Carriage Return" ("Return"/"Enter") key (&#9166;) to end the current input and begin a new one on the following line (below and to the left)</li>
+          <li>A "Tab" key (&#8660;) to end the current input and begin a new one at the current cursor position</li>
+          <li>A "Shift" key (&#8657;) to shift alphabetic keys from lowercase to uppercase, access more punctuation, etc.</li>
+          <li>A "Caps Lock" key (&#10514;) to toggle permanent shifting of alphabetic keys from lowercase to uppercase (click it again to disable caps lock)</li>
+          <li>A "Compose" key ("Cmp"), to initiate character composition (e.g., click "Cmp", "a", "e" to produce an "æ" character)</li>
+          <li>An "Alternate Graphics" key ("AltGr") to access additional characters (e.g., "¿", "ß", etc.)</li>
+          <li>An "Alternate" key ("Alt")</li>
+          <li>A "Paste" key to paste the current clipboard's text into the Text or Label tool</li>
+          <li>Left and right arrows (&larr; &amp; &rarr;) to access different on-screen keyboard layouts</li>
+        </ul>
+      </p>
+
       <p class="note">
         <span title="Configuration option">&#9881;</span>        See the "<a href="OPTIONS.html"><em>Options</em></a>" and "<a href="EXTENDING.html"><em>Extending Tux Paint</em></a>" documentation for more information.      </p>
     </dd>

docs/es_ES.UTF-8/EXTENDING.txt

@@ -5,7 +5,7 @@
         Copyright © 2002-2024 by various contributors; see AUTHORS.txt.
                              https://tuxpaint.org/
 
-                               octubre 10, 2024
+                              diciembre 25, 2024
 
 +-----------------------------------------+
 |            Table of Contents            |
@@ -958,11 +958,11 @@ source code ("/src/im.c"), and requires updates to the Makefile, to ensure the
 On-screen Keyboard
 
 As of version 0.9.22, Tux Paint's 'Text' and 'Label' tools can present an
-on-screen keyboard that allows the pointer (via a mouse, eye-tracking systems,
+on-screen keyboard that allows the pointer (via a mouse, touch screen,
-etc.) to be used to input characters. Files that describe the layout and
+eye-tracking systems, etc.) to be used to input characters. Files that describe
-available keys are stored in Tux Paint "osk" directory. Each keyboard layout is
+the layout and available keys are stored in Tux Paint "osk" directory. Each
-defined by a number of files (some of which may be shared by different
+keyboard layout is defined by a number of files (some of which may be shared by
-layouts).
+different layouts).
 
 We'll use the QWERTY keyboard as an example:
 
@@ -979,7 +979,7 @@ and key mappings.
 
 ⚙ Note: Blank lines within the ".layout" file will be ignored, as will any text
 following a "#" (pound/hash) character — it can be used to denote comments, as
-seen in the example above.
+seen in the example below.
 
 The "keyboardlist" line describes which layouts to switch to, when the user
 clicks the left and right buttons on the keyboard. (See below.)
@@ -996,6 +996,9 @@ been pressed (one each for: no modifiers, [Shift], [AltGr], and [Shift] +
 (use "1") or [AltGr] (alternate graphics) key (use "2"), or not at all (use
 "0").
 
+The "NEWLINE" keyword is used to indicate the end of one row of the keyboard,
+and thus subsequent key layout descriptions will be beginning on a new row.
+
     WIDTH 15
     HEIGHT 5
 
@@ -1031,10 +1034,14 @@ been pressed (one each for: no modifiers, [Shift], [AltGr], and [Shift] +
     KEY 64 2.0 Alt Alt Alt Alt 0
 
     # Space
-    KEY 65 7.0 SPACE SPACE SPACE SPACE 0
+    KEY 65 5.0 SPACE SPACE SPACE SPACE 0
 
+    # AltGr
     KEY 108 2.0 AltGr AltGr AltGr AltGr 0
 
+    # Paste
+    KEY 143 2.0 Paste Paste Paste Paste 0
+
     # Arrow to right will change to the next keyboard
     KEY 1 1.0 -> -> -> -> 0
 
@@ -1048,6 +1055,11 @@ described below.
   * 1 — next layout (per the layout file's "keyboardlist" setting)
   * 2 — previous layout (per the layout file's "keyboardlist" setting)
 
+📜 Starting with Tux Paint 0.9.35, the XF86Paste keysym (value 143) can be used
+to initiate a copy/paste clipboard buffer "paste" event. See the "Paste" key in
+the keyboard layout files. (Pasting via a physical keyboard is initiated using
+the [Control] + [V] key combination.
+
             ### Keymap file ("us-intl-altgr-dead-keys.keymap") ###
 
 This file defines which numeric keycodes (seen in the keyboard layout files,

docs/es_ES.UTF-8/README.txt

@@ -6,7 +6,7 @@
         Copyright © 2002-2024 by various contributors; see AUTHORS.txt.
                              https://tuxpaint.org/
 
-                               octubre 25, 2024
+                              diciembre 25, 2024
 
 +-------------------------------------------------+
 |                Table of Contents                |
@@ -103,6 +103,9 @@ See COPYING.txt for the full text of the GPL license.
     Better behavior when clicking/tapping and dragging hue/saturation box and
     value slider.
      
+→ Text clipboard paste support ←
+    The "Text" and "Label" tools support pasting the copy/paste clipboard.
+     
 
 See CHANGES.txt for the complete list of changes.
 
@@ -489,6 +492,13 @@ e."Text" and "Label" Tools ←
     to the left. (This can be useful to create a line of text with mixed
     colors, fonts, styles and sizes.)
 
+    Text from the clipboard (copy/paste buffer) can be inserted with the "Text"
+    and "Label" tools by pressing the [Control] + [V] key combination on a
+    physical keyboard, or clicking the "Paste" button in Tux Paint's on-screen
+    keyboard. The text will wrap to the next line if it hits the right edge of
+    the canvas. If the text hits the bottom of the canvas, the pasting will
+    abort, truncating the text.
+
     Clicking elsewhere in the picture while the text entry is still active
     causes the current line of text to move to that location (where you can
     continue editing it).
@@ -527,6 +537,9 @@ e."Text" and "Label" Tools ←
         Tool" in Tux Paint Config. or running Tux Paint with the "nolabel"
         option).
 
+        📜 The ability to paste text from the clipboard was added in Tux Paint
+        0.9.35
+
 
          
     → International Character Input ←
@@ -560,7 +573,37 @@ e."Text" and "Label" Tools ←
 
         An optional on-screen keyboard is available for the Text and Label
         tools, which can provide a variety of layouts and character composition
-        (e.g., composing "a" and "e" into "æ").
+        (e.g., composing "a" and "e" into "æ"). Run Tux Paint with the
+        "--onscreen-keyboard" option, or enable that setting in Tux Paint's
+        configuration file, to enable it. Multiple layouts are offered
+        (currently "QWERTY" and "ABC"), which the user can switch between.
+        Additional configuration options allow specifying a default layout, as
+        well as preventing the layout from being changed.
+
+        The on-screen keyboard appears at the bottom or top of the Tux Paint
+        window, obscuring part of the canvas, depending on where the text
+        insertion cursor is placed. Along with alphabetic, numeric, and some
+        punctuation keys, the keyboard provides:
+          @ A "Backspace" key (⇐) to remove the previous character
+          @ A "Carriage Return" ("Return"/"Enter") key (⏎) to end the current
+            input and begin a new one on the following line (below and to the
+            left)
+          @ A "Tab" key (⇔) to end the current input and begin a new one at the
+            current cursor position
+          @ A "Shift" key (⇑) to shift alphabetic keys from lowercase to
+            uppercase, access more punctuation, etc.
+          @ A "Caps Lock" key (⤒) to toggle permanent shifting of alphabetic
+            keys from lowercase to uppercase (click it again to disable caps
+            lock)
+          @ A "Compose" key ("Cmp"), to initiate character composition (e.g.,
+            click "Cmp", "a", "e" to produce an "æ" character)
+          @ An "Alternate Graphics" key ("AltGr") to access additional
+            characters (e.g., "¿", "ß", etc.)
+          @ An "Alternate" key ("Alt")
+          @ A "Paste" key to paste the current clipboard's text into the Text
+            or Label tool
+          @ Left and right arrows (← & →) to access different on-screen
+            keyboard layouts
 
         ⚙ See the "Options" and "Extending Tux Paint" documentation for more
         information.

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

@@ -100,7 +100,7 @@
           </p>
     
           <p>
-            octubre 10, 2024          </p>
+            diciembre 25, 2024          </p>
         </center>
       </header>
 
@@ -1118,7 +1118,7 @@
       </header>
 
       <p>
-        As of version 0.9.22, Tux Paint's 'Text' and 'Label' tools can present an on-screen keyboard that allows the pointer (via a mouse, eye-tracking systems, etc.) to be used to input characters. Files that describe the layout and available keys are stored in Tux Paint "<code>osk</code>" directory. Each keyboard layout is defined by a number of files (some of which may be shared by different layouts).      </p>
+        As of version 0.9.22, Tux Paint's 'Text' and 'Label' tools can present an on-screen keyboard that allows the pointer (via a mouse, touch screen, eye-tracking systems, etc.) to be used to input characters. Files that describe the layout and available keys are stored in Tux Paint "<code>osk</code>" directory. Each keyboard layout is defined by a number of files (some of which may be shared by different layouts).      </p>
       <p>
         We'll use the QWERTY keyboard as an example:      </p>
       
@@ -1142,7 +1142,7 @@
         </blockquote>
 
         <p class="note">
-          <span title="Configuration option">&#9881;</span>          <strong>Note:</strong> Blank lines within the "<code>.layout</code>" file will be ignored, as will any text following a "<code>#</code>" (pound/hash) character — it can be used to denote comments, as seen in the example above.        </p>
+          <span title="Configuration option">&#9881;</span>          <strong>Note:</strong> Blank lines within the "<code>.layout</code>" file will be ignored, as will any text following a "<code>#</code>" (pound/hash) character — it can be used to denote comments, as seen in the example below.        </p>
 
         <p>
           The "<code>keyboardlist</code>" line describes which layouts to switch to, when the user clicks the left and right buttons on the keyboard. (See below.)        </p>
@@ -1157,6 +1157,9 @@
         <p>
           This describes how big the keyboard is (as a "width × height" grid), and lists each key with its numeric keycode (see the "<code>keymap</code>" file, below), the width it should be drawn at (typically "<code>1.0</code>", to take one space on the keyboard, but in the example below, notice the "<code>TAB</code>" and "<code>SPACE</code>" keys are much wider), the character or text to display on the key, depending on which modifier keys have been pressed (one each for: no modifiers, <b><code>[Shift]</code></b>, <b><code>[AltGr]</code></b>, and <b><code>[Shift]</code></b> + <b><code>[AltGr]</code></b>), and finally whether or not the key is affected by the <b><code>[CapsLock]</code></b> key (use "<code>1</code>") or <b><code>[AltGr]</code></b> (alternate graphics) key (use "<code>2</code>"), or not at all (use "<code>0</code>").        </p>
 
+        <p>
+          The "<code>NEWLINE</code>" keyword is used to indicate the end of one row of the keyboard, and thus subsequent key layout descriptions will be beginning on a new row.        </p>
+
         <blockquote>
           <p>
             <code>WIDTH 15<br>
@@ -1193,10 +1196,14 @@
             KEY 64 2.0 Alt Alt Alt Alt 0<br>
             <br>
             # Space<br>
-            KEY 65 7.0 SPACE SPACE SPACE SPACE 0<br>
+            KEY 65 5.0 SPACE SPACE SPACE SPACE 0<br>
             <br>
+            # AltGr<br>
             KEY 108 2.0 AltGr AltGr AltGr AltGr 0<br>
             <br>
+            # Paste<br>
+            KEY 143 2.0 Paste Paste Paste Paste 0<br>
+            <br>
             # Arrow to right will change to the next keyboard<br>
             KEY 1 1.0 -&gt; -&gt; -&gt; -&gt; 0</code>
           </p>
@@ -1221,6 +1228,10 @@
             <code>2</code> —
                 previous layout (per the layout file's "<code>keyboardlist</code>" setting)          </li>
         </ul>
+
+        <p class="note">
+          <span title="Version variation">&#128220;</span>          Starting with Tux Paint 0.9.35, the <code>XF86Paste</code> keysym (value 143) can be used to initiate a copy/paste clipboard buffer "paste" event. See the "Paste" key in the keyboard layout files. (Pasting via a physical keyboard is initiated using the <code>[Control]</code> + <code>[V]</code> key combination.        </p>
+
       </section><!-- H2: Keyboard layout file ("qwerty.h_layout") -->
 
       <section><!-- H2: Keymap file ("us-intl-altgr-dead-keys.keymap") -->

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

@@ -102,7 +102,7 @@
           </p>
 
           <p>
-            octubre 25, 2024          </p>
+            diciembre 25, 2024          </p>
         </center>
       </header>
       <table border="2"
@@ -230,6 +230,9 @@
     <dl>
   <dt>Improved color picker</dt>
   <dd>Better behavior when clicking/tapping and dragging hue/saturation box and value slider.</dd>
+
+  <dt>Text clipboard paste support</dt>
+  <dd>The "Text" and "Label" tools support pasting the copy/paste clipboard.</dd>
 </dl>
 
     <p>
@@ -819,6 +822,9 @@
   <p>
     Alternatively, press <strong><code>[Tab]</code></strong> and the text will be drawn onto the picture, but the cursor will move to the right of the text, rather than down a line, and to the left. (This can be useful to create a line of text with mixed colors, fonts, styles and sizes.)  </p>
 
+  <p>
+    Text from the clipboard (copy/paste buffer) can be inserted with the "Text" and "Label" tools by pressing the <strong><code>[Control]</code> + <code>[V]</code></strong> key combination on a physical keyboard, or clicking the "<strong>Paste</strong>" button in Tux Paint's on-screen keyboard.  The text will wrap to the next line if it hits the right edge of the canvas.  If the text hits the bottom of the canvas, the pasting will abort, truncating the text.  </p>
+
   <p>
     Clicking elsewhere in the picture while the text entry is still active causes the current line of text to move to that location (where you can continue editing it).  </p>
 
@@ -849,6 +855,9 @@
 
       <p class="note">
         <span title="Configuration option">&#9881;</span>        The <strong>Label</strong> tool can be disabled (e.g., by selecting "Disable 'Label' Tool" in <em>Tux Paint Config.</em> or running <em>Tux Paint</em> with the "<code>nolabel</code>" option).      </p>
+
+      <p class="note">
+        <span title="Version variation">&#128220;</span>        The ability to paste text from the clipboard was added in Tux Paint 0.9.35      </p>
     </dd>
 
     <dt>
@@ -886,7 +895,23 @@
 
     <dd>
       <p>
-        An optional on-screen keyboard is available for the Text and Label tools, which can provide a variety of layouts and character composition (e.g., composing "a" and "e" into "æ").      </p>
+        An optional on-screen keyboard is available for the Text and Label tools, which can provide a variety of layouts and character composition (e.g., composing "a" and "e" into "æ").  Run Tux Paint with the "<code>--onscreen-keyboard</code>" option, or enable that setting in Tux Paint's configuration file, to enable it.  Multiple layouts are offered (currently "QWERTY" and "ABC"), which the user can switch between.  Additional configuration options allow specifying a default layout, as well as preventing the layout from being changed.      </p>
+
+      <p>
+        The on-screen keyboard appears at the bottom or top of the Tux Paint window, obscuring part of the canvas, depending on where the text insertion cursor is placed.  Along with alphabetic, numeric, and some punctuation keys, the keyboard provides:        <ul>
+          <li>A "Backspace" key (&#8656;) to remove the previous character</li>
+          <li>A "Carriage Return" ("Return"/"Enter") key (&#9166;) to end the current input and begin a new one on the following line (below and to the left)</li>
+          <li>A "Tab" key (&#8660;) to end the current input and begin a new one at the current cursor position</li>
+          <li>A "Shift" key (&#8657;) to shift alphabetic keys from lowercase to uppercase, access more punctuation, etc.</li>
+          <li>A "Caps Lock" key (&#10514;) to toggle permanent shifting of alphabetic keys from lowercase to uppercase (click it again to disable caps lock)</li>
+          <li>A "Compose" key ("Cmp"), to initiate character composition (e.g., click "Cmp", "a", "e" to produce an "æ" character)</li>
+          <li>An "Alternate Graphics" key ("AltGr") to access additional characters (e.g., "¿", "ß", etc.)</li>
+          <li>An "Alternate" key ("Alt")</li>
+          <li>A "Paste" key to paste the current clipboard's text into the Text or Label tool</li>
+          <li>Left and right arrows (&larr; &amp; &rarr;) to access different on-screen keyboard layouts</li>
+        </ul>
+      </p>
+
       <p class="note">
         <span title="Configuration option">&#9881;</span>        See the "<a href="OPTIONS.html"><em>Options</em></a>" and "<a href="EXTENDING.html"><em>Extending Tux Paint</em></a>" documentation for more information.      </p>
     </dd>

docs/fr_FR.UTF-8/EXTENDING.txt

@@ -5,7 +5,7 @@
        Copyright © 2002-2024 by divers contributeurs; voir AUTHORS.txt.
                              https://tuxpaint.org/
 
-                               octobre 10, 2024
+                               décembre 25, 2024
 
 +-------------------------------------------------------------+
 |                     Table des matières                      |
@@ -1015,13 +1015,12 @@ jour de Makefile, pour s'assurer que les fichiers ".im" sont disponibles pour
 
 Clavier virtuel sur écran
 
-Depuis la version 0.9.22, les outils «Texte» et «Étiquette» de Tux Paint
+As of version 0.9.22, Tux Paint's 'Text' and 'Label' tools can present an
-peuvent présenter un clavier à l'écran qui permet d'utiliser le pointeur (via
+on-screen keyboard that allows the pointer (via a mouse, touch screen,
-une souris, des systèmes de suivi oculaire, etc.) pour saisir des caractères.
+eye-tracking systems, etc.) to be used to input characters. Files that describe
-Les fichiers qui décrivent la mise en page et les clés disponibles sont stockés
+the layout and available keys are stored in Tux Paint "osk" directory. Each
-dans le répertoire "osk" de Tux Paint . Chaque disposition de clavier est
+keyboard layout is defined by a number of files (some of which may be shared by
-définie par un certain nombre de fichiers (dont certains peuvent être partagés
+different layouts).
-par différentes dispositions).
 
 Nous utiliserons le clavier QWERTY comme exemple :
 
@@ -1036,9 +1035,9 @@ décrire l'agencement et la disposition des touches.
     keysymdefs keysymdef.h
     keyboardlist qwerty.layout default.layout
 
-⚙ RemarqueLes lignes vides du fichier ".layout" sont ignorées, aussi bien que
+⚙ Note: Blank lines within the ".layout" file will be ignored, as will any text
-les lignes commençant par le caractère "#" ( livre/dièse)-- on peut l'utiliser
+following a "#" (pound/hash) character — it can be used to denote comments, as
-pour ajouter des commentaires, comme dans l'exemple ci-dessus.
+seen in the example below.
 
 La ligne "keyboardlist" décrit les dispositions vers lesquelles on bascule
 lorsque l'utilisateur clique sur les boutons gauche et droit du clavier. (Voir
@@ -1057,6 +1056,9 @@ afficher sur la touche, selon les touches de modification qui ont été enfoncé
 (utilisez "1") ou [AltGr] (alt graphiques alternatifs) (utilisez "2"), ou pas
 du tout (utilisez "0").
 
+The "NEWLINE" keyword is used to indicate the end of one row of the keyboard,
+and thus subsequent key layout descriptions will be beginning on a new row.
+
     WIDTH 15
     HEIGHT 5
 
@@ -1092,10 +1094,14 @@ du tout (utilisez "0").
     KEY 64 2.0 Alt Alt Alt Alt 0
 
     # Espace
-    KEY 65 7.0 SPACE SPACE SPACE SPACE 0
+    KEY 65 5.0 SPACE SPACE SPACE SPACE 0
 
+    # AltGr
     KEY 108 2.0 AltGr AltGr AltGr AltGr 0
 
+    # Paste
+    KEY 143 2.0 Paste Paste Paste Paste 0
+
     # Flèche droite pour aller au clavier suivant
     KEY 1 1.0 -> -> -> -> 0
 
@@ -1112,6 +1118,11 @@ utilisés sont décrits ci-dessous.
   * 2 — disposition précédente (pour le réglage "keyboardlist" du fichier
     d'agencement)
 
+📜 Starting with Tux Paint 0.9.35, the XF86Paste keysym (value 143) can be used
+to initiate a copy/paste clipboard buffer "paste" event. See the "Paste" key in
+the keyboard layout files. (Pasting via a physical keyboard is initiated using
+the [Control] + [V] key combination.
+
            ### Fichier keymap ("us-intl-altgr-dead-keys.keymap") ###
 
 Ce fichier définit quels codes de touches numériques (vus dans les fichiers de

docs/fr_FR.UTF-8/README.txt

@@ -6,7 +6,7 @@
        Copyright © 2002-2024 by divers contributeurs; voir AUTHORS.txt.
                              https://tuxpaint.org/
 
-                               octobre 25, 2024
+                               décembre 25, 2024
 
 +-------------------------------------------------------+
 |                  Table des matières                   |
@@ -108,6 +108,9 @@ Voir COPYING.txt pour le texte complet de la licence GPL.
     Better behavior when clicking/tapping and dragging hue/saturation box and
     value slider.
      
+→ Text clipboard paste support ←
+    The "Text" and "Label" tools support pasting the copy/paste clipboard.
+     
 
 Voir CHANGES.txt pour la liste complète des changements.
 
@@ -519,6 +522,13 @@ e.Outils "Texte" et "Étiquette" ←
     ligne et vers la gauche. (Cela peut être utile pour créer une ligne de
     texte avec des couleurs, des polices, des styles et des tailles variés.)
 
+    Text from the clipboard (copy/paste buffer) can be inserted with the "Text"
+    and "Label" tools by pressing the [Control] + [V] key combination on a
+    physical keyboard, or clicking the "Paste" button in Tux Paint's on-screen
+    keyboard. The text will wrap to the next line if it hits the right edge of
+    the canvas. If the text hits the bottom of the canvas, the pasting will
+    abort, truncating the text.
+
     Cliquer ailleurs dans l'image alors que l'entrée de texte est toujours
     active entraîne le déplacement de la ligne de texte actuelle vers cet
     emplacement (et vous pouvez continuer à la modifier).
@@ -559,6 +569,9 @@ e.Outils "Texte" et "Étiquette" ←
         "Désactiver l'outil 'Label'" dans Tux Paint Config ou bien en exécutant
         Tux Paint en ligne de commande avec l'option "nolabel").
 
+        📜 The ability to paste text from the clipboard was added in Tux Paint
+        0.9.35
+
 
          
     → Saisie de caractères internationaux ←
@@ -591,9 +604,39 @@ e.Outils "Texte" et "Étiquette" ←
          
     → Clavier virtuel sur écran ←
 
-        Un clavier virtuel sur écran (optionnel) est disponible pour les outils
+        An optional on-screen keyboard is available for the Text and Label
-        "Texte" et "Étiquette", qui peut présenter une palette de dispositions
+        tools, which can provide a variety of layouts and character composition
-        et de création de caractères (par ex "a" et "e" pour "æ").
+        (e.g., composing "a" and "e" into "æ"). Run Tux Paint with the
+        "--onscreen-keyboard" option, or enable that setting in Tux Paint's
+        configuration file, to enable it. Multiple layouts are offered
+        (currently "QWERTY" and "ABC"), which the user can switch between.
+        Additional configuration options allow specifying a default layout, as
+        well as preventing the layout from being changed.
+
+        The on-screen keyboard appears at the bottom or top of the Tux Paint
+        window, obscuring part of the canvas, depending on where the text
+        insertion cursor is placed. Along with alphabetic, numeric, and some
+        punctuation keys, the keyboard provides:
+          @ A "Backspace" key (⇐) to remove the previous character
+          @ A "Carriage Return" ("Return"/"Enter") key (⏎) to end the current
+            input and begin a new one on the following line (below and to the
+            left)
+          @ A "Tab" key (⇔) to end the current input and begin a new one at the
+            current cursor position
+          @ A "Shift" key (⇑) to shift alphabetic keys from lowercase to
+            uppercase, access more punctuation, etc.
+          @ A "Caps Lock" key (⤒) to toggle permanent shifting of alphabetic
+            keys from lowercase to uppercase (click it again to disable caps
+            lock)
+          @ A "Compose" key ("Cmp"), to initiate character composition (e.g.,
+            click "Cmp", "a", "e" to produce an "æ" character)
+          @ An "Alternate Graphics" key ("AltGr") to access additional
+            characters (e.g., "¿", "ß", etc.)
+          @ An "Alternate" key ("Alt")
+          @ A "Paste" key to paste the current clipboard's text into the Text
+            or Label tool
+          @ Left and right arrows (← & →) to access different on-screen
+            keyboard layouts
 
         ⚙ Voir les documents "Options" et "Extension de Tux Paint" pour plus
         d'informations.

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

@@ -100,7 +100,7 @@
           </p>
     
           <p>
-            octobre 10, 2024          </p>
+            décembre 25, 2024          </p>
         </center>
       </header>
 
@@ -1118,7 +1118,7 @@
       </header>
 
       <p>
-        Depuis la version 0.9.22, les outils «Texte» et «Étiquette» de Tux Paint peuvent présenter un clavier à l'écran qui permet d'utiliser le pointeur (via une souris, des systèmes de suivi oculaire, etc.) pour saisir des caractères. Les fichiers qui décrivent la mise en page et les clés disponibles sont stockés dans le répertoire "<code>osk</code>" de Tux Paint . Chaque disposition de clavier est définie par un certain nombre de fichiers (dont certains peuvent être partagés par différentes dispositions).      </p>
+        As of version 0.9.22, Tux Paint's 'Text' and 'Label' tools can present an on-screen keyboard that allows the pointer (via a mouse, touch screen, eye-tracking systems, etc.) to be used to input characters. Files that describe the layout and available keys are stored in Tux Paint "<code>osk</code>" directory. Each keyboard layout is defined by a number of files (some of which may be shared by different layouts).      </p>
       <p>
         Nous utiliserons le clavier QWERTY comme exemple :      </p>
       
@@ -1142,7 +1142,7 @@
         </blockquote>
 
         <p class="note">
-          <span title="Configuration option">&#9881;</span>          <strong>Remarque</strong>Les lignes vides du fichier "<code>.layout</code>" sont ignorées, aussi bien que les lignes commençant par le caractère "<code>#</code>" ( livre/dièse)-- on peut l'utiliser pour ajouter des commentaires, comme dans l'exemple ci-dessus.        </p>
+          <span title="Configuration option">&#9881;</span>          <strong>Note:</strong> Blank lines within the "<code>.layout</code>" file will be ignored, as will any text following a "<code>#</code>" (pound/hash) character — it can be used to denote comments, as seen in the example below.        </p>
 
         <p>
           La ligne "<code>keyboardlist</code>" décrit les dispositions vers lesquelles on bascule lorsque l'utilisateur clique sur les boutons gauche et droit du clavier. (Voir ci-dessous.)        </p>
@@ -1157,6 +1157,9 @@
         <p>
           Ceci décrit la taille du clavier (sous forme de grille L × H), et répertorie chaque touche avec son code numérique (voir le fichier "<code>keymap</code>", ci-dessous), la largeur à laquelle il doit être dessiné (généralement "<code>1.0</code>", pour en prendre un espace sur le clavier, mais dans l'exemple ci-dessous, notez que les touches "<code>TAB</code>" et "<code>SPACE</code>" sont beaucoup plus larges), le caractère ou le texte à afficher sur la touche, selon les touches de modification qui ont été enfoncées (une pour chacune : pas de modificateurs, <b><code>[Shift]</code></b> , <b><code>[AltGr]</code></b> et <b><code>[Shift]</code></b> + <b><code>[AltGr]</code></b> ), et enfin si la touche est affectée ou non par la touche <b><code>[CapsLock]</code></b> (utilisez "<code>1</code>") ou <b><code>[AltGr]</code></b> (alt graphiques alternatifs) (utilisez "<code>2</code>"), ou pas du tout (utilisez "<code>0</code>").        </p>
 
+        <p>
+          The "<code>NEWLINE</code>" keyword is used to indicate the end of one row of the keyboard, and thus subsequent key layout descriptions will be beginning on a new row.        </p>
+
         <blockquote>
           <p>
             <code>WIDTH 15<br>
@@ -1193,10 +1196,14 @@
             KEY 64 2.0 Alt Alt Alt Alt 0<br>
             <br>
             # Espace<br>
-            KEY 65 7.0 SPACE SPACE SPACE SPACE 0<br>
+            KEY 65 5.0 SPACE SPACE SPACE SPACE 0<br>
             <br>
+            # AltGr<br>
             KEY 108 2.0 AltGr AltGr AltGr AltGr 0<br>
             <br>
+            # Paste<br>
+            KEY 143 2.0 Paste Paste Paste Paste 0<br>
+            <br>
             # Flèche droite pour aller au clavier suivant<br>
             KEY 1 1.0 -&gt; -&gt; -&gt; -&gt; 0</code>
           </p>
@@ -1221,6 +1228,10 @@
             <code>2</code> —
                 disposition précédente (pour le réglage "<code>keyboardlist</code>" du fichier d'agencement)          </li>
         </ul>
+
+        <p class="note">
+          <span title="Version variation">&#128220;</span>          Starting with Tux Paint 0.9.35, the <code>XF86Paste</code> keysym (value 143) can be used to initiate a copy/paste clipboard buffer "paste" event. See the "Paste" key in the keyboard layout files. (Pasting via a physical keyboard is initiated using the <code>[Control]</code> + <code>[V]</code> key combination.        </p>
+
       </section><!-- H2: Keyboard layout file ("qwerty.h_layout") -->
 
       <section><!-- H2: Keymap file ("us-intl-altgr-dead-keys.keymap") -->

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

@@ -102,7 +102,7 @@
           </p>
 
           <p>
-            octobre 25, 2024          </p>
+            décembre 25, 2024          </p>
         </center>
       </header>
       <table border="2"
@@ -230,6 +230,9 @@
     <dl>
   <dt>Improved color picker</dt>
   <dd>Better behavior when clicking/tapping and dragging hue/saturation box and value slider.</dd>
+
+  <dt>Text clipboard paste support</dt>
+  <dd>The "Text" and "Label" tools support pasting the copy/paste clipboard.</dd>
 </dl>
 
     <p>
@@ -819,6 +822,9 @@
   <p>
     Sinon, appuyez sur <strong><code>[Tab]</code></strong> et le texte sera inclus dans l'image, mais le curseur se déplacera vers la droite du texte, plutôt que vers le bas d'une ligne et vers la gauche. (Cela peut être utile pour créer une ligne de texte avec des couleurs, des polices, des styles et des tailles variés.)  </p>
 
+  <p>
+    Text from the clipboard (copy/paste buffer) can be inserted with the "Text" and "Label" tools by pressing the <strong><code>[Control]</code> + <code>[V]</code></strong> key combination on a physical keyboard, or clicking the "<strong>Paste</strong>" button in Tux Paint's on-screen keyboard.  The text will wrap to the next line if it hits the right edge of the canvas.  If the text hits the bottom of the canvas, the pasting will abort, truncating the text.  </p>
+
   <p>
     Cliquer ailleurs dans l'image alors que l'entrée de texte est toujours active entraîne le déplacement de la ligne de texte actuelle vers cet emplacement (et vous pouvez continuer à la modifier).  </p>
 
@@ -849,6 +855,9 @@
 
       <p class="note">
         <span title="Configuration option">&#9881;</span>        L' outil <strong>Étiquette</strong> peut être désactivé (par exemple, en sélectionnant "Désactiver l'outil 'Label'" dans Tux Paint Config ou bien en exécutant Tux Paint en ligne de commande avec l'option  "<code>nolabel</code>").      </p>
+
+      <p class="note">
+        <span title="Version variation">&#128220;</span>        The ability to paste text from the clipboard was added in Tux Paint 0.9.35      </p>
     </dd>
 
     <dt>
@@ -886,7 +895,23 @@
 
     <dd>
       <p>
-        Un clavier virtuel sur écran (optionnel) est disponible pour les outils "Texte" et "Étiquette", qui peut présenter une palette de dispositions et de création de caractères (par ex "a" et "e" pour "æ").      </p>
+        An optional on-screen keyboard is available for the Text and Label tools, which can provide a variety of layouts and character composition (e.g., composing "a" and "e" into "æ").  Run Tux Paint with the "<code>--onscreen-keyboard</code>" option, or enable that setting in Tux Paint's configuration file, to enable it.  Multiple layouts are offered (currently "QWERTY" and "ABC"), which the user can switch between.  Additional configuration options allow specifying a default layout, as well as preventing the layout from being changed.      </p>
+
+      <p>
+        The on-screen keyboard appears at the bottom or top of the Tux Paint window, obscuring part of the canvas, depending on where the text insertion cursor is placed.  Along with alphabetic, numeric, and some punctuation keys, the keyboard provides:        <ul>
+          <li>A "Backspace" key (&#8656;) to remove the previous character</li>
+          <li>A "Carriage Return" ("Return"/"Enter") key (&#9166;) to end the current input and begin a new one on the following line (below and to the left)</li>
+          <li>A "Tab" key (&#8660;) to end the current input and begin a new one at the current cursor position</li>
+          <li>A "Shift" key (&#8657;) to shift alphabetic keys from lowercase to uppercase, access more punctuation, etc.</li>
+          <li>A "Caps Lock" key (&#10514;) to toggle permanent shifting of alphabetic keys from lowercase to uppercase (click it again to disable caps lock)</li>
+          <li>A "Compose" key ("Cmp"), to initiate character composition (e.g., click "Cmp", "a", "e" to produce an "æ" character)</li>
+          <li>An "Alternate Graphics" key ("AltGr") to access additional characters (e.g., "¿", "ß", etc.)</li>
+          <li>An "Alternate" key ("Alt")</li>
+          <li>A "Paste" key to paste the current clipboard's text into the Text or Label tool</li>
+          <li>Left and right arrows (&larr; &amp; &rarr;) to access different on-screen keyboard layouts</li>
+        </ul>
+      </p>
+
       <p class="note">
         <span title="Configuration option">&#9881;</span>        Voir les documents "<a href="OPTIONS.html"><em>Options</em></a>" et "<a href="EXTENDING.html"><em>Extension de Tux Paint</em></a>" pour plus d'informations.      </p>
     </dd>

docs/gl_ES.UTF-8/EXTENDING.txt

@@ -5,7 +5,7 @@
         Copyright © 2002-2024 by varios colaboradores; see AUTHORS.txt.
                              https://tuxpaint.org/
 
-                             10 de Outubro de 2024
+                            25 de Decembro de 2024
 
 +-------------------------------------------------------------+
 |                           Índice                            |
@@ -981,13 +981,12 @@ de execución.
 
 Teclado en pantalla
 
-A partir da versión 0.9.22, as ferramentas «Texto» e «Etiqueta» de Tux Paint
+As of version 0.9.22, Tux Paint's 'Text' and 'Label' tools can present an
-poden presentar un teclado en pantalla que permite utilizar o punteiro
+on-screen keyboard that allows the pointer (via a mouse, touch screen,
-(mediante un rato, sistemas de seguimento de ollos, etc.) para introducir
+eye-tracking systems, etc.) to be used to input characters. Files that describe
-caracteres. Os ficheiros que describen o deseño e as claves dispoñíbeis
+the layout and available keys are stored in Tux Paint "osk" directory. Each
-almacénanse no directorio «osk» de Tux Paint. Cada deseño de teclado está
+keyboard layout is defined by a number of files (some of which may be shared by
-definido por varios ficheiros (algúns dos cales poden ser compartidos por
+different layouts).
-diferentes deseños).
 
 Usaremos o teclado QWERTY como exemplo:
 
@@ -1004,7 +1003,7 @@ describir a disposición e as asignacións de teclas.
 
 ⚙ Note: Blank lines within the ".layout" file will be ignored, as will any text
 following a "#" (pound/hash) character — it can be used to denote comments, as
-seen in the example above.
+seen in the example below.
 
 A liña «keyboardlist» describe a que esquemas cambiar, cando o usuario preme
 nos botóns esquerdo e dereito do teclado. (Ver máis abaixo.)
@@ -1021,6 +1020,9 @@ modificadores,[Maiúsculas],[AltGr] e [Maiúsculas] + [AltGr]) e, finalmente, se
 a tecla está afectada ou non pola tecla [BloqMaiús] (use «1») ou a tecla
 [AltGr] (gráficos alternativos) ( use «2»), ou non (use «0»).
 
+The "NEWLINE" keyword is used to indicate the end of one row of the keyboard,
+and thus subsequent key layout descriptions will be beginning on a new row.
+
     WIDTH 15
     HEIGHT 5
 
@@ -1056,10 +1058,14 @@ a tecla está afectada ou non pola tecla [BloqMaiús] (use «1») ou a tecla
     KEY 64 2.0 Alt Alt Alt Alt 0
 
     # Espazo
-    KEY 65 7.0 SPACE SPACE SPACE SPACE 0
+    KEY 65 5.0 SPACE SPACE SPACE SPACE 0
 
+    # AltGr
     KEY 108 2.0 AltGr AltGr AltGr AltGr 0
 
+    # Paste
+    KEY 143 2.0 Paste Paste Paste Paste 0
+
     # A frecha cara á dereita cambiará ao seguinte teclado
     KEY 1 1.0 -> -> -> -> 0
 
@@ -1076,6 +1082,11 @@ actualmente descríbense a continuación.
   * 2 — disposición anterior (segundo o axuste «keyboardlist» do ficheiro de
     disposición)
 
+📜 Starting with Tux Paint 0.9.35, the XF86Paste keysym (value 143) can be used
+to initiate a copy/paste clipboard buffer "paste" event. See the "Paste" key in
+the keyboard layout files. (Pasting via a physical keyboard is initiated using
+the [Control] + [V] key combination.
+
     ### Ficheiro do mapa do teclado («us-intl-altgr-dead-keys.keymap») ###
 
 Este ficheiro define que códigos das teclas numéricas (vistos nos ficheiros de

docs/gl_ES.UTF-8/README.txt

@@ -6,7 +6,7 @@
         Copyright © 2002-2024 by varios colaboradores; see AUTHORS.txt.
                              https://tuxpaint.org/
 
-                             25 de Outubro de 2024
+                            25 de Decembro de 2024
 
 +--------------------------------------------------------+
 |                         Índice                         |
@@ -104,6 +104,9 @@ Consulte o texto completo da licenza GPL en COPYING.txt.
     Better behavior when clicking/tapping and dragging hue/saturation box and
     value slider.
      
+→ Text clipboard paste support ←
+    The "Text" and "Label" tools support pasting the copy/paste clipboard.
+     
 
 See CHANGES.txt for the complete list of changes.
 
@@ -497,6 +500,13 @@ e.Ferramentas «Texto» e «Etiquetas» ←
     esquerda. (Isto pode ser útil para crear unha liña de texto con cores,
     tipos de letra, estilos e tamaños mesturados.)
 
+    Text from the clipboard (copy/paste buffer) can be inserted with the "Text"
+    and "Label" tools by pressing the [Control] + [V] key combination on a
+    physical keyboard, or clicking the "Paste" button in Tux Paint's on-screen
+    keyboard. The text will wrap to the next line if it hits the right edge of
+    the canvas. If the text hits the bottom of the canvas, the pasting will
+    abort, truncating the text.
+
     Ao premer noutro lugar da imaxe mentres a entrada de texto aínda está
     activa, a liña de texto actual moverase a esa posición (onde pode continuar
     editándoa).
@@ -535,6 +545,9 @@ e.Ferramentas «Texto» e «Etiquetas» ←
         «Desactivar a ferramenta "Etiqueta"» en Tux Paint Config. ou executando
         Tux Paint coa opción «nolabel»).
 
+        📜 The ability to paste text from the clipboard was added in Tux Paint
+        0.9.35
+
 
          
     → Introdución de caracteres internacionais ←
@@ -571,7 +584,37 @@ e.Ferramentas «Texto» e «Etiquetas» ←
 
         An optional on-screen keyboard is available for the Text and Label
         tools, which can provide a variety of layouts and character composition
-        (e.g., composing "a" and "e" into "æ").
+        (e.g., composing "a" and "e" into "æ"). Run Tux Paint with the
+        "--onscreen-keyboard" option, or enable that setting in Tux Paint's
+        configuration file, to enable it. Multiple layouts are offered
+        (currently "QWERTY" and "ABC"), which the user can switch between.
+        Additional configuration options allow specifying a default layout, as
+        well as preventing the layout from being changed.
+
+        The on-screen keyboard appears at the bottom or top of the Tux Paint
+        window, obscuring part of the canvas, depending on where the text
+        insertion cursor is placed. Along with alphabetic, numeric, and some
+        punctuation keys, the keyboard provides:
+          @ A "Backspace" key (⇐) to remove the previous character
+          @ A "Carriage Return" ("Return"/"Enter") key (⏎) to end the current
+            input and begin a new one on the following line (below and to the
+            left)
+          @ A "Tab" key (⇔) to end the current input and begin a new one at the
+            current cursor position
+          @ A "Shift" key (⇑) to shift alphabetic keys from lowercase to
+            uppercase, access more punctuation, etc.
+          @ A "Caps Lock" key (⤒) to toggle permanent shifting of alphabetic
+            keys from lowercase to uppercase (click it again to disable caps
+            lock)
+          @ A "Compose" key ("Cmp"), to initiate character composition (e.g.,
+            click "Cmp", "a", "e" to produce an "æ" character)
+          @ An "Alternate Graphics" key ("AltGr") to access additional
+            characters (e.g., "¿", "ß", etc.)
+          @ An "Alternate" key ("Alt")
+          @ A "Paste" key to paste the current clipboard's text into the Text
+            or Label tool
+          @ Left and right arrows (← & →) to access different on-screen
+            keyboard layouts
 
         ⚙ See the "Options" and "Extending Tux Paint" documentation for more
         information.

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

@@ -100,7 +100,7 @@
           </p>
     
           <p>
-            10 de Outubro de 2024          </p>
+            25 de Decembro de 2024          </p>
         </center>
       </header>
 
@@ -1118,7 +1118,7 @@
       </header>
 
       <p>
-        A partir da versión 0.9.22, as ferramentas «Texto» e «Etiqueta» de Tux Paint poden presentar un teclado en pantalla que permite utilizar o punteiro (mediante un rato, sistemas de seguimento de ollos, etc.) para introducir caracteres. Os ficheiros que describen o deseño e as claves dispoñíbeis almacénanse no directorio «<code>osk</code>» de Tux Paint. Cada deseño de teclado está definido por varios ficheiros (algúns dos cales poden ser compartidos por diferentes deseños).      </p>
+        As of version 0.9.22, Tux Paint's 'Text' and 'Label' tools can present an on-screen keyboard that allows the pointer (via a mouse, touch screen, eye-tracking systems, etc.) to be used to input characters. Files that describe the layout and available keys are stored in Tux Paint "<code>osk</code>" directory. Each keyboard layout is defined by a number of files (some of which may be shared by different layouts).      </p>
       <p>
         Usaremos o teclado QWERTY como exemplo:      </p>
       
@@ -1142,7 +1142,7 @@
         </blockquote>
 
         <p class="note">
-          <span title="Configuration option">&#9881;</span>          <strong>Note:</strong> Blank lines within the "<code>.layout</code>" file will be ignored, as will any text following a "<code>#</code>" (pound/hash) character — it can be used to denote comments, as seen in the example above.        </p>
+          <span title="Configuration option">&#9881;</span>          <strong>Note:</strong> Blank lines within the "<code>.layout</code>" file will be ignored, as will any text following a "<code>#</code>" (pound/hash) character — it can be used to denote comments, as seen in the example below.        </p>
 
         <p>
           A liña «<code>keyboardlist</code>» describe a que esquemas cambiar, cando o usuario preme nos botóns esquerdo e dereito do teclado. (Ver máis abaixo.)        </p>
@@ -1157,6 +1157,9 @@
         <p>
           Isto describe o tamaño do teclado (como unha reixa de «largo × alto») e lista cada tecla co seu código numérico (ver o ficheiro «<code>keymap</code>», máis abaixo), o largo no que debería debuxarse ​​(normalmente «<code>1.0</code>», para ocupar un espazo no teclado, pero no seguinte exemplo, teña en conta que as teclas «<code>TAB</code>» e «<code>SPACE</code>» son moito máis largas), o carácter ou o texto que se amosará na tecla, dependendo das teclas modificadoras premido (unha para cada unha: sen modificadores,<b><code>[Maiúsculas]</code></b>,<b><code>[AltGr]</code></b> e <b><code>[Maiúsculas]</code></b> + <b><code>[AltGr]</code></b>) e, finalmente, se a tecla está afectada ou non pola tecla <b><code>[BloqMaiús]</code></b> (use «<code>1</code>») ou a tecla <b><code>[AltGr]</code></b> (gráficos alternativos) ( use «<code>2</code>»), ou non (use «<code>0</code>»).        </p>
 
+        <p>
+          The "<code>NEWLINE</code>" keyword is used to indicate the end of one row of the keyboard, and thus subsequent key layout descriptions will be beginning on a new row.        </p>
+
         <blockquote>
           <p>
             <code>WIDTH 15<br>
@@ -1193,10 +1196,14 @@
             KEY 64 2.0 Alt Alt Alt Alt 0<br>
             <br>
             # Espazo<br>
-            KEY 65 7.0 SPACE SPACE SPACE SPACE 0<br>
+            KEY 65 5.0 SPACE SPACE SPACE SPACE 0<br>
             <br>
+            # AltGr<br>
             KEY 108 2.0 AltGr AltGr AltGr AltGr 0<br>
             <br>
+            # Paste<br>
+            KEY 143 2.0 Paste Paste Paste Paste 0<br>
+            <br>
             # A frecha cara á dereita cambiará ao seguinte teclado<br>
             KEY 1 1.0 -&gt; -&gt; -&gt; -&gt; 0</code>
           </p>
@@ -1221,6 +1228,10 @@
             <code>2</code> —
                 disposición anterior (segundo o axuste «<code>keyboardlist</code>» do ficheiro de disposición)          </li>
         </ul>
+
+        <p class="note">
+          <span title="Version variation">&#128220;</span>          Starting with Tux Paint 0.9.35, the <code>XF86Paste</code> keysym (value 143) can be used to initiate a copy/paste clipboard buffer "paste" event. See the "Paste" key in the keyboard layout files. (Pasting via a physical keyboard is initiated using the <code>[Control]</code> + <code>[V]</code> key combination.        </p>
+
       </section><!-- H2: Keyboard layout file ("qwerty.h_layout") -->
 
       <section><!-- H2: Keymap file ("us-intl-altgr-dead-keys.keymap") -->

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

@@ -102,7 +102,7 @@
           </p>
 
           <p>
-            25 de Outubro de 2024          </p>
+            25 de Decembro de 2024          </p>
         </center>
       </header>
       <table border="2"
@@ -230,6 +230,9 @@
     <dl>
   <dt>Improved color picker</dt>
   <dd>Better behavior when clicking/tapping and dragging hue/saturation box and value slider.</dd>
+
+  <dt>Text clipboard paste support</dt>
+  <dd>The "Text" and "Label" tools support pasting the copy/paste clipboard.</dd>
 </dl>
 
     <p>
@@ -819,6 +822,9 @@
   <p>
     Como alternativa, prema <strong><code>[Tab]</code></strong> e o texto será debuxado na imaxe, mais o cursor moverase á dereita do texto, no canto  de baixar unha liña e á esquerda. (Isto pode ser útil para crear unha liña de texto con cores, tipos de letra, estilos e tamaños mesturados.)  </p>
 
+  <p>
+    Text from the clipboard (copy/paste buffer) can be inserted with the "Text" and "Label" tools by pressing the <strong><code>[Control]</code> + <code>[V]</code></strong> key combination on a physical keyboard, or clicking the "<strong>Paste</strong>" button in Tux Paint's on-screen keyboard.  The text will wrap to the next line if it hits the right edge of the canvas.  If the text hits the bottom of the canvas, the pasting will abort, truncating the text.  </p>
+
   <p>
     Ao premer noutro lugar da imaxe mentres a entrada de texto aínda está activa, a liña de texto actual moverase a esa posición (onde pode continuar editándoa).  </p>
 
@@ -849,6 +855,9 @@
 
       <p class="note">
         <span title="Configuration option">&#9881;</span>        A ferramenta <strong>Etiqueta</strong> pódese desactivar (p. ex.: seleccionando «Desactivar a ferramenta "Etiqueta"» en <em>Tux Paint Config.</em> ou executando <em>Tux Paint</em> coa opción «<code>nolabel</code>»).      </p>
+
+      <p class="note">
+        <span title="Version variation">&#128220;</span>        The ability to paste text from the clipboard was added in Tux Paint 0.9.35      </p>
     </dd>
 
     <dt>
@@ -886,7 +895,23 @@
 
     <dd>
       <p>
-        An optional on-screen keyboard is available for the Text and Label tools, which can provide a variety of layouts and character composition (e.g., composing "a" and "e" into "æ").      </p>
+        An optional on-screen keyboard is available for the Text and Label tools, which can provide a variety of layouts and character composition (e.g., composing "a" and "e" into "æ").  Run Tux Paint with the "<code>--onscreen-keyboard</code>" option, or enable that setting in Tux Paint's configuration file, to enable it.  Multiple layouts are offered (currently "QWERTY" and "ABC"), which the user can switch between.  Additional configuration options allow specifying a default layout, as well as preventing the layout from being changed.      </p>
+
+      <p>
+        The on-screen keyboard appears at the bottom or top of the Tux Paint window, obscuring part of the canvas, depending on where the text insertion cursor is placed.  Along with alphabetic, numeric, and some punctuation keys, the keyboard provides:        <ul>
+          <li>A "Backspace" key (&#8656;) to remove the previous character</li>
+          <li>A "Carriage Return" ("Return"/"Enter") key (&#9166;) to end the current input and begin a new one on the following line (below and to the left)</li>
+          <li>A "Tab" key (&#8660;) to end the current input and begin a new one at the current cursor position</li>
+          <li>A "Shift" key (&#8657;) to shift alphabetic keys from lowercase to uppercase, access more punctuation, etc.</li>
+          <li>A "Caps Lock" key (&#10514;) to toggle permanent shifting of alphabetic keys from lowercase to uppercase (click it again to disable caps lock)</li>
+          <li>A "Compose" key ("Cmp"), to initiate character composition (e.g., click "Cmp", "a", "e" to produce an "æ" character)</li>
+          <li>An "Alternate Graphics" key ("AltGr") to access additional characters (e.g., "¿", "ß", etc.)</li>
+          <li>An "Alternate" key ("Alt")</li>
+          <li>A "Paste" key to paste the current clipboard's text into the Text or Label tool</li>
+          <li>Left and right arrows (&larr; &amp; &rarr;) to access different on-screen keyboard layouts</li>
+        </ul>
+      </p>
+
       <p class="note">
         <span title="Configuration option">&#9881;</span>        See the "<a href="OPTIONS.html"><em>Options</em></a>" and "<a href="EXTENDING.html"><em>Extending Tux Paint</em></a>" documentation for more information.      </p>
     </dd>

docs/is_IS.UTF-8/EXTENDING.txt

@@ -5,7 +5,7 @@
         Copyright © 2002-2024 by various contributors; see AUTHORS.txt.
                              https://tuxpaint.org/
 
-                               október 10, 2024
+                               desember 25, 2024
 
 +-----------------------------------------+
 |            Table of Contents            |
@@ -958,11 +958,11 @@ source code ("/src/im.c"), and requires updates to the Makefile, to ensure the
 On-screen Keyboard
 
 As of version 0.9.22, Tux Paint's 'Text' and 'Label' tools can present an
-on-screen keyboard that allows the pointer (via a mouse, eye-tracking systems,
+on-screen keyboard that allows the pointer (via a mouse, touch screen,
-etc.) to be used to input characters. Files that describe the layout and
+eye-tracking systems, etc.) to be used to input characters. Files that describe
-available keys are stored in Tux Paint "osk" directory. Each keyboard layout is
+the layout and available keys are stored in Tux Paint "osk" directory. Each
-defined by a number of files (some of which may be shared by different
+keyboard layout is defined by a number of files (some of which may be shared by
-layouts).
+different layouts).
 
 We'll use the QWERTY keyboard as an example:
 
@@ -979,7 +979,7 @@ and key mappings.
 
 ⚙ Note: Blank lines within the ".layout" file will be ignored, as will any text
 following a "#" (pound/hash) character — it can be used to denote comments, as
-seen in the example above.
+seen in the example below.
 
 The "keyboardlist" line describes which layouts to switch to, when the user
 clicks the left and right buttons on the keyboard. (See below.)
@@ -996,6 +996,9 @@ been pressed (one each for: no modifiers, [Shift], [AltGr], and [Shift] +
 (use "1") or [AltGr] (alternate graphics) key (use "2"), or not at all (use
 "0").
 
+The "NEWLINE" keyword is used to indicate the end of one row of the keyboard,
+and thus subsequent key layout descriptions will be beginning on a new row.
+
     WIDTH 15
     HEIGHT 5
 
@@ -1031,10 +1034,14 @@ been pressed (one each for: no modifiers, [Shift], [AltGr], and [Shift] +
     KEY 64 2.0 Alt Alt Alt Alt 0
 
     # Space
-    KEY 65 7.0 SPACE SPACE SPACE SPACE 0
+    KEY 65 5.0 SPACE SPACE SPACE SPACE 0
 
+    # AltGr
     KEY 108 2.0 AltGr AltGr AltGr AltGr 0
 
+    # Paste
+    KEY 143 2.0 Paste Paste Paste Paste 0
+
     # Arrow to right will change to the next keyboard
     KEY 1 1.0 -> -> -> -> 0
 
@@ -1048,6 +1055,11 @@ described below.
   * 1 — next layout (per the layout file's "keyboardlist" setting)
   * 2 — previous layout (per the layout file's "keyboardlist" setting)
 
+📜 Starting with Tux Paint 0.9.35, the XF86Paste keysym (value 143) can be used
+to initiate a copy/paste clipboard buffer "paste" event. See the "Paste" key in
+the keyboard layout files. (Pasting via a physical keyboard is initiated using
+the [Control] + [V] key combination.
+
             ### Keymap file ("us-intl-altgr-dead-keys.keymap") ###
 
 This file defines which numeric keycodes (seen in the keyboard layout files,

docs/is_IS.UTF-8/README.txt

@@ -6,7 +6,7 @@
         Copyright © 2002-2024 by various contributors; see AUTHORS.txt.
                              https://tuxpaint.org/
 
-                               október 25, 2024
+                               desember 25, 2024
 
 +-------------------------------------------------+
 |                Table of Contents                |
@@ -103,6 +103,9 @@ See COPYING.txt for the full text of the GPL license.
     Better behavior when clicking/tapping and dragging hue/saturation box and
     value slider.
      
+→ Text clipboard paste support ←
+    The "Text" and "Label" tools support pasting the copy/paste clipboard.
+     
 
 See CHANGES.txt for the complete list of changes.
 
@@ -489,6 +492,13 @@ e."Text" and "Label" Tools ←
     to the left. (This can be useful to create a line of text with mixed
     colors, fonts, styles and sizes.)
 
+    Text from the clipboard (copy/paste buffer) can be inserted with the "Text"
+    and "Label" tools by pressing the [Control] + [V] key combination on a
+    physical keyboard, or clicking the "Paste" button in Tux Paint's on-screen
+    keyboard. The text will wrap to the next line if it hits the right edge of
+    the canvas. If the text hits the bottom of the canvas, the pasting will
+    abort, truncating the text.
+
     Clicking elsewhere in the picture while the text entry is still active
     causes the current line of text to move to that location (where you can
     continue editing it).
@@ -527,6 +537,9 @@ e."Text" and "Label" Tools ←
         Tool" in Tux Paint Config. or running Tux Paint with the "nolabel"
         option).
 
+        📜 The ability to paste text from the clipboard was added in Tux Paint
+        0.9.35
+
 
          
     → International Character Input ←
@@ -560,7 +573,37 @@ e."Text" and "Label" Tools ←
 
         An optional on-screen keyboard is available for the Text and Label
         tools, which can provide a variety of layouts and character composition
-        (e.g., composing "a" and "e" into "æ").
+        (e.g., composing "a" and "e" into "æ"). Run Tux Paint with the
+        "--onscreen-keyboard" option, or enable that setting in Tux Paint's
+        configuration file, to enable it. Multiple layouts are offered
+        (currently "QWERTY" and "ABC"), which the user can switch between.
+        Additional configuration options allow specifying a default layout, as
+        well as preventing the layout from being changed.
+
+        The on-screen keyboard appears at the bottom or top of the Tux Paint
+        window, obscuring part of the canvas, depending on where the text
+        insertion cursor is placed. Along with alphabetic, numeric, and some
+        punctuation keys, the keyboard provides:
+          @ A "Backspace" key (⇐) to remove the previous character
+          @ A "Carriage Return" ("Return"/"Enter") key (⏎) to end the current
+            input and begin a new one on the following line (below and to the
+            left)
+          @ A "Tab" key (⇔) to end the current input and begin a new one at the
+            current cursor position
+          @ A "Shift" key (⇑) to shift alphabetic keys from lowercase to
+            uppercase, access more punctuation, etc.
+          @ A "Caps Lock" key (⤒) to toggle permanent shifting of alphabetic
+            keys from lowercase to uppercase (click it again to disable caps
+            lock)
+          @ A "Compose" key ("Cmp"), to initiate character composition (e.g.,
+            click "Cmp", "a", "e" to produce an "æ" character)
+          @ An "Alternate Graphics" key ("AltGr") to access additional
+            characters (e.g., "¿", "ß", etc.)
+          @ An "Alternate" key ("Alt")
+          @ A "Paste" key to paste the current clipboard's text into the Text
+            or Label tool
+          @ Left and right arrows (← & →) to access different on-screen
+            keyboard layouts
 
         ⚙ See the "Options" and "Extending Tux Paint" documentation for more
         information.

docs/is_IS.UTF-8/html/EXTENDING.html

@@ -100,7 +100,7 @@
           </p>
     
           <p>
-            október 10, 2024          </p>
+            desember 25, 2024          </p>
         </center>
       </header>
 
@@ -1118,7 +1118,7 @@
       </header>
 
       <p>
-        As of version 0.9.22, Tux Paint's 'Text' and 'Label' tools can present an on-screen keyboard that allows the pointer (via a mouse, eye-tracking systems, etc.) to be used to input characters. Files that describe the layout and available keys are stored in Tux Paint "<code>osk</code>" directory. Each keyboard layout is defined by a number of files (some of which may be shared by different layouts).      </p>
+        As of version 0.9.22, Tux Paint's 'Text' and 'Label' tools can present an on-screen keyboard that allows the pointer (via a mouse, touch screen, eye-tracking systems, etc.) to be used to input characters. Files that describe the layout and available keys are stored in Tux Paint "<code>osk</code>" directory. Each keyboard layout is defined by a number of files (some of which may be shared by different layouts).      </p>
       <p>
         We'll use the QWERTY keyboard as an example:      </p>
       
@@ -1142,7 +1142,7 @@
         </blockquote>
 
         <p class="note">
-          <span title="Configuration option">&#9881;</span>          <strong>Note:</strong> Blank lines within the "<code>.layout</code>" file will be ignored, as will any text following a "<code>#</code>" (pound/hash) character — it can be used to denote comments, as seen in the example above.        </p>
+          <span title="Configuration option">&#9881;</span>          <strong>Note:</strong> Blank lines within the "<code>.layout</code>" file will be ignored, as will any text following a "<code>#</code>" (pound/hash) character — it can be used to denote comments, as seen in the example below.        </p>
 
         <p>
           The "<code>keyboardlist</code>" line describes which layouts to switch to, when the user clicks the left and right buttons on the keyboard. (See below.)        </p>
@@ -1157,6 +1157,9 @@
         <p>
           This describes how big the keyboard is (as a "width × height" grid), and lists each key with its numeric keycode (see the "<code>keymap</code>" file, below), the width it should be drawn at (typically "<code>1.0</code>", to take one space on the keyboard, but in the example below, notice the "<code>TAB</code>" and "<code>SPACE</code>" keys are much wider), the character or text to display on the key, depending on which modifier keys have been pressed (one each for: no modifiers, <b><code>[Shift]</code></b>, <b><code>[AltGr]</code></b>, and <b><code>[Shift]</code></b> + <b><code>[AltGr]</code></b>), and finally whether or not the key is affected by the <b><code>[CapsLock]</code></b> key (use "<code>1</code>") or <b><code>[AltGr]</code></b> (alternate graphics) key (use "<code>2</code>"), or not at all (use "<code>0</code>").        </p>
 
+        <p>
+          The "<code>NEWLINE</code>" keyword is used to indicate the end of one row of the keyboard, and thus subsequent key layout descriptions will be beginning on a new row.        </p>
+
         <blockquote>
           <p>
             <code>WIDTH 15<br>
@@ -1193,10 +1196,14 @@
             KEY 64 2.0 Alt Alt Alt Alt 0<br>
             <br>
             # Space<br>
-            KEY 65 7.0 SPACE SPACE SPACE SPACE 0<br>
+            KEY 65 5.0 SPACE SPACE SPACE SPACE 0<br>
             <br>
+            # AltGr<br>
             KEY 108 2.0 AltGr AltGr AltGr AltGr 0<br>
             <br>
+            # Paste<br>
+            KEY 143 2.0 Paste Paste Paste Paste 0<br>
+            <br>
             # Arrow to right will change to the next keyboard<br>
             KEY 1 1.0 -&gt; -&gt; -&gt; -&gt; 0</code>
           </p>
@@ -1221,6 +1228,10 @@
             <code>2</code> —
                 previous layout (per the layout file's "<code>keyboardlist</code>" setting)          </li>
         </ul>
+
+        <p class="note">
+          <span title="Version variation">&#128220;</span>          Starting with Tux Paint 0.9.35, the <code>XF86Paste</code> keysym (value 143) can be used to initiate a copy/paste clipboard buffer "paste" event. See the "Paste" key in the keyboard layout files. (Pasting via a physical keyboard is initiated using the <code>[Control]</code> + <code>[V]</code> key combination.        </p>
+
       </section><!-- H2: Keyboard layout file ("qwerty.h_layout") -->
 
       <section><!-- H2: Keymap file ("us-intl-altgr-dead-keys.keymap") -->

docs/is_IS.UTF-8/html/README.html

@@ -102,7 +102,7 @@
           </p>
 
           <p>
-            október 25, 2024          </p>
+            desember 25, 2024          </p>
         </center>
       </header>
       <table border="2"
@@ -230,6 +230,9 @@
     <dl>
   <dt>Improved color picker</dt>
   <dd>Better behavior when clicking/tapping and dragging hue/saturation box and value slider.</dd>
+
+  <dt>Text clipboard paste support</dt>
+  <dd>The "Text" and "Label" tools support pasting the copy/paste clipboard.</dd>
 </dl>
 
     <p>
@@ -819,6 +822,9 @@
   <p>
     Alternatively, press <strong><code>[Tab]</code></strong> and the text will be drawn onto the picture, but the cursor will move to the right of the text, rather than down a line, and to the left. (This can be useful to create a line of text with mixed colors, fonts, styles and sizes.)  </p>
 
+  <p>
+    Text from the clipboard (copy/paste buffer) can be inserted with the "Text" and "Label" tools by pressing the <strong><code>[Control]</code> + <code>[V]</code></strong> key combination on a physical keyboard, or clicking the "<strong>Paste</strong>" button in Tux Paint's on-screen keyboard.  The text will wrap to the next line if it hits the right edge of the canvas.  If the text hits the bottom of the canvas, the pasting will abort, truncating the text.  </p>
+
   <p>
     Clicking elsewhere in the picture while the text entry is still active causes the current line of text to move to that location (where you can continue editing it).  </p>
 
@@ -849,6 +855,9 @@
 
       <p class="note">
         <span title="Configuration option">&#9881;</span>        The <strong>Label</strong> tool can be disabled (e.g., by selecting "Disable 'Label' Tool" in <em>Tux Paint Config.</em> or running <em>Tux Paint</em> with the "<code>nolabel</code>" option).      </p>
+
+      <p class="note">
+        <span title="Version variation">&#128220;</span>        The ability to paste text from the clipboard was added in Tux Paint 0.9.35      </p>
     </dd>
 
     <dt>
@@ -886,7 +895,23 @@
 
     <dd>
       <p>
-        An optional on-screen keyboard is available for the Text and Label tools, which can provide a variety of layouts and character composition (e.g., composing "a" and "e" into "æ").      </p>
+        An optional on-screen keyboard is available for the Text and Label tools, which can provide a variety of layouts and character composition (e.g., composing "a" and "e" into "æ").  Run Tux Paint with the "<code>--onscreen-keyboard</code>" option, or enable that setting in Tux Paint's configuration file, to enable it.  Multiple layouts are offered (currently "QWERTY" and "ABC"), which the user can switch between.  Additional configuration options allow specifying a default layout, as well as preventing the layout from being changed.      </p>
+
+      <p>
+        The on-screen keyboard appears at the bottom or top of the Tux Paint window, obscuring part of the canvas, depending on where the text insertion cursor is placed.  Along with alphabetic, numeric, and some punctuation keys, the keyboard provides:        <ul>
+          <li>A "Backspace" key (&#8656;) to remove the previous character</li>
+          <li>A "Carriage Return" ("Return"/"Enter") key (&#9166;) to end the current input and begin a new one on the following line (below and to the left)</li>
+          <li>A "Tab" key (&#8660;) to end the current input and begin a new one at the current cursor position</li>
+          <li>A "Shift" key (&#8657;) to shift alphabetic keys from lowercase to uppercase, access more punctuation, etc.</li>
+          <li>A "Caps Lock" key (&#10514;) to toggle permanent shifting of alphabetic keys from lowercase to uppercase (click it again to disable caps lock)</li>
+          <li>A "Compose" key ("Cmp"), to initiate character composition (e.g., click "Cmp", "a", "e" to produce an "æ" character)</li>
+          <li>An "Alternate Graphics" key ("AltGr") to access additional characters (e.g., "¿", "ß", etc.)</li>
+          <li>An "Alternate" key ("Alt")</li>
+          <li>A "Paste" key to paste the current clipboard's text into the Text or Label tool</li>
+          <li>Left and right arrows (&larr; &amp; &rarr;) to access different on-screen keyboard layouts</li>
+        </ul>
+      </p>
+
       <p class="note">
         <span title="Configuration option">&#9881;</span>        See the "<a href="OPTIONS.html"><em>Options</em></a>" and "<a href="EXTENDING.html"><em>Extending Tux Paint</em></a>" documentation for more information.      </p>
     </dd>

docs/ja_JP.UTF-8/EXTENDING.txt

@@ -5,7 +5,7 @@
        Copyright © 2002-2024 by various contributors; AUTHORS.txt 参照.
                              https://tuxpaint.org/
 
-                                2024年10月10日
+                                2024年12月25日
 
 +-----------------------------------------+
 |                  目次                   |
@@ -958,11 +958,11 @@ source code ("/src/im.c"), and requires updates to the Makefile, to ensure the
 画面キーボード
 
 As of version 0.9.22, Tux Paint's 'Text' and 'Label' tools can present an
-on-screen keyboard that allows the pointer (via a mouse, eye-tracking systems,
+on-screen keyboard that allows the pointer (via a mouse, touch screen,
-etc.) to be used to input characters. Files that describe the layout and
+eye-tracking systems, etc.) to be used to input characters. Files that describe
-available keys are stored in Tux Paint "osk" directory. Each keyboard layout is
+the layout and available keys are stored in Tux Paint "osk" directory. Each
-defined by a number of files (some of which may be shared by different
+keyboard layout is defined by a number of files (some of which may be shared by
-layouts).
+different layouts).
 
 We'll use the QWERTY keyboard as an example:
 
@@ -979,7 +979,7 @@ and key mappings.
 
 ⚙ Note: Blank lines within the ".layout" file will be ignored, as will any text
 following a "#" (pound/hash) character — it can be used to denote comments, as
-seen in the example above.
+seen in the example below.
 
 The "keyboardlist" line describes which layouts to switch to, when the user
 clicks the left and right buttons on the keyboard. (See below.)
@@ -996,6 +996,9 @@ been pressed (one each for: no modifiers, [Shift], [AltGr], and [Shift] +
 (use "1") or [AltGr] (alternate graphics) key (use "2"), or not at all (use
 "0").
 
+The "NEWLINE" keyword is used to indicate the end of one row of the keyboard,
+and thus subsequent key layout descriptions will be beginning on a new row.
+
     WIDTH 15
     HEIGHT 5
 
@@ -1031,10 +1034,14 @@ been pressed (one each for: no modifiers, [Shift], [AltGr], and [Shift] +
     KEY 64 2.0 Alt Alt Alt Alt 0
 
     # Space
-    KEY 65 7.0 SPACE SPACE SPACE SPACE 0
+    KEY 65 5.0 SPACE SPACE SPACE SPACE 0
 
+    # AltGr
     KEY 108 2.0 AltGr AltGr AltGr AltGr 0
 
+    # Paste
+    KEY 143 2.0 Paste Paste Paste Paste 0
+
     # Arrow to right will change to the next keyboard
     KEY 1 1.0 -> -> -> -> 0
 
@@ -1048,6 +1055,11 @@ described below.
   * 1 — next layout (per the layout file's "keyboardlist" setting)
   * 2 — previous layout (per the layout file's "keyboardlist" setting)
 
+📜 Starting with Tux Paint 0.9.35, the XF86Paste keysym (value 143) can be used
+to initiate a copy/paste clipboard buffer "paste" event. See the "Paste" key in
+the keyboard layout files. (Pasting via a physical keyboard is initiated using
+the [Control] + [V] key combination.
+
             ### Keymap file ("us-intl-altgr-dead-keys.keymap") ###
 
 This file defines which numeric keycodes (seen in the keyboard layout files,

docs/ja_JP.UTF-8/README.txt

@@ -6,7 +6,7 @@
        Copyright © 2002-2024 by various contributors; AUTHORS.txt 参照.
                              https://tuxpaint.org/
 
-                                2024年10月25日
+                                2024年12月25日
 
 +--------------------------------------------------+
 |                       目次                       |
@@ -101,6 +101,9 @@ Tux Paint は、オープンソースのプロジェクトで、GNUの一般公
     Better behavior when clicking/tapping and dragging hue/saturation box and
     value slider.
      
+→ Text clipboard paste support ←
+    The "Text" and "Label" tools support pasting the copy/paste clipboard.
+     
 
 全ての変更点については、CHANGES.txt をお読みください。
 
@@ -444,6 +447,13 @@ e.「もじ」ツール、「ラベル」ツール ←
     側に移動します。これは、１行の中で異なったフォント、字体、フォントサイズ、
     色などを混在させたい場合に便利な方法です。
 
+    Text from the clipboard (copy/paste buffer) can be inserted with the "Text"
+    and "Label" tools by pressing the [Control] + [V] key combination on a
+    physical keyboard, or clicking the "Paste" button in Tux Paint's on-screen
+    keyboard. The text will wrap to the next line if it hits the right edge of
+    the canvas. If the text hits the bottom of the canvas, the pasting will
+    abort, truncating the text.
+
     文字の入力中に別の場所をクリックすると、入力内容を維持したまま、文字を貼り
     付ける位置をクリックした位置に移動させ、文字入力を続けることができます。
 
@@ -477,6 +487,9 @@ e.「もじ」ツール、「ラベル」ツール ←
         ⚙ 「ラベル」ツールは、Tux Paint 設定ツールや、"nolabel"オプションによ
         り、無効にすることができます。
 
+        📜 The ability to paste text from the clipboard was added in Tux Paint
+        0.9.35
+
 
          
     → 多言語文字入力 ←
@@ -506,9 +519,39 @@ e.「もじ」ツール、「ラベル」ツール ←
          
     → 画面キーボード ←
 
-        「もじ」ツールや「ラベル」ツールで使える、オプションの「スクリーンキー
+        An optional on-screen keyboard is available for the Text and Label
-        ボード」では、キーボードレイアウトを変えたり、文字の合成（例: "a "と "e
+        tools, which can provide a variety of layouts and character composition
-        "を "æ "に合成）を行うことができます。
+        (e.g., composing "a" and "e" into "æ"). Run Tux Paint with the
+        "--onscreen-keyboard" option, or enable that setting in Tux Paint's
+        configuration file, to enable it. Multiple layouts are offered
+        (currently "QWERTY" and "ABC"), which the user can switch between.
+        Additional configuration options allow specifying a default layout, as
+        well as preventing the layout from being changed.
+
+        The on-screen keyboard appears at the bottom or top of the Tux Paint
+        window, obscuring part of the canvas, depending on where the text
+        insertion cursor is placed. Along with alphabetic, numeric, and some
+        punctuation keys, the keyboard provides:
+          @ A "Backspace" key (⇐) to remove the previous character
+          @ A "Carriage Return" ("Return"/"Enter") key (⏎) to end the current
+            input and begin a new one on the following line (below and to the
+            left)
+          @ A "Tab" key (⇔) to end the current input and begin a new one at the
+            current cursor position
+          @ A "Shift" key (⇑) to shift alphabetic keys from lowercase to
+            uppercase, access more punctuation, etc.
+          @ A "Caps Lock" key (⤒) to toggle permanent shifting of alphabetic
+            keys from lowercase to uppercase (click it again to disable caps
+            lock)
+          @ A "Compose" key ("Cmp"), to initiate character composition (e.g.,
+            click "Cmp", "a", "e" to produce an "æ" character)
+          @ An "Alternate Graphics" key ("AltGr") to access additional
+            characters (e.g., "¿", "ß", etc.)
+          @ An "Alternate" key ("Alt")
+          @ A "Paste" key to paste the current clipboard's text into the Text
+            or Label tool
+          @ Left and right arrows (← & →) to access different on-screen
+            keyboard layouts
 
         ⚙ 詳細については "各種設定について" と "Tux Paintの拡張" のドキュメント
         を参照してください。

docs/ja_JP.UTF-8/html/EXTENDING.html

@@ -100,7 +100,7 @@
           </p>
     
           <p>
-            2024年10月10日          </p>
+            2024年12月25日          </p>
         </center>
       </header>
 
@@ -1118,7 +1118,7 @@
       </header>
 
       <p>
-        As of version 0.9.22, Tux Paint's 'Text' and 'Label' tools can present an on-screen keyboard that allows the pointer (via a mouse, eye-tracking systems, etc.) to be used to input characters. Files that describe the layout and available keys are stored in Tux Paint "<code>osk</code>" directory. Each keyboard layout is defined by a number of files (some of which may be shared by different layouts).      </p>
+        As of version 0.9.22, Tux Paint's 'Text' and 'Label' tools can present an on-screen keyboard that allows the pointer (via a mouse, touch screen, eye-tracking systems, etc.) to be used to input characters. Files that describe the layout and available keys are stored in Tux Paint "<code>osk</code>" directory. Each keyboard layout is defined by a number of files (some of which may be shared by different layouts).      </p>
       <p>
         We'll use the QWERTY keyboard as an example:      </p>
       
@@ -1142,7 +1142,7 @@
         </blockquote>
 
         <p class="note">
-          <span title="Configuration option">&#9881;</span>          <strong>Note:</strong> Blank lines within the "<code>.layout</code>" file will be ignored, as will any text following a "<code>#</code>" (pound/hash) character — it can be used to denote comments, as seen in the example above.        </p>
+          <span title="Configuration option">&#9881;</span>          <strong>Note:</strong> Blank lines within the "<code>.layout</code>" file will be ignored, as will any text following a "<code>#</code>" (pound/hash) character — it can be used to denote comments, as seen in the example below.        </p>
 
         <p>
           The "<code>keyboardlist</code>" line describes which layouts to switch to, when the user clicks the left and right buttons on the keyboard. (See below.)        </p>
@@ -1157,6 +1157,9 @@
         <p>
           This describes how big the keyboard is (as a "width × height" grid), and lists each key with its numeric keycode (see the "<code>keymap</code>" file, below), the width it should be drawn at (typically "<code>1.0</code>", to take one space on the keyboard, but in the example below, notice the "<code>TAB</code>" and "<code>SPACE</code>" keys are much wider), the character or text to display on the key, depending on which modifier keys have been pressed (one each for: no modifiers, <b><code>[Shift]</code></b>, <b><code>[AltGr]</code></b>, and <b><code>[Shift]</code></b> + <b><code>[AltGr]</code></b>), and finally whether or not the key is affected by the <b><code>[CapsLock]</code></b> key (use "<code>1</code>") or <b><code>[AltGr]</code></b> (alternate graphics) key (use "<code>2</code>"), or not at all (use "<code>0</code>").        </p>
 
+        <p>
+          The "<code>NEWLINE</code>" keyword is used to indicate the end of one row of the keyboard, and thus subsequent key layout descriptions will be beginning on a new row.        </p>
+
         <blockquote>
           <p>
             <code>WIDTH 15<br>
@@ -1193,10 +1196,14 @@
             KEY 64 2.0 Alt Alt Alt Alt 0<br>
             <br>
             # Space<br>
-            KEY 65 7.0 SPACE SPACE SPACE SPACE 0<br>
+            KEY 65 5.0 SPACE SPACE SPACE SPACE 0<br>
             <br>
+            # AltGr<br>
             KEY 108 2.0 AltGr AltGr AltGr AltGr 0<br>
             <br>
+            # Paste<br>
+            KEY 143 2.0 Paste Paste Paste Paste 0<br>
+            <br>
             # Arrow to right will change to the next keyboard<br>
             KEY 1 1.0 -&gt; -&gt; -&gt; -&gt; 0</code>
           </p>
@@ -1221,6 +1228,10 @@
             <code>2</code> —
                 previous layout (per the layout file's "<code>keyboardlist</code>" setting)          </li>
         </ul>
+
+        <p class="note">
+          <span title="Version variation">&#128220;</span>          Starting with Tux Paint 0.9.35, the <code>XF86Paste</code> keysym (value 143) can be used to initiate a copy/paste clipboard buffer "paste" event. See the "Paste" key in the keyboard layout files. (Pasting via a physical keyboard is initiated using the <code>[Control]</code> + <code>[V]</code> key combination.        </p>
+
       </section><!-- H2: Keyboard layout file ("qwerty.h_layout") -->
 
       <section><!-- H2: Keymap file ("us-intl-altgr-dead-keys.keymap") -->

docs/ja_JP.UTF-8/html/README.html

@@ -102,7 +102,7 @@
           </p>
 
           <p>
-            2024年10月25日          </p>
+            2024年12月25日          </p>
         </center>
       </header>
       <table border="2"
@@ -230,6 +230,9 @@
     <dl>
   <dt>Improved color picker</dt>
   <dd>Better behavior when clicking/tapping and dragging hue/saturation box and value slider.</dd>
+
+  <dt>Text clipboard paste support</dt>
+  <dd>The "Text" and "Label" tools support pasting the copy/paste clipboard.</dd>
 </dl>
 
     <p>
@@ -819,6 +822,9 @@
   <p>
     また、<strong><code>[Tab]</code></strong>キーを押すと、文字が描画された後、カーソルは、次の行ではなく、右側に移動します。これは、１行の中で異なったフォント、字体、フォントサイズ、色などを混在させたい場合に便利な方法です。  </p>
 
+  <p>
+    Text from the clipboard (copy/paste buffer) can be inserted with the "Text" and "Label" tools by pressing the <strong><code>[Control]</code> + <code>[V]</code></strong> key combination on a physical keyboard, or clicking the "<strong>Paste</strong>" button in Tux Paint's on-screen keyboard.  The text will wrap to the next line if it hits the right edge of the canvas.  If the text hits the bottom of the canvas, the pasting will abort, truncating the text.  </p>
+
   <p>
     文字の入力中に別の場所をクリックすると、入力内容を維持したまま、文字を貼り付ける位置をクリックした位置に移動させ、文字入力を続けることができます。  </p>
 
@@ -849,6 +855,9 @@
 
       <p class="note">
         <span title="Configuration option">&#9881;</span>        <strong>「ラベル」</strong>ツールは、<em>Tux Paint 設定ツール</em>や、"<code>nolabel</code>"オプションにより、無効にすることができます。      </p>
+
+      <p class="note">
+        <span title="Version variation">&#128220;</span>        The ability to paste text from the clipboard was added in Tux Paint 0.9.35      </p>
     </dd>
 
     <dt>
@@ -886,7 +895,23 @@
 
     <dd>
       <p>
-        「もじ」ツールや「ラベル」ツールで使える、オプションの「スクリーンキーボード」では、キーボードレイアウトを変えたり、文字の合成（例: "a "と "e "を "æ "に合成）を行うことができます。      </p>
+        An optional on-screen keyboard is available for the Text and Label tools, which can provide a variety of layouts and character composition (e.g., composing "a" and "e" into "æ").  Run Tux Paint with the "<code>--onscreen-keyboard</code>" option, or enable that setting in Tux Paint's configuration file, to enable it.  Multiple layouts are offered (currently "QWERTY" and "ABC"), which the user can switch between.  Additional configuration options allow specifying a default layout, as well as preventing the layout from being changed.      </p>
+
+      <p>
+        The on-screen keyboard appears at the bottom or top of the Tux Paint window, obscuring part of the canvas, depending on where the text insertion cursor is placed.  Along with alphabetic, numeric, and some punctuation keys, the keyboard provides:        <ul>
+          <li>A "Backspace" key (&#8656;) to remove the previous character</li>
+          <li>A "Carriage Return" ("Return"/"Enter") key (&#9166;) to end the current input and begin a new one on the following line (below and to the left)</li>
+          <li>A "Tab" key (&#8660;) to end the current input and begin a new one at the current cursor position</li>
+          <li>A "Shift" key (&#8657;) to shift alphabetic keys from lowercase to uppercase, access more punctuation, etc.</li>
+          <li>A "Caps Lock" key (&#10514;) to toggle permanent shifting of alphabetic keys from lowercase to uppercase (click it again to disable caps lock)</li>
+          <li>A "Compose" key ("Cmp"), to initiate character composition (e.g., click "Cmp", "a", "e" to produce an "æ" character)</li>
+          <li>An "Alternate Graphics" key ("AltGr") to access additional characters (e.g., "¿", "ß", etc.)</li>
+          <li>An "Alternate" key ("Alt")</li>
+          <li>A "Paste" key to paste the current clipboard's text into the Text or Label tool</li>
+          <li>Left and right arrows (&larr; &amp; &rarr;) to access different on-screen keyboard layouts</li>
+        </ul>
+      </p>
+
       <p class="note">
         <span title="Configuration option">&#9881;</span>        詳細については "<a href="OPTIONS.html"><em>各種設定について</em></a>" と "<a href="EXTENDING.html"><em>Tux Paintの拡張</em></a>" のドキュメントを参照してください。      </p>
     </dd>

docs/sq_AL.UTF-8/EXTENDING.txt

@@ -5,7 +5,7 @@
  Të drejta kopjimi © 2002-2024 nga kontribues të ndryshëm; shihni AUTHORS.txt.
                              https://tuxpaint.org/
 
-                                 10 tetor 2024
+                                25 dhjetor 2024
 
 +------------------------------------------------------------------------+
 |                            Pasqyrë e Lëndës                            |
@@ -985,12 +985,12 @@ kartelat “.im” janë të gatshme për përdorim gjatë xhirimit.
 
 Tastierë Në Ekran
 
-Që me versionin 0.9.22, mjetet “Tekst” dhe “Etiketë” të Tux Paint-tit mund të
+As of version 0.9.22, Tux Paint's 'Text' and 'Label' tools can present an
-paraqesin një tastierë në ekran që lejon treguesin e kursorit (përmes një miu,
+on-screen keyboard that allows the pointer (via a mouse, touch screen,
-sistemesh ndjekjeje vështrimi, etj.) të përdoret për të futur shenja. Kartelat
+eye-tracking systems, etc.) to be used to input characters. Files that describe
-që përshkruajnë skemën dhe tastet e gatshme depozitohen te drejtoria “osk” e
+the layout and available keys are stored in Tux Paint "osk" directory. Each
-Tux Paint-it. Çdo skemë tastiere përcaktohet nga një numër kartelash (disa prej
+keyboard layout is defined by a number of files (some of which may be shared by
-të cilave mund të jenë të përbashkëta për skema të ndryshme).
+different layouts).
 
 Si shembull, do të përdorim një tastierë QWERTY:
 
@@ -1005,9 +1005,9 @@ përshkruar skemën dhe përshoqërimet e tasteve.
     keysymdefs keysymdef.h
     keyboardlist qwerty.layout default.layout
 
-⚙ Shënim: Rreshta të zbrazët brenda kartelës “.layout” do të shpërfillen, siç
+⚙ Note: Blank lines within the ".layout" file will be ignored, as will any text
-do të ndodhë edhe me çfarëdo teksti në vijim të një shenje “#” (sterlinë/hash)
+following a "#" (pound/hash) character — it can be used to denote comments, as
-— mund të përdoret për të terguar komente, siç shihet në shembullin më sipër.
+seen in the example below.
 
 Rreshti “keyboardlist” përshkruan te cila skema të kalohet, kur përdoruesi
 klikon butonat majtas dhe djathtas te tastiera. (Shihni më poshtë.)
@@ -1024,6 +1024,9 @@ cilët taste ndryshues janë shtypur (një nga : pa ndryshues, [Tasti Shift],
 jo tastet nga tasti [Tasti Capslock] (përdorni “1”) ose tasti [Tasti AltGr]
 (grafika alternative) (përdorni “2”), ose fare (përdorni “0”).
 
+The "NEWLINE" keyword is used to indicate the end of one row of the keyboard,
+and thus subsequent key layout descriptions will be beginning on a new row.
+
     WIDTH 15
     HEIGHT 5
 
@@ -1059,10 +1062,14 @@ jo tastet nga tasti [Tasti Capslock] (përdorni “1”) ose tasti [Tasti AltGr]
     KEY 64 2.0 Alt Alt Alt Alt 0
 
     # Tasti Hapësirë
-    KEY 65 7.0 SPACE SPACE SPACE SPACE 0
+    KEY 65 5.0 SPACE SPACE SPACE SPACE 0
 
+    # AltGr
     KEY 108 2.0 AltGr AltGr AltGr AltGr 0
 
+    # Paste
+    KEY 143 2.0 Paste Paste Paste Paste 0
+
     # Shigjeta për majtas do ta kthejë te tastiera pasuese
     KEY 1 1.0 -> -> -> -> 0
 
@@ -1077,6 +1084,11 @@ aktualisht përshkruhen më poshtë.
   * 1 — skema pasuese (per the layout file's "keyboardlist" setting)
   * 2 — skema e mëparshme (per the layout file's "keyboardlist" setting)
 
+📜 Starting with Tux Paint 0.9.35, the XF86Paste keysym (value 143) can be used
+to initiate a copy/paste clipboard buffer "paste" event. See the "Paste" key in
+the keyboard layout files. (Pasting via a physical keyboard is initiated using
+the [Control] + [V] key combination.
+
        ### Kartelë skeme tastiere (“us-intl-altgr-dead-keys.keymap”) ###
 
 This file defines which numeric keycodes (seen in the keyboard layout files,

docs/sq_AL.UTF-8/README.txt

@@ -6,7 +6,7 @@
  Të drejta kopjimi © 2002-2024 nga kontribues të ndryshëm; shihni AUTHORS.txt.
                              https://tuxpaint.org/
 
-                                 25 tetor 2024
+                                25 dhjetor 2024
 
 +---------------------------------------------------+
 |                 Pasqyrë e Lëndës                  |
@@ -103,6 +103,9 @@ See COPYING.txt for the full text of the GPL license.
     Better behavior when clicking/tapping and dragging hue/saturation box and
     value slider.
      
+→ Text clipboard paste support ←
+    The "Text" and "Label" tools support pasting the copy/paste clipboard.
+     
 
 Për listën e plotë të ndryshimeve, shihni CHANGES.txt.
 
@@ -490,6 +493,13 @@ e.Mjete “Tekst” dhe “Etiketa” ←
     down a line, and to the left. (This can be useful to create a line of text
     with mixed colors, fonts, styles and sizes.)
 
+    Text from the clipboard (copy/paste buffer) can be inserted with the "Text"
+    and "Label" tools by pressing the [Control] + [V] key combination on a
+    physical keyboard, or clicking the "Paste" button in Tux Paint's on-screen
+    keyboard. The text will wrap to the next line if it hits the right edge of
+    the canvas. If the text hits the bottom of the canvas, the pasting will
+    abort, truncating the text.
+
     Clicking elsewhere in the picture while the text entry is still active
     causes the current line of text to move to that location (where you can
     continue editing it).
@@ -528,6 +538,9 @@ e.Mjete “Tekst” dhe “Etiketa” ←
         Tool" in Tux Paint Config. or running Tux Paint with the "nolabel"
         option).
 
+        📜 The ability to paste text from the clipboard was added in Tux Paint
+        0.9.35
+
 
          
     → Futje Shenjash Ndërkombëtare ←
@@ -562,7 +575,37 @@ e.Mjete “Tekst” dhe “Etiketa” ←
 
         An optional on-screen keyboard is available for the Text and Label
         tools, which can provide a variety of layouts and character composition
-        (e.g., composing "a" and "e" into "æ").
+        (e.g., composing "a" and "e" into "æ"). Run Tux Paint with the
+        "--onscreen-keyboard" option, or enable that setting in Tux Paint's
+        configuration file, to enable it. Multiple layouts are offered
+        (currently "QWERTY" and "ABC"), which the user can switch between.
+        Additional configuration options allow specifying a default layout, as
+        well as preventing the layout from being changed.
+
+        The on-screen keyboard appears at the bottom or top of the Tux Paint
+        window, obscuring part of the canvas, depending on where the text
+        insertion cursor is placed. Along with alphabetic, numeric, and some
+        punctuation keys, the keyboard provides:
+          @ A "Backspace" key (⇐) to remove the previous character
+          @ A "Carriage Return" ("Return"/"Enter") key (⏎) to end the current
+            input and begin a new one on the following line (below and to the
+            left)
+          @ A "Tab" key (⇔) to end the current input and begin a new one at the
+            current cursor position
+          @ A "Shift" key (⇑) to shift alphabetic keys from lowercase to
+            uppercase, access more punctuation, etc.
+          @ A "Caps Lock" key (⤒) to toggle permanent shifting of alphabetic
+            keys from lowercase to uppercase (click it again to disable caps
+            lock)
+          @ A "Compose" key ("Cmp"), to initiate character composition (e.g.,
+            click "Cmp", "a", "e" to produce an "æ" character)
+          @ An "Alternate Graphics" key ("AltGr") to access additional
+            characters (e.g., "¿", "ß", etc.)
+          @ An "Alternate" key ("Alt")
+          @ A "Paste" key to paste the current clipboard's text into the Text
+            or Label tool
+          @ Left and right arrows (← & →) to access different on-screen
+            keyboard layouts
 
         ⚙ See the "Options" and "Extending Tux Paint" documentation for more
         information.

docs/sq_AL.UTF-8/html/EXTENDING.html

@@ -100,7 +100,7 @@
           </p>
     
           <p>
-            10 tetor 2024          </p>
+            25 dhjetor 2024          </p>
         </center>
       </header>
 
@@ -1118,7 +1118,7 @@
       </header>
 
       <p>
-        Që me versionin 0.9.22, mjetet “Tekst” dhe “Etiketë” të Tux Paint-tit mund të paraqesin një tastierë në ekran që lejon treguesin e kursorit (përmes një miu, sistemesh ndjekjeje vështrimi, etj.) të përdoret për të futur shenja. Kartelat që përshkruajnë skemën dhe tastet e gatshme depozitohen te drejtoria “<code>osk</code>” e Tux Paint-it. Çdo skemë tastiere përcaktohet nga një numër kartelash (disa prej të cilave mund të jenë të përbashkëta për skema të ndryshme).      </p>
+        As of version 0.9.22, Tux Paint's 'Text' and 'Label' tools can present an on-screen keyboard that allows the pointer (via a mouse, touch screen, eye-tracking systems, etc.) to be used to input characters. Files that describe the layout and available keys are stored in Tux Paint "<code>osk</code>" directory. Each keyboard layout is defined by a number of files (some of which may be shared by different layouts).      </p>
       <p>
         Si shembull, do të përdorim një tastierë QWERTY:      </p>
       
@@ -1142,7 +1142,7 @@
         </blockquote>
 
         <p class="note">
-          <span title="Configuration option">&#9881;</span>          <strong>Shënim:</strong> Rreshta të zbrazët brenda kartelës “<code>.layout</code>” do të shpërfillen, siç do të ndodhë edhe me çfarëdo teksti në vijim të një shenje “<code>#</code>” (sterlinë/hash) — mund të përdoret për të terguar komente, siç shihet në shembullin më sipër.        </p>
+          <span title="Configuration option">&#9881;</span>          <strong>Note:</strong> Blank lines within the "<code>.layout</code>" file will be ignored, as will any text following a "<code>#</code>" (pound/hash) character — it can be used to denote comments, as seen in the example below.        </p>
 
         <p>
           Rreshti “<code>keyboardlist</code>” përshkruan te cila skema të kalohet, kur përdoruesi klikon butonat majtas dhe djathtas te tastiera. (Shihni më poshtë.)        </p>
@@ -1157,6 +1157,9 @@
         <p>
           Kjo përshkruan se sa e madhe është tastiera (si kuadrat "width × height") dhe tregon çdo tast me kodin numerik të tastit (shihni kartelën “<code>keymap</code>” më poshtë), gjerësia sa duhet vizatuar (zakonisht “<code>1.0</code>”, për të zënë një vend te tastiera, por, në shembullin më sipër, vini re se tastet “<code>TAB</code>” dhe “<code>SPACE</code>” janë shumë më të gjerë), shenja ose teksti që duhet shfaqur mbi tastin, në varësi se cilët taste ndryshues janë shtypur (një nga : pa ndryshues, <b><code>[Tasti Shift]</code></b>, <b><code>[Tasti AltGr]</code></b> dhe <b><code>[Tasti Shift]</code></b> + <b><code>[Tasti AltGr]</code></b>) dhe, së fundi, nëse preken apo jo tastet nga tasti <b><code>[Tasti Capslock]</code></b> (përdorni “<code>1</code>”) ose tasti <b><code>[Tasti AltGr]</code></b> (grafika alternative) (përdorni “<code>2</code>”), ose fare (përdorni “<code>0</code>”).        </p>
 
+        <p>
+          The "<code>NEWLINE</code>" keyword is used to indicate the end of one row of the keyboard, and thus subsequent key layout descriptions will be beginning on a new row.        </p>
+
         <blockquote>
           <p>
             <code>WIDTH 15<br>
@@ -1193,10 +1196,14 @@
             KEY 64 2.0 Alt Alt Alt Alt 0<br>
             <br>
             # Tasti Hapësirë<br>
-            KEY 65 7.0 SPACE SPACE SPACE SPACE 0<br>
+            KEY 65 5.0 SPACE SPACE SPACE SPACE 0<br>
             <br>
+            # AltGr<br>
             KEY 108 2.0 AltGr AltGr AltGr AltGr 0<br>
             <br>
+            # Paste<br>
+            KEY 143 2.0 Paste Paste Paste Paste 0<br>
+            <br>
             # Shigjeta për majtas do ta kthejë te tastiera pasuese<br>
             KEY 1 1.0 -&gt; -&gt; -&gt; -&gt; 0</code>
           </p>
@@ -1221,6 +1228,10 @@
             <code>2</code> —
                 skema e mëparshme (per the layout file's "<code>keyboardlist</code>" setting)          </li>
         </ul>
+
+        <p class="note">
+          <span title="Version variation">&#128220;</span>          Starting with Tux Paint 0.9.35, the <code>XF86Paste</code> keysym (value 143) can be used to initiate a copy/paste clipboard buffer "paste" event. See the "Paste" key in the keyboard layout files. (Pasting via a physical keyboard is initiated using the <code>[Control]</code> + <code>[V]</code> key combination.        </p>
+
       </section><!-- H2: Keyboard layout file ("qwerty.h_layout") -->
 
       <section><!-- H2: Keymap file ("us-intl-altgr-dead-keys.keymap") -->

docs/sq_AL.UTF-8/html/README.html

@@ -102,7 +102,7 @@
           </p>
 
           <p>
-            25 tetor 2024          </p>
+            25 dhjetor 2024          </p>
         </center>
       </header>
       <table border="2"
@@ -230,6 +230,9 @@
     <dl>
   <dt>Improved color picker</dt>
   <dd>Better behavior when clicking/tapping and dragging hue/saturation box and value slider.</dd>
+
+  <dt>Text clipboard paste support</dt>
+  <dd>The "Text" and "Label" tools support pasting the copy/paste clipboard.</dd>
 </dl>
 
     <p>
@@ -819,6 +822,9 @@
   <p>
     Alternatively, press <strong><code>[Tasti Tab]</code></strong> and the text will be drawn onto the picture, but the cursor will move to the right of the text, rather than down a line, and to the left. (This can be useful to create a line of text with mixed colors, fonts, styles and sizes.)  </p>
 
+  <p>
+    Text from the clipboard (copy/paste buffer) can be inserted with the "Text" and "Label" tools by pressing the <strong><code>[Control]</code> + <code>[V]</code></strong> key combination on a physical keyboard, or clicking the "<strong>Paste</strong>" button in Tux Paint's on-screen keyboard.  The text will wrap to the next line if it hits the right edge of the canvas.  If the text hits the bottom of the canvas, the pasting will abort, truncating the text.  </p>
+
   <p>
     Clicking elsewhere in the picture while the text entry is still active causes the current line of text to move to that location (where you can continue editing it).  </p>
 
@@ -849,6 +855,9 @@
 
       <p class="note">
         <span title="Configuration option">&#9881;</span>        The <strong>Label</strong> tool can be disabled (e.g., by selecting "Disable 'Label' Tool" in <em>Tux Paint Config.</em> or running <em>Tux Paint</em> with the "<code>nolabel</code>" option).      </p>
+
+      <p class="note">
+        <span title="Version variation">&#128220;</span>        The ability to paste text from the clipboard was added in Tux Paint 0.9.35      </p>
     </dd>
 
     <dt>
@@ -886,7 +895,23 @@
 
     <dd>
       <p>
-        An optional on-screen keyboard is available for the Text and Label tools, which can provide a variety of layouts and character composition (e.g., composing "a" and "e" into "æ").      </p>
+        An optional on-screen keyboard is available for the Text and Label tools, which can provide a variety of layouts and character composition (e.g., composing "a" and "e" into "æ").  Run Tux Paint with the "<code>--onscreen-keyboard</code>" option, or enable that setting in Tux Paint's configuration file, to enable it.  Multiple layouts are offered (currently "QWERTY" and "ABC"), which the user can switch between.  Additional configuration options allow specifying a default layout, as well as preventing the layout from being changed.      </p>
+
+      <p>
+        The on-screen keyboard appears at the bottom or top of the Tux Paint window, obscuring part of the canvas, depending on where the text insertion cursor is placed.  Along with alphabetic, numeric, and some punctuation keys, the keyboard provides:        <ul>
+          <li>A "Backspace" key (&#8656;) to remove the previous character</li>
+          <li>A "Carriage Return" ("Return"/"Enter") key (&#9166;) to end the current input and begin a new one on the following line (below and to the left)</li>
+          <li>A "Tab" key (&#8660;) to end the current input and begin a new one at the current cursor position</li>
+          <li>A "Shift" key (&#8657;) to shift alphabetic keys from lowercase to uppercase, access more punctuation, etc.</li>
+          <li>A "Caps Lock" key (&#10514;) to toggle permanent shifting of alphabetic keys from lowercase to uppercase (click it again to disable caps lock)</li>
+          <li>A "Compose" key ("Cmp"), to initiate character composition (e.g., click "Cmp", "a", "e" to produce an "æ" character)</li>
+          <li>An "Alternate Graphics" key ("AltGr") to access additional characters (e.g., "¿", "ß", etc.)</li>
+          <li>An "Alternate" key ("Alt")</li>
+          <li>A "Paste" key to paste the current clipboard's text into the Text or Label tool</li>
+          <li>Left and right arrows (&larr; &amp; &rarr;) to access different on-screen keyboard layouts</li>
+        </ul>
+      </p>
+
       <p class="note">
         <span title="Configuration option">&#9881;</span>        See the "<a href="OPTIONS.html"><em>Options</em></a>" and "<a href="EXTENDING.html"><em>Extending Tux Paint</em></a>" documentation for more information.      </p>
     </dd>