Mercurial > sdl-ios-xcode

Date: Sun, 13 Jan 2002 13:59:56 -0600
From: David Snopek <xevol@newtonave.net>
To: slouken@devolution.com
Subject: Compiling SDL with Borland C++

<html>
<title>Building SDL with Borland C++ </title>
<body>

<h1>Building SDL with Borland C++ </h1>
<b> by <a href=mailto:xevol@users.sourceforge.net> David Snopek </a> </b>

<br>
<br>

These instructions cover how to compile SDL and its included test programs using either
Borland C++ Builder 5 or the free Borland compiler. <br>

<h3> <b> Extract the files </b> </h3>

<p> Unzip the Borland.zip archive into <b>this</b> directory.  Do not unzip it into any
other directory because the makefiles use relative paths to refer to the SDL sources.  This
should create a directory named "Borland" inside of the top level SDL source directory.
</p>

<h3> <b> Using Borland C++ Builder 5 </b> </h3>

<p> Inside of the "Borland" directory there is a "bcb5" directory that contains a number
of Builder project files.  Double-click on the "libSDL.bpg" file icon.  Once Builder has
started click on the "<u>P</u>rojects" menu on the menu-bar and go down to
"B<u>u</u>ild All Projects" option.  This will proceed to build SDL, SDLmain, and all
the <a href="#tests">test programs</a>. </p>

<h3> <b> Using the free Borland compiler </b> </h3>

<p> The free Borland compiler can be downloaded at no charge from <a href="http://www.borland.com/bcppbuilder/freecompiler/"> the
Borland website </a>.  Make sure that it is installed and properly configured. </p>

<p> Open an MS-DOS Prompt.  Change to the "Borland\freebcc" directory under the
SDL source directory.  Type "make -f SDL.mak" to build SDL and "make -f
SDLmain.mak".  There are also makefiles for all of the <a href="#tests">test
programs</a>, if you wish to build them. </p>

<h3> <b> Output files </b> </h3>

No matter which compiler you used, three important files should have been produced:

<UL>
	<LI> SDL.dll </LI>
	<LI> SDL.lib </LI>
	<LI> SDLmain.lib </LI>
</UL>

Both of the *.lib files will need to be added to all the projects that use SDL and SDL.dll
must be placed some where the Windows dynamic linker can find it (either in your
project directory or on the system path, C:\WINDOWS\SYSTEM).

<a name="tests">
<h3> <b> Test programs </b> </h3>
</a>

Some of the test programs require included media files.  Before trying to run any of the
test programs, copy these media files from the "tests/" directory into the build directory.

</body>
</html>
author	Sam Lantinga <slouken@libsdl.org>
date	Mon, 01 Apr 2002 15:35:28 +0000
parents	051b991765ba
children