Sync docs after various doc source updates

...mostly in terms of modularizing how various file
and directory (folder) paths are shown (for consistency in
both name and styling); add some missing paths (e.g., where
does Tux Paint save drawings on Haiku?)
This commit is contained in:
Bill Kendrick 2024-04-27 12:42:55 -07:00
parent 9c2a75455d
commit e268b598ff
71 changed files with 1074 additions and 873 deletions

View file

@ -5,7 +5,7 @@
Të drejta kopjimi © 2002-2024 nga kontribues të ndryshëm; shihni AUTHORS.txt.
https://tuxpaint.org/
26 janar 2024
27 prill 2024
+------------------------------------------------------------------------+
| Pasqyrë e Lëndës |

View file

@ -239,17 +239,21 @@ Ku i ruan Tux Paint-i vizatimet e mia?
vendndodhje standarde në diskun tuaj vendor:
Windows Vista, Windows 8, Windows 10, Windows 11
Te dosja “AppData” e përdoruesit:
p.sh., C:\Users\Emërpërdoruesi\AppData\Roaming\TuxPaint\saved
In the user's "AppData" folder:
e.g., "C:\Users\emër përdoruesi\AppData\Roaming\TuxPaint\saved\"
macOS
Te dosja “Application Support” e përdoruesit:
p.sh., /Users/Emërpërdoruesi/Library/Applicaton Support/TuxPaint/saved/
In the user's "Application Support" folder:
e.g.,
"/Users/emër përdoruesi/Library/Application Support/TuxPaint/saved/"
Linux / Unix
Te drejtoria shtëpi e përdoruesit (“$HOME”), nën një nëndosje
“.tuxpaint”:
p.sh., /home/emërpërdoruesi/.tuxpaint/saved/
In the user's "home directory" folder:
e.g., "/home/emër përdoruesi/.tuxpaint/saved/"
Haiku
In the user's "settings" folder:
e.g., "/boot/home/config/settings/TuxPaint/saved/"
Figurat depozitohen si bitmap-e PNG, të cilat, shumica e programeve modernë
@ -500,13 +504,13 @@ Tux Paint-i nuk xhiron
Paint!", this means it has been launched in the last 30 seconds. (On Unix/
Linux, this message would appear in a terminal console if you ran Tux Paint
from a command-line. On Windows, this message would appear in a file named
"stdout.txt" in the same folder where TuxPaint.exe resides (e.g., in "C:\
Program Files\TuxPaint").
"stdout.txt" in the same folder where TuxPaint.exe resides (e.g., in
"C:\Program Files\TuxPaint\").
A lockfile ("~/.tuxpaint/lockfile.dat" on Linux and Unix, "userdata\
lockfile.dat" on Windows) is used to make sure Tux Paint isn't run too many
times at once (e.g., due to a child impatiently clicking its icon more than
once).
A lockfile (e.g., "/home/emër përdoruesi/.tuxpaint/lockfile.dat" on Linux
and Unix, "userdata\lockfile.dat" on Windows) is used to make sure Tux
Paint isn't run too many times at once (e.g., due to a child impatiently
clicking its icon more than once).
Even if the lockfile exists, it contains the 'time' Tux Paint was last run.
If it's been more than 30 seconds, Tux Paint should run fine, and simply
@ -582,9 +586,14 @@ Tux Paint is using options I didn't specify!
+ Windows
Under Windows, Tux Paint first examines the configuration file:
Under Windows, it first examines the system-wide configuration file,
located here:
C:\Users\Username\AppData\Roaming\TuxPaint\tuxpaint.cfg
C:\Program Files\TuxPaint\tuxpaint.cfg
Mandej ekzaminon kartelën e formësimit personal të përdoruesit:
C:\Users\emër përdoruesi\AppData\Roaming\TuxPaint\tuxpaint.cfg
Finally, any options sent as command-line arguments are used.
@ -597,7 +606,7 @@ Tux Paint is using options I didn't specify!
Mandej ekzaminon kartelën e formësimit personal të përdoruesit:
/Users/Username/Library/Application Support/TuxPaint/tuxpaint.cfg
/Users/emër përdoruesi/Library/Application Support/TuxPaint/tuxpaint.cfg
Finally, any options sent as command-line arguments are used.
@ -631,8 +640,8 @@ Tux Paint is using options I didn't specify!
nosound=yes
...then you can reenable sound by either adding this option to your own "/
home/emër përdoruesi/.tuxpaintrc" file:
...then you can reenable sound by either adding this option to your own
"/home/emër përdoruesi/.tuxpaintrc" file:
sound=yes

