Sync docs re: forthcoming complexity option

docs/en/OPTIONS.txt

@@ -6,7 +6,7 @@
         Copyright © 2002-2023 by various contributors; see AUTHORS.txt.
                              https://tuxpaint.org/
 
-                                 July 20, 2023
+                               December 29, 2023
 
 +--------------------------------------------+
 |             Table of Contents              |
@@ -517,6 +517,38 @@ nobrushspacing=yes
 
 
 
+complexity=COMPLEXITY
+
+    Sets the complexity (expertise) level of Tux Paint, which can either
+    disable some Magic tools, or cause them to operate differently. (For
+    example, the "Clone" tool is not available in novice mode, and the 1-, 2-,
+    and 3-point perspective tools do not allow vanishing points to be edited in
+    beginner mode.)
+
+    The COMPLEXITY value may be one of:
+
+    advanced (the default)
+        "Advanced" — For users familiar with Tux Paint and who can operate more
+        complex tools.
+
+    beginner
+        "Beginner" — For users comfortable with Tux Paint, but where complex
+        tools may cause confusion or frustration.
+
+    novice
+        "Novice" — For first-time Tux Paint users, users inexperienced with
+        computers, or those with special accessibility needs.
+
+
+    📜 Note: The complexity option was added to Tux Paint in version 0.9.32.
+    Consult the individual Magic tools' documentation.
+
+    ⚙ Note: If used in a system-wide configuration file, may be overridden by
+    the user's configuration file using "complexity=advanced". In both cases,
+    may be overridden by the command-line option "--complexity=advanced".
+
+
+
 notemplateexport=yes
 
     Disables the ability to create a new Template image (based on a saved

docs/en/README.txt

@@ -111,6 +111,12 @@ D. What's New in Tux Paint version 0.9.32?
     A pair of tools that allow you to set three vanishing points, and then draw
     lines in 3-point perspective.
 
+New "complexity" setting (complexity)
+
+A new setting that allows certain Magic tools to behave differently (or remove
+    their availability altogether) based on the expertise-level of the user.
+    The new "N-point Perspective" tools and "Clone" tool are affected by this
+    setting.
 Font details shown when selected
     The name and size of the selected font are shown when using the Text and
     Label tools.

docs/en/html/OPTIONS.html

@@ -102,7 +102,7 @@
           </p>
 
           <p>
-            July 20, 2023          </p>
+            December 29, 2023          </p>
         </center>
       </header>
 
@@ -711,6 +711,29 @@
         <span title="Configuration option">&#9881;</span>        <strong>Note:</strong> If used in a system-wide configuration file, may be overridden by the user's configuration file using "<code>nobrushspacing=no</code>" or "<code>brushspacing=yes</code>". In both cases, may be overridden by the command-line option "<code>--brushspacing</code>".      </p>
     </dd>
 
+    <dt>
+      <code><b>complexity=<i>COMPLEXITY</i></b></code>
+    </dt>
+
+    <dd>
+      <p>
+        Sets the complexity (expertise) level of Tux Paint, which can either disable some Magic tools, or cause them to operate differently. (For example, the "Clone" tool is not available in <em>novice</em> mode, and the 1-, 2-, and 3-point perspective tools do not allow vanishing points to be edited in <em>beginner</em> mode.)      </p>
+      <p>
+        The <code>COMPLEXITY</code> value may be one of:        <dl>
+          <dt><code>advanced</code> (the default)</dt>
+          <dd>"Advanced" &mdash; For users familiar with Tux Paint and who can operate more complex tools.</dd>
+          <dt><code>beginner</code></dt>
+          <dd>"Beginner" &mdash; For users comfortable with Tux Paint, but where complex tools may cause confusion or frustration.</dd>
+          <dt><code>novice</code></dt>
+          <dd>"Novice" &mdash; For first-time Tux Paint users, users inexperienced with computers, or those with special accessibility needs.</dd>
+        </dl>
+      </p>
+      <p class="note">
+        <span title="Version variation">&#128220;</span>        <strong>Note:</strong> The complexity option was added to Tux Paint in version 0.9.32. Consult the <a href="magic-docs/html/index.html">individual Magic tools' documentation</a>.      </p>
+      <p class="note">
+        <span title="Configuration option">&#9881;</span>        <strong>Note:</strong> If used in a system-wide configuration file, may be overridden by the user's configuration file using "<code>complexity=advanced</code>". In both cases, may be overridden by the command-line option "<code>--complexity=advanced</code>".      </p>
+    </dd>
+
     <dt>
       <code><b>notemplateexport=yes</b></code>
     </dt>

docs/en/html/README.html

@@ -237,6 +237,9 @@
   <dt>3-point Perspective (vanishing point) Magic tool</dt>
   <dd>A pair of tools that allow you to set three vanishing points, and then draw lines in 3-point perspective.</dd>
 
+  <dt>New "complexity" setting (<code>complexity</code>)</dd>
+  <dt>A new setting that allows certain Magic tools to behave differently (or remove their availability altogether) based on the expertise-level of the user. The new "N-point Perspective" tools and "Clone" tool are affected by this setting.</dt>
+
   <dt>Font details shown when selected</dt>
   <dd>The name and size of the selected font are shown when using the Text and Label tools.</dd>
 </dl>

docs/es_ES.UTF-8/OPTIONS.txt

@@ -6,7 +6,7 @@
         Copyright © 2002-2023 by various contributors; see AUTHORS.txt.
                              https://tuxpaint.org/
 
-                                julio 20, 2023
+                              diciembre 29, 2023
 
 +--------------------------------------------+
 |             Table of Contents              |
@@ -517,6 +517,38 @@ nobrushspacing=yes
 
 
 
+complexity=COMPLEXITY
+
+    Sets the complexity (expertise) level of Tux Paint, which can either
+    disable some Magic tools, or cause them to operate differently. (For
+    example, the "Clone" tool is not available in novice mode, and the 1-, 2-,
+    and 3-point perspective tools do not allow vanishing points to be edited in
+    beginner mode.)
+
+    The COMPLEXITY value may be one of:
+
+    advanced (the default)
+        "Advanced" — For users familiar with Tux Paint and who can operate more
+        complex tools.
+
+    beginner
+        "Beginner" — For users comfortable with Tux Paint, but where complex
+        tools may cause confusion or frustration.
+
+    novice
+        "Novice" — For first-time Tux Paint users, users inexperienced with
+        computers, or those with special accessibility needs.
+
+
+    📜 Note: The complexity option was added to Tux Paint in version 0.9.32.
+    Consult the individual Magic tools' documentation.
+
+    ⚙ Note: If used in a system-wide configuration file, may be overridden by
+    the user's configuration file using "complexity=advanced". In both cases,
+    may be overridden by the command-line option "--complexity=advanced".
+
+
+
 notemplateexport=yes
 
     Disables the ability to create a new Template image (based on a saved

docs/es_ES.UTF-8/README.txt

@@ -111,6 +111,12 @@ D. What's New in Tux Paint version 0.9.32?
     A pair of tools that allow you to set three vanishing points, and then draw
     lines in 3-point perspective.
 
+New "complexity" setting (complexity)
+
+A new setting that allows certain Magic tools to behave differently (or remove
+    their availability altogether) based on the expertise-level of the user.
+    The new "N-point Perspective" tools and "Clone" tool are affected by this
+    setting.
 Font details shown when selected
     The name and size of the selected font are shown when using the Text and
     Label tools.

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

@@ -102,7 +102,7 @@
           </p>
 
           <p>
-            julio 20, 2023          </p>
+            diciembre 29, 2023          </p>
         </center>
       </header>
 
@@ -711,6 +711,29 @@
         <span title="Configuration option">&#9881;</span>        <strong>Note:</strong> If used in a system-wide configuration file, may be overridden by the user's configuration file using "<code>nobrushspacing=no</code>" or "<code>brushspacing=yes</code>". In both cases, may be overridden by the command-line option "<code>--brushspacing</code>".      </p>
     </dd>
 
+    <dt>
+      <code><b>complexity=<i>COMPLEXITY</i></b></code>
+    </dt>
+
+    <dd>
+      <p>
+        Sets the complexity (expertise) level of Tux Paint, which can either disable some Magic tools, or cause them to operate differently. (For example, the "Clone" tool is not available in <em>novice</em> mode, and the 1-, 2-, and 3-point perspective tools do not allow vanishing points to be edited in <em>beginner</em> mode.)      </p>
+      <p>
+        The <code>COMPLEXITY</code> value may be one of:        <dl>
+          <dt><code>advanced</code> (the default)</dt>
+          <dd>"Advanced" &mdash; For users familiar with Tux Paint and who can operate more complex tools.</dd>
+          <dt><code>beginner</code></dt>
+          <dd>"Beginner" &mdash; For users comfortable with Tux Paint, but where complex tools may cause confusion or frustration.</dd>
+          <dt><code>novice</code></dt>
+          <dd>"Novice" &mdash; For first-time Tux Paint users, users inexperienced with computers, or those with special accessibility needs.</dd>
+        </dl>
+      </p>
+      <p class="note">
+        <span title="Version variation">&#128220;</span>        <strong>Note:</strong> The complexity option was added to Tux Paint in version 0.9.32. Consult the <a href="magic-docs/html/index.html">individual Magic tools' documentation</a>.      </p>
+      <p class="note">
+        <span title="Configuration option">&#9881;</span>        <strong>Note:</strong> If used in a system-wide configuration file, may be overridden by the user's configuration file using "<code>complexity=advanced</code>". In both cases, may be overridden by the command-line option "<code>--complexity=advanced</code>".      </p>
+    </dd>
+
     <dt>
       <code><b>notemplateexport=yes</b></code>
     </dt>

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

@@ -237,6 +237,9 @@
   <dt>3-point Perspective (vanishing point) Magic tool</dt>
   <dd>A pair of tools that allow you to set three vanishing points, and then draw lines in 3-point perspective.</dd>
 
+  <dt>New "complexity" setting (<code>complexity</code>)</dd>
+  <dt>A new setting that allows certain Magic tools to behave differently (or remove their availability altogether) based on the expertise-level of the user. The new "N-point Perspective" tools and "Clone" tool are affected by this setting.</dt>
+
   <dt>Font details shown when selected</dt>
   <dd>The name and size of the selected font are shown when using the Text and Label tools.</dd>
 </dl>

docs/fr_FR.UTF-8/OPTIONS.txt

@@ -6,7 +6,7 @@
        Copyright © 2002-2023 by divers contributeurs; voir AUTHORS.txt.
                              https://tuxpaint.org/
 
-                               juillet 20, 2023
+                               décembre 29, 2023
 
 +--------------------------------------------------------------------+
 |                         Table des matières                         |
@@ -554,6 +554,39 @@ nobrushspacing=yes
 
 
 
+complexity=COMPLEXITY
+
+    Sets the complexity (expertise) level of Tux Paint, which can either
+    disable some Magic tools, or cause them to operate differently. (For
+    example, the "Clone" tool is not available in novice mode, and the 1-, 2-,
+    and 3-point perspective tools do not allow vanishing points to be edited in
+    beginner mode.)
+
+    The COMPLEXITY value may be one of:
+
+    advanced (par défaut)
+        "Advanced" — For users familiar with Tux Paint and who can operate more
+        complex tools.
+
+    beginner
+        "Beginner" — For users comfortable with Tux Paint, but where complex
+        tools may cause confusion or frustration.
+
+    novice
+        "Novice" — For first-time Tux Paint users, users inexperienced with
+        computers, or those with special accessibility needs.
+
+
+    📜 Note: The complexity option was added to Tux Paint in version 0.9.32.
+    Consult the individual Magic tools' documentation.
+
+    ⚙ Note : si utilisé dans un fichier de configuration pour tout le monde, il
+    peut être remplacé par le fichier de configuration de l'utilisateur en
+    utilisant "complexity=advanced". Dans les deux cas, il peut être remplacé
+    avec l'option en ligne de commande "--complexity=advanced".
+
+
+
 notemplateexport=yes
 
     Désactive la possibilité de créer de nouvelles images Modèle (basées sur

docs/fr_FR.UTF-8/README.txt

@@ -116,6 +116,12 @@ Outil Magie avec une perspective à 2 points de fuite
     A pair of tools that allow you to set three vanishing points, and then draw
     lines in 3-point perspective.
 
+New "complexity" setting (complexity)
+
+A new setting that allows certain Magic tools to behave differently (or remove
+    their availability altogether) based on the expertise-level of the user.
+    The new "N-point Perspective" tools and "Clone" tool are affected by this
+    setting.
 Les détails de la police sont affichés lors du choix
     Le nom et la taille de la police choisie sont montrés quand on utilise les
     outils Texte et Étiquette.

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

@@ -102,7 +102,7 @@
           </p>
 
           <p>
-            juillet 20, 2023          </p>
+            décembre 29, 2023          </p>
         </center>
       </header>
 
@@ -711,6 +711,29 @@
         <span title="Configuration option">&#9881;</span>        <strong>Note : </strong>si utilisé dans un fichier de configuration pour tout le monde, il peut être remplacé par le fichier de configuration de l'utilisateur en utilisant "<code>nobrushspacing=no</code>" ou "<code>brushspacing=yes</code>". Dans les deux cas, il peut être remplacé avec l'option en ligne de commande "<code>--brushspacing</code>".      </p>
     </dd>
 
+    <dt>
+      <code><b>complexity=<i>COMPLEXITY</i></b></code>
+    </dt>
+
+    <dd>
+      <p>
+        Sets the complexity (expertise) level of Tux Paint, which can either disable some Magic tools, or cause them to operate differently. (For example, the "Clone" tool is not available in <em>novice</em> mode, and the 1-, 2-, and 3-point perspective tools do not allow vanishing points to be edited in <em>beginner</em> mode.)      </p>
+      <p>
+        The <code>COMPLEXITY</code> value may be one of:        <dl>
+          <dt><code>advanced</code> (par défaut)</dt>
+          <dd>"Advanced" &mdash; For users familiar with Tux Paint and who can operate more complex tools.</dd>
+          <dt><code>beginner</code></dt>
+          <dd>"Beginner" &mdash; For users comfortable with Tux Paint, but where complex tools may cause confusion or frustration.</dd>
+          <dt><code>novice</code></dt>
+          <dd>"Novice" &mdash; For first-time Tux Paint users, users inexperienced with computers, or those with special accessibility needs.</dd>
+        </dl>
+      </p>
+      <p class="note">
+        <span title="Version variation">&#128220;</span>        <strong>Note:</strong> The complexity option was added to Tux Paint in version 0.9.32. Consult the <a href="magic-docs/html/index.html">individual Magic tools' documentation</a>.      </p>
+      <p class="note">
+        <span title="Configuration option">&#9881;</span>        <strong>Note : </strong> si utilisé dans un fichier de configuration pour tout le monde, il peut être remplacé par le fichier de configuration de l'utilisateur en utilisant "<code>complexity=advanced</code>". Dans les deux cas, il peut être remplacé avec l'option en ligne de commande "<code>--complexity=advanced</code>".      </p>
+    </dd>
+
     <dt>
       <code><b>notemplateexport=yes</b></code>
     </dt>

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

@@ -237,6 +237,9 @@
   <dt>3-point Perspective (vanishing point) Magic tool</dt>
   <dd>A pair of tools that allow you to set three vanishing points, and then draw lines in 3-point perspective.</dd>
 
+  <dt>New "complexity" setting (<code>complexity</code>)</dd>
+  <dt>A new setting that allows certain Magic tools to behave differently (or remove their availability altogether) based on the expertise-level of the user. The new "N-point Perspective" tools and "Clone" tool are affected by this setting.</dt>
+
   <dt>Les détails de la police sont affichés lors du choix</dt>
   <dd>Le nom et la taille de la police choisie sont montrés quand on utilise les outils Texte et Étiquette.</dd>
 </dl>

docs/gl_ES.UTF-8/OPTIONS.txt

@@ -6,7 +6,7 @@
         Copyright © 2002-2023 by varios colaboradores; see AUTHORS.txt.
                              https://tuxpaint.org/
 
-                              20 de Xullo de 2023
+                            29 de Decembro de 2023
 
 +----------------------------------------------------+
 |                       Índice                       |
@@ -526,6 +526,38 @@ nobrushspacing=yes
 
 
 
+complexity=COMPLEXITY
+
+    Sets the complexity (expertise) level of Tux Paint, which can either
+    disable some Magic tools, or cause them to operate differently. (For
+    example, the "Clone" tool is not available in novice mode, and the 1-, 2-,
+    and 3-point perspective tools do not allow vanishing points to be edited in
+    beginner mode.)
+
+    The COMPLEXITY value may be one of:
+
+    advanced (o predeterminado)
+        "Advanced" — For users familiar with Tux Paint and who can operate more
+        complex tools.
+
+    beginner
+        "Beginner" — For users comfortable with Tux Paint, but where complex
+        tools may cause confusion or frustration.
+
+    novice
+        "Novice" — For first-time Tux Paint users, users inexperienced with
+        computers, or those with special accessibility needs.
+
+
+    📜 Note: The complexity option was added to Tux Paint in version 0.9.32.
+    Consult the individual Magic tools' documentation.
+
+    ⚙ Note: If used in a system-wide configuration file, may be overridden by
+    the user's configuration file using "complexity=advanced". In both cases,
+    may be overridden by the command-line option "--complexity=advanced".
+
+
+
 notemplateexport=yes
 
     Disables the ability to create a new Template image (based on a saved

docs/gl_ES.UTF-8/README.txt

@@ -112,6 +112,12 @@ D. What's New in Tux Paint version 0.9.32?
     A pair of tools that allow you to set three vanishing points, and then draw
     lines in 3-point perspective.
 
+New "complexity" setting (complexity)
+
+A new setting that allows certain Magic tools to behave differently (or remove
+    their availability altogether) based on the expertise-level of the user.
+    The new "N-point Perspective" tools and "Clone" tool are affected by this
+    setting.
 Font details shown when selected
     The name and size of the selected font are shown when using the Text and
     Label tools.

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

@@ -102,7 +102,7 @@
           </p>
 
           <p>
-            20 de Xullo de 2023          </p>
+            29 de Decembro de 2023          </p>
         </center>
       </header>
 
@@ -711,6 +711,29 @@
         <span title="Configuration option">&#9881;</span>        <strong>Note:</strong> If used in a system-wide configuration file, may be overridden by the user's configuration file using "<code>nobrushspacing=no</code>" or "<code>brushspacing=yes</code>". In both cases, may be overridden by the command-line option "<code>--brushspacing</code>".      </p>
     </dd>
 
+    <dt>
+      <code><b>complexity=<i>COMPLEXITY</i></b></code>
+    </dt>
+
+    <dd>
+      <p>
+        Sets the complexity (expertise) level of Tux Paint, which can either disable some Magic tools, or cause them to operate differently. (For example, the "Clone" tool is not available in <em>novice</em> mode, and the 1-, 2-, and 3-point perspective tools do not allow vanishing points to be edited in <em>beginner</em> mode.)      </p>
+      <p>
+        The <code>COMPLEXITY</code> value may be one of:        <dl>
+          <dt><code>advanced</code> (o predeterminado)</dt>
+          <dd>"Advanced" &mdash; For users familiar with Tux Paint and who can operate more complex tools.</dd>
+          <dt><code>beginner</code></dt>
+          <dd>"Beginner" &mdash; For users comfortable with Tux Paint, but where complex tools may cause confusion or frustration.</dd>
+          <dt><code>novice</code></dt>
+          <dd>"Novice" &mdash; For first-time Tux Paint users, users inexperienced with computers, or those with special accessibility needs.</dd>
+        </dl>
+      </p>
+      <p class="note">
+        <span title="Version variation">&#128220;</span>        <strong>Note:</strong> The complexity option was added to Tux Paint in version 0.9.32. Consult the <a href="magic-docs/html/index.html">individual Magic tools' documentation</a>.      </p>
+      <p class="note">
+        <span title="Configuration option">&#9881;</span>        <strong>Note:</strong> If used in a system-wide configuration file, may be overridden by the user's configuration file using "<code>complexity=advanced</code>". In both cases, may be overridden by the command-line option "<code>--complexity=advanced</code>".      </p>
+    </dd>
+
     <dt>
       <code><b>notemplateexport=yes</b></code>
     </dt>

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

@@ -237,6 +237,9 @@
   <dt>3-point Perspective (vanishing point) Magic tool</dt>
   <dd>A pair of tools that allow you to set three vanishing points, and then draw lines in 3-point perspective.</dd>
 
+  <dt>New "complexity" setting (<code>complexity</code>)</dd>
+  <dt>A new setting that allows certain Magic tools to behave differently (or remove their availability altogether) based on the expertise-level of the user. The new "N-point Perspective" tools and "Clone" tool are affected by this setting.</dt>
+
   <dt>Font details shown when selected</dt>
   <dd>The name and size of the selected font are shown when using the Text and Label tools.</dd>
 </dl>

docs/is_IS.UTF-8/OPTIONS.txt

@@ -6,7 +6,7 @@
         Copyright © 2002-2023 by various contributors; see AUTHORS.txt.
                              https://tuxpaint.org/
 
-                                 júlí 20, 2023
+                               desember 29, 2023
 
 +--------------------------------------------+
 |             Table of Contents              |
@@ -517,6 +517,38 @@ nobrushspacing=yes
 
 
 
+complexity=COMPLEXITY
+
+    Sets the complexity (expertise) level of Tux Paint, which can either
+    disable some Magic tools, or cause them to operate differently. (For
+    example, the "Clone" tool is not available in novice mode, and the 1-, 2-,
+    and 3-point perspective tools do not allow vanishing points to be edited in
+    beginner mode.)
+
+    The COMPLEXITY value may be one of:
+
+    advanced (the default)
+        "Advanced" — For users familiar with Tux Paint and who can operate more
+        complex tools.
+
+    beginner
+        "Beginner" — For users comfortable with Tux Paint, but where complex
+        tools may cause confusion or frustration.
+
+    novice
+        "Novice" — For first-time Tux Paint users, users inexperienced with
+        computers, or those with special accessibility needs.
+
+
+    📜 Note: The complexity option was added to Tux Paint in version 0.9.32.
+    Consult the individual Magic tools' documentation.
+
+    ⚙ Note: If used in a system-wide configuration file, may be overridden by
+    the user's configuration file using "complexity=advanced". In both cases,
+    may be overridden by the command-line option "--complexity=advanced".
+
+
+
 notemplateexport=yes
 
     Disables the ability to create a new Template image (based on a saved

docs/is_IS.UTF-8/README.txt

@@ -111,6 +111,12 @@ D. What's New in Tux Paint version 0.9.32?
     A pair of tools that allow you to set three vanishing points, and then draw
     lines in 3-point perspective.
 
+New "complexity" setting (complexity)
+
+A new setting that allows certain Magic tools to behave differently (or remove
+    their availability altogether) based on the expertise-level of the user.
+    The new "N-point Perspective" tools and "Clone" tool are affected by this
+    setting.
 Font details shown when selected
     The name and size of the selected font are shown when using the Text and
     Label tools.

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

@@ -102,7 +102,7 @@
           </p>
 
           <p>
-            júlí 20, 2023          </p>
+            desember 29, 2023          </p>
         </center>
       </header>
 
@@ -711,6 +711,29 @@
         <span title="Configuration option">&#9881;</span>        <strong>Note:</strong> If used in a system-wide configuration file, may be overridden by the user's configuration file using "<code>nobrushspacing=no</code>" or "<code>brushspacing=yes</code>". In both cases, may be overridden by the command-line option "<code>--brushspacing</code>".      </p>
     </dd>
 
+    <dt>
+      <code><b>complexity=<i>COMPLEXITY</i></b></code>
+    </dt>
+
+    <dd>
+      <p>
+        Sets the complexity (expertise) level of Tux Paint, which can either disable some Magic tools, or cause them to operate differently. (For example, the "Clone" tool is not available in <em>novice</em> mode, and the 1-, 2-, and 3-point perspective tools do not allow vanishing points to be edited in <em>beginner</em> mode.)      </p>
+      <p>
+        The <code>COMPLEXITY</code> value may be one of:        <dl>
+          <dt><code>advanced</code> (the default)</dt>
+          <dd>"Advanced" &mdash; For users familiar with Tux Paint and who can operate more complex tools.</dd>
+          <dt><code>beginner</code></dt>
+          <dd>"Beginner" &mdash; For users comfortable with Tux Paint, but where complex tools may cause confusion or frustration.</dd>
+          <dt><code>novice</code></dt>
+          <dd>"Novice" &mdash; For first-time Tux Paint users, users inexperienced with computers, or those with special accessibility needs.</dd>
+        </dl>
+      </p>
+      <p class="note">
+        <span title="Version variation">&#128220;</span>        <strong>Note:</strong> The complexity option was added to Tux Paint in version 0.9.32. Consult the <a href="magic-docs/html/index.html">individual Magic tools' documentation</a>.      </p>
+      <p class="note">
+        <span title="Configuration option">&#9881;</span>        <strong>Note:</strong> If used in a system-wide configuration file, may be overridden by the user's configuration file using "<code>complexity=advanced</code>". In both cases, may be overridden by the command-line option "<code>--complexity=advanced</code>".      </p>
+    </dd>
+
     <dt>
       <code><b>notemplateexport=yes</b></code>
     </dt>

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

@@ -237,6 +237,9 @@
   <dt>3-point Perspective (vanishing point) Magic tool</dt>
   <dd>A pair of tools that allow you to set three vanishing points, and then draw lines in 3-point perspective.</dd>
 
+  <dt>New "complexity" setting (<code>complexity</code>)</dd>
+  <dt>A new setting that allows certain Magic tools to behave differently (or remove their availability altogether) based on the expertise-level of the user. The new "N-point Perspective" tools and "Clone" tool are affected by this setting.</dt>
+
   <dt>Font details shown when selected</dt>
   <dd>The name and size of the selected font are shown when using the Text and Label tools.</dd>
 </dl>

docs/ja_JP.UTF-8/OPTIONS.txt

@@ -6,7 +6,7 @@
        Copyright © 2002-2023 by various contributors; AUTHORS.txt 参照.
                              https://tuxpaint.org/
 
-                                 2023年7月20日
+                                2023年12月29日
 
 +------------------------------------------------------+
 |                         目次                         |
@@ -524,6 +524,39 @@ nobrushspacing=yes
 
 
 
+complexity=COMPLEXITY
+
+    Sets the complexity (expertise) level of Tux Paint, which can either
+    disable some Magic tools, or cause them to operate differently. (For
+    example, the "Clone" tool is not available in novice mode, and the 1-, 2-,
+    and 3-point perspective tools do not allow vanishing points to be edited in
+    beginner mode.)
+
+    The COMPLEXITY value may be one of:
+
+    advanced (the default)
+        "Advanced" — For users familiar with Tux Paint and who can operate more
+        complex tools.
+
+    beginner
+        "Beginner" — For users comfortable with Tux Paint, but where complex
+        tools may cause confusion or frustration.
+
+    novice
+        "Novice" — For first-time Tux Paint users, users inexperienced with
+        computers, or those with special accessibility needs.
+
+
+    📜 Note: The complexity option was added to Tux Paint in version 0.9.32.
+    Consult the individual Magic tools' documentation.
+
+    ⚙ 注: システム全体の設定ファイルで設定されている場合は、ユーザーの設定ファ
+    イルで "complexity=advanced" を設定すると上書きされることがあります。また、
+    どちらの設定も、コマンドラインオプションの "--complexity=advanced" で変更で
+    きます。
+
+
+
 notemplateexport=yes
 
     「ひらく」ダイアログで、保存された作品を用いて新しいテンプレート画像を作成

docs/ja_JP.UTF-8/README.txt

@@ -109,6 +109,12 @@ D. Tux Paint バージョン 0.9.32 での変更点
     A pair of tools that allow you to set three vanishing points, and then draw
     lines in 3-point perspective.
 
+New "complexity" setting (complexity)
+
+A new setting that allows certain Magic tools to behave differently (or remove
+    their availability altogether) based on the expertise-level of the user.
+    The new "N-point Perspective" tools and "Clone" tool are affected by this
+    setting.
 Font details shown when selected
     The name and size of the selected font are shown when using the Text and
     Label tools.

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

@@ -102,7 +102,7 @@
           </p>
 
           <p>
-            2023年7月20日          </p>
+            2023年12月29日          </p>
         </center>
       </header>
 
@@ -711,6 +711,29 @@
         <span title="Configuration option">&#9881;</span>        <strong>注:</strong> システム全体の設定ファイルで設定されている場合は、ユーザーの設定ファイルで "<code>nobrushspacing=no</code>" または "<code>brushspacing=yes</code>" を設定すると上書きされることがあります。また、どちらの設定も、コマンドラインオプションの "<code>--brushspacing</code>" で変更できます。      </p>
     </dd>
 
+    <dt>
+      <code><b>complexity=<i>COMPLEXITY</i></b></code>
+    </dt>
+
+    <dd>
+      <p>
+        Sets the complexity (expertise) level of Tux Paint, which can either disable some Magic tools, or cause them to operate differently. (For example, the "Clone" tool is not available in <em>novice</em> mode, and the 1-, 2-, and 3-point perspective tools do not allow vanishing points to be edited in <em>beginner</em> mode.)      </p>
+      <p>
+        The <code>COMPLEXITY</code> value may be one of:        <dl>
+          <dt><code>advanced</code> (the default)</dt>
+          <dd>"Advanced" &mdash; For users familiar with Tux Paint and who can operate more complex tools.</dd>
+          <dt><code>beginner</code></dt>
+          <dd>"Beginner" &mdash; For users comfortable with Tux Paint, but where complex tools may cause confusion or frustration.</dd>
+          <dt><code>novice</code></dt>
+          <dd>"Novice" &mdash; For first-time Tux Paint users, users inexperienced with computers, or those with special accessibility needs.</dd>
+        </dl>
+      </p>
+      <p class="note">
+        <span title="Version variation">&#128220;</span>        <strong>Note:</strong> The complexity option was added to Tux Paint in version 0.9.32. Consult the <a href="magic-docs/html/index.html">individual Magic tools' documentation</a>.      </p>
+      <p class="note">
+        <span title="Configuration option">&#9881;</span>        <strong>注:</strong> システム全体の設定ファイルで設定されている場合は、ユーザーの設定ファイルで "<code>complexity=advanced</code>" を設定すると上書きされることがあります。また、どちらの設定も、コマンドラインオプションの "<code>--complexity=advanced</code>" で変更できます。      </p>
+    </dd>
+
     <dt>
       <code><b>notemplateexport=yes</b></code>
     </dt>

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

@@ -237,6 +237,9 @@
   <dt>3-point Perspective (vanishing point) Magic tool</dt>
   <dd>A pair of tools that allow you to set three vanishing points, and then draw lines in 3-point perspective.</dd>
 
+  <dt>New "complexity" setting (<code>complexity</code>)</dd>
+  <dt>A new setting that allows certain Magic tools to behave differently (or remove their availability altogether) based on the expertise-level of the user. The new "N-point Perspective" tools and "Clone" tool are affected by this setting.</dt>
+
   <dt>Font details shown when selected</dt>
   <dd>The name and size of the selected font are shown when using the Text and Label tools.</dd>
 </dl>

man/en/tuxpaint.1

@@ -1,5 +1,5 @@
-.\" tuxpaint.1 - 2023.11.21
+.\" tuxpaint.1 - 2023.12.29
-.TH TUXPAINT 1 "November 21, 2023" "0.9.32" "Tux Paint"
+.TH TUXPAINT 1 "December 29, 2023" "0.9.32" "Tux Paint"
 .SH NAME
 tuxpaint -- "Tux Paint", a drawing program for young children.
 
@@ -77,6 +77,8 @@ tuxpaint -- "Tux Paint", a drawing program for young children.
 .br
 [\-\-nobrushspacing]
 .br
+[\-\-complexity=\fIbeginner\fP | \-\-complexity=\fInovice\fP]
+.br
 [\-\-notemplateexport]
 .br
 [\-\-newcolorslast]
@@ -233,6 +235,8 @@ tuxpaint -- "Tux Paint", a drawing program for young children.
 .br
 [\-\-brushspacing]
 .br
+[\-\-complexity=\fIadvanced\fP]
+.br
 [\-\-templateexport]
 .br
 [\-\-newcolorsfirst]
@@ -466,6 +470,11 @@ which can be altered or moved later.
 Disable or enable (default) the brush spacing option of the Paint and Lines
 tools, which allows you to override the default spacing of a brush.
 
+.TP 8
+.B \-\-complexity=advanced \-\-complexity=beginner \-\-complexity=novice
+Set the complexity (expertise) level, which affects whether certain Magic
+tools are available, or how they operate. (advanced is the default)
+
 .TP 8
 .B \-\-notemplateexport \-\-templateexport
 Disable or enable (default) the ability to create new Templates from saved

man/es_ES.UTF-8/tuxpaint.1

@@ -1,5 +1,5 @@
-.\" tuxpaint.1 - 2023.11.21
+.\" tuxpaint.1 - 2023.12.29
-.TH TUXPAINT 1 "noviembre 21, 2023" "0.9.32" "Tux Paint"
+.TH TUXPAINT 1 "diciembre 29, 2023" "0.9.32" "Tux Paint"
 .SH NAME
 tuxpaint -- "Tux Paint", a drawing program for young children.
 
@@ -77,6 +77,8 @@ tuxpaint -- "Tux Paint", a drawing program for young children.
 .br
 [\-\-nobrushspacing]
 .br
+[\-\-complexity=\fIbeginner\fP | \-\-complexity=\fInovice\fP]
+.br
 [\-\-notemplateexport]
 .br
 [\-\-newcolorslast]
@@ -233,6 +235,8 @@ tuxpaint -- "Tux Paint", a drawing program for young children.
 .br
 [\-\-brushspacing]
 .br
+[\-\-complexity=\fIadvanced\fP]
+.br
 [\-\-templateexport]
 .br
 [\-\-newcolorsfirst]
@@ -466,6 +470,11 @@ which can be altered or moved later.
 Disable or enable (default) the brush spacing option of the Paint and Lines
 tools, which allows you to override the default spacing of a brush.
 
+.TP 8
+.B \-\-complexity=advanced \-\-complexity=beginner \-\-complexity=novice
+Set the complexity (expertise) level, which affects whether certain Magic
+tools are available, or how they operate. (advanced is the default)
+
 .TP 8
 .B \-\-notemplateexport \-\-templateexport
 Disable or enable (default) the ability to create new Templates from saved

man/fr_FR.UTF-8/tuxpaint.1

@@ -1,5 +1,5 @@
-.\" tuxpaint.1 - 2023.11.21
+.\" tuxpaint.1 - 2023.12.29
-.TH TUXPAINT 1 "novembre 21, 2023" "0.9.32" "Tux Paint"
+.TH TUXPAINT 1 "décembre 29, 2023" "0.9.32" "Tux Paint"
 .SH NAME
 tuxpaint -- "Tux Paint", un programme simple pour les jeunes enfants.
 
@@ -77,6 +77,8 @@ tuxpaint -- "Tux Paint", un programme simple pour les jeunes enfants.
 .br
 [\-\-nobrushspacing]
 .br
+[\-\-complexity=\fIbeginner\fP | \-\-complexity=\fInovice\fP]
+.br
 [\-\-notemplateexport]
 .br
 [\-\-newcolorslast]
@@ -233,6 +235,8 @@ tuxpaint -- "Tux Paint", un programme simple pour les jeunes enfants.
 .br
 [\-\-brushspacing]
 .br
+[\-\-complexity=\fIadvanced\fP]
+.br
 [\-\-templateexport]
 .br
 [\-\-newcolorsfirst]
@@ -477,6 +481,11 @@ Déactive ou active (par défaut) l'option d'espacement des coups de
 pinceaux et des outils Lignes, ce qui vous permet d'annuler l'espacement
 des coups de pinceaux.
 
+.TP 8
+.B \-\-complexity=advanced \-\-complexity=beginner \-\-complexity=novice
+Set the complexity (expertise) level, which affects whether certain Magic
+tools are available, or how they operate. (advanced is the default)
+
 .TP 8
 .B \-\-notemplateexport \-\-templateexport
 Désactive ou active (défaut) la création de nouveaux Modèles à partir

man/gl_ES.UTF-8/tuxpaint.1

@@ -1,5 +1,5 @@
-.\" tuxpaint.1 - 2023.11.21
+.\" tuxpaint.1 - 2023.12.29
-.TH TUXPAINT 1 "21 de Novembro de 2023" "0.9.32" "Tux Paint"
+.TH TUXPAINT 1 "29 de Decembro de 2023" "0.9.32" "Tux Paint"
 .SH NAME
 tuxpaint -- "Tux Paint", a drawing program for young children.
 
@@ -77,6 +77,8 @@ tuxpaint -- "Tux Paint", a drawing program for young children.
 .br
 [\-\-nobrushspacing]
 .br
+[\-\-complexity=\fIbeginner\fP | \-\-complexity=\fInovice\fP]
+.br
 [\-\-notemplateexport]
 .br
 [\-\-newcolorslast]
@@ -233,6 +235,8 @@ tuxpaint -- "Tux Paint", a drawing program for young children.
 .br
 [\-\-brushspacing]
 .br
+[\-\-complexity=\fIadvanced\fP]
+.br
 [\-\-templateexport]
 .br
 [\-\-newcolorsfirst]
@@ -466,6 +470,11 @@ which can be altered or moved later.
 Disable or enable (default) the brush spacing option of the Paint and Lines
 tools, which allows you to override the default spacing of a brush.
 
+.TP 8
+.B \-\-complexity=advanced \-\-complexity=beginner \-\-complexity=novice
+Set the complexity (expertise) level, which affects whether certain Magic
+tools are available, or how they operate. (advanced is the default)
+
 .TP 8
 .B \-\-notemplateexport \-\-templateexport
 Disable or enable (default) the ability to create new Templates from saved

man/is_IS.UTF-8/tuxpaint.1

@@ -1,5 +1,5 @@
-.\" tuxpaint.1 - 2023.11.21
+.\" tuxpaint.1 - 2023.12.29
-.TH TUXPAINT 1 "nóvember 21, 2023" "0.9.32" "Tux Paint"
+.TH TUXPAINT 1 "desember 29, 2023" "0.9.32" "Tux Paint"
 .SH NAME
 tuxpaint -- "Tux Paint", a drawing program for young children.
 
@@ -77,6 +77,8 @@ tuxpaint -- "Tux Paint", a drawing program for young children.
 .br
 [\-\-nobrushspacing]
 .br
+[\-\-complexity=\fIbeginner\fP | \-\-complexity=\fInovice\fP]
+.br
 [\-\-notemplateexport]
 .br
 [\-\-newcolorslast]
@@ -233,6 +235,8 @@ tuxpaint -- "Tux Paint", a drawing program for young children.
 .br
 [\-\-brushspacing]
 .br
+[\-\-complexity=\fIadvanced\fP]
+.br
 [\-\-templateexport]
 .br
 [\-\-newcolorsfirst]
@@ -466,6 +470,11 @@ which can be altered or moved later.
 Disable or enable (default) the brush spacing option of the Paint and Lines
 tools, which allows you to override the default spacing of a brush.
 
+.TP 8
+.B \-\-complexity=advanced \-\-complexity=beginner \-\-complexity=novice
+Set the complexity (expertise) level, which affects whether certain Magic
+tools are available, or how they operate. (advanced is the default)
+
 .TP 8
 .B \-\-notemplateexport \-\-templateexport
 Disable or enable (default) the ability to create new Templates from saved

man/ja_JP.UTF-8/tuxpaint.1

@@ -1,5 +1,5 @@
-.\" tuxpaint.1 - 2023.11.21
+.\" tuxpaint.1 - 2023.12.29
-.TH TUXPAINT 1 "2023年11月21日" "0.9.32" "Tux Paint"
+.TH TUXPAINT 1 "2023年12月29日" "0.9.32" "Tux Paint"
 .SH NAME
 tuxpaint -- "Tux Paint", a drawing program for young children.
 
@@ -77,6 +77,8 @@ tuxpaint -- "Tux Paint", a drawing program for young children.
 .br
 [\-\-nobrushspacing]
 .br
+[\-\-complexity=\fIbeginner\fP | \-\-complexity=\fInovice\fP]
+.br
 [\-\-notemplateexport]
 .br
 [\-\-newcolorslast]
@@ -233,6 +235,8 @@ tuxpaint -- "Tux Paint", a drawing program for young children.
 .br
 [\-\-brushspacing]
 .br
+[\-\-complexity=\fIadvanced\fP]
+.br
 [\-\-templateexport]
 .br
 [\-\-newcolorsfirst]
@@ -466,6 +470,11 @@ which can be altered or moved later.
 Disable or enable (default) the brush spacing option of the Paint and Lines
 tools, which allows you to override the default spacing of a brush.
 
+.TP 8
+.B \-\-complexity=advanced \-\-complexity=beginner \-\-complexity=novice
+Set the complexity (expertise) level, which affects whether certain Magic
+tools are available, or how they operate. (advanced is the default)
+
 .TP 8
 .B \-\-notemplateexport \-\-templateexport
 Disable or enable (default) the ability to create new Templates from saved

src/tuxpaint-completion.bash

@@ -3,7 +3,7 @@
 # Bill Kendrick <bill@newbreedsoftware.com>; https://tuxpaint.org/
 # Based on inkscape's completion file, by allali@univ-mlv.fr
 #
-# Last modified 2023-06-01
+# Last modified 2023-12-29
 #
 # $Id$
 
@@ -12,6 +12,10 @@
 
 # FIXME: Use the source to list all of the available options -bjk 2018.12.18
 
+# FIXME: For options with specific settings (e.g., "orient" and "complexity"),
+# a way to hint to the user, and allow completion, for values after the "="
+# -bjk 2023.12.29
+
 have tuxpaint &&
 _tuxpaint()
 {
@@ -42,6 +46,7 @@ _tuxpaint()
 			-m --mixedcase -u --uppercase \
 			--label --nolabel \
 			--brushspacing --nobrushspacing \
+			--complexity=advanced --complexity=beginner --complexity=novice \
 			--fancycursors --nofancycursors \
 			--hidecursor --showcursor \
 			--mouse --keyboard \

src/tuxpaint.c

@@ -8093,6 +8093,7 @@ void show_usage(int exitcode)
           "  [--nolabel | --label]\n"
           "  [--nobrushspacing | --brushspacing]\n"
           "  [--notemplateexport | --templateexport]\n"
+          "  [--complexity=advanced | --complexity=beginner | --complexity=novice]\n"
           "  [--noerase | --erase]\n"
           "\n"
           " Languages:\n"