removed "BUILD"
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238
diff --git a/BUILD b/BUILD
deleted file mode 100644
index 6cfd39c..0000000
--- a/BUILD
+++ /dev/null
@@ -1,232 +0,0 @@
-FreeType 2 compilation how-to
-
-
-Introduction:
-
-Welcome to this new beta of the FreeType 2 library. You'll find in this
-document instructions on how to compile the library on your favorite
-platform.
-
- *** UNIX USERS : Even though the FT2 build system doesn't
- ************** : use the Autoconf/Automake tools, these will
- ************** : be introduced in the Unix-specific parts of
- ************** : the build in our final release..
-
-
-I. QUICK COMMAND-LINE GUIDE:
-----------------------------
-
- Install GNU Make, then try the following on Unix or any system with gcc:
-
- make // this will setup the build
- make // this will build the library
-
- On Win32+Visual C++:
-
- make setup visualc // setup the build for VisualC++ on Win32
- make // build the library
-
- Then, go to the "demos" directory and type
-
- make
-
- To compile the demo programs..
-
- If this doesn't work, read the following..
-
-
-
-II. COMMAND-LINE COMPILATION:
------------------------------
-
- Note that if you do not want to compile FreeType 2 from a command line
- shell, please skip to section III below (DETAILED COMPILATION)
-
- FreeType 2 includes a powerful and flexible build system that allows you
- to easily compile it on a great variety of platforms from the command
- line. To do so, just follow these simple instructions:
-
- a/ Install GNU Make:
-
- Because GNU Make is the only Make tool supported to compile FreeType 2,
- you should install it on your machine.
-
- Because the FT2 build system relies on many important features of GNU
- Make, trying to build the library with any other Make tool will *fail*.
-
-
- b/ Invoke "make":
-
- Go to the root FT2 directory, then simply invoke GNU Make from the
- command line, this will launch the FreeType 2 Host Platform detection
- routines. A summary will be displayed, for example, on Win32:
-
- ========================================================================
- FreeType build system -- automatic system detection
-
- The following settings are used:
-
- platform win32
- compiler gcc
- configuration directory ./config/win32
- configuration rules ./config/win32/w32-gcc.mk
-
- If this does not correspond to your system or settings please remove
- the file 'config.mk' from this directory then read the INSTALL file
- for help.
-
- Otherwise, simply type 'make' again to build the library.
- =========================================================================
-
- If the detected settings correspond to your platform and compiler,
- skip to step e/. Note that if your platform is completely alien to
- the build system, the detected platform will be "ansi".
-
-
- c/ Configure the build system for a different compiler:
-
- If the build system correctly detected your platform, but you want to
- use a different compiler than the one specified in the summary (for
- most platforms, gcc is the defaut compiler), simply invoke GNU Make
- like :
-
- make setup <compiler>
-
- For example:
-
- to use Visual C++ on Win32, type: "make setup visualc"
- to use LCC-Win32 on Win32, type: "make setup lcc"
-
- The <compiler> name to use is platform-dependent. The list of available
- compilers for your system is available in the file
- "config/<system>/detect.mk" (note that we hope to make the list
- displayed at user demand in the final release)..
-
- If you're satisfying by the new configuration summary, skip to step e/
-
-
- d/ Configure the build system for an unknown platform/compiler:
-
- What the auto-detection/setup phase of the build system does is simply
- copy a file to the current directory under the name "config.mk".
-
- For example, on OS/2+gcc, it would simply copy "config/os2/os2-gcc.mk"
- to "./config.mk"
-
- If for some reason your platform isn't correctly detected, simply copy
- manually the configuration sub-makefile to "./config.mk" and go to
- step e/.
-
- Note that this file is a sub-Makefile used to specify Make variables
- used to invoke the compiler and linker during the build, you can easily
- create your own version from one of the existing configuration files,
- then copy it to the current directory under the name "./config.mk".
-
-
- e/ Build the library:
-
- The auto-detection/setup phase should have copied a file in the current
- directory, called "./config.mk". This file contains definitions of various
- Make variables used to invoke the compiler and linker during the build.
-
- To launch the build, simply invoke GNU Make again: the top Makefile will
- detect the configuration file and run the build with it..
-
-
- f/ Build the demonstration programs:
-
- Once the library is compiled, go to "demos", then invoke GNU Make.
-
- Note that the demonstration programs include a tiny graphics sub-system
- that includes "drivers" to display Windows on Win32, X11 and OS/2. The
- build system should automatically detect which driver to use based on
- the current platform.
-
- UNIX USERS TAKE NOTE: XXXXXX
-
- When building the demos, the build system tries to detect your X11 path
- by looking for the patterns "X11R5/bin", "X11R6/bin" or "X11/bin" in
- your current path. If no X11 path is found, the demo programs will not
- be able to display graphics and will fail. Change your current path
- if you encounter this problem.
-
- Note that the release version will use Autoconf to detect everything
- on Unix, so this will not be necessary !!
-
-
-II. DETAILED COMPILATION PROCEDURE:
------------------------------------
-
- If you don't want to compile FreeType 2 from the command-line (for example
- from a graphical IDE on a Mac or Windows), you'll need to understand how the
- FreeType files are organized.
-
- FreeType 2 has a very module design, and it is made of several components.
- Each component must be compiled as a stand-alone object file, even when it
- is really made of several C source files. For example, the "base layer"
- component is made of the following C files:
-
- src/
- base/
- ftcalc.c - computations
- ftobjs.c - object management
- ftstream.c - stream input
- ftlist.c - simple list management
- ftoutln.c - simple outline processing
- ftextend.c - extensions support
-
- However, you can create a single object file by compiling the file
- "src/base/ftbase.c", whose content is:
-
- #include <ftcalc.c>
- #include <ftobjs.c>
- #include <ftstream.c>
- #include <ftlist.c>
- #include <ftoutln.c>
- #include <ftextend.c>
-
- Similarly, each component has a single "englobing" C file to compile it
- as a stand-alone object, i.e. :
-
- src/base/ftbase.c - the base layer, high-level interface
- src/sfnt/sfnt.c - the "sfnt" module
- src/psnames/psnames.c - the Postscript Names module
- src/truetype/truetype.c - the TrueType font driver
- src/type1/type1.c - the Type 1 font driver
-
-
- To compile one component, do the following:
-
- - add the top-level "include" directory to your compilation include path
-
- - add the component's path to your compilation include path too. Being
- in the component's directory isn't enough !!
-
- - compile the component "source" file (see list below).
-
- For example, the following line can be used to compile the truetype driver
- on Unix:
-
- cd freetype2/
- cc -c -Iinclude -Isrc/truetype src/truetype/truetype.c
-
- Alternatively:
-
- cd freetype2/src/truetype
- cc -c -I../../include -I. src/truetype/truetype.c
-
- The complete list of files to compile for a feature-complete build of
- FreeType 2 is:
-
- src/base/ftsystem.c - system-specific memory and i/o support
- src/base/ftinit.c - initialisation layer
- src/base/ftdebug.c - debugging component (empty in release build)
- src/base/ftbase.c - the "base layer" component
- src/base/ftglyph.c - optional convenience functions
- src/raster1/raster1.c - the monochrome bitmap renderer
- src/smooth/smooth.c - the anti-aliased bitmap renderer
- src/sfnt/sfnt.c - the "sfnt" module
- src/psnames/psnames.c - the "psnames" module
- src/truetype/truetype.c - the TrueType font driver
- src/type1/type1.c - the Type 1 font driver
-