From a0f90185a5c9ef8c055a5403e178960b05d2c421 Mon Sep 17 00:00:00 2001 From: Bill Kendrick Date: Fri, 29 Dec 2023 16:25:37 -0800 Subject: [PATCH] Sync docs re: forthcoming complexity option --- docs/en/OPTIONS.txt | 34 ++++++++++++++++++++++++++++- docs/en/README.txt | 6 +++++ docs/en/html/OPTIONS.html | 25 ++++++++++++++++++++- docs/en/html/README.html | 3 +++ docs/es_ES.UTF-8/OPTIONS.txt | 34 ++++++++++++++++++++++++++++- docs/es_ES.UTF-8/README.txt | 6 +++++ docs/es_ES.UTF-8/html/OPTIONS.html | 25 ++++++++++++++++++++- docs/es_ES.UTF-8/html/README.html | 3 +++ docs/fr_FR.UTF-8/OPTIONS.txt | 35 +++++++++++++++++++++++++++++- docs/fr_FR.UTF-8/README.txt | 6 +++++ docs/fr_FR.UTF-8/html/OPTIONS.html | 25 ++++++++++++++++++++- docs/fr_FR.UTF-8/html/README.html | 3 +++ docs/gl_ES.UTF-8/OPTIONS.txt | 34 ++++++++++++++++++++++++++++- docs/gl_ES.UTF-8/README.txt | 6 +++++ docs/gl_ES.UTF-8/html/OPTIONS.html | 25 ++++++++++++++++++++- docs/gl_ES.UTF-8/html/README.html | 3 +++ docs/is_IS.UTF-8/OPTIONS.txt | 34 ++++++++++++++++++++++++++++- docs/is_IS.UTF-8/README.txt | 6 +++++ docs/is_IS.UTF-8/html/OPTIONS.html | 25 ++++++++++++++++++++- docs/is_IS.UTF-8/html/README.html | 3 +++ docs/ja_JP.UTF-8/OPTIONS.txt | 35 +++++++++++++++++++++++++++++- docs/ja_JP.UTF-8/README.txt | 6 +++++ docs/ja_JP.UTF-8/html/OPTIONS.html | 25 ++++++++++++++++++++- docs/ja_JP.UTF-8/html/README.html | 3 +++ man/en/tuxpaint.1 | 13 +++++++++-- man/es_ES.UTF-8/tuxpaint.1 | 13 +++++++++-- man/fr_FR.UTF-8/tuxpaint.1 | 13 +++++++++-- man/gl_ES.UTF-8/tuxpaint.1 | 13 +++++++++-- man/is_IS.UTF-8/tuxpaint.1 | 13 +++++++++-- man/ja_JP.UTF-8/tuxpaint.1 | 13 +++++++++-- src/tuxpaint-completion.bash | 7 +++++- src/tuxpaint.c | 1 + 32 files changed, 471 insertions(+), 25 deletions(-) diff --git a/docs/en/OPTIONS.txt b/docs/en/OPTIONS.txt index dbe3ae212..e35a4388c 100644 --- a/docs/en/OPTIONS.txt +++ b/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 diff --git a/docs/en/README.txt b/docs/en/README.txt index 6b1367789..5f2a0827f 100644 --- a/docs/en/README.txt +++ b/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. diff --git a/docs/en/html/OPTIONS.html b/docs/en/html/OPTIONS.html index a015b7437..a88e6d9ae 100644 --- a/docs/en/html/OPTIONS.html +++ b/docs/en/html/OPTIONS.html @@ -102,7 +102,7 @@

- July 20, 2023

+ December 29, 2023

@@ -711,6 +711,29 @@ ⚙ Note: If used in a system-wide configuration file, may be overridden by the user's configuration file using "nobrushspacing=no" or "brushspacing=yes". In both cases, may be overridden by the command-line option "--brushspacing".