View file

@ -2,10 +2,10 @@
version 0.9.33
Dokumentim Instalimi
Të drejta kopjimi © 2002-2023 nga kontribues të ndryshëm; shihni AUTHORS.txt.
Të drejta kopjimi © 2002-2024 nga kontribues të ndryshëm; shihni AUTHORS.txt.
https://tuxpaint.org/
13 maj 2023
27 prill 2024
+------------------------------------------------------+
| Pasqyrë e Lëndës |
@ -466,8 +466,8 @@ Nëse Diçka Shkon Ters
If, when you double-click on the shortcut to run Tux Paint, nothing happens, it
is probably because some of these command-line options are wrong. Open an
Explorer, and look for a file called "stderr.txt" in your personal saving
folder for TuxPaint which is normaly "C:\Users\username\AppData\Roaming\
TuxPaint".
folder for TuxPaint which is normaly
"C:\Users\emër përdoruesi\AppData\Roaming\TuxPaint\".
It will contain a description of what was wrong. Usually it will just be due to
incorrect character-case (capital 'Z' instead of lowercase 'z') or a missing

View file

@ -1136,17 +1136,19 @@ Ruaje Formësimin e Shtypësit
If you do not override it, the default location is:
o Linux & Unix — Under a hidden directory named ".tuxpaint" in your
home directory (aka "~" or "$HOME")
Shembull: /home/username/.tuxpaint/saved/
o Windows — Inside a folder named "TuxPaint" in your "Application
Data" folder.
Shembull: C:\Documents and Settings\Username\Application Data\
TuxPaint\saved\
o macOS — Inside a folder named "TuxPaint" in your "Application
Support" folder.
Shembull: /Users/Username/Library/Application Support/TuxPaint/
saved/
Linux / Unix
Under a hidden directory in your home directory:
/home/emër përdoruesi/.tuxpaint/saved/
Windows
C:\Users\emër përdoruesi\AppData\Roaming\TuxPaint\saved\
macOS
/Users/emër përdoruesi/Library/Application Support/TuxPaint/saved/
Haiku
/boot/home/config/settings/TuxPaint/saved/
💡 Note: When specifying a Windows drive (e.g., "H:\"), you must also
specify a subdirectory.

View file

@ -154,8 +154,9 @@ the 'Tux Paint Installer,' but chose not to have shortcuts installed, you'll
need to double-click the "tuxpaint.exe" icon in the "Tux Paint" folder on your
computer.
By default, the 'Tux Paint Installer' will put Tux Paint's folder in "C:\
Program Files\", though you may have changed this when you ran the installer.
By default, the 'Tux Paint Installer' will put Tux Paint's folder in
"C:\Program Files\TuxPaint\", though you may have changed this when you ran the
installer.
If you used the 'ZIP-file' download, Tux Paint's folder will be wherever you
extracted the contents of the ZIP file.
@ -1160,21 +1161,21 @@ You can simply convert the picture to the format Tux Paint uses — PNG (Portabl
Network Graphic) — and place it in Tux Paint's "saved" directory/folder. Here
is where to find it (by default):
Windows 10, 8, 7, Vista
Brenda dosjes “AppData” të përdoruesi, p.sh.: “C:\Users\emër përdoruesi\
AppData\Roaming\TuxPaint\saved\”.
Windows 2000, XP
Brenda dosjes “Application Data” të përdoruesi, p.sh.: “C:\Documents and
Settings\emër përdoruesi\Application Data\TuxPaint\saved\”.
Windows Vista, Windows 8, Windows 10, Windows 11
In the user's "AppData" folder:
e.g., "C:\Users\emër përdoruesi\AppData\Roaming\TuxPaint\saved\"
macOS
Brenda dosjes “Library” të përdoruesi, p.sh.: “/Users/emër përdoruesi/
Library/Application Support/Tux Paint/saved/”.
In the user's "Application Support" folder:
e.g., "/Users/emër përdoruesi/Library/Application Support/TuxPaint/saved/"
Linux/Unix
Inside a hidden ".tuxpaint" directory, in the user's home directory
("$HOME"), e.g. "/home/emër përdoruesi/.tuxpaint/saved/".
Linux / Unix
In the user's "home directory" folder:
e.g., "/home/emër përdoruesi/.tuxpaint/saved/"
Haiku
In the user's "settings" folder:
e.g., "/boot/home/config/settings/TuxPaint/saved/"
💡 Note: It is also from this folder that you can copy or open pictures drawn in

View file

@ -100,7 +100,7 @@
</p>
<p>
26 janar 2024 </p>
27 prill 2024 </p>
</center>
</header>

View file

@ -312,27 +312,34 @@
Hiq rastin kur i keni kërkuar Tux Paint-it që ti ruaj në një vend të caktuar (duke përdorur mundësinë “savedir”), Tux Paint-i i ruan te një vendndodhje standarde në diskun tuaj vendor: </p>
<dl>
<dt>
<cite>Windows Vista, Windows 8, Windows 10, Windows 11</cite>
</dt>
<dt>
<cite>Windows Vista, Windows 8, Windows 10, Windows 11</cite>
</dt>
<dd>
Te dosja “AppData” e përdoruesit:<br> p.sh., <code>C:\Users\<i>Emërpërdoruesi</i>\AppData\Roaming\TuxPaint\saved</code> </dd>
<dd>
In the user's "AppData" folder:<br> e.g., <nobr>"<code>C:\Users\emër përdoruesi\AppData\Roaming\TuxPaint\saved\</code>"</nobr> </dd>
<dt>
<cite>macOS</cite>
</dt>
<dt>
<cite>macOS</cite>
</dt>
<dd>
Te dosja “Application Support” e përdoruesit:<br> p.sh., <code>/Users/<i>Emërpërdoruesi</i>/Library/Applicaton Support/TuxPaint/saved/</code> </dd>
<dd>
In the user's "Application Support" folder:<br> e.g., <nobr>"<code>/Users/emër përdoruesi/Library/Application Support/TuxPaint/saved/</code>"</nobr> </dd>
<dt>
<cite>Linux / Unix</cite>
</dt>
<dt>
<cite>Linux / Unix</cite>
</dt>
<dd>
Te drejtoria shtëpi e përdoruesit (“<code>$HOME</code>”), nën një nëndosje “.tuxpaint”:<br> p.sh., <code>/home/<i>emërpërdoruesi</i>/.tuxpaint/saved/</code> </dd>
</dl>
<dd>
In the user's "home directory" folder:<br> e.g., <nobr>"<code>/home/emër përdoruesi/.tuxpaint/saved/</code>"</nobr> </dd>
<dt>
<cite>Haiku</cite>
</dt>
<dd>
In the user's "settings" folder:<br> e.g., <nobr>"<code>/boot/home/config/settings/TuxPaint/saved/</code>"</nobr> </dd>
</dl>
<p>
Figurat depozitohen si bitmap-e PNG, të cilat, shumica e programeve modernë (përpunuesi figurash, përpunues fjalësh, shfletues, etj), duhet të jenë në gjendje ti ngarkojnë. </p>
@ -610,10 +617,10 @@
<dd>
<p>
If Tux Paint aborts with the message: "You're already running a copy of Tux Paint!", this means it has been launched in the last 30 seconds. (On Unix/Linux, this message would appear in a terminal console if you ran Tux Paint from a command-line. On Windows, this message would appear in a file named "<code>stdout.txt</code>" in the same folder where <code>TuxPaint.exe</code> resides (e.g., in "<code>C:\Program Files\TuxPaint</code>"). </p>
If Tux Paint aborts with the message: "You're already running a copy of Tux Paint!", this means it has been launched in the last 30 seconds. (On Unix/Linux, this message would appear in a terminal console if you ran Tux Paint from a command-line. On Windows, this message would appear in a file named "<code>stdout.txt</code>" in the same folder where <code>TuxPaint.exe</code> resides (e.g., in <nobr>"<code>C:\Program Files\TuxPaint\</code>"</nobr>). </p>
<p>
A lockfile ("~/.tuxpaint/lockfile.dat" on Linux and Unix, "userdata\lockfile.dat" on Windows) is used to make sure Tux Paint isn't run too many times at once (e.g., due to a child impatiently clicking its icon more than once). </p>
A lockfile (e.g., <nobr>"<code>/home/emër përdoruesi/.tuxpaint/lockfile.dat</code>"</nobr> on Linux and Unix, <nobr>"<code>userdata\lockfile.dat</code>"</nobr> on Windows) is used to make sure Tux Paint isn't run too many times at once (e.g., due to a child impatiently clicking its icon more than once). </p>
<p>
Even if the lockfile exists, it contains the 'time' Tux Paint was last run. If it's been more than 30 seconds, Tux Paint should run fine, and simply update the lockfile with the current time. </p>
@ -694,12 +701,19 @@
<li>
<cite>Windows</cite>
<p>
Under Windows, Tux Paint first examines the configuration file: </p>
Under Windows, it first examines the system-wide configuration file, located here: </p>
<blockquote>
<p>
<code>C:\Users\<i>Username</i>\AppData\Roaming\TuxPaint\tuxpaint.cfg</code>
</p>
<nobr><code>C:\Program Files\TuxPaint\tuxpaint.cfg</code></nobr> </p>
</blockquote>
<p>
Mandej ekzaminon kartelën e formësimit personal të përdoruesit: </p>
<blockquote>
<p>
<nobr><code>C:\Users\emër përdoruesi\AppData\Roaming\TuxPaint\tuxpaint.cfg</code></nobr> </p>
</blockquote>
<p>
@ -713,8 +727,7 @@
<blockquote>
<p>
<code>/Library/Application Support/TuxPaint/tuxpaint.cfg</code>
</p>
<nobr><code>/Library/Application Support/TuxPaint/tuxpaint.cfg</code></nobr> </p>
</blockquote>
<p>
@ -722,8 +735,7 @@
<blockquote>
<p>
<code>/Users/<i>Username</i>/Library/Application Support/TuxPaint/tuxpaint.cfg</code>
</p>
<nobr><code>/Users/emër përdoruesi/Library/Application Support/TuxPaint/tuxpaint.cfg</code></nobr> </p>
</blockquote>
<p>
@ -737,8 +749,7 @@
<blockquote>
<p>
<code>/etc/tuxpaint/tuxpaint.conf</code>
</p>
<nobr><code>/etc/tuxpaint/tuxpaint.conf</code></nobr> </p>
</blockquote>
<p>
@ -746,8 +757,7 @@
<blockquote>
<p>
<code>/home/emër përdoruesi/.tuxpaintrc</code>
</p>
<nobr><code>/home/emër përdoruesi/.tuxpaintrc</code></nobr> </p>
</blockquote>
<p>
@ -761,8 +771,7 @@
<blockquote>
<p>
<code>/boot/home/config/settings/TuxPaint/tuxpaint.conf</code>
</p>
<nobr><code>/boot/home/config/settings/TuxPaint/tuxpaint.conf</code></nobr> </p>
</blockquote>
<p>
@ -774,7 +783,7 @@
This means that if anything is set in a configuration file that you don't want set, you'll need to either change the config. file (if you can), or override the option on the command-line. </p>
<p>
For example, on Linux and Unix, if "<code>/etc/tuxpaint/tuxpaint.conf</code>" includes this option to disable sound... </p>
For example, on Linux and Unix, if <nobr>"<code>/etc/tuxpaint/tuxpaint.conf</code>"</nobr> includes this option to disable sound... </p>
<blockquote>
<p>
@ -783,7 +792,7 @@
</blockquote>
<p>
...then you can reenable sound by either adding this option to your own "<code>/home/emër përdoruesi/.tuxpaintrc</code>" file: </p>
...then you can reenable sound by either adding this option to your own <nobr>"<code>/home/emër përdoruesi/.tuxpaintrc</code>"</nobr> file: </p>
<blockquote>
<p>

View file

@ -93,12 +93,12 @@
Dokumentim Instalimi </h1>
<p>
Të drejta kopjimi &copy; 2002-2023 nga kontribues të ndryshëm; shihni <a href="../../AUTHORS.txt">AUTHORS.txt</a>.<br>
Të drejta kopjimi &copy; 2002-2024 nga kontribues të ndryshëm; shihni <a href="../../AUTHORS.txt">AUTHORS.txt</a>.<br>
<a href="https://tuxpaint.org/">https://tuxpaint.org/</a>
</p>
<p>
13 maj 2023 </p>
27 prill 2024 </p>
</center>
</header>
@ -757,7 +757,7 @@
</header>
<p>
If, when you double-click on the shortcut to run Tux Paint, nothing happens, it is probably because some of these command-line options are wrong. Open an Explorer, and look for a file called "<code>stderr.txt</code>" in your personal saving folder for TuxPaint which is normaly "C:\Users\<i>username</i>\AppData\Roaming\TuxPaint". </p>
If, when you double-click on the shortcut to run Tux Paint, nothing happens, it is probably because some of these command-line options are wrong. Open an Explorer, and look for a file called "<code>stderr.txt</code>" in your personal saving folder for TuxPaint which is normaly <nobr>"<code>C:\Users\emër përdoruesi\AppData\Roaming\TuxPaint\</code>"</nobr>. </p>
<p>
It will contain a description of what was wrong. Usually it will just be due to incorrect character-case (capital 'Z' instead of lowercase 'z') or a missing (or extra) '-' (dash). </p>

View file

@ -1786,17 +1786,24 @@
<p>
If you do not override it, the <b><i>default</i></b> location is: </p>
<ul>
<li>Linux &amp; Unix — Under a hidden directory named "<code>.tuxpaint</code>" in your home directory (aka "<code>~</code>" or "<code>$HOME</code>")<br>
Shembull: <code>/home/<i>username</i>/.tuxpaint/saved/</code> </li>
<dl>
<dt>Linux / Unix</dt>
<dd>
Under a hidden directory in your home directory:<br/>
<nobr><code>/home/emër përdoruesi/.tuxpaint/saved/</code></nobr> </dd>
<li>Windows — Inside a folder named "<code>TuxPaint</code>" in your "<code>Application Data</code>" folder.<br>
Shembull: <code>C:\Documents and Settings\<i>Username</i>\Application Data\TuxPaint\saved\</code> <br>
</li>
<dt>Windows</dt>
<dd>
<nobr><code>C:\Users\emër përdoruesi\AppData\Roaming\TuxPaint\saved\</code></nobr> </dd>
<li>macOS — Inside a folder named "<code>TuxPaint</code>" in your "<code>Application Support</code>" folder.<br>
Shembull: <code>/Users/<i>Username</i>/Library/Application Support/TuxPaint/saved/</code> </li>
</ul>
<dt>macOS</dt>
<dd>
<nobr><code>/Users/emër përdoruesi/Library/Application Support/TuxPaint/saved/</code></nobr> </dd>
<dt>Haiku</dt>
<dd>
<nobr><code>/boot/home/config/settings/TuxPaint/saved/</code></nobr> </dd>
</dl>
<p class="note">
<span title="Information">&#128161;</span> <strong>Note:</strong> When specifying a Windows drive (e.g., "<code>H:\</code>"), you must also specify a subdirectory. </p>

View file

@ -318,7 +318,7 @@
If you're using the 'portable' (ZIP-file) version of Tux Paint, or if you used the 'Tux Paint Installer,' but chose not to have shortcuts installed, you'll need to double-click the "<code>tuxpaint.exe</code>" icon in the "<code>Tux Paint</code>" folder on your computer. </p>
<p>
By default, the 'Tux Paint Installer' will put Tux Paint's folder in "<code>C:\Program Files\</code>", though you may have changed this when you ran the installer. </p>
By default, the 'Tux Paint Installer' will put Tux Paint's folder in <nobr>"<code>C:\Program Files\TuxPaint\</code>"</nobr>, though you may have changed this when you ran the installer. </p>
<p>
If you used the 'ZIP-file' download, Tux Paint's folder will be wherever you extracted the contents of the ZIP file. </p>
@ -1669,36 +1669,36 @@
<p>
You can simply convert the picture to the format Tux Paint uses &mdash; PNG (Portable Network Graphic) &mdash; and place it in Tux Paint's "<code>saved</code>" directory/folder. Here is where to find it (by default): </p>
<dl>
<dt>
<strong>Windows 10, 8, 7, Vista</strong>
</dt>
<dd>
Brenda dosjes “<code>AppData</code>” të përdoruesi, p.sh.: “<code>C:\Users\<em>emër përdoruesi</em>\AppData\Roaming\TuxPaint\saved\</code>”. </dd>
<dt>
<strong>Windows 2000, XP</strong>
</dt>
<dd>
Brenda dosjes “<code>Application Data</code>” të përdoruesi, p.sh.: “<code>C:\Documents and Settings\<em>emër përdoruesi</em>\Application Data\TuxPaint\saved\</code>”. </dd>
<dt>
<strong>macOS</strong>
</dt>
<dd>
Brenda dosjes “<code>Library</code>” të përdoruesi, p.sh.: “<code>/Users/<em>emër përdoruesi</em>/Library/Application Support/Tux Paint/saved/</code>”. </dd>
<dt>
<strong>Linux/Unix</strong>
</dt>
<dd>
Inside a hidden "<code>.tuxpaint</code>" directory, in the user's home directory ("<code>$HOME</code>"), e.g. "<code>/home/<em>emër përdoruesi</em>/.tuxpaint/saved/</code>". </dd>
</dl>
<dt>
<cite>Windows Vista, Windows 8, Windows 10, Windows 11</cite>
</dt>
<dd>
In the user's "AppData" folder:<br> e.g., <nobr>"<code>C:\Users\emër përdoruesi\AppData\Roaming\TuxPaint\saved\</code>"</nobr> </dd>
<dt>
<cite>macOS</cite>
</dt>
<dd>
In the user's "Application Support" folder:<br> e.g., <nobr>"<code>/Users/emër përdoruesi/Library/Application Support/TuxPaint/saved/</code>"</nobr> </dd>
<dt>
<cite>Linux / Unix</cite>
</dt>
<dd>
In the user's "home directory" folder:<br> e.g., <nobr>"<code>/home/emër përdoruesi/.tuxpaint/saved/</code>"</nobr> </dd>
<dt>
<cite>Haiku</cite>
</dt>
<dd>
In the user's "settings" folder:<br> e.g., <nobr>"<code>/boot/home/config/settings/TuxPaint/saved/</code>"</nobr> </dd>
</dl>
<p class="note">
<span title="Information">&#128161;</span> <strong>Note:</strong> It is also from this folder that you can copy or open pictures drawn in Tux Paint using <em>other</em> applications, though the 'Export' option from Tux Paint's 'Open' dialog can be used to copy them to a location that's easier and safer to access. </p>