tuxpaint-pencil-sharpener/docs/TROUBLESHOOTING.txt
2023-03-09 22:42:43 -08:00

59 lines
2.2 KiB
Text

Troubleshooting Guide for Tux Paint
Last updated: 2023.03.09
Questions
=========
For users, the following is a list of information you can send the
Tux Paint developers when opening a ticket at SourceForge.net or
emailing us for assistance.
Tux Paint project members, if someone has asked you for help, there is
information you can gather before passing it along to the developers
(in particular, those who help maintain the various ports of Tux Paint).
Windows
-------
* The version of Windows (e.g., "Windows 11 Pro 22H2")
* The version of Tux Paint (e.g., "0.9.28-3")
* Type of the package used -- Installer EXE or Portable ZIP version
* If Installer, Which installation type was selected while -- "All Users"
or "Current User Only"
* Send a copy of the config file, e.g. "tuxpaint.cfg" in
C:\Users\username\AppData\Roaming\TuxPaint\
* Send any debugging output files, e.g., "stdout.txt" and "stderr.txt"
in C:\Users\username\AppData\Roaming\TuxPaint\
* FIXME -- Anything else?
macOS
-----
* The version of macOS (e.g., "macOS 13.1 Ventura")
* The CPU type (e.g., "Intel x86_64", or "Apple Silicon M1")
* The version of Tux Paint (e.g., 0.9.28-3)
* Send a copy of the config file, e.g. "tuxpaint.cfg" in
$HOME/Library/Application Support/TuxPaint/
* FIXME -- Current way to grab stderr/stdout output
(may need to describe how to get the Terminal app?)
* FIXME -- Anything else?
Android
-------
* The version of Android (e.g., "Tiramisu (OS 13)")
* The version of Tux Paint (e.g., "0.9.28-1" aka "9281")
* The source of Tux Paint -- Google Play, F-Droid, direct APK download
* Any changes made to Tux Paint configuration ("gear" icon)
FIXME -- Is there an easy way to grab the config file?
* FIXME -- Anything else?
Linux
-----
* The Linux distro and version (e.g., Ubuntu 22.04, RHEL 9, etc.)
* The version of Tux Paint (e.g., "0.9.28-3")
* The source of Tux Paint -- built from source code, installed
from distro's software repository, direct package file download
(.rpm), Flatpak, etc.
* Send a copy of the config file, e.g. ".tuxpaintrc" in $HOME
* Any output seen on a terminal when running "tuxpaint" from
a command-line
* FIXME -- Anything else?