Converted FAQ from bullet lists to definition lists.

This commit is contained in:
Bill Kendrick 2020-10-30 13:46:25 -07:00
parent 71116ecf1f
commit de96578f22
2 changed files with 637 additions and 590 deletions

File diff suppressed because it is too large Load diff

View file

@ -36,25 +36,25 @@
</p> </p>
</center> </center>
<hr>
<h2> <h2>
Drawing-related Drawing-related
</h2> </h2>
<ul> <dl>
<li> <dt><h3>Fonts I added to Tux&nbsp;Paint only show squares</h3></dt>
<em>Fonts I added to Tux&nbsp;Paint only show squares</em> <dd>
<p> The TrueType Font you're using might have the wrong
The TrueType Font you're using might have the wrong encoding. If it's 'custom' encoded, for example, you can
encoding. If it's 'custom' encoded, for example, you can try running it through FontForge (<a href=
try running it through FontForge (<a href= "http://fontforge.sourceforge.net/">http://fontforge.sourceforge.net/</a>)
"http://fontforge.sourceforge.net/">http://fontforge.sourceforge.net/</a>) to convert it to an ISO-8859 format. (Email us if you
to convert it to an ISO-8859 format. (Email us if you need help with special fonts.)
need help with special fonts.) </dd>
</p>
</li>
<li> <dt><h3>The Rubber Stamp tool is greyed out!<h3></dt>
<em>The Rubber Stamp tool is greyed out!</em> <dd>
<p> <p>
This means that Tux&nbsp;Paint either couldn't find any This means that Tux&nbsp;Paint either couldn't find any
stamp images, or was asked not to load them. stamp images, or was asked not to load them.
@ -92,10 +92,10 @@
command line or "<code>nostamps=no</code>" or command line or "<code>nostamps=no</code>" or
"<code>stamps=yes</code>" in a configuration file. "<code>stamps=yes</code>" in a configuration file.
</p> </p>
</li> </dd>
<li> <dt><h3>The Magic "Fill" Tool Looks Bad</h3></dt>
<em>The Magic "Fill" Tool Looks Bad</em> <dd>
<p> <p>
Tux&nbsp;Paint is probably comparing exact pixel colors Tux&nbsp;Paint is probably comparing exact pixel colors
when filling. This is faster, but looks worse. Run the when filling. This is faster, but looks worse. Run the
@ -119,10 +119,10 @@
<p> <p>
in the "tuxpaint.c" file in the "src" directory. in the "tuxpaint.c" file in the "src" directory.
</p> </p>
</li> </dd>
<li> <dt><h3>Stamp outlines are always rectangles</h3></dt>
<em>Stamp outlines are always rectangles</em> <dd>
<p> <p>
Tux&nbsp;Paint was built with low-quality (but faster) Tux&nbsp;Paint was built with low-quality (but faster)
stamp outlines. stamp outlines.
@ -142,16 +142,18 @@
<p> <p>
in the "tuxpaint.c" file in the "src" directory. in the "tuxpaint.c" file in the "src" directory.
</p> </p>
</li> </dd>
</ul> </dl>
<hr>
<h2> <h2>
Interface Problems Interface Problems
</h2> </h2>
<ul> <dl>
<li> <dt><h3>Stamp thumbnails in the Stamp Selector look bad</h3></dt>
<em>Stamp thumbnails in the Stamp Selector look bad</em> <dd>
<p> <p>
Tux&nbsp;Paint was probably compiled with the faster, Tux&nbsp;Paint was probably compiled with the faster,
lower quality thumbnail code enabled. Run the command: lower quality thumbnail code enabled. Run the command:
@ -175,19 +177,16 @@
<p> <p>
in the "tuxpaint.c" file in the "src" directory. in the "tuxpaint.c" file in the "src" directory.
</p> </p>
</li> </dd>
<li> <dt><h3>Pictures in the 'Open' dialog look bad</h3></dt>
<em>Pictures in the 'Open' dialog look bad</em> <dd>
<p> "Low Quality Thumbnails" is probably enabled. See: "Stamp
"Low Quality Thumbnails" is probably enabled. See: "Stamp thumbnails in the Stamp Selector look bad", above.
thumbnails in the Stamp Selector look bad", above. </dd>
</p>
</li>
<li> <dt><h3>The color picker buttons are ugly squares, not pretty buttons!</h3></dt>
<em>The color picker buttons are ugly squares, not pretty <dd>
buttons!</em>
<p> <p>
Tux&nbsp;Paint was probably compiled with the nice Tux&nbsp;Paint was probably compiled with the nice
looking color selector buttons disabled. Run the command: looking color selector buttons disabled. Run the command:
@ -211,10 +210,10 @@
<p> <p>
in the "tuxpaint.c" file in the "src" directory. in the "tuxpaint.c" file in the "src" directory.
</p> </p>
</li> </dd>
<li> <dt><h3>All of the text is in uppercase!</h3></dt>
<em>All of the text is in uppercase!</em> <dd>
<p> <p>
The "uppercase" option is on. The "uppercase" option is on.
</p> </p>
@ -251,18 +250,16 @@
Or use Tux&nbsp;Paint&nbsp;Config. and make sure "Show Or use Tux&nbsp;Paint&nbsp;Config. and make sure "Show
Uppercase Text Only" (under "Languages") is not checked. Uppercase Text Only" (under "Languages") is not checked.
</p> </p>
</li> </dd>
<li> <dt><h3>Tux&nbsp;Paint is in a different language!</h3></dt>
<em>Tux&nbsp;Paint is in a different language!</em> <dd>
<p> Make sure your locale setting is correct. See
Make sure your locale setting is correct. See "Tux&nbsp;Paint won't switch to my language", below.
"Tux&nbsp;Paint won't switch to my language", below. </dd>
</p>
</li>
<li> <dt><h3>Tux&nbsp;Paint won't switch to my language</h3></dt>
<em>Tux&nbsp;Paint won't switch to my language</em> <dd>
<ul> <ul>
<li> <li>
<i>Linux and Unix users: Make sure the locale is <i>Linux and Unix users: Make sure the locale is
@ -276,73 +273,73 @@
</p> </p>
<p> <p>
Note: Debian users can simply run Note: Debian and derivative (e.g., Ubuntu) users can simply run
"<code>dpkg-reconfigure locales</code>" if the "<code>dpkg-reconfigure locales</code>" if the
locales are managed by "dpkg." locales are managed by "dpkg."
</p> </p>
</li>
<ul> <li>If you're using the "<code>--lang</code>"
<li>If you're using the "<code>--lang</code>" command-line option
command-line option <p>
<p> Try using the "<code>--locale</code>"
Try using the "<code>--locale</code>" command-line option, or your operating system's
command-line option, or your operating system's locale settings (e.g., the "<code>$LANG</code>"
locale settings (e.g., the "<code>$LANG</code>" environment variable), and please e-mail us
environment variable), and please e-mail us regarding your trouble.
regarding your trouble. </p>
</p> </li>
</li>
<li>If you're using the "<code>--locale</code>" <li>If you're using the "<code>--locale</code>"
command-line option command-line option
<p> <p>
If this doesn't work, please e-mail us regarding If this doesn't work, please e-mail us regarding
your trouble. your trouble.
</p> </p>
</li> </li>
<li>If you're trying to use your Operating System's <li>If you're trying to use your Operating System's
locale locale
<p> <p>
If this doesn't work, please e-mail us regarding If this doesn't work, please e-mail us regarding
your trouble. your trouble.
</p> </p>
</li> </li>
<li>Make sure you have the necessary font <li>Make sure you have the necessary font
<p> <p>
Some translations require their own font. Chinese Some translations require their own font. Chinese
and Korean, for example, need Chinese and Korean and Korean, for example, need Chinese and Korean
TrueType Fonts installed and placed in the proper TrueType Fonts installed and placed in the proper
location, respectively. location, respectively.
</p> </p>
<p> <p>
The appropriate fonts for such locales can be The appropriate fonts for such locales can be
downloaded from the Tux&nbsp;Paint website: downloaded from the Tux&nbsp;Paint website:
</p> </p>
<blockquote> <blockquote>
<p> <p>
<a href= <a href=
"http://www.tuxpaint.org/download/fonts/">http://www.tuxpaint,org/download/fonts/</a> "http://www.tuxpaint.org/download/fonts/">http://www.tuxpaint,org/download/fonts/</a>
</p> </p>
</blockquote> </blockquote>
</li>
</ul>
</li> </li>
</ul> </ul>
</li> </dd>
</ul> </dl>
<hr>
<h2> <h2>
Printing Printing
</h2> </h2>
<ul> <dl>
<li> <dt><h3>Tux&nbsp;Paint won't print, gives an error, or prints
<em>Tux&nbsp;Paint won't print, gives an error, or prints garbage (Unix/Linux)</h3></dt>
garbage (Unix/Linux)</em> <dd>
<p> <p>
Tux&nbsp;Paint prints by creating a PostScript rendition Tux&nbsp;Paint prints by creating a PostScript rendition
of the picture and sending it to an external command. By of the picture and sending it to an external command. By
@ -370,11 +367,11 @@
Tux&nbsp;Paint 0.9.15, you will need to go back and alter Tux&nbsp;Paint 0.9.15, you will need to go back and alter
it to accept PostScript. it to accept PostScript.
</p> </p>
</li> </dd>
<li> <dt><h3>I get the message "You can't print yet!" when I go to
<em>I get the message "You can't print yet!" when I go to print!</h3></dt>
print!</em> <dd>
<p> <p>
The "print delay" option is on. You can only print once The "print delay" option is on. You can only print once
every <i>X</i>&nbsp;seconds. every <i>X</i>&nbsp;seconds.
@ -419,10 +416,10 @@
Or use Tux&nbsp;Paint&nbsp;Config. and make sure "Print Or use Tux&nbsp;Paint&nbsp;Config. and make sure "Print
Delay" (under "Printing") is set to "0&nbsp;seconds." Delay" (under "Printing") is set to "0&nbsp;seconds."
</p> </p>
</li> </dd>
<li> <dt><h3>I simply can't print! The button is greyed out!</h3></dt>
<em>I simply can't print! The button is greyed out!</em> <dd>
<p> <p>
The "no print" option is on. The "no print" option is on.
</p> </p>
@ -457,16 +454,18 @@
Or use Tux&nbsp;Paint&nbsp;Config. and make sure "Allow Or use Tux&nbsp;Paint&nbsp;Config. and make sure "Allow
Printing" (under "Printing") is checked. Printing" (under "Printing") is checked.
</p> </p>
</li> </dd>
</ul> </dl>
<hr>
<h2> <h2>
Saving Saving
</h2> </h2>
<ul> <dl>
<li> <dt><h3>Where does Tux Paint save my drawings?</h3><dt>
<em>Where are my pictures?</em> <dd>
<p> <p>
Unless you asked Tux&nbsp;Paint to save into a specific Unless you asked Tux&nbsp;Paint to save into a specific
location (using the 'savedir' option), Tux&nbsp;Paint location (using the 'savedir' option), Tux&nbsp;Paint
@ -475,7 +474,7 @@
<dl> <dl>
<dt> <dt>
Windows Vista Windows Vista, Windows 8, Windows 10
</dt> </dt>
<dd> <dd>
@ -522,10 +521,10 @@
programs should be able to load (image editors, word programs should be able to load (image editors, word
processors, web browsers, etc.) processors, web browsers, etc.)
</p> </p>
</li> </dd>
<li> <dt><h3>Tux&nbsp;Paint always saves over my old picture!</h3></dt>
<em>Tux&nbsp;Paint always saves over my old picture!</em> <dd>
<p> <p>
The "save over" option is enabled. (This disables the The "save over" option is enabled. (This disables the
prompt that would appear when you click 'Save.') prompt that would appear when you click 'Save.')
@ -567,10 +566,10 @@
Also, see "Tux&nbsp;Paint always saves a new picture!", Also, see "Tux&nbsp;Paint always saves a new picture!",
below. below.
</p> </p>
</li> </dd>
<li> <dt><h3>Tux&nbsp;Paint always saves a new picture!</h3></dt>
<em>Tux&nbsp;Paint always saves a new picture!</em> <dd>
<p> <p>
The "never save over" option is enabled. (This disables The "never save over" option is enabled. (This disables
the prompt that would appear when you click 'Save.') the prompt that would appear when you click 'Save.')
@ -612,16 +611,18 @@
Also, see "Tux&nbsp;Paint always saves over my old Also, see "Tux&nbsp;Paint always saves over my old
picture!", above. picture!", above.
</p> </p>
</li> </dd>
</ul> </dl>
<hr>
<h2> <h2>
Audio Problems Audio Problems
</h2> </h2>
<ul> <dl>
<li> <dt><h3>There's no sound!</h3></dt>
<em>There's no sound!</em> <dd>
<ul> <ul>
<li> <li>
<em>First, check the obvious:</em> <em>First, check the obvious:</em>
@ -735,11 +736,10 @@
</p> </p>
</li> </li>
</ul> </ul>
</li> </dd>
<li> <dt><h3>Tux Paint makes too much noise! Can I turn them off?</h3></dt>
<em>Tux Paint makes too much noise! Can I turn them <dd>
off?</em>
<p> <p>
Yes, there are a number of ways to disable sounds in Tux Yes, there are a number of ways to disable sounds in Tux
Paint: Paint:
@ -774,11 +774,10 @@
</ul> </ul>
</li> </li>
</ul> </ul>
</li> </dd>
<li> <dt><h3>The stereo panning of sound effects is bothersome; can sound effects be monophonic?</h3></dt>
<em>The stereo panning of sound effects is bothersome; can sound <dd>
effects be monophonic?</em>
<p> <p>
Run Tux&nbsp;Paint with the "no&nbsp;stereo" option: Run Tux&nbsp;Paint with the "no&nbsp;stereo" option:
</p> </p>
@ -796,10 +795,10 @@
the command line or shortcut or desktop icon. the command line or shortcut or desktop icon.
</li> </li>
</ul> </ul>
</li> </dd>
<li> <dt><h3>The sound effects sound strange</h3><dt>
<em>The sound effects sound strange</em> <dd>
<p> <p>
This could have to do with how SDL and SDL_mixer were This could have to do with how SDL and SDL_mixer were
initialized. (The buffer size chosen.) initialized. (The buffer size chosen.)
@ -812,25 +811,25 @@
"<code>tuxpaint&nbsp;--version</code>" to verify), and so "<code>tuxpaint&nbsp;--version</code>" to verify), and so
on.) on.)
</p> </p>
</li> </dd>
</ul> </dl>
<hr>
<h2> <h2>
Fullscreen Mode Problems Fullscreen Mode Problems
</h2> </h2>
<ul> <dl>
<li> <dt><h3>When I run Tux&nbsp;Paint full-screen and ALT-TAB out,
<em>When I run Tux&nbsp;Paint full-screen and ALT-TAB out, the window turns black!</h3></dt>
the window turns black!</em> <dd>
<p> This is apparently a bug in the SDL library. Sorry.
This is apparently a bug in the SDL library. Sorry. </dd>
</p>
</li>
<li> <dt><h3>When I run Tux&nbsp;Paint full-screen, it has large
<em>When I run Tux&nbsp;Paint full-screen, it has large borders around it</h3></dt>
borders around it</em> <dd>
<p> <p>
Linux users - Your X-Window server is probably not set Linux users - Your X-Window server is probably not set
with the ability to switch to the desired resolution: with the ability to switch to the desired resolution:
@ -875,11 +874,11 @@
command "dpkg-reconfigure xserver-xfree86" as root, for command "dpkg-reconfigure xserver-xfree86" as root, for
example. example.
</p> </p>
</li> </dd>
<li> <dt><h3>Tux&nbsp;Paint keeps running in Full Screen mode - I
<em>Tux&nbsp;Paint keeps running in Full Screen mode - I want it windowed!</h3></dt>
want it windowed!</em> <dd>
<p> <p>
The "fullscreen" option is set. The "fullscreen" option is set.
</p> </p>
@ -914,16 +913,18 @@
Or use Tux&nbsp;Paint&nbsp;Config. and make sure Or use Tux&nbsp;Paint&nbsp;Config. and make sure
"Fullscreen" (under "Video &amp; Sound") is not checked. "Fullscreen" (under "Video &amp; Sound") is not checked.
</p> </p>
</li> </dd>
</ul> </dl>
<hr>
<h2> <h2>
Other Probelms Other Probelms
</h2> </h2>
<ul> <dl>
<li> <dt><h3>Tux&nbsp;Paint won't run</h3></dt>
<em>Tux&nbsp;Paint won't run</em> <dd>
<p> <p>
If Tux&nbsp;Paint aborts with the message: "You're If Tux&nbsp;Paint aborts with the message: "You're
already running a copy of Tux&nbsp;Paint!", this means it already running a copy of Tux&nbsp;Paint!", this means it
@ -962,10 +963,10 @@
"<code>--nolockfile</code>" argument to Tux&nbsp;Paint's "<code>--nolockfile</code>" argument to Tux&nbsp;Paint's
command-line. command-line.
</p> </p>
</li> </dd>
<li> <dt><h3>I can't quit Tux&nbsp;Paint</h3></dt>
<em>I can't quit Tux&nbsp;Paint</em> <dd>
<p> <p>
The "noquit" option is set. This disables the "Quit" The "noquit" option is set. This disables the "Quit"
button in Tux&nbsp;Paint's toolbar (greying it out), and button in Tux&nbsp;Paint's toolbar (greying it out), and
@ -990,10 +991,10 @@
the <b>[Alt] + [F4]</b> combination on your keyboard to the <b>[Alt] + [F4]</b> combination on your keyboard to
quit Tux&nbsp;Paint.) quit Tux&nbsp;Paint.)
</p> </p>
</li> </dd>
<li> <dt><h3>I don't want "noquit" mode enabled!</h3></dt>
<em>I don't want "noquit" mode enabled!</em> <dd>
<p> <p>
If you're running Tux&nbsp;Paint from a command-line, If you're running Tux&nbsp;Paint from a command-line,
make sure you're not giving it a "<code>--noquit</code>" make sure you're not giving it a "<code>--noquit</code>"
@ -1025,11 +1026,11 @@
Quit Button and [Escape] Key" (under "Simplification") is Quit Button and [Escape] Key" (under "Simplification") is
not checked. not checked.
</p> </p>
</li> </dd>
<li> <dt><h3>Tux&nbsp;Paint keeps writing weird messages to the
<em>Tux&nbsp;Paint keeps writing weird messages to the screen / to a text file</h3></dt>
screen / to a text file</em> <dd>
<p> <p>
A few messages are normal, but if Tux&nbsp;Paint is being A few messages are normal, but if Tux&nbsp;Paint is being
extremely verbose (like listing the name of every extremely verbose (like listing the name of every
@ -1051,10 +1052,10 @@
<p> <p>
in the "tuxpaint.c" file in the "src" directory. in the "tuxpaint.c" file in the "src" directory.
</p> </p>
</li> </dd>
<li> <dt><h3>Tux&nbsp;Paint is using options I didn't specify!</h3></dt>
<em>Tux&nbsp;Paint is using options I didn't specify!</em> <dd>
<p> <p>
By default, Tux&nbsp;Paint first looks at configuration By default, Tux&nbsp;Paint first looks at configuration
files for options. files for options.
@ -1167,26 +1168,18 @@
command-line arguments to determine what options should command-line arguments to determine what options should
be set. be set.
</p> </p>
</li> </dd>
</ul> </dl>
<hr>
<h2> <h2>
Help / Contact Help / Contact
</h2> </h2>
<p> <p>
Any questions you don't see answered? Let me know! Any questions you don't see answered? Please let us know!
</p> You can subscribe and post to our "tuxpaint-users" mailing list:
<blockquote>
<p>
<a href=
"mailto:bill@newbreedsoftware.com">bill@newbreedsoftware.com</a>
</p>
</blockquote>
<p>
Or post to our 'tuxpaint-users' mailing list:
</p> </p>
<blockquote> <blockquote>
@ -1195,5 +1188,16 @@
"http://www.tuxpaint.org/lists/">http://www.tuxpaint.org/lists/</a> "http://www.tuxpaint.org/lists/">http://www.tuxpaint.org/lists/</a>
</p> </p>
</blockquote> </blockquote>
<p>
Or, contact lead developer Bill Kendrick directly:
</p>
<blockquote>
<p>
<a href=
"mailto:bill@newbreedsoftware.com">bill@newbreedsoftware.com</a>
</p>
</blockquote>
</body> </body>
</html> </html>