Mercurial > sdl-ios-xcode
comparison README.OS2 @ 1758:45138f6a2fb5
Updated OS/2 project files
author | Sam Lantinga <slouken@libsdl.org> |
---|---|
date | Tue, 02 May 2006 03:06:33 +0000 |
parents | e3242177fe4a |
children | d5d3a6fe05a1 |
comparison
equal
deleted
inserted
replaced
1757:ac282d472a2e | 1758:45138f6a2fb5 |
---|---|
1 | 1 |
2 =========== | 2 =========== |
3 SDL on OS/2 | 3 SDL on OS/2 |
4 =========== | 4 =========== |
5 | 5 |
6 Last updated on Feb. 26, 2006. | 6 Last updated on May. 1, 2006. |
7 | 7 |
8 | 8 |
9 1. How to compile? | 9 1. How to compile? |
10 ------------------ | 10 ------------------ |
11 | 11 |
14 - The OpenWatcom compiler | 14 - The OpenWatcom compiler |
15 (http://www.openwatcom.org) | 15 (http://www.openwatcom.org) |
16 - The FSLib library | 16 - The FSLib library |
17 (ftp://ftp.netlabs.org/pub/SDL) | 17 (ftp://ftp.netlabs.org/pub/SDL) |
18 | 18 |
19 First of all, you have to put the OS/2-specific Watcom makefiles into the | 19 First of all, you have to unzip the Watcom-OS2.zip file. This will result in a |
20 source code tree by unzipping the file Watcom-OS2.zip here. This will | 20 file called "makefile" and a file called "setvars.cmd" in this folder (and some |
21 result in a Watcom.mif and a setvars.cmd file in this folder, and several | 21 more files...). |
22 Makefile.wat files in the src\ folder and in some of its subfolders. | |
23 | 22 |
24 Please edit the second, fourth and fifth lines of setvars.cmd file | 23 Please edit the second, fourth and fifth lines of setvars.cmd file |
25 to set the folders where the toolkit, the OW compiler and the FSLib are. | 24 to set the folders where the toolkit, the OW compiler and the FSLib are. |
26 You won't need NASM yet (The Netwide Assembler), you can leave that line. | 25 You won't need NASM yet (The Netwide Assembler), you can leave that line. |
27 Run setvars.cmd, and you should get a shell in which you can | 26 Run setvars.cmd, and you should get a shell in which you can |
28 compile SDL. | 27 compile SDL. |
29 | 28 |
30 Check the "Watcom.mif" file. This is the file which is included by all the | 29 Check the "makefile" file. There is a line in there which determines if the |
31 Watcom makefiles, so changes here will affect the whole build process. | 30 resulting SDL.DLL will be a 'debug' or a 'release' build. The 'debug' version |
32 There is a line in there which determines if the resulting SDL.DLL will be | 31 is full of printf()'s, so if something goes wrong, its output can help a lot |
33 a 'debug' or a 'release' build. The 'debug' version is full of printf()'s, | 32 for debugging. |
34 so if something goes wrong, its output can help a lot for debugging. | 33 |
35 | 34 Then run "wmake". |
36 Then go to the 'src' folder, and run "wmake -f makefile.wat". | 35 This should create the SDL.DLL and the corresponding SDL.LIB file here. |
37 This should create the SDL.DLL and the corresponding SDL.LIB file there. | |
38 | 36 |
39 To test applications, it's a good idea to use the 'debug' build of SDL, and | 37 To test applications, it's a good idea to use the 'debug' build of SDL, and |
40 redirect the standard output and standard error output to files, to see what | 38 redirect the standard output and standard error output to files, to see what |
41 happens internally in SDL. | 39 happens internally in SDL. |
42 (like: testsprite >stdout.txt 2>stderr.txt) | 40 (like: testsprite >stdout.txt 2>stderr.txt) |
43 | 41 |
44 To rebuild SDL, use the following commands in 'src' folder: | 42 To rebuild SDL, use the following commands in this folder: |
45 wmake -f makefile.wat clean | 43 wmake clean |
46 wmake -f makefile.wat | 44 wmake |
47 | 45 |
48 | 46 |
49 | 47 |
50 2. How to compile the testapps? | 48 2. How to compile the testapps? |
51 ------------------------------- | 49 ------------------------------- |
52 | 50 |
53 Once you have SDL.DLL compiled, navigate into the 'test' folder, copy in there | 51 Once you have SDL.DLL compiled, navigate into the 'test' folder, copy in there |
54 the newly built SDL.DLL, and copy in there FSLib.DLL. | 52 the newly built SDL.DLL, and copy in there FSLib.DLL. |
55 | 53 |
56 Then run "wmake -f makefile.wat" in there to compile some of the testapps. | 54 Then run "wmake" in there to compile some of the testapps. |
57 | 55 |
58 | 56 |
59 | 57 |
60 3. What is missing? | 58 3. What is missing? |
61 ------------------- | 59 ------------------- |
190 | 188 |
191 | 189 |
192 | 190 |
193 10. Changelog of the OS/2 port | 191 10. Changelog of the OS/2 port |
194 ------------------------------ | 192 ------------------------------ |
193 | |
194 Version 1.2 - 2006-05-01 - Doodle | |
195 - Modified makefile system to have only one makefile | |
196 - Included FSLib headers, DLL and LIB file | |
195 | 197 |
196 Version 1.2 - 2006-02-26 - Doodle | 198 Version 1.2 - 2006-02-26 - Doodle |
197 - Updated the official SDL version with the OS/2 specific changes. | 199 - Updated the official SDL version with the OS/2 specific changes. |
198 - Added support for real unicode keycode conversion. | 200 - Added support for real unicode keycode conversion. |
199 | 201 |