+
+ 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
diff --git a/docs/en/html/README.html b/docs/en/html/README.html index 28a4cb2d2..d9eb8eb10 100644 --- a/docs/en/html/README.html +++ b/docs/en/html/README.html @@ -237,6 +237,9 @@
3-point Perspective (vanishing point) Magic tool
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.
diff --git a/docs/es_ES.UTF-8/OPTIONS.txt b/docs/es_ES.UTF-8/OPTIONS.txt index 9b25da085..2daa7f0a3 100644 --- a/docs/es_ES.UTF-8/OPTIONS.txt +++ b/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 diff --git a/docs/es_ES.UTF-8/README.txt b/docs/es_ES.UTF-8/README.txt index 393f8ec3f..e411cfccd 100644 --- a/docs/es_ES.UTF-8/README.txt +++ b/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. diff --git a/docs/es_ES.UTF-8/html/OPTIONS.html b/docs/es_ES.UTF-8/html/OPTIONS.html index ce403dd82..1f0fc597b 100644 --- a/docs/es_ES.UTF-8/html/OPTIONS.html +++ b/docs/es_ES.UTF-8/html/OPTIONS.html @@ -102,7 +102,7 @@

- julio 20, 2023

+ diciembre 29, 2023

@@ -711,6 +711,29 @@ ⚙ Note: If used in a system-wide configuration file, may be overridden by the user's configuration file using "nobrushspacing=no" or "brushspacing=yes". In both cases, may be overridden by the command-line option "--brushspacing".

+
+ 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
diff --git a/docs/es_ES.UTF-8/html/README.html b/docs/es_ES.UTF-8/html/README.html index 32c93d53c..cf4842a72 100644 --- a/docs/es_ES.UTF-8/html/README.html +++ b/docs/es_ES.UTF-8/html/README.html @@ -237,6 +237,9 @@
3-point Perspective (vanishing point) Magic tool
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.
diff --git a/docs/fr_FR.UTF-8/OPTIONS.txt b/docs/fr_FR.UTF-8/OPTIONS.txt index f00ccd894..33912385b 100644 --- a/docs/fr_FR.UTF-8/OPTIONS.txt +++ b/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 diff --git a/docs/fr_FR.UTF-8/README.txt b/docs/fr_FR.UTF-8/README.txt index c97074fdc..47bbbe0b3 100644 --- a/docs/fr_FR.UTF-8/README.txt +++ b/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. diff --git a/docs/fr_FR.UTF-8/html/OPTIONS.html b/docs/fr_FR.UTF-8/html/OPTIONS.html index 83405a4ea..e4aa50262 100644 --- a/docs/fr_FR.UTF-8/html/OPTIONS.html +++ b/docs/fr_FR.UTF-8/html/OPTIONS.html @@ -102,7 +102,7 @@

- juillet 20, 2023

+ décembre 29, 2023

@@ -711,6 +711,29 @@ ⚙ 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 "nobrushspacing=no" ou "brushspacing=yes". Dans les deux cas, il peut être remplacé avec l'option en ligne de commande "--brushspacing".

+
+ 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
diff --git a/docs/fr_FR.UTF-8/html/README.html b/docs/fr_FR.UTF-8/html/README.html index a0b942cf3..ca91756ae 100644 --- a/docs/fr_FR.UTF-8/html/README.html +++ b/docs/fr_FR.UTF-8/html/README.html @@ -237,6 +237,9 @@
3-point Perspective (vanishing point) Magic tool
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.
diff --git a/docs/gl_ES.UTF-8/OPTIONS.txt b/docs/gl_ES.UTF-8/OPTIONS.txt index 3abd79bab..cb86d4db1 100644 --- a/docs/gl_ES.UTF-8/OPTIONS.txt +++ b/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 diff --git a/docs/gl_ES.UTF-8/README.txt b/docs/gl_ES.UTF-8/README.txt index 9af647376..6d414e3ce 100644 --- a/docs/gl_ES.UTF-8/README.txt +++ b/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. diff --git a/docs/gl_ES.UTF-8/html/OPTIONS.html b/docs/gl_ES.UTF-8/html/OPTIONS.html index 45ffa7f6c..2a66ab102 100644 --- a/docs/gl_ES.UTF-8/html/OPTIONS.html +++ b/docs/gl_ES.UTF-8/html/OPTIONS.html @@ -102,7 +102,7 @@

