BorlandC.html
author Sam Lantinga <slouken@libsdl.org>
Mon, 11 Mar 2002 17:38:56 +0000
changeset 309 2de77f7b7a28
parent 274 051b991765ba
permissions -rw-r--r--
*** empty log message ***
     1 Date: Sun, 13 Jan 2002 13:59:56 -0600
     2 From: David Snopek <xevol@newtonave.net>
     3 To: slouken@devolution.com
     4 Subject: Compiling SDL with Borland C++
     5 
     6 <html>
     7 <title>Building SDL with Borland C++ </title>
     8 <body>
     9 
    10 <h1>Building SDL with Borland C++ </h1>
    11 <b> by <a href=mailto:xevol@users.sourceforge.net> David Snopek </a> </b> 
    12 
    13 <br>
    14 <br>
    15 
    16 These instructions cover how to compile SDL and its included test programs using either 
    17 Borland C++ Builder 5 or the free Borland compiler. <br>
    18 
    19 <h3> <b> Extract the files </b> </h3>
    20 
    21 <p> Unzip the Borland.zip archive into <b>this</b> directory.  Do not unzip it into any 
    22 other directory because the makefiles use relative paths to refer to the SDL sources.  This 
    23 should create a directory named "Borland" inside of the top level SDL source directory. 
    24 </p>
    25 
    26 <h3> <b> Using Borland C++ Builder 5 </b> </h3>
    27 
    28 <p> Inside of the "Borland" directory there is a "bcb5" directory that contains a number 
    29 of Builder project files.  Double-click on the "libSDL.bpg" file icon.  Once Builder has 
    30 started click on the "<u>P</u>rojects" menu on the menu-bar and go down to 
    31 "B<u>u</u>ild All Projects" option.  This will proceed to build SDL, SDLmain, and all 
    32 the <a href="#tests">test programs</a>. </p>
    33 
    34 <h3> <b> Using the free Borland compiler </b> </h3>
    35 
    36 <p> The free Borland compiler can be downloaded at no charge from <a href="http://www.borland.com/bcppbuilder/freecompiler/"> the 
    37 Borland website </a>.  Make sure that it is installed and properly configured. </p>
    38 
    39 <p> Open an MS-DOS Prompt.  Change to the "Borland\freebcc" directory under the 
    40 SDL source directory.  Type "make -f SDL.mak" to build SDL and "make -f 
    41 SDLmain.mak".  There are also makefiles for all of the <a href="#tests">test 
    42 programs</a>, if you wish to build them. </p>
    43 
    44 <h3> <b> Output files </b> </h3>
    45 
    46 No matter which compiler you used, three important files should have been produced:
    47  
    48 <UL>
    49 	<LI> SDL.dll </LI>
    50 	<LI> SDL.lib </LI>
    51 	<LI> SDLmain.lib </LI>
    52 </UL>
    53 
    54 Both of the *.lib files will need to be added to all the projects that use SDL and SDL.dll 
    55 must be placed some where the Windows dynamic linker can find it (either in your 
    56 project directory or on the system path, C:\WINDOWS\SYSTEM).
    57 
    58 <a name="tests">
    59 <h3> <b> Test programs </b> </h3>
    60 </a>
    61 
    62 Some of the test programs require included media files.  Before trying to run any of the 
    63 test programs, copy these media files from the "tests/" directory into the build directory.
    64 
    65 </body>
    66 </html>
    67 
    68