                                   Tux Paint
                                 versión 0.9.27
                          Documentación da instalación

    Copyright © 2002-2021 por varios colaboradores; vexa AUTHORS (AUTORES).
                            http://www.tuxpaint.org/

                             17 de Setembro de 2021

     ----------------------------------------------------------------------

   +----------------------------------------------------+
   |Índice                                              |
   |----------------------------------------------------|
   |  * Requirements                                    |
   |       * Simple DirectMedia Layer library (libSDL)  |
   |       * Outras bibliotecas                         |
   |  * Compiling and Installation                      |
   |       * Usuarios de Windows                        |
   |       * Usuarios de Linux/Unix                     |
   |       * Usuarios de macOS                          |
   |  * Debugging                                       |
   |  * Uninstalling Tux Paint                          |
   |       * Windows                                    |
   |       * macOS                                      |
   |       * Linux                                      |
   +----------------------------------------------------+

     ----------------------------------------------------------------------

Requirements

  Simple DirectMedia Layer library (libSDL)

       Tux Paint require a «Simple DirectMedia Layer Library (libSDL)», unha
       biblioteca de programación multimedia de código aberto dispoñíbel
       baixo a licenza pública GNU Lesser General Public License (LGPL).

       Along with libSDL, Tux Paint depends on a number of other SDL 'helper'
       libraries: SDL_Image (for graphics files), SDL_gfx (for some graphical
       functions, like rotation), SDL_TTF and (optionally) SDL_Pango (for
       True Type Font support) and, optionally, SDL_Mixer (for sound
       effects).

    Usuarios de Linux/Unix:

         As bibliotecas SDL están dispoñíbeis como código fonte ou como
         paquetes RPM ou Debian para varias distribucións de Linux. Pódense
         descargar dende:

           * libSDL: http://www.libsdl.org/
           * SDL_Image: http://www.libsdl.org/projects/SDL_image/
           * SDL_gfx:
             https://www.ferzkopp.net/wordpress/2016/01/02/sdl_gfx-sdl2_gfx/
             (https://sourceforge.net/projects/sdlgfx/)
           * SDL_TTF: http://www.libsdl.org/projects/SDL_ttf/
           * SDL_Pango: http://sourceforge.net/projects/sdlpango/ (opcional)
           * SDL_Mixer: http://www.libsdl.org/projects/SDL_mixer/ (opcional)

         Normalmente tamén están dispoñíbeis xunto coa súa distribución de
         Linux (p. ex.: nun medio de instalación ou dispoñíbeis a través dun
         software de mantemento de paquetes como «apt» de Debian).

         Nota: Cando instale bibliotecas a partir de paquetes, asegúrese de
         instalar TAMÉN as versións de desenvolvemento dos paquetes. (Por
         exemplo, instale tanto «SDL-1.2.4.rpm» como «SDL-1.2.4-devel.rpm».).

  Outras bibliotecas

       Tux Paint tamén aproveita outras bibliotecas libres con licenza LGPL.
       En Linux, do mesmo xeito que SDL, deberían estar xa instaladas ou
       estar dispoñíbeis para a súa instalación como parte da súa
       distribución de Linux.

    libPNG

         Tux Paint utiliza o formato PNG (Portable Network Graphics –
         Gráficos de Rede Portátiles) para os seus ficheiros de datos. A
         imaxe SDL requirirá a instalación de libPNG.

         http://www.libpng.org/pub/png/libpng.html

    gettext

         Tux Paint utiliza a configuración local do sistema xunto coa
         biblioteca «gettext» para admitir varios idiomas (p. ex., o
         español). Necesitará ter a biblioteca gettext instalada.

         http://www.gnu.org/software/gettext/

    libpaper (Só Linux/Unix)

         A partir de Tux Paint 0.9.17, Tux Paint pode determinar o tamaño de
         papel predeterminado do seu sistema (p. ex.: A4 ou Carta), ou
         pódeselle indicar que use un tamaño de papel particular, grazas a
         «libpaper».

         https://github.com/naota/libpaper

    FriBiDi

         As ferramentas «Texto» e «Etiqueta» de Tux Paint admiten linguaxes
         bidireccionais grazas á biblioteca «FriBiDi».

         http://fribidi.org/

    Compatibilidade de SVG

         A partir de Tux Paint 0.9.17, Tux Paint pode cargar imaxes SVG
         (Scalable Vector Graphics — Gráficos Vectoriais Escalábeis) como
         selos. Admítense dous conxuntos de bibliotecas e pódese desactivar
         completamente a compatibilidade SVG (a través de «make SVG_LIB:=»)

      librsvg-2 & libCairo2 (bibliotecas máis recentes)

           * libRSVG 2: http://librsvg.sourceforge.net/
           * Cairo 2: http://www.cairographics.org/
           * Estes tamén dependen do seguinte:
                * GdkPixbuf & GLib: http://www.gtk.org/
                * Pango: http://www.pango.org/

      Bibliotecas SVG máis antigas

           * libcairo1, libsvg1, & libsvg-cairo1:
             http://www.cairographics.org/
           * Estes tamén dependen do seguinte:
                * libxml2: https://gitlab.gnome.org/GNOME/libxml2

    Función de exportación de GIF animado

         Para a compatibilidade da exportación de GIF animados (presentacións
         de diapositivas), é necesaria a biblioteca «libimagequant» (do
         proxecto «pngquant2»).

         https://github.com/ImageOptim/libimagequant

    Ferramentas NetPBM (opcional) Xa non se usa, de xeito predeterminado

         En Linux e Unix, as versións anteriores de Tux Paint utilizaban as
         ferramentas NetPBM para axudar á impresión. (Tux Paint xera un PNG e
         convértese nun PostScript usando as ferramentas da liña de ordes
         NetPBM «pngtopnm» e «pnmtops»).

         http://netpbm.sourceforge.net/

     ----------------------------------------------------------------------

Compiling and Installation

     Tux Paint publícase baixo a Licenza Pública Xeral de GNU (GPL) (consulte
     «COPYING.txt» para máis detalles) e, polo tanto, o «código fonte» do
     programa está dispoñíbel libremente.

  Usuarios de Windows

     3 de Novembro de 2021 Shin-ichi TOYAMA shin1@wmail.plala.or.jp
     <shin1@wmail.plala.or.jp>

    Compiling Set-Up

         A partir de febreiro de 2005 (comezando con Tux Paint 0.9.15), o
         «Makefile» inclúe compatibilidade para construír nun sistema Windows
         usando MinGW/MSYS (https://sourceforge.net/projects/msys2/).

         Many tools and libraries are required to build Tux Paint. The
         package management system "pacman" helps you install them
         automatically solving complicated dependencies.

         Download the latest MSYS2 environment from
         https://sourceforge.net/projects/msys2/files/Base/ and install it
         where you'd like (the default is "C:\msys64")

         Open the MSYS2 shell from the "Start Menu" -> "MSYS2 64bit" ->
         "MSYS2 MSYS" and execute following command (press [Intro] or
         [Retorno] to accept the defaults for all questions):

           pacman -Syu

         This will update core system and the window will close
         automatically. Repeat the steps above one more time to finish the
         remaining update process.

         Within the MSYS2 shell, run the following command to install basic
         development tools:

           pacman -S base-devel msys2-devel git

       Proceed to the next "MinGW 64bit (x86_64) toolchains" section, or skip
       to the "MinGW 32bit (i686) toolchains" section if you need only a
       32bit build environment.

            -------------------------------------------------------

    MinGW 64bit (x86_64) toolchains

         Within the MSYS2 shell, run the following command to install basic
         64bit development tools:

           pacman -S mingw-w64-x86_64-toolchain

    64bit (x86_64) dependency libraries for Tux Paint

         You can install tools and libraries required for compiling Tux Paint
         on MSYS2/MINGW using "pacman" except for SDL_Pango.

         "ntldd" is a small tool which examine windows executable files to
         list Dynamic Link Library (.dll) files they depends on. Tux Paint's
         packaging process for binary distribution uses it to find required
         .dll files.

         FLTK is a cross-platform GUI toolkit used by "Tux Paint Config.".
         You can skip installing it if you are only building "Tux Paint".

           $ pacman -S mingw-w64-x86_64-SDL_{image,mixer,ttf,gfx}
           $ pacman -S mingw-w64-x86_64-librsvg
           $ pacman -S mingw-w64-x86_64-fribidi
           $ pacman -S mingw-w64-x86_64-libimagequant
           $ pacman -S mingw-w64-x86_64-fltk
           $ pacman -S mingw-w64-x86_64-ntldd-git

         Note: Close the shell before proceeding to the remaining process.

    Install SDL_Pango on the 64bit environment

         SDL_Pango should be installed manually.

         This time, use the MinGW "64bit" shell. Open the shell from the
         "Start Menu" -> "MSYS2 64bit" -> "MSYS2 MinGW 64-bit"

      SDL_Pango

           At first, you have to prepare source tar-ball and a required patch
           in the same directory.

             * Download source tar-ball of SDL_Pango-0.1.2 from SDL_Pango's
               page on Sourceforge.net.
             * Download a patch file from John Popplewell's "Tux Paint -
               MinGW/MSYS build instructions" webpage. (This adds some extra
               (required) functionality to SDL_Pango.)

           Build and install SDL_Pango as follows.

             $ tar zxvf SDL_Pango-0.1.2.tar.gz
             $ cd SDL_Pango-0.1.2/
             $ patch -p0 < ../SDL_Pango-configure-extra-api.patch
             $ ./configure --prefix=/mingw64 && make && make install

       Proceed to the next "MinGW 32bit (i686) toolchains" section, or skip
       to the "ImageMagick" section if you need only a 64bit build
       environment.

            -------------------------------------------------------

    MinGW 32bit (i686) toolchains

         Within the MSYS2 shell, run the following command to install basic
         32bit development tools:

           pacman -S mingw-w64-i686-toolchain

    32bit (i686) dependency libraries for Tux Paint

         You can install tools and libraries required for compiling Tux Paint
         on MSYS2/MINGW using "pacman" except for SDL_Pango.

         "ntldd" is a small tool which examine windows executable files to
         list Dynamic Link Library (.dll) files they depends on. Tux Paint's
         packaging process for binary distribution uses it to find required
         .dll files.

         FLTK is a cross-platform GUI toolkit used by "Tux Paint Config.".
         You can skip installing it if you are only building "Tux Paint".

           $ pacman -S mingw-w64-i686-SDL_{image,mixer,ttf,gfx}
           $ pacman -S mingw-w64-i686-librsvg
           $ pacman -S mingw-w64-i686-fribidi
           $ pacman -S mingw-w64-i686-libimagequant
           $ pacman -S mingw-w64-i686-fltk
           $ pacman -S mingw-w64-i686-ntldd-git

         Note: Close the shell before proceeding to the remaining process.

    Install SDL_Pango on the 32bit environment

         SDL_Pango should be installed manually.

         This time, use the MinGW "32bit" shell. Open the shell from the
         "Start Menu" -> "MSYS2 64bit" -> "MSYS2 MinGW 32-bit"

      SDL_Pango

           At first, you have to prepare source tar-ball and a required patch
           in the same directory.

             * Download source tar-ball of SDL_Pango-0.1.2 from SDL_Pango's
               page on Sourceforge.net.
             * Download a patch file from John Popplewell's "Tux Paint -
               MinGW/MSYS build instructions" webpage. (This adds some extra
               (required) functionality to SDL_Pango.)

           Build and install SDL_Pango as follows.

             $ tar zxvf SDL_Pango-0.1.2.tar.gz
             $ cd SDL_Pango-0.1.2/
             $ patch -p0 < ../SDL_Pango-configure-extra-api.patch
             $ ./configure --prefix=/mingw32 && make && make install

            -------------------------------------------------------

    ImageMagick

         ImageMagick is a compilation of command line tools to create, edit,
         compose, or convert bitmap images supporting quite a large number of
         image formats. Tux Paint uses two functions ("convert" and
         "composite") in it to generate thumbnails for startar images and
         templates during the build process.

         Using official binary release available from "Windows Binary
         Release" is recommended, due to the commands installed with "pacman"
         on MinGW/MSYS not working as expected!

         Do not forget to enable "Install legacy utilities (e.g. convert)"
         while installing it, because Tux Paint's build process uses them.

         Add the path to the directory in which ImageMagick is installed at
         the top of your "PATH" environment variable. For example:

           $ export PATH=/c/Program\ Files/ImageMagick-7.0.10-Q16-HDRI:$PATH

         You can make this permanent by adding the above to your the BASH
         shell configuration file, "~/.bash_profile".

            -------------------------------------------------------

    Tux Paint

         You can compile 64bit binaries using MSYS2 64bit shell, and 32bit
         binaries using MSYS2 32bit shell, respectively.

           * Select "MSYS2 64bit" -> "MSYS2 MinGW 64-bit" from the "Start
             Menu" to open the 64bit shell.
           * Select "MSYS2 64bit" -> "MSYS2 MinGW 32-bit" from the "Start
             Menu" to open the 32bit shell.

         Compile Tux Paint with the following command:

           $ make bdist-win32

         Note: At this point, you will want to build "Tux Paint Config." for
         Windows, so it can be included along with "Tux Paint", if you're
         making an official (or test) release. The build process will look
         for it in a directory named "tuxpaint-config" (with no version
         number, e.g., "tuxpaint-config-X.Y.Z"). See "Tux Paint Config."'s
         INSTALL.txt documentation for details.

         All the files needed for starting Tux Paint (and Tux Paint Config.)
         are collected in the directory for binary distribution "bdist"
         directory under "win32". You can start them by double-clicking their
         executable (.exe) files in the "bdist" directory.

            -------------------------------------------------------

    Building the Tux Paint Windows Installer:

         Inno Setup is used to build executable installer for Tux Paint.
         Therefore you have to install it in the first place.

         Inno Setup officially supports translations for only about 20
         languages. However, one of the great points of Tux Paint is it
         supports so many languages. Therefore, the set up script
         "tuxpaint.iss" to build the installer is written to use much more
         translations including unofficial one which are available on "Inno
         Setup Translations". You have to download translation files (.isl)
         required and put them in "Languages" directory under the directory
         in which Inno Setup is installed.

         Before building an installer, edit the "tuxpaint.iss" file and
         enable one of the lines starting with "#define BuildTarget=",
         depending on the architecture of the installer you want to create.

         Then, you can easily build an executable installer by right-clicking
         on the "tuxpaint.iss" icon in the "win32" directory and selecting
         "Compile" on the list. It will run for a while, and eventually you
         will find a "tuxpaint-X.Y.Z-windows-<arch>-installer.exe" file in
         the same directory.

            -------------------------------------------------------

    Running the Tux Paint Windows Installer:

         Faga dobre clic no executábel do instalador de Tux Paint (ficheiro
         .EXE) e siga as instrucións.

         First, you will be asked to read the license. (It is the GNU General
         Public License (GPL), which is also available as "COPYING.txt".)

         Após preguntaráselle se quere instalar accesos directos a Tux Paint
         no seu menú de inicio de Windows e no escritorio de Windows.
         (Ámbalas dúas opcións están definidas de xeito predeterminado.)

         A seguir preguntaráselle onde quere instalar Tux Paint. O valor
         predeterminado debería ser axeitado, sempre que haxa espazo
         dispoñíbel. Se non, escolla un lugar diferente.

         Neste punto, pode premer en «Instalar» para instalar Tux Paint.

            -------------------------------------------------------

    Cambiar os axustes usando o acceso directo:

         Para cambiar os axustes do programa, prema co botón dereito no
         atallo de TuxPaint e seleccione «Propiedades» (na parte inferior).

         Asegúrese de que a lapela «Atallo» está seleccionada na xanela que
         aparece e examine o campo «Obxectivo:». Debería ver algo así:

           "C:\Program Files\TuxPaint\TuxPaint.exe"

         Agora pode engadir opcións de liña de ordes que se activarán ao
         facer dobre clic na icona.

         Por exemplo, para que o xogo se execute en modo de pantalla
         completa, con formas sinxelas (sen opción de rotación) e en francés,
         engada as opcións (após «TuxPaint.exe»), así:

           "C:\Program Files\TuxPaint\TuxPaint.exe" -f -s --lang french

         (Vexa a documentación principal para obter unha lista completa das
         opcións dispoñíbeis da liña de ordes.)

         Se se trabuca ou desaparece todo, use [Ctrl] + [Z] para desfacer ou
         só prema a tecla [Esc] e a caixa pecharase sen facer cambios (a non
         ser que premera o botón «Aplicar»).

         Cando teña rematado, prema en «Aceptar».

            -------------------------------------------------------

    Se algo vai mal:

         Se ao facer dobre clic no atallo para executar Tux Paint, non ocorre
         nada, probabelmente sexa porque algunhas destas opcións da liña de
         ordes son incorrectas. Abra un explorador de ficheiros coma antes e
         busque un ficheiro chamado «stderr.txt» no cartafol TuxPaint.

         Conterá unha descrición do que estaba mal. Normalmente só se debe a
         maiúsculas e minúsculas incorrectas (maiúsculas «Z» no canto de
         minúsculas «z») ou a falta (ou exceso) de «-» (guións).

     ----------------------------------------------------------------------

  Usuarios de Linux/Unix

    Compilación:

         Nota: Tux Paint non usa autoconf/automake, polo que non hai ningún
         script «./configure» para executar. Non obstante, a compilación
         debería ser directa, supoñendo que todo o que precisa Tux Paint está
         instalado.

         Para compilar o programa dende o código fonte, simplemente execute a
         seguinte orde dende un indicador do sistema (p. ex.: «$»):

           $ make

            -------------------------------------------------------

    Desactivar a compatibilidade de «SVG» (e, polo tanto, as dependencias de
    «Cairo, libSVG, e svg-cairo»:

         Para desactivar a compatibilidade con SVG (por exemplo, se o seu
         sistema non é compatíbel coa biblioteca de Cairo ou outras
         dependencias relacionadas co SVG), pode executar «make» engadindo
         «SVG_LIB= SVG_CFLAGS= NOSVGFLAG=NOSVG»:

           $ make SVG_LIB= SVG_CFLAGS=

            -------------------------------------------------------

    Desactivar a compatibilidade de «Pango» (e, polo tanto, as dependencias de
    «Pango, Cairo, etc.»:

         Antes da versión 0.9.18, Tux Paint utilizaba a biblioteca libSDL_ttf
         para renderizar texto usando tipos de letra TrueType. Dende o 0.9.18
         úsase libSDL_Pango, xa que ten unha mellor compatibilidade coa
         internacionalización. Non obstante, se quere desactivar o uso de
         SDL_Pango, pode facelo executando «make» engadindo «SDL_PANGO_LIB=»:

           $ make SDL_PANGO_LIB=

            -------------------------------------------------------

    Desactivación do son en tempo de compilación:

         Se non te unha tarxeta de son ou prefire construír o programa sen
         asistencia de son (e polo tanto sen a dependencia SDL_mixer), pode
         executar «make» con «SDL_MIXER_LIB=» engadido:

           $ make SDL_MIXER_LIB=

            -------------------------------------------------------

    Outras opcións:

         Outras opcións (p. ex.: rutas de instalación) poden ser anuladas;
         véxaas en «Makefile» para máis detalles.

            -------------------------------------------------------

    Se se producen erros:

         Se recibe algún erro durante o tempo de compilación, asegúrese de
         ter instaladas as bibliotecas axeitadas (ver máis arriba). Se está a
         empregar versións empaquetadas das bibliotecas (por exemplo, RPM en
         RedHat ou DEB en Debian), asegúrese de obter tamén os
         correspondentes paquetes «-dev» ou «-devel», se non, non poderá
         compilar Tux Paint (e outros programas) dende o código fonte.

            -------------------------------------------------------

    Instalar:

         Supoñendo que non se produciron erros graves, agora pode instalar o
         programa para que os usuarios do sistema poidan executalo. De xeito
         predeterminado, isto debe facelo o usuario «root» («superusuario»).
         Cambie a «root» escribindo a orde:

           $ su

         Introduza o contrasinal de «root» no indicador do sistema. Agora
         debería ser «root» (cun indicador como «#»). Para instalar o
         programa e os seus ficheiros de datos, escriba:

           # make install

         Finalmente, pode volver ao seu usuario habitual saíndo do modo de
         superusuario:

           # exit

         Como alternativa, pode simplemente usar a orde «sudo» (po.ex.: en
         Ubuntu Linux):

           $ sudo make install

         Nota: De xeito predeterminado, «tuxpaint», o programa executábel,
         colócase en «/usr/local/bin/». Os ficheiros de datos (imaxes, sons,
         etc.) colócanse en «/usr/local/share/tuxpaint/».

      Cambiar onde van as cousas

           Pode cambiar onde irán as cousas axustando as variábeis de
           «Makefile» na liña de ordes. «DESTDIR» úsase para colocar a saída
           nunha área de espera para a creación de paquetes. «PREFIX» é a
           base de onde van todos os demais ficheiros e, de xeito
           predeterminado, está estabelecido en «/usr/local».

           Outras variábeis son:

           BIN_PREFIX
                   Onde se instalará o binario «tuxpaint». (Estabelécese como
                   «$(PREFIX)/bin»como predeterminado, p. ex.:
                   «/usr/local/bin»)

           DATA_PREFIX
                   Onde irán os ficheiros de datos (son, gráficos, pinceis,
                   selos, tipos de letra) e onde os buscará Tux Paint cando
                   se execute. (Estabelecer en «$(PREFIX)/share/tuxpaint»)

           DOC_PREFIX
                   Onde irán os ficheiros de texto da documentación (o
                   directorio «docs»). (Estabelecer como
                   «$(PREFIX)/share/doc/tuxpaint»)

           MAN_PREFIX
                   Onde irá a páxina do manual de Tux Paint. (Estabelecer
                   como «$(PREFIX)/share/man»)

           ICON_PREFIX — $(PREFIX)/share/pixmaps

           X11_ICON_PREFIX — $(PREFIX)/X11R6/include/X11/pixmaps

           GNOME_PREFIX — $(PREFIX)/share/gnome/apps/Graphics

           KDE_PREFIX — $(PREFIX)/share/applnk/Graphics
                   Onde irán as iconas e os lanzadores (para GNOME e KDE).

           LOCALE_PREFIX
                   Onde irán os ficheiros de tradución para Tux Paint e onde
                   os buscará Tux Paint. (Estabelécese en
                   «$(PREFIX)/share/locale/») (A localización final dun
                   ficheiro de tradución estará no directorio da
                   configuración local (por exemplo, «es» para o español),
                   dentro do subdirectorio «LC_MESSAGES»).

           Nota: Esta lista non está actualizada. Consulte «Makefile» e
           «Makefile-i18n» para ver unha lista completa.

     ----------------------------------------------------------------------

  Usuarios de macOS

     21 de Setembro de 2021 Mark K. Kim <markuskimius@gmail.com>

       Tux Paint 0.9.22 and earlier required building Tux Paint from the
       Xcode IDE. Starting with 0.9.23, however, Tux Paint for macOS is built
       as though it were a Linux application.

    Prerequisites

         Although Tux Paint is built without the Xcode IDE, Xcode itself is
         still required to build Tux Paint. Download it from the App Store,
         and launch it once to accept its license agreements. You may also
         need to install the Xcode command line tools using the command:

           xcode-select --install

         Building Tux Paint also requires various libraries. We install them
         from MacPorts where possible, source code otherwise. Install
         MacPorts to the default /opt/local path according to the
         instructions found on their website: https://www.macports.org/
           * ImageMagick
           * cairo
           * fribidi
           * lbzip2
           * libimagequant^*
           * libpaper
           * libpng
           * librsvg
           * libsdl
           * libsdl_image
           * libsdl_mixer
           * libsdl_pango
           * libsdl_ttf
           * libsdl_gfx
           * pkgconfig
           * zlib
         ... but you should install any package that is required by the
         latest version of Tux Paint.

         ^* Not available from MacPorts as of this writing, see below.

      libimagequant

           libimagequant is not available from MacPorts as of this writing.
           It can be installed from the source code as follows. It should be
           installed to /opt/local (same as MacPorts) for the library to be
           included in TuxPaint.dmg.

             $ git clone https://github.com/ImageOptim/libimagequant.git
             $ cd libimagequant
             $ ./configure --prefix=/opt/local
             $ make
             $ sudo make install

         WARNING: Having any UNIX-like toolset installed on your Mac besides
         MacPorts and Xcode, such as Fink or Brew, will prevent your app
         bundle from being portable. Be sure Fink and Brew are not accessible
         from your build environment.

            -------------------------------------------------------

    How to Build

         Simply, run:

           % make
           % make install

         ... to create the TuxPaint.app application bundle that can be run
         in-place or copied to /Applications. It also creates TuxPaint.dmg
         for distribution.

            -------------------------------------------------------

    Known Issues

           * A macOS binary built on a specific version of macOS only runs on
             that version of macOS or later. To ensure Tux Paint can run on
             the oldest version of macOS possible, build it on the oldest
             version of macOS available. As of this writing we know Tux Paint
             cannot be built to run on macOS 10.7 or earlier.

             See "Old Versions of macOS" below for best-effort instructions
             on how to obtain, install, and build Tux Paint on an old version
             of macOS.

            -------------------------------------------------------

    Old Versions of macOS

         Some old versions of macOS can be downloaded from Apple's support
         page: https://support.apple.com/en-us/HT211683

         macOS does allow dual booting of multiple versions of the OS, but
         it's safer and easier to install the old macOS onto a flash drive.
         Wherever you're installing it, the target drive's partitioniong
         scheme and partition type must match what the old macOS expects, so
         use the Disk Utility to partition and format the flash drive
         accordingly.

         As of this writing, the oldest version of macOS available on Apple's
         support site is Yosemite 10.10, which expects "GPT (GUID Partition
         Table)" partitioning scheme instead of the older MBR scheme, and
         "Mac OS Extended (Journaled)" as the partition type instead of the
         newer APFS partition type.

         Upon launching the installer, if you get a popup about macOS being
         too old or new to be installed, a bootable installer can be created
         using the instructions found here:
         https://support.apple.com/en-mide/HT201372

         It has been found that macOS can be installed onto the bootable
         media itself, so you can make the flash drive into a bootable
         installer then install the old macOS onto the same flash drive.

         Once the old macOS is installed, you may find the Xcode on the App
         Store is too new to run on the version of the old macOS. Old
         versions of Xcode can be downloaded from Apple's Developer site in
         an area accessible with free registration:
         https://developer.apple.com/download/more/

         The list of macOS versions and the last version of Xcode compatible
         with them are laid out nicely on the Wikipedia page on Xcode:
         https://en.wikipedia.org/wiki/Xcode#Version_comparison_table

         And because Xcode is being installed manually, you can skip the step
         to install the Xcode command line tools (do not run "xcode-select
         --install") but otherwise build Tux Paint using the same steps
         described in the earlier part of this document.

     ----------------------------------------------------------------------

Debugging

     Debugging output — to "STDOUT" on Linux and Unix, to a "stdout.txt" file
     on Windows, and to the file "/tmp/tuxpaint.log" on macOS — can be
     enabled by setting "DEBUG" (and, if verbose logging is wanted,
     "VERBOSE") #defines in "src/debug.h" and (re)compiling Tux Paint.

     ----------------------------------------------------------------------

Uninstalling Tux Paint

  Windows

    Uso do desinstalador

         Se instalou os atallos do menú Inicio (o predeterminado), vaia ao
         cartafol TuxPaint e seleccione «Desinstalar». Amosarase unha caixa
         que confirmará que está a piques de desinstalar Tux Paint e, se está
         seguro de que quere eliminar permanentemente Tux Paint, prema no
         botón «Desinstalar».

         Cando remate, prema no botón pechar.

    Usar o Panel de control

         Tamén é posíbel usar a entrada «TuxPaint (só eliminar)« na sección
         Engadir/Eliminar programas do Panel de control.

     ----------------------------------------------------------------------

  macOS

       Delete "TuxPaint.app" from the "Applications" folder. Data files,
       including the configuration files, stamps, and saved pictures, may be
       found in "Library/Application Support/TuxPaint" (all users) and
       "/Users/USERNAME/Library/Application Support/TuxPaint" (individual
       users).

     ----------------------------------------------------------------------

  Linux

       Within the Tux Paint source directory (where you compiled Tux Paint),
       you can use the "make uninstall" target to uninstall Tux Paint. By
       default, this must be done by the "root" user ('superuser'), but if
       you installed Tux Paint somewhere else (e.g., using a "PREFIX=..."
       setting to "make" and "make install"), you may not, and will want to
       provide those same settings here. (See the installation instructions
       above for further information.)