- 20 de Xullo de 2023

+ 29 de Decembro de 2023

@@ -711,6 +711,29 @@ ⚙ Note: If used in a system-wide configuration file, may be overridden by the user's configuration file using "nobrushspacing=no" or "brushspacing=yes". In both cases, may be overridden by the command-line option "--brushspacing".

+
+ 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
diff --git a/docs/gl_ES.UTF-8/html/README.html b/docs/gl_ES.UTF-8/html/README.html index aaf12129f..e02095510 100644 --- a/docs/gl_ES.UTF-8/html/README.html +++ b/docs/gl_ES.UTF-8/html/README.html @@ -237,6 +237,9 @@
3-point Perspective (vanishing point) Magic tool
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.
diff --git a/docs/is_IS.UTF-8/OPTIONS.txt b/docs/is_IS.UTF-8/OPTIONS.txt index 5747ea36a..5a0fb4e62 100644 --- a/docs/is_IS.UTF-8/OPTIONS.txt +++ b/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 diff --git a/docs/is_IS.UTF-8/README.txt b/docs/is_IS.UTF-8/README.txt index 8594fd922..c1880133e 100644 --- a/docs/is_IS.UTF-8/README.txt +++ b/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. diff --git a/docs/is_IS.UTF-8/html/OPTIONS.html b/docs/is_IS.UTF-8/html/OPTIONS.html index 76c7ca91f..199a829b4 100644 --- a/docs/is_IS.UTF-8/html/OPTIONS.html +++ b/docs/is_IS.UTF-8/html/OPTIONS.html @@ -102,7 +102,7 @@

- júlí 20, 2023

+ desember 29, 2023

@@ -711,6 +711,29 @@ ⚙ Note: If used in a system-wide configuration file, may be overridden by the user's configuration file using "nobrushspacing=no" or "brushspacing=yes". In both cases, may be overridden by the command-line option "--brushspacing".

+
+ 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
diff --git a/docs/is_IS.UTF-8/html/README.html b/docs/is_IS.UTF-8/html/README.html index 79685e704..5d54bc1e8 100644 --- a/docs/is_IS.UTF-8/html/README.html +++ b/docs/is_IS.UTF-8/html/README.html @@ -237,6 +237,9 @@
3-point Perspective (vanishing point) Magic tool
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.
diff --git a/docs/ja_JP.UTF-8/OPTIONS.txt b/docs/ja_JP.UTF-8/OPTIONS.txt index f2d061bf3..fe997b852 100644 --- a/docs/ja_JP.UTF-8/OPTIONS.txt +++ b/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 「ひらく」ダイアログで、保存された作品を用いて新しいテンプレート画像を作成 diff --git a/docs/ja_JP.UTF-8/README.txt b/docs/ja_JP.UTF-8/README.txt index 313e999ac..594e3522d 100644 --- a/docs/ja_JP.UTF-8/README.txt +++ b/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. diff --git a/docs/ja_JP.UTF-8/html/OPTIONS.html b/docs/ja_JP.UTF-8/html/OPTIONS.html index d1988faf2..f19c84278 100644 --- a/docs/ja_JP.UTF-8/html/OPTIONS.html +++ b/docs/ja_JP.UTF-8/html/OPTIONS.html @@ -102,7 +102,7 @@

- 2023年7月20日

+ 2023年12月29日

@@ -711,6 +711,29 @@ ⚙ 注: システム全体の設定ファイルで設定されている場合は、ユーザーの設定ファイルで "nobrushspacing=no" または "brushspacing=yes" を設定すると上書きされることがあります。また、どちらの設定も、コマンドラインオプションの "--brushspacing" で変更できます。

