update for HEAD-2003050101

[reactos.git] / lib / freetype / docs / INSTALL.ANY

diff --git a/lib/freetype/docs/INSTALL.ANY b/lib/freetype/docs/INSTALL.ANY
new file mode 100644 (file)
index 0000000..5e2cf0e
--- /dev/null
+++ b/lib/freetype/docs/INSTALL.ANY
@@ -0,0 +1,96 @@
+Instructions on how to build FreeType with your own build tool:
+
+  see the file "CUSTOMIZE" to learn how to customize FreeType to
+  specific environments.
+
+  follow these simple steps:
+
+I. Normal way:
+--------------
+
+  * DISABLE PRE-COMPILED HEADERS ! This is very important for Visual
+    C++, because FreeType uses lines like:
+    
+       #include FT_FREETYPE_H
+    
+    which are not correctly supported by this compiler, while being
+    ISO C compliant !!
+
+  * You need to add  the directories "freetype2/include" to your include
+    path when compiling the library.
+
+  * FreeType  2 is  made  of several  components;  each one  of them  is
+    located   in  a  subdirectory   of  "freetype2/src".   For  example,
+    'freetype2/src/truetype/' contains the TrueType font driver.
+
+  * DO NOT COMPILE ALL C FILES!  Rather, compile the following ones:
+
+      -- base components (required)
+
+        src/base/ftsystem.c
+        src/base/ftinit.c
+        src/base/ftdebug.c
+        src/base/ftbase.c
+        src/base/ftglyph.c
+        src/base/ftbbox.c
+        src/base/ftmm.c
+        src/base/ftpfr.c        -- optional, see <freetype/ftpfr.h>
+        src/base/ftbdf.c        -- optional, see <freetype/ftbdf.h>
+        src/base/ftwinfnt.c     -- optional, see <freetype/ftwinfnt.h>
+
+        src/base/ftmac.c        -- only on the Macintosh
+
+     -- other components are optional
+
+        src/autohint/autohint.c -- auto hinting module
+        src/cache/ftcache.c     -- cache sub-system (in beta)
+        src/sfnt/sfnt.c         -- SFNT files support
+                                   (TrueType & OpenType)
+        src/cff/cff.c           -- CFF/OpenType font driver
+        src/pfr/pfr.c           -- PFR/TrueDoc font driver
+        src/bdf/bdf.c           -- BDF font driver
+        src/pcf/pcf.c           -- PCF font driver
+        src/psnames/psnames.c   -- Postscript glyph names support
+        src/psaux/psaux.c       -- Postscript Type 1 parsing
+        src/truetype/truetype.c -- TrueType font driver
+        src/type1/type1.c       -- Type 1 font driver
+        src/cid/type1cid.c      -- Type 1 CID-keyed font driver
+        src/winfonts/winfonts.c -- Windows FONT / FNT font driver
+        src/raster1/raster1.c   -- monochrome rasterizer
+        src/smooth/smooth.c     -- anti-aliasing rasterizer
+
+    Note:
+
+      `truetype.c' needs `sfnt.c' and `psnames.c'
+      `type1.c'    needs `psaux.c' and `psnames.c'
+      `type1cid.c' needs `psaux.c' and `psnames.c'
+      `cff.c'      needs `sfnt.c', `psaux.c', and `psnames.c'
+
+  that should be it ! in case of problems, see the archives of
+  the FreeType development mailing list.
+
+
+II. Support for flat-directory compilation
+------------------------------------------
+
+  It is  possible to  put all  FreeType 2 source  files into  a single
+  directory, with the *exception* of the `include' hierarchy.
+
+    1. Copy all files in current directory:
+
+        cp freetype2/src/base/*.[hc] .
+        cp freetype2/src/raster1/*.[hc] .
+        cp freetype2/src/smooth/*.[hc] .
+        etc.
+
+    2. Compile sources:
+
+        cc -c -Ifreetype2/include ftsystem.c
+        cc -c -Ifreetype2/include ftinit.c
+        cc -c -Ifreetype2/include ftdebug.c
+        cc -c -Ifreetype2/include ftbase.c
+        etc.
+
+   You don't need to define the FT_FLAT_COMPILATION macro (as this was
+   required in previous releases of FreeType 2).
+