README.OS2
changeset 1895 c121d94672cb
parent 1850 d5d3a6fe05a1
child 3244 7c73d5b5a0d6
equal deleted inserted replaced
1894:c69cee13dd76 1895:c121d94672cb
     1 
     1 
     2 ===========
     2 ===========
     3 SDL on OS/2
     3 SDL on OS/2
     4 ===========
     4 ===========
     5 
     5 
     6 Last updated on May. 17, 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 
    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)
    16 
    18 
    17 First of all, you have to unzip the Watcom-OS2.zip file. This will result in a 
    19 First of all, you have to unzip the Watcom-OS2.zip file. This will result in a 
    18 file called "makefile" and a file called "setvars.cmd" in this folder (and some
    20 file called "makefile" and a file called "setvars.cmd" in this folder (and some
    19 more files...).
    21 more files...).
    20 
    22 
    28 resulting SDL.DLL will be a 'debug' or a 'release' build. The 'debug' version 
    30 resulting SDL.DLL will be a 'debug' or a 'release' build. The 'debug' version 
    29 is full of printf()'s, so if something goes wrong, its output can help a lot
    31 is full of printf()'s, so if something goes wrong, its output can help a lot
    30 for debugging.
    32 for debugging.
    31 
    33 
    32 Then run "wmake".
    34 Then run "wmake".
    33 This should create the SDL12.DLL and the corresponding SDL12.LIB file here.
    35 This should create the SDL.DLL and the corresponding SDL.LIB file here.
    34 
    36 
    35 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
    36 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
    37 happens internally in SDL.
    39 happens internally in SDL.
    38 (like: testsprite >stdout.txt 2>stderr.txt)
    40 (like: testsprite >stdout.txt 2>stderr.txt)
    44 
    46 
    45 
    47 
    46 2. How to compile the testapps?
    48 2. How to compile the testapps?
    47 -------------------------------
    49 -------------------------------
    48 
    50 
    49 Once you have SDL12.DLL compiled, navigate into the 'test' folder, copy in 
    51 Once you have SDL.DLL compiled, navigate into the 'test' folder, copy in there
    50 there the newly built SDL12.DLL, and copy in there FSLib.DLL.
    52 the newly built SDL.DLL, and copy in there FSLib.DLL.
    51 
    53 
    52 Then run "wmake" in there to compile some of the testapps.
    54 Then run "wmake" in there to compile some of the testapps.
    53 
    55 
    54 
    56 
    55 
    57 
   186 
   188 
   187 
   189 
   188 
   190 
   189 10. Changelog of the OS/2 port
   191 10. Changelog of the OS/2 port
   190 ------------------------------
   192 ------------------------------
   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)
       
   195 
   193 
   196 Version 1.2 - 2006-05-01  - Doodle
   194 Version 1.2 - 2006-05-01  - Doodle
   197  - Modified makefile system to have only one makefile
   195  - Modified makefile system to have only one makefile
   198  - Included FSLib headers, DLL and LIB file
   196  - Included FSLib headers, DLL and LIB file
   199 
   197 
   216    environment variable to something before starting the application
   214    environment variable to something before starting the application
   217    (e.g.: 
   215    (e.g.: 
   218     SET SDL_USE_PROPORTIONAL_WINDOW=1
   216     SET SDL_USE_PROPORTIONAL_WINDOW=1
   219     dosbox.exe
   217     dosbox.exe
   220    )
   218    )
   221    or, if you have the HOME environment variable set, then SDL12.DLL will
   219    or, if you have the HOME environment variable set, then SDL.DLL will
   222    create a file in that directory called .sdl.proportionals, and you can
   220    create a file in that directory called .sdl.proportionals, and you can
   223    put there the name of executable files that will be automatically made
   221    put there the name of executable files that will be automatically made
   224    proportional.
   222    proportional.
   225 
   223 
   226 Version 1.2.7 - 2005-10-14  - Doodle
   224 Version 1.2.7 - 2005-10-14  - Doodle