Removed unsupported Borland related files
authorSam Lantinga <slouken@libsdl.org>
Sun, 22 Jan 2012 17:32:50 -0500
changeset 62522fe50fbc8f91
parent 6251 3e8c673cad58
child 6253 c571220b40f4
Removed unsupported Borland related files
Borland.html
Borland.zip
Makefile.in
     1.1 --- a/Borland.html	Sun Jan 22 17:26:45 2012 -0500
     1.2 +++ /dev/null	Thu Jan 01 00:00:00 1970 +0000
     1.3 @@ -1,139 +0,0 @@
     1.4 -<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
     1.5 -<html>
     1.6 -<head>
     1.7 -  <title>Building SDL with Borland's C++ compilers</title>
     1.8 -                                  
     1.9 -  <meta name="author"
    1.10 - content="David Snopek and updated by Dominique Louis.">
    1.11 -</head>
    1.12 -  <body>
    1.13 -     <xevol @newtonave.net="">      </xevol>     
    1.14 -<h1>Building SDL with Borland's C++ compilers. </h1>
    1.15 -      <b> by <a href="mailto:xevol@users.sourceforge.net"> David Snopek</a></b> 
    1.16 -    and updated by <b><a href="mailto:Dominique@SavageSoftware.com.au">Dominique 
    1.17 -  Louis</a></b> ( Last updated : 30th June 2003 ).<br>
    1.18 -      <br>
    1.19 -       These instructions cover how to compile SDL and its included test
    1.20 -programs   using either  Borland <a href="#bcbwin">C++ Builder 5, 6 for Windows</a>, 
    1.21 - <a href="#k3">C++ Builder for Linux  ( AKA Kylix 3 )</a> or the free <a
    1.22 - href="#bccc">Borland C++ command-line compiler</a>. <br>
    1.23 -            
    1.24 -<h3> <b> Extract the files </b> </h3>
    1.25 -            
    1.26 -<p> Unzip the Borland.zip archive into <b>this</b> directory.  Do not unzip 
    1.27 -  it into any  other directory because the makefiles ( *.mak ) and project 
    1.28 - files ( *.bpr ) use relative paths to refer to the SDL sources.  This  should 
    1.29 - create a directory named "Borland" inside of the top level SDL source directory. 
    1.30 -   </p>
    1.31 -            
    1.32 -<h3> <b><a name="bcbwin"></a> Using Borland C++ Builder 5, 6 for Windows </b>
    1.33 -</h3>
    1.34 -            
    1.35 -<p> Inside of the "Borland" directory there is a "bcb6" directory that contains 
    1.36 -  a number  of Builder project files.  Double-click on the "libSDL.bpg" file 
    1.37 -  icon.  Once Builder has  started click on the "<u>P</u>rojects" menu on 
    1.38 -the  menu-bar and go down to  "B<u>u</u>ild All Projects" option.  <br>
    1.39 -   This will proceed  to build SDL ( with Borland's calling convention ), 
    1.40 -SDLmain,  and all  the <a href="#tests">test programs</a>. Currently, all 
    1.41 -the <a href="#tests">test programs</a>  are dynamically linked to Sam Lantinga's 
    1.42 -SDL.dll.</p>
    1.43 -     
    1.44 -<p><b>NOTE :</b> Borland's "lib" format and Microsoft's "lib" format are incompatible.
    1.45 -&nbsp;<br>
    1.46 -   If you wish to dynamically link to the SDL library supplied by Sam Lantinga 
    1.47 - in each release, I have created the correct *.libs for SDL 1.2.4 and they 
    1.48 - exist in the "/lib" directory.<br>
    1.49 -   If you would like to create the *.lib files yourself, you will need to 
    1.50 -make  use of Borland's "implib.exe" utility.<br>
    1.51 -   </p>
    1.52 -     
    1.53 -<p><tt>IMPLIB</tt> works like this: </p>
    1.54 -       
    1.55 -<pre>    IMPLIB (destination lib name) (source dll)<br></pre>
    1.56 -       
    1.57 -<p> For example,</p>
    1.58 -       
    1.59 -<pre>    IMPLIB SDL.lib SDL.dll<br></pre>
    1.60 -     
    1.61 -<p>This assumes that SDL.dll was compiled with Visual C++ or similar.<br>
    1.62 -   </p>
    1.63 -     
    1.64 -<p>To learn more about the difference between Borland's and Microsoft's *.lib 
    1.65 - format please read the article <a
    1.66 - href="http://www.bcbdev.com/articles/vcdll.htm">here</a>.<br>
    1.67 -   </p>
    1.68 -     
    1.69 -<p>  <b><br>
    1.70 -   NOTE :</b> The C++ Builder for Windows project format, is not compatible
    1.71 - with the Kylix  3 project format, hence the reason why they are in separate
    1.72 - directories.</p>
    1.73 -            
    1.74 -<h3> <b><a name="bccc"></a> Using the free Borland C++ command-line compiler 
    1.75 - </b> </h3>
    1.76 -            
    1.77 -<p> The free Borland compiler can be downloaded at no charge from <a
    1.78 - href="http://www.borland.com/bcppbuilder/freecompiler/"> the  Borland website 
    1.79 -  </a>.  Make sure that it is installed and properly configured. </p>
    1.80 -            
    1.81 -<p> Open an MS-DOS Prompt.  Change to the "Borland\freebcc" directory under 
    1.82 -  the  SDL source directory.  Type "make -f SDL.mak" to build SDL and "make 
    1.83 -  -f  SDLmain.mak".  There are also makefiles for all of the <a
    1.84 - href="#tests">test  programs</a>, if you wish to build them. All .exes and 
    1.85 -DLLs are created in the "test" SDL directory. Ify ou would like to create 
    1.86 -the DLL and all the test applications, I have thrown together a basic batchfile 
    1.87 -called "makeall.bat" which should create everything in the right order. </p>
    1.88 -            
    1.89 -<h3> <b> Output files </b> </h3>
    1.90 -       No matter which compiler you used, three important files should have 
    1.91 - been  produced:        
    1.92 -<ul>
    1.93 -      	<li> SDL.dll ( Borland format ) </li>
    1.94 -      	<li> SDL.lib&nbsp;( Borland format ) </li>
    1.95 -      	<li> SDLmain.lib&nbsp;( Borland format ) </li>
    1.96 -           
    1.97 -</ul>
    1.98 -       Both of the *.lib files will need to be added to all the projects
    1.99 -that   use SDL and SDL.dll  must be placed some where the Windows dynamic
   1.100 -linker   can find it (either in your  project directory or on the system
   1.101 -path, C:\WINDOWS\SYSTEM).       
   1.102 -<h3> <b><a name="k3"></a> Using Borland C++ Builder for Linux ( AKA Kylix 
   1.103 - 3 ) </b> </h3>
   1.104 -              
   1.105 -<p> Inside of the "Borland" directory there is a "k3" directory that contains 
   1.106 -  a number  of Builder project files.  Double-click on the "libSDL.bpg" file 
   1.107 -  icon.  Once Builder has  started click on the "<u>P</u>rojects" menu on 
   1.108 -the  menu-bar and go down to  "B<u>u</u>ild All Projects" option.  This will 
   1.109 -proceed  to build all  the <a href="#tests">test programs</a>.&nbsp;<br>
   1.110 -   Linux  users do not need *.lib files as the Shared Object is linked right 
   1.111 - into the  project ( very neat actually, Windows should do this sort of thing 
   1.112 - as it is a lot easier for the developer ).  <br>
   1.113 -      <b>NOTE :</b>&nbsp;The C++ Builder for Windows project format, is not
   1.114 - compatible with the Kylix  3 project format, hence the reason why they are
   1.115 - in separate directories.</p>
   1.116 -           
   1.117 -<p> On Mandrake 8.1 the shared objects for SDL are located in the /usr/lib 
   1.118 -  directory as libSDL_*.so and the Mesa OpenGL shared objects are located 
   1.119 -in  /usr/X11R6/lib as libGL*.so<br>
   1.120 -       <br>
   1.121 -       So if your setup is different you may need to change the project file
   1.122 -  so that they re-link to the ones on your system.<br>
   1.123 -       <br>
   1.124 -       On Mandrake 8.1 the headers files are located at /usr/include/SDL/.
   1.125 - So  if you you have not installed the development RPMs ( usually named libSDL-devel*
   1.126 -   ) for SDL ( not included ) you may have to change the include directory
   1.127 - within  some of the projects.<br>
   1.128 -   </p>
   1.129 -     
   1.130 -<h3> Known Problems</h3>
   1.131 -     The only known problem is that I ( Dominique Louis ), was unable to
   1.132 -create  the projects that rebuilt the SDL shared objects under Linux, due
   1.133 -to time  constraints and my lack of intimate knowledge of Linux.     
   1.134 -<h3><a name="tests"><b> Test programs </b> </a></h3>
   1.135 -   Some of the test programs require included media files ( *.wav; *.bmp
   1.136 -etc   ). All the test programs are now created in the "test" directory, where
   1.137 -the media files are ( usually ) so they should be ready to go.  <br>
   1.138 -     <br>
   1.139 -  <br>
   1.140 - <br>
   1.141 -</body>
   1.142 -</html>
     2.1 Binary file Borland.zip has changed
     3.1 --- a/Makefile.in	Sun Jan 22 17:26:45 2012 -0500
     3.2 +++ b/Makefile.in	Sun Jan 22 17:32:50 2012 -0500
     3.3 @@ -36,7 +36,7 @@
     3.4  SDLMAIN_TARGET = libSDL2main.a
     3.5  SDLMAIN_OBJECTS = @SDLMAIN_OBJECTS@
     3.6  
     3.7 -SRC_DIST = acinclude Android.mk autogen.sh Borland.html Borland.zip BUGS build-scripts configure configure.in COPYING CREDITS include INSTALL Makefile.minimal Makefile.in README* sdl2-config.in sdl2.m4 sdl2.pc.in SDL2.spec.in src test TODO VisualC.html VisualC VisualCE Watcom-Win32.zip WhatsNew Xcode Xcode-iOS
     3.8 +SRC_DIST = acinclude Android.mk autogen.sh BUGS build-scripts configure configure.in COPYING CREDITS include INSTALL Makefile.minimal Makefile.in README* sdl2-config.in sdl2.m4 sdl2.pc.in SDL2.spec.in src test TODO VisualC.html VisualC VisualCE Watcom-Win32.zip WhatsNew Xcode Xcode-iOS
     3.9  GEN_DIST = SDL2.spec
    3.10  
    3.11  HDRS = \