Skip to content

Commit 800c442

Browse files
authored
Add Arch install instructions and fix typos in INSTALL.md (supertuxkart#5217)
1 parent 3dbf360 commit 800c442

File tree

1 file changed

+33
-25
lines changed

1 file changed

+33
-25
lines changed

INSTALL.md

+33-25
Original file line numberDiff line numberDiff line change
@@ -26,6 +26,15 @@ To build SuperTuxKart from source, you'll need to install the following packages
2626
* jpeg (libjpeg-turbo-devel)
2727
* SDL2 (libsdl2-devel)
2828

29+
Debian-based Distributions command:
30+
31+
```bash
32+
sudo apt-get install build-essential cmake libbluetooth-dev libsdl2-dev \
33+
libcurl4-openssl-dev libenet-dev libfreetype6-dev libharfbuzz-dev \
34+
libjpeg-dev libogg-dev libopenal-dev libpng-dev \
35+
libssl-dev libvorbis-dev libmbedtls-dev pkg-config zlib1g-dev
36+
```
37+
2938
Fedora command:
3039

3140
```bash
@@ -39,13 +48,12 @@ libogg-devel openssl-devel pkgconf \
3948
wiiuse-devel zlib-devel
4049
```
4150

42-
Mageia 6 command:
51+
Arch-based Distributions command:
4352

4453
```bash
45-
su -c 'urpmi gcc-c++ cmake openssl-devel libcurl-devel freetype-devel harfbuzz-devel \
46-
libjpeg-turbo-devel libogg-devel openal-soft-devel SDL2-devel \
47-
libpng-devel libvorbis-devel nettle-devel zlib-devel git subversion \
48-
libbluez-devel libfreetype6-devel
54+
sudo pacman -S openal libogg libvorbis freetype2 harfbuzz curl \
55+
bluez-libs openssl libpng zlib libjpeg-turbo sdl2 gcc cmake \
56+
pkgconf make git subversion
4957
```
5058

5159
openSUSE command:
@@ -57,13 +65,13 @@ libvorbis-devel pkgconf zlib-devel enet-devel \
5765
libjpeg-devel bluez-devel freetype2-devel
5866
```
5967

60-
Debian-based Distributions command:
68+
Mageia 6 command:
6169

6270
```bash
63-
sudo apt-get install build-essential cmake libbluetooth-dev libsdl2-dev \
64-
libcurl4-openssl-dev libenet-dev libfreetype6-dev libharfbuzz-dev \
65-
libjpeg-dev libogg-dev libopenal-dev libpng-dev \
66-
libssl-dev libvorbis-dev libmbedtls-dev pkg-config zlib1g-dev
71+
su -c 'urpmi gcc-c++ cmake openssl-devel libcurl-devel freetype-devel harfbuzz-devel \
72+
libjpeg-turbo-devel libogg-devel openal-soft-devel SDL2-devel \
73+
libpng-devel libvorbis-devel nettle-devel zlib-devel git subversion \
74+
libbluez-devel libfreetype6-devel
6775
```
6876
6977
Solus command:
@@ -73,19 +81,19 @@ harfbuzz-devel curl-devel bluez-devel openssl-devel libpng-devel zlib-devel \
7381
libjpeg-turbo-devel sdl2-devel enet-devel libjpeg-turbo-devel bluez-devel curl-devel
7482
```
7583
76-
### In-game recorder
84+
#### In-game recorder
7785
7886
To build the in-game recorder for STK, you have to install
7987
`libopenglrecorder` from your distribution, or compile it yourself from [here](https://github.com/Benau/libopenglrecorder).
8088
Compilation instruction is explained there. If you don't need this feature, pass `-DBUILD_RECORDER=off` to CMake.
8189

82-
### Shaderc for Vulkan support
90+
#### Shaderc for Vulkan support
8391

8492
You need to compile [Shaderc](https://github.com/google/shaderc) for Vulkan support in SuperTuxKart if you are not building for Windows or macOS. If you don't need this feature, pass `-DNO_SHADERC=on` to CMake.
8593
8694
### Compiling
8795
88-
To compile SuperTuxKart, run the following commands inside the `stk-code` directory
96+
To compile SuperTuxKart, run the following commands inside the `stk-code` directory:
8997
9098
```bash
9199
# go into the stk-code directory
@@ -102,7 +110,7 @@ cmake ..
102110
make -j$(nproc)
103111
```
104112
105-
STK can then be run from the build directory with `bin/supertuxkart`
113+
STK can then be run from the build directory with `bin/supertuxkart`.
106114
107115
#### Keeping your build up to date
108116
@@ -115,11 +123,11 @@ cmake ..
115123
make -j$(nproc)
116124
```
117125
118-
##### Build Speed Optimization
126+
#### Build Speed Optimization
119127
120-
"-j$(nproc)" is an example, for a faster build, use "-jx" instead, where "x" is the amount of CPU threads you have, minus one.
128+
The `-j$(nproc)` option is an example. For a faster build, use `-jx` instead, where "x" is the amount of CPU threads you have, minus one.
121129
122-
### Further options
130+
#### Further options
123131
124132
To create a debug version of STK, run:
125133
@@ -134,21 +142,21 @@ sudo make install
134142
```
135143
136144
The default install location is `/usr/local`, i.e. the data files will
137-
be written to `/usr/local/share/games/supertuxkart`, the executable
145+
be written to `/usr/local/share/games/supertuxkart` and the executable
138146
will be copied to `/usr/local/bin`. To change the default installation
139147
location, specify `CMAKE_INSTALL_PREFIX` when running CMake, e.g.:
140-
`cmake .. -DCMAKE_INSTALL_PREFIX=/opt/stk`
148+
`cmake .. -DCMAKE_INSTALL_PREFIX=/opt/stk`.
141149
142150
## Building SuperTuxKart on Windows
143151
144-
To Build SuperTuxKart on Windows follow these instructions:
152+
To Build SuperTuxKart on Windows, follow these instructions:
145153
146154
1. Download and install Visual Studio from here: [Visual Studio - Download](https://www.visualstudio.com/downloads/). The free Visual Studio Community edition works fine. Remember to select "Desktop development with C++" in the installer.
147155
148-
2. If you want the stable version, download the SuperTuxKart source package from the latest stable version [SuperTuxKart on GitHub](https://github.com/supertuxkart/stk-code/releases) and unpack it.
156+
2. If you want the stable version, download the SuperTuxKart source package from the latest stable version of [SuperTuxKart on GitHub](https://github.com/supertuxkart/stk-code/releases) and unpack it.
149157
150158
3. If you want the development version, you will need a Git client and an SVN client. More information can be found here: [SuperTuxKart.net - Source Control](https://supertuxkart.net/Source_control).
151-
Open your file browser and find somewhere you want to put the development version of SuperTuxKart. For example in C:\Users\<Your Username> as the Git and SVN clients will have write permissions there, and you should create its own directory, for example SuperTuxKart-dev. Enter that directory, and create a directory inside called stk-assets, and enter it. If you installed TortoiseSVN, right-click, select TortoiseSVN -> Checkout... and paste the corresponding URL found in [SuperTuxKart.net - Source Control](https://supertuxkart.net/Source_control). While it is downloading the game assets, go back to your file browser and one level up. Right-click again somewhere empty and select "Git clone..." and paste the corresponding link found in [SuperTuxKart.net - Source Control](https://supertuxkart.net/Source_control).
159+
Open your file browser and find somewhere you want to put the development version of SuperTuxKart. For example in C:\\Users\\\<Your Username\> as the Git and SVN clients will have write permissions there, and you should create its own directory, for example "SuperTuxKart-dev". Enter that directory, and create a directory inside called "stk-assets", and enter it. If you installed TortoiseSVN, right-click, select TortoiseSVN -> Checkout... and paste the corresponding URL found in [SuperTuxKart.net - Source Control](https://supertuxkart.net/Source_control). While it is downloading the game assets, go back to your file browser and move one level up (if you followed the example that directory would be named "SuperTuxKart-dev"). Right-click again somewhere empty and select "Git clone..." and paste the corresponding link found in [SuperTuxKart.net - Source Control](https://supertuxkart.net/Source_control).
152160
*Note: Both `stk-code` and `stk-assets` **must** be in the same directory, otherwise the build will likely fail!*
153161
154162
4. If you got the stable version, download the Windows dependencies package from [SuperTuxKart on GitHub - Dependencies Releases](https://github.com/supertuxkart/dependencies/releases), find the stk-code version there and download the `dependencies(arch).zip` as needed and unpack the archive into the `stk-code` directory.
@@ -204,7 +212,7 @@ and unpack the archive into the `stk-code` directory. Download `i686` if you use
204212
msbuild.exe SuperTuxKart.sln
205213
```
206214
207-
SuperTuxKart can now be run as `bin\Debug\supertuxkart.exe` or `bin\Release\supertuxkart.exe`
215+
SuperTuxKart can now be run as `bin\Debug\supertuxkart.exe` or `bin\Release\supertuxkart.exe`.
208216
209217
## Building SuperTuxKart on Windows using LLVM MinGW
210218
@@ -250,7 +258,7 @@ Install the developer tools, either from the OS X Install DVD or from Apple's we
250258

251259
Download `dependencies-macosx.tar.xz` from the `Assets` section [here](https://github.com/supertuxkart/dependencies/releases) and extract it inside the `stk-code` directory, use the `preview` version for git stk-code.
252260

253-
Build STK
261+
Build STK:
254262

255263
```bash
256264
cd /path/to/stk-code
@@ -270,6 +278,6 @@ By default, the executable that is produced is not ready for distribution. Insta
270278
dylibbundler -od -b -x ./bin/SuperTuxKart.app/Contents/MacOS/supertuxkart -d ./bin/SuperTuxKart.app/Contents/libs/ -p @executable_path/../libs/ -s ../dependencies-macosx/lib
271279
```
272280

273-
Add `-ns` to disable ad-hoc codesigning
281+
Add `-ns` to disable ad-hoc codesigning.
274282

275283
Afterwards, copy the contents of `stk-assets` into `/SuperTuxKart.app/Contents/Resources/data`.

0 commit comments

Comments
 (0)