+
+ 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
diff --git a/docs/ja_JP.UTF-8/html/README.html b/docs/ja_JP.UTF-8/html/README.html index 09bf097c1..422b433b4 100644 --- a/docs/ja_JP.UTF-8/html/README.html +++ b/docs/ja_JP.UTF-8/html/README.html @@ -237,6 +237,9 @@
3-point Perspective (vanishing point) Magic tool
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.
diff --git a/man/en/tuxpaint.1 b/man/en/tuxpaint.1 index 597ee5c80..ae9fd1906 100644 --- a/man/en/tuxpaint.1 +++ b/man/en/tuxpaint.1 @@ -1,5 +1,5 @@ -.\" tuxpaint.1 - 2023.11.21 -.TH TUXPAINT 1 "November 21, 2023" "0.9.32" "Tux Paint" +.\" tuxpaint.1 - 2023.12.29 +.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 diff --git a/man/es_ES.UTF-8/tuxpaint.1 b/man/es_ES.UTF-8/tuxpaint.1 index 4a9fa80e1..c33a1eb5b 100644 --- a/man/es_ES.UTF-8/tuxpaint.1 +++ b/man/es_ES.UTF-8/tuxpaint.1 @@ -1,5 +1,5 @@ -.\" tuxpaint.1 - 2023.11.21 -.TH TUXPAINT 1 "noviembre 21, 2023" "0.9.32" "Tux Paint" +.\" tuxpaint.1 - 2023.12.29 +.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 diff --git a/man/fr_FR.UTF-8/tuxpaint.1 b/man/fr_FR.UTF-8/tuxpaint.1 index ef4f2d2e9..466b984e9 100644 --- a/man/fr_FR.UTF-8/tuxpaint.1 +++ b/man/fr_FR.UTF-8/tuxpaint.1 @@ -1,5 +1,5 @@ -.\" tuxpaint.1 - 2023.11.21 -.TH TUXPAINT 1 "novembre 21, 2023" "0.9.32" "Tux Paint" +.\" tuxpaint.1 - 2023.12.29 +.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 diff --git a/man/gl_ES.UTF-8/tuxpaint.1 b/man/gl_ES.UTF-8/tuxpaint.1 index 55bb6376f..aae291360 100644 --- a/man/gl_ES.UTF-8/tuxpaint.1 +++ b/man/gl_ES.UTF-8/tuxpaint.1 @@ -1,5 +1,5 @@ -.\" tuxpaint.1 - 2023.11.21 -.TH TUXPAINT 1 "21 de Novembro de 2023" "0.9.32" "Tux Paint" +.\" tuxpaint.1 - 2023.12.29 +.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 diff --git a/man/is_IS.UTF-8/tuxpaint.1 b/man/is_IS.UTF-8/tuxpaint.1 index 402fd11fb..5ee5e256e 100644 --- a/man/is_IS.UTF-8/tuxpaint.1 +++ b/man/is_IS.UTF-8/tuxpaint.1 @@ -1,5 +1,5 @@ -.\" tuxpaint.1 - 2023.11.21 -.TH TUXPAINT 1 "nóvember 21, 2023" "0.9.32" "Tux Paint" +.\" tuxpaint.1 - 2023.12.29 +.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 diff --git a/man/ja_JP.UTF-8/tuxpaint.1 b/man/ja_JP.UTF-8/tuxpaint.1 index 158e52479..fab9b2771 100644 --- a/man/ja_JP.UTF-8/tuxpaint.1 +++ b/man/ja_JP.UTF-8/tuxpaint.1 @@ -1,5 +1,5 @@ -.\" tuxpaint.1 - 2023.11.21 -.TH TUXPAINT 1 "2023年11月21日" "0.9.32" "Tux Paint" +.\" tuxpaint.1 - 2023.12.29 +.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 diff --git a/src/tuxpaint-completion.bash b/src/tuxpaint-completion.bash index 49d3198ad..f4ccc6c60 100644 --- a/src/tuxpaint-completion.bash +++ b/src/tuxpaint-completion.bash @@ -3,7 +3,7 @@ # Bill Kendrick ; 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 \ diff --git a/src/tuxpaint.c b/src/tuxpaint.c index 71c013ed5..77e1f91e6 100644 --- a/src/tuxpaint.c +++ b/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"