Refresh docs after Win build process update

(https://sourceforge.net/p/tuxpaint/tuxpaint-docs/ci/af2070ce899cd5339027107dba125bf753c4ac59/)
This commit is contained in:
Bill Kendrick 2022-05-16 22:33:16 -07:00
parent 3a0741db8b
commit 83b56e64e6
10 changed files with 887 additions and 294 deletions

View file

@ -147,7 +147,7 @@ Simple DirectMedia Layer library (libSDL)
Windows
3 de Novembro de 2021 Shin-ichi TOYAMA dolphin6k@wmail.plala.or.jp
16 de Maio de 2022 Shin-ichi TOYAMA dolphin6k@wmail.plala.or.jp
<dolphin6k@wmail.plala.or.jp>
Compiling Set-Up
@ -177,7 +177,8 @@ Windows
Within the MSYS2 shell, run the following command to install basic
development tools:
pacman -S base-devel msys2-devel git
pacman -S make automake-wrapper autoconf-wrapper libtool git zip patch
gperf
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
@ -185,41 +186,52 @@ Windows
-------------------------------------------------------
MinGW 64bit (x86_64) toolchains
MinGW 64bit (x86_64) compiler and tools
Within the MSYS2 shell, run the following command to install basic 64bit
development tools:
Within the MSYS2 shell, run the following command to install 64bit
compiler and basic 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.
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
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
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.
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-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-ntldd-git
💡 Note: Close the shell before proceeding to the remaining process.
Install SDL_Pango on the 64bit environment
Install SDL_mixer, SDL_Pango and libunibreak on the 64bit environment
SDL_Pango should be installed manually.
SDL_mixer, SDL_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
@ -237,46 +249,69 @@ Windows
$ patch -p0 < ../SDL_Pango-configure-extra-api.patch
$ ./configure --prefix=/mingw64 && make && make install
libunibreak
libunibreak is required for compiling Tux Paint Config. You can skip
installing it if you are only building "Tux Paint".
You can fetch the source code from the git repositry and compile it as
follows.
$ git clone https://github.com/adah1972/libunibreak libunibreak
$ cd libunibreak
$ ./augogen.sh --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
MinGW 32bit (i686) compiler and tools
Within the MSYS2 shell, run the following command to install basic 32bit
development tools:
Within the MSYS2 shell, run the following command to install 32bit
compiler and basic 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.
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
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
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.
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-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-ntldd-git
💡 Note: Close the shell before proceeding to the remaining process.
Install SDL_Pango on the 32bit environment
Install SDL_mixer, SDL_Pango and libunibreak on the 32bit environment
SDL_Pango should be installed manually.
SDL_mixer, SDL_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
@ -294,6 +329,18 @@ Windows
$ patch -p0 < ../SDL_Pango-configure-extra-api.patch
$ ./configure --prefix=/mingw32 && make && make install
libunibreak
libunibreak is required for compiling Tux Paint Config. You can skip
installing it if you are only building "Tux Paint".
You can fetch the source code from the git repositry and compile it as
follows.
$ git clone https://github.com/adah1972/libunibreak libunibreak
$ cd libunibreak
$ ./augogen.sh --prefix=/mingw32 && make && make install
ImageMagick
ImageMagick is a compilation of command line tools to create, edit,

View file

@ -301,7 +301,7 @@
<p style="font-size: small;">
<em>
3 de Novembro de 2021 Shin-ichi TOYAMA dolphin6k@wmail.plala.or.jp &lt;<a href="mailto:dolphin6k@wmail.plala.or.jp">dolphin6k@wmail.plala.or.jp</a>&gt;
16 de Maio de 2022 Shin-ichi TOYAMA dolphin6k@wmail.plala.or.jp &lt;<a href="mailto:dolphin6k@wmail.plala.or.jp">dolphin6k@wmail.plala.or.jp</a>&gt;
</em>
</p>
</header>
@ -334,7 +334,7 @@
<p>
Within the MSYS2 shell, run the following command to install basic development tools: <blockquote>
<code>
pacman -S base-devel msys2-devel git
pacman -S make automake-wrapper autoconf-wrapper libtool git zip patch gperf
</code>
</blockquote>
</p>
@ -345,44 +345,44 @@
</p>
<hr size="1" noshade width="75%" />
<section class="indent"><!-- H4: MinGW...toolchains -->
<section class="indent"><!-- H4: MinGW...compiler and tools -->
<header>
<h4>
<a name="64bit" id="64bit">
MinGW 64bit (x86_64) toolchains </a>
MinGW 64bit (x86_64) compiler and tools </a>
</h4>
</header>
<p>
Within the MSYS2 shell, run the following command to install basic 64bit development tools: <blockquote>
Within the MSYS2 shell, run the following command to install 64bit compiler and basic development tools: <blockquote>
<code>
pacman -S mingw-w64-x86_64-toolchain
pacman -S mingw-w64-x86_64-{gcc,pkgconf,ntldd-git}
</code>
</blockquote>
</p>
<p>
"<code>ntldd</code>" is a small tool which examine windows executable files to list Dynamic Link Library (<code>.dll</code>) files they depends on. Tux Paint's packaging process for binary distribution uses it to find required <code>.dll</code> files. </p>
</section><!-- H4: MinGW...toolchains -->
<section class="indent"><!-- H4: ...dependency libraries for Tux Paint -->
<header>
<h4>
64bit (x86_64) dependency libraries for Tux Paint </h4>
64bit (x86_64) dependency libraries for Tux Paint and Tux Paint Config </h4>
</header>
<p>
You can install tools and libraries required for compiling Tux Paint on MSYS2/MINGW using "<code>pacman</code>" except for SDL_Pango. </p>
You can install tools and libraries required for compiling Tux Paint and Tux Paint Config on MSYS2/MINGW using "<code>pacman</code>" except for SDL_mixer, SDL_Pango and libunibreak. </p>
<p>
"<code>ntldd</code>" is a small tool which examine windows executable files to list Dynamic Link Library (<code>.dll</code>) files they depends on. Tux Paint's packaging process for binary distribution uses it to find required <code>.dll</code> files. </p>
<p>
FLTK is a cross-platform GUI toolkit used by "Tux Paint Config.". You can skip installing it if you are <em>only</em> building "Tux Paint". </p>
FLTK is a cross-platform GUI toolkit used by "Tux Paint Config". You can skip installing it if you are <em>only</em> building "Tux Paint". </p>
<p>
<blockquote>
<code>
$ pacman -S mingw-w64-x86_64-SDL_{image,mixer,ttf,gfx}<br/>
$ pacman -S mingw-w64-x86_64-SDL_{image,ttf,gfx}<br/>
$ pacman -S mingw-w64-x86_64-libvorbis<br/>
$ pacman -S mingw-w64-x86_64-librsvg<br/>
$ pacman -S mingw-w64-x86_64-fribidi<br/>
$ pacman -S mingw-w64-x86_64-libimagequant<br/>
$ pacman -S mingw-w64-x86_64-fltk<br/>
$ pacman -S mingw-w64-x86_64-ntldd-git
</code>
</blockquote>
</p>
@ -393,14 +393,32 @@
<section class="indent"><!-- H4: Install SDL_Pango... -->
<header>
<h4>
Install SDL_Pango on the 64bit environment </h4>
Install SDL_mixer, SDL_Pango and libunibreak on the 64bit environment </h4>
</header>
<p>
SDL_Pango should be installed manually. </p>
SDL_mixer, SDL_Pango and libunibreak should be installed manually. </p>
<p>
This time, use the MinGW "64bit" shell. Open the shell from the "Start Menu" -&gt; "MSYS2 64bit" -&gt; "MSYS2 MinGW 64-bit" </p>
<section class="indent"><!-- H5: SDL_mixer -->
<header>
<h5>SDL_mixer</h5>
</header>
<p>
Download <a href="https://www.libsdl.org/projects/SDL_mixer/release/SDL_mixer-1.2.12.tar.gz">source tar-ball of SDL_mixer-1.2.12</a> from <a href="https://www.libsdl.org/projects/SDL_mixer/">SDL_mixer's page</a>. </p>
<p>
Build and install SDL_mixer as follows. <blockquote>
<code>
$ tar zxvf SDL_mixer-1.2.12.tar.gz<br/>
$ cd SDL_mixer-1.2.12/<br/>
$ ./configure --prefix=/mingw64 &amp;&amp; make &amp;&amp; make install
</code>
</blockquote>
</p>
</section><!-- H5: SDL_mixer -->
<section class="indent"><!-- H5: SDL_Pango -->
<header>
<h5>SDL_Pango</h5>
@ -426,6 +444,24 @@
</p>
</section><!-- H5: SDL_Pango -->
<section class="indent"><!-- H5: libunibreak -->
<header>
<h5>libunibreak</h5>
</header>
<p>
libunibreak is required for compiling Tux Paint Config. You can skip installing it if you are <em>only</em> building "Tux Paint". </p>
<p>
You can fetch the source code from the git repositry and compile it as follows. <blockquote>
<code>
$ git clone https://github.com/adah1972/libunibreak libunibreak<br/>
$ cd libunibreak<br/>
$ ./augogen.sh --prefix=/mingw64 &amp;&amp; make &amp;&amp; make install
</code>
</blockquote>
</p>
</section><!-- H5: libunibreak -->
<p>
<i>
Proceed to the next "<a href="#32bit">MinGW 32bit (i686) toolchains</a>" section, or skip to the "<a href="#imagemagick">ImageMagick</a>" section if you need only a 64bit build environment. </i>
@ -434,44 +470,44 @@
</section><!-- H4: Install SDL_Pango... -->
<hr size="1" noshade width="75%" />
<section class="indent"><!-- H4: MinGW...toolchains -->
<section class="indent"><!-- H4: MinGW...compiler and tools -->
<header>
<h4>
<a name="32bit" id="32bit">
MinGW 32bit (i686) toolchains </a>
MinGW 32bit (i686) compiler and tools </a>
</h4>
</header>
<p>
Within the MSYS2 shell, run the following command to install basic 32bit development tools: <blockquote>
Within the MSYS2 shell, run the following command to install 32bit compiler and basic development tools: <blockquote>
<code>
pacman -S mingw-w64-i686-toolchain
pacman -S mingw-w64-i686-{gcc,pkgconf,ntldd-git}
</code>
</blockquote>
</p>
<p>
"<code>ntldd</code>" is a small tool which examine windows executable files to list Dynamic Link Library (<code>.dll</code>) files they depends on. Tux Paint's packaging process for binary distribution uses it to find required <code>.dll</code> files. </p>
</section><!-- H4: MinGW...toolchains -->
<section class="indent"><!-- H4: ...dependency libraries for Tux Paint -->
<header>
<h4>
32bit (i686) dependency libraries for Tux Paint </h4>
32bit (i686) dependency libraries for Tux Paint and Tux Paint Config </h4>
</header>
<p>
You can install tools and libraries required for compiling Tux Paint on MSYS2/MINGW using "<code>pacman</code>" except for SDL_Pango. </p>
You can install tools and libraries required for compiling Tux Paint and Tux Paint Config on MSYS2/MINGW using "<code>pacman</code>" except for SDL_mixer, SDL_Pango and libunibreak. </p>
<p>
"<code>ntldd</code>" is a small tool which examine windows executable files to list Dynamic Link Library (<code>.dll</code>) files they depends on. Tux Paint's packaging process for binary distribution uses it to find required <code>.dll</code> files. </p>
<p>
FLTK is a cross-platform GUI toolkit used by "Tux Paint Config.". You can skip installing it if you are <em>only</em> building "Tux Paint". </p>
FLTK is a cross-platform GUI toolkit used by "Tux Paint Config". You can skip installing it if you are <em>only</em> building "Tux Paint". </p>
<p>
<blockquote>
<code>
$ pacman -S mingw-w64-i686-SDL_{image,mixer,ttf,gfx}<br/>
$ pacman -S mingw-w64-i686-SDL_{image,ttf,gfx}<br/>
$ pacman -S mingw-w64-i686-libvorbis<br/>
$ pacman -S mingw-w64-i686-librsvg<br/>
$ pacman -S mingw-w64-i686-fribidi<br/>
$ pacman -S mingw-w64-i686-libimagequant<br/>
$ pacman -S mingw-w64-i686-fltk<br/>
$ pacman -S mingw-w64-i686-ntldd-git
</code>
</blockquote>
</p>
@ -482,14 +518,32 @@
<section class="indent"><!-- H4: Install SDL_Pango... -->
<header>
<h4>
Install SDL_Pango on the 32bit environment </h4>
Install SDL_mixer, SDL_Pango and libunibreak on the 32bit environment </h4>
</header>
<p>
SDL_Pango should be installed manually. </p>
SDL_mixer, SDL_Pango and libunibreak should be installed manually. </p>
<p>
This time, use the MinGW "32bit" shell. Open the shell from the "Start Menu" -&gt; "MSYS2 64bit" -&gt; "MSYS2 MinGW 32-bit" </p>
<section class="indent"><!-- H5: SDL_mixer -->
<header>
<h5>SDL_mixer</h5>
</header>
<p>
Download <a href="https://www.libsdl.org/projects/SDL_mixer/release/SDL_mixer-1.2.12.tar.gz">source tar-ball of SDL_mixer-1.2.12</a> from <a href="https://www.libsdl.org/projects/SDL_mixer/">SDL_mixer's page</a>. </p>
<p>
Build and install SDL_mixer as follows. <blockquote>
<code>
$ tar zxvf SDL_mixer-1.2.12.tar.gz<br/>
$ cd SDL_mixer-1.2.12/<br/>
$ ./configure --prefix=/mingw32 &amp;&amp; make &amp;&amp; make install
</code>
</blockquote>
</p>
</section><!-- H5: SDL_mixer -->
<section class="indent"><!-- H5: SDL_Pango -->
<header>
<h5>SDL_Pango</h5>
@ -515,6 +569,24 @@
</p>
</section><!-- H5: SDL_Pango -->
<section class="indent"><!-- H5: libunibreak -->
<header>
<h5>libunibreak</h5>
</header>
<p>
libunibreak is required for compiling Tux Paint Config. You can skip installing it if you are <em>only</em> building "Tux Paint". </p>
<p>
You can fetch the source code from the git repositry and compile it as follows. <blockquote>
<code>
$ git clone https://github.com/adah1972/libunibreak libunibreak<br/>
$ cd libunibreak<br/>
$ ./augogen.sh --prefix=/mingw32 &amp;&amp; make &amp;&amp; make install
</code>
</blockquote>
</p>
</section><!-- H5: libunibreak -->
</section><!-- H4: Install SDL_Pango... -->