notgne2/tuxpaint-pencil-sharpener
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

Trying to sync INSTALL w/ Shin-Ichi's page (TXT)

Browse source
This commit is contained in:
Bill Kendrick 2022-07-08 23:43:34 -07:00
parent 148d26af7f
commit 401d5805a6
5 changed files with 479 additions and 460 deletions
Download patch file Download diff file Expand all files Collapse all files

186
docs/gl_ES.UTF-8/INSTALL.txt
View file

@ -5,7 +5,7 @@
Copyright © 2002-2022 by varios colaboradores; see AUTHORS.txt.
https://tuxpaint.org/
4 de Xuño de 2022
8 de Xullo de 2022
+----------------------------------------------------+
|Índice |
@ -147,8 +147,7 @@ Simple DirectMedia Layer library (libSDL)
Windows
16 de Maio de 2022 Shin-ichi TOYAMA dolphin6k@wmail.plala.or.jp
<dolphin6k@wmail.plala.or.jp>
8 de Xullo de 2022 Shin-ichi TOYAMA <dolphin6k@wmail.plala.or.jp>
Compiling Set-Up
@ -156,29 +155,34 @@ Windows
«Makefile» inclúe compatibilidade para construír nun sistema Windows
usando MinGW/MSYS (https://sourceforge.net/projects/msys2/).
💡 Note: This documentation relates to the SDL2.0 version of Tux Paint,
which became available starting with version 0.9.28 in June 2022.
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")
MYSYS2
Download the latest MSYS2 environment from https://www.msys2.org/ 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):
MSYS" and execute following command:
pacman -Syu
$ yes "" | 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.
This will update core system and the window will close automatically. Open
the msys2 shell again and execute following command to finish remaining
updating process.
$ yes "" | pacman -Syu
Within the MSYS2 shell, run the following command to install basic
development tools:
pacman -S make automake-wrapper autoconf-wrapper libtool git zip patch
gperf
$ yes "" | pacman -S make automake-wrapper autoconf-wrapper libtool git
zip patch gperf dos2unix
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
@ -191,7 +195,7 @@ Windows
Within the MSYS2 shell, run the following command to install 64bit
compiler and basic development tools:
pacman -S mingw-w64-x86_64-{gcc,pkgconf,ntldd-git}
$ yes "" | pacman -S mingw-w64-x86_64-{gcc,pkgconf,ntldd-git}
"ntldd" is a small tool which examine windows executable files to list
Dynamic Link Library (.dll) files they depends on. Tux Paint's packaging
@ -200,53 +204,33 @@ Windows
64bit (x86_64) dependency libraries for Tux Paint and Tux Paint Config
You can install tools and libraries required for compiling Tux Paint and
Tux Paint Config on MSYS2/MINGW using "pacman" except for SDL_mixer,
SDL_Pango and libunibreak.
Tux Paint Config on MSYS2/MINGW using "pacman" except for SDL2_Pango and
libunibreak.
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,ttf,gfx}
$ pacman -S mingw-w64-x86_64-libvorbis
$ 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-{librsvg,fribidi,libimagequant,fltk}
💡 Note: Close the shell before proceeding to the remaining process.
Install SDL_mixer, SDL_Pango and libunibreak on the 64bit environment
Install SDL2_Pango and libunibreak on the 64bit environment
SDL_mixer, SDL_Pango and libunibreak should be installed manually.
SDL2_Pango and libunibreak 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_mixer
Download source tar-ball of SDL_mixer-1.2.12 from SDL_mixer's page.
Build and install SDL_mixer as follows.
$ tar zxvf SDL_mixer-1.2.12.tar.gz
$ cd SDL_mixer-1.2.12/
$ ./configure --prefix=/mingw64 && make && make install
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.)
Download a patch from z1.plala.jp, which enable SDL2_Pango to create dlls,
then build and install SDL2_Pango as follows.
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
$ wget https://z1.plala.jp/tuxpaint/SDL2_Pango-dll.patch
$ git clone https://github.com/markuskimius/SDL2_Pango
$ cd SDL2_Pango
$ patch -p0 < ../SDL2_Pango-dll.patch
$ ./configure --prefix=/mingw64 && make && make install
libunibreak
@ -271,7 +255,7 @@ Windows
Within the MSYS2 shell, run the following command to install 32bit
compiler and basic development tools:
pacman -S mingw-w64-i686-{gcc,pkgconf,ntldd-git}
$ yes "" | pacman -S mingw-w64-i686-{gcc,pkgconf,ntldd-git}
"ntldd" is a small tool which examine windows executable files to list
Dynamic Link Library (.dll) files they depends on. Tux Paint's packaging
@ -280,53 +264,33 @@ Windows
32bit (i686) dependency libraries for Tux Paint and Tux Paint Config
You can install tools and libraries required for compiling Tux Paint and
Tux Paint Config on MSYS2/MINGW using "pacman" except for SDL_mixer,
SDL_Pango and libunibreak.
Tux Paint Config on MSYS2/MINGW using "pacman" except for SDL2_Pango and
libunibreak.
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,ttf,gfx}
$ pacman -S mingw-w64-i686-libvorbis
$ 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-{librsvg,fribidi,libimagequant,fltk}
💡 Note: Close the shell before proceeding to the remaining process.
Install SDL_mixer, SDL_Pango and libunibreak on the 32bit environment
Install SDL2_Pango and libunibreak on the 32bit environment
SDL_mixer, SDL_Pango and libunibreak should be installed manually.
SDL2_Pango and libunibreak 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_mixer
Download source tar-ball of SDL_mixer-1.2.12 from SDL_mixer's page.
Build and install SDL_mixer as follows.
$ tar zxvf SDL_mixer-1.2.12.tar.gz
$ cd SDL_mixer-1.2.12/
$ ./configure --prefix=/mingw32 && make && make install
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.)
Download a patch from z1.plala.jp, which enable SDL2_Pango to create dlls,
then build and install SDL2_Pango as follows.
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
$ wget https://z1.plala.jp/tuxpaint/SDL2_Pango-dll.patch
$ git clone https://github.com/markuskimius/SDL2_Pango
$ cd SDL2_Pango
$ patch -p0 < ../SDL2_Pango-dll.patch
$ ./configure --prefix=/mingw32 && make && make install
libunibreak
@ -364,27 +328,66 @@ Windows
You can make this permanent by adding the above to your the BASH shell
configuration file, "~/.bash_profile".
Tux Paint
Tux Paint & Tux Paint Config.
You can compile 64bit binaries using MSYS2 64bit shell, and 32bit binaries
using MSYS2 32bit shell, respectively.
You can compile 64-bit binaries using "MSYS2 64bit" shell, and 32-bit
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:
Tux Paint Config.
"Tux Paint Config" is a useful graphical tool for tweaking Tux Paint's
behavior. You have to build this component before compiling Tux Paint if
you want to have it included in your package.
You can use either (a) a stable tar-ball release, or (b) the developing
source tree.
a. Using stable tar-ball release:
* Download a source tar-ball
* Expand the tar-ball and change the directory name so that the
final packaging process can find related files.
$ tar zxvf tuxpaint-config-A.B.C.tar.gz
$ mv tuxpaint-config-A.B.C tuxpaint-config
b. Using the developing source tree:
* Fetch the developing source tree from git repository:
$ git clone https://git.code.sf.net/p/tuxpaint/tuxpaint-config
tuxpaint-config
Now you can build Tux Paint Config. as follows:
$ cd tuxpaint-config
$ make win32
Tux Paint
You can use either (a) a stable tar-ball release, or (b) the developing
source tree.
a. Using stable tar-ball release:
* Download a source tar-ball
* Expand the tar-ball and change the directory name so that the
final packaging process can find related files.
$ tar zxvf tuxpaint-A.B.C-sdl2.tar.gz
$ mv tuxpaint-A.B.C-sdl2 tuxpaint-sdl2
b. Using the developing source tree:
* Fetch the developing source tree from git repository:
$ git clone -b sdl2.0
https://git.code.sf.net/p/tuxpaint/tuxpaint tuxpaint-sdl2
Now you can build Tux Paint as follows:
$ cd tuxpaint-sdl2
$ 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)
@ -410,7 +413,8 @@ Windows
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.
"tuxpaint-X.Y.Z-windows-sdl2.0-<arch>-installer.exe" file in the same
directory.
Running the Tux Paint Windows Installer
@ -613,7 +617,7 @@ macOS
once to accept its license agreements. You may also need to install the
Xcode command line tools using the command:
xcode-select --install
$ xcode-select --install
Building Tux Paint also requires various libraries. We install them from
MacPorts where possible, source code otherwise. Install MacPorts to the