changeset 465:25f475cd4981

Updated the Borland C++ projects (thanks Dominique!)
author Sam Lantinga <slouken@libsdl.org>
date Sat, 24 Aug 2002 16:15:37 +0000
parents 1c4be4a16410
children 91d9a962e126
files Borland.html Borland.zip BorlandC.html Makefile.am
diffstat 4 files changed, 149 insertions(+), 80 deletions(-) [+]
line wrap: on
line diff
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/Borland.html	Sat Aug 24 16:15:37 2002 +0000
@@ -0,0 +1,137 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html>
+<head>
+  <title>Building SDL with Borland's C++ compilers</title>
+                    
+  <meta name="author"
+ content="David Snopek and updated by Dominique Louis.">
+</head>
+  <body>
+   <xevol @newtonave.net="">      </xevol>   
+<h1>Building SDL with Borland's C++ compilers. </h1>
+    <b> by <a href="mailto:xevol@users.sourceforge.net"> David Snopek</a></b> 
+   and updated by <b><a href="mailto:Dominique@SavageSoftware.com.au">Dominique 
+ Louis</a></b>.<br>
+    <br>
+     These instructions cover how to compile SDL and its included test programs 
+ using either  Borland <a href="#bcbwin">C++ Builder 5, 6 for Windows</a>, 
+<a href="#k3">C++ Builder for Linux  ( AKA Kylix 3 )</a> or the free <a
+ href="#bccc">Borland C++ command-line compiler</a>. <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 ( *.mak ) and project 
+files ( *.bpr ) 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><a name="bcbwin"></a> Using Borland C++ Builder 5, 6 for Windows </b>
+</h3>
+        
+<p> Inside of the "Borland" directory there is a "bcb6" 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.  <br>
+ This will proceed  to build SDL ( with Borland's calling convention ), SDLmain, 
+and all  the <a href="#tests">test programs</a>. Currently, all the <a
+ href="#tests">test programs</a> 
+are dynamically linked to Sam Lantinga's SDL.dll.</p>
+ 
+<p><b>NOTE :</b> Borland's "lib" format and Microsoft's "lib" format are incompatible.
+&nbsp;<br>
+ If you wish to dynamically link to the SDL library supplied by Sam Lantinga 
+in each release, I have created the correct *.libs for SDL 1.2.4 and they 
+exist in the "/lib" directory.<br>
+ If you would like to create the *.lib files yourself, you will need to make 
+use of Borland's "implib.exe" utility.<br>
+ </p>
+ 
+<p><tt>IMPLIB</tt> works like this: </p>
+   
+<pre>    IMPLIB (destination lib name) (source dll)<br></pre>
+   
+<p> For example,</p>
+   
+<pre>    IMPLIB SDL.lib SDL.dll<br></pre>
+ 
+<p>This assumes that SDL.dll was compiled with Visual C++ or similar.<br>
+ </p>
+ 
+<p>To learn more about the difference between Borland's and Microsoft's *.lib 
+format please read the article <a
+ href="http://www.bcbdev.com/articles/vcdll.htm">here</a>.<br>
+ </p>
+ 
+<p>  <b><br>
+ NOTE :</b> The C++ Builder for Windows project format, is not compatible
+with the Kylix  3 project format, hence the reason why they are in separate
+directories.</p>
+        
+<h3> <b><a name="bccc"></a> Using the free Borland C++ command-line 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 ( Borland format ) </li>
+    	<li> SDL.lib&nbsp;( Borland format ) </li>
+    	<li> SDLmain.lib&nbsp;( Borland format ) </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). 
+   
+<h3> <b><a name="k3"></a> Using Borland C++ Builder for Linux ( AKA Kylix 
+3 ) </b> </h3>
+          
+<p> Inside of the "Borland" directory there is a "k3" 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 all  the <a
+ href="#tests">test programs</a>.&nbsp;<br>
+ Linux  users do not need *.lib files as the Shared Object is linked right 
+into the  project ( very neat actually, Windows should do this sort of thing 
+as it is a lot easier for the developer ).  <br>
+    <b>NOTE :</b>&nbsp;The C++ Builder for Windows project format, is not
+compatible with the Kylix  3 project format, hence the reason why they are
+in separate directories.</p>
+       
+<p> On Mandrake 8.1 the shared objects for SDL are located in the /usr/lib 
+ directory as libSDL_*.so and the Mesa OpenGL shared objects are located in
+ /usr/X11R6/lib as libGL*.so<br>
+     <br>
+     So if your setup is different you may need to change the project file
+ so that they re-link to the ones on your system.<br>
+     <br>
+     On Mandrake 8.1 the headers files are located at /usr/include/SDL/.
+So  if you you have not installed the development RPMs ( usually named libSDL-devel*
+  ) for SDL ( not included ) you may have to change the include directory
+within  some of the projects.<br>
+ </p>
+ 
+<h3> Known Problems</h3>
+   The only known problem is that I ( Dominique Louis ), was unable to create 
+the projects that rebuilt the SDL shared objects under Linux, due to time 
+constraints and my lack of intimate knowledge of Linux.   
+<h3><a name="tests"><b> Test programs </b> </a></h3>
+ Some of the test programs require included media files ( *.wav; *.bmp etc 
+ ).  Before trying to run any of the  test programs, copy these media files 
+ from the "tests/" directory into the Borland build directory that you extracted 
+ the project files to.  <br>
+   <br>
+</body>
+</html>
+
Binary file Borland.zip has changed
--- a/BorlandC.html	Sat Aug 24 15:29:06 2002 +0000
+++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
@@ -1,68 +0,0 @@
-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>
-
-
--- a/Makefile.am	Sat Aug 24 15:29:06 2002 +0000
+++ b/Makefile.am	Sat Aug 24 16:15:37 2002 +0000
@@ -19,9 +19,9 @@
 EXTRA_DIST =		\
 	BUGS		\
 	TODO		\
-        COPYING		\
-        CREDITS		\
-        INSTALL		\
+	COPYING		\
+	CREDITS		\
+	INSTALL		\
 	README		\
 	README.AmigaOS	\
 	README.CVS	\
@@ -35,21 +35,21 @@
 	README.Qtopia	\
 	README.WinCE	\
 	README-SDL.txt	\
-	BorlandC.html	\
+	Borland.html	\
 	Borland.zip	\
-        VisualC.html	\
-        VisualC.zip	\
+	VisualC.html	\
+	VisualC.zip	\
 	VisualCE.zip	\
-        MPWmake.sea.bin	\
+	MPWmake.sea.bin	\
 	CWprojects.sea.bin \
 	PBProjects.tar.gz \
 	EpocBuildFiles.zip \
-        WhatsNew	\
-        docs.html	\
+	WhatsNew	\
+	docs.html	\
 	sdl.m4		\
-        SDL.spec	\
-        autogen.sh	\
-        strip_fPIC.sh
+	SDL.spec	\
+	autogen.sh	\
+	strip_fPIC.sh
 
 # M4 macro file for inclusion with autoconf
 m4datadir = $(datadir)/aclocal