annotate BorlandC.html @ 449:8a687496061f

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