README.OS2
changeset 1850 d5d3a6fe05a1
parent 1758 45138f6a2fb5
child 1895 c121d94672cb
equal deleted inserted replaced
1849:b5a4ac87b98c 1850:d5d3a6fe05a1
     1 
     1 
     2 ===========
     2 ===========
     3 SDL on OS/2
     3 SDL on OS/2
     4 ===========
     4 ===========
     5 
     5 
     6 Last updated on May. 1, 2006.
     6 Last updated on May. 17, 2006.
     7 
     7 
     8 
     8 
     9 1. How to compile?
     9 1. How to compile?
    10 ------------------
    10 ------------------
    11 
    11 
    12 To compile this, you'll need the followings installed:
    12 To compile this, you'll need the followings installed:
    13 - The OS/2 Developer's Toolkit
    13 - The OS/2 Developer's Toolkit
    14 - The OpenWatcom compiler 
    14 - The OpenWatcom compiler 
    15   (http://www.openwatcom.org)
    15   (http://www.openwatcom.org)
    16 - The FSLib library
       
    17   (ftp://ftp.netlabs.org/pub/SDL)
       
    18 
    16 
    19 First of all, you have to unzip the Watcom-OS2.zip file. This will result in a 
    17 First of all, you have to unzip the Watcom-OS2.zip file. This will result in a 
    20 file called "makefile" and a file called "setvars.cmd" in this folder (and some
    18 file called "makefile" and a file called "setvars.cmd" in this folder (and some
    21 more files...).
    19 more files...).
    22 
    20 
    30 resulting SDL.DLL will be a 'debug' or a 'release' build. The 'debug' version 
    28 resulting SDL.DLL will be a 'debug' or a 'release' build. The 'debug' version 
    31 is full of printf()'s, so if something goes wrong, its output can help a lot
    29 is full of printf()'s, so if something goes wrong, its output can help a lot
    32 for debugging.
    30 for debugging.
    33 
    31 
    34 Then run "wmake".
    32 Then run "wmake".
    35 This should create the SDL.DLL and the corresponding SDL.LIB file here.
    33 This should create the SDL12.DLL and the corresponding SDL12.LIB file here.
    36 
    34 
    37 To test applications, it's a good idea to use the 'debug' build of SDL, and
    35 To test applications, it's a good idea to use the 'debug' build of SDL, and
    38 redirect the standard output and standard error output to files, to see what
    36 redirect the standard output and standard error output to files, to see what
    39 happens internally in SDL.
    37 happens internally in SDL.
    40 (like: testsprite >stdout.txt 2>stderr.txt)
    38 (like: testsprite >stdout.txt 2>stderr.txt)
    46 
    44 
    47 
    45 
    48 2. How to compile the testapps?
    46 2. How to compile the testapps?
    49 -------------------------------
    47 -------------------------------
    50 
    48 
    51 Once you have SDL.DLL compiled, navigate into the 'test' folder, copy in there
    49 Once you have SDL12.DLL compiled, navigate into the 'test' folder, copy in 
    52 the newly built SDL.DLL, and copy in there FSLib.DLL.
    50 there the newly built SDL12.DLL, and copy in there FSLib.DLL.
    53 
    51 
    54 Then run "wmake" in there to compile some of the testapps.
    52 Then run "wmake" in there to compile some of the testapps.
    55 
    53 
    56 
    54 
    57 
    55 
   188 
   186 
   189 
   187 
   190 
   188 
   191 10. Changelog of the OS/2 port
   189 10. Changelog of the OS/2 port
   192 ------------------------------
   190 ------------------------------
       
   191 
       
   192 Version 1.2.10 - 2006-05-17  - Doodle
       
   193  - Small modifications for v1.2.10 release
       
   194  - Changed DLL name to include version info (currently SDL12.dll)
   193 
   195 
   194 Version 1.2 - 2006-05-01  - Doodle
   196 Version 1.2 - 2006-05-01  - Doodle
   195  - Modified makefile system to have only one makefile
   197  - Modified makefile system to have only one makefile
   196  - Included FSLib headers, DLL and LIB file
   198  - Included FSLib headers, DLL and LIB file
   197 
   199 
   214    environment variable to something before starting the application
   216    environment variable to something before starting the application
   215    (e.g.: 
   217    (e.g.: 
   216     SET SDL_USE_PROPORTIONAL_WINDOW=1
   218     SET SDL_USE_PROPORTIONAL_WINDOW=1
   217     dosbox.exe
   219     dosbox.exe
   218    )
   220    )
   219    or, if you have the HOME environment variable set, then SDL.DLL will
   221    or, if you have the HOME environment variable set, then SDL12.DLL will
   220    create a file in that directory called .sdl.proportionals, and you can
   222    create a file in that directory called .sdl.proportionals, and you can
   221    put there the name of executable files that will be automatically made
   223    put there the name of executable files that will be automatically made
   222    proportional.
   224    proportional.
   223 
   225 
   224 Version 1.2.7 - 2005-10-14  - Doodle
   226 Version 1.2.7 - 2005-10-14  - Doodle