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