README.OS2
changeset 1758 45138f6a2fb5
parent 1442 e3242177fe4a
child 1850 d5d3a6fe05a1
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