* include/freetype/freetype.h, include/freetype/ftchapters.h: Add
a preliminary section with some explanations about user allocation.

* src/tools/docmaker/tohtml.py (HtmlFormatter.section_enter):
Don't abort if there are no data types, functions, etc., in a
section.
Print synopsis only if we have a data type, function, etc.

* docs/INSTALL.ANY, docs/INSTALL, docs/INSTALL.UNX, docs/CUSTOMIZE,
docs/INSTALL.GNU, docs/TRUETYPE, docs/DEBUG, docs/UPGRADE.UNX,
docs/VERSION.DLL, docs/formats.txt: Revised, formatted.
diff --git a/docs/INSTALL.ANY b/docs/INSTALL.ANY
index 4045b2f..75e701a 100644
--- a/docs/INSTALL.ANY
+++ b/docs/INSTALL.ANY
@@ -1,26 +1,26 @@
 Instructions on how to build FreeType with your own build tool
 ==============================================================
 
-See  the  file `CUSTOMIZE'  to  learn  how  to customize  FreeType  to
-specific environments.
+See the file `CUSTOMIZE' to  learn how to customize FreeType to specific
+environments.
 
 
 I. Standard procedure
 ---------------------
 
-  * DISABLE PRE-COMPILED  HEADERS!  This is very  important for Visual
+  * 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!
+    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.
+  * You need to add  the directories `freetype2/include' to your include
+    path when compiling the library.
 
-  * FreeType 2 is made of  several components; each of them is located
-    in    a   subdirectory    of   `freetype2/src'.     For   example,
+  * FreeType 2 is made of several components; each 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:
@@ -85,14 +85,17 @@
       `type42.c'   needs `truetype.c'
 
 
-  You are done.  In case of problems, see the archives of the FreeType
+  Read the file `CUSTOMIZE' in case you want to compile only a subset of
+  the drivers, renderers, and optional modules.
+
+  You are done.   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
+  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
@@ -110,19 +113,19 @@
       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).
+    You don't need to define  the FT_FLAT_COMPILATION macro (as this was
+    required in previous releases of FreeType 2).
 
-----------------------------------------------------------------------
+------------------------------------------------------------------------
 
 Copyright 2003, 2005 by
 David Turner, Robert Wilhelm, and Werner Lemberg.
 
-This  file is  part of  the FreeType  project, and  may only  be used,
-modified,  and distributed  under the  terms of  the  FreeType project
-license,  LICENSE.TXT.  By  continuing to  use, modify,  or distribute
-this file you  indicate that you have read  the license and understand
-and accept it fully.
+This  file is  part  of the  FreeType  project, and  may  only be  used,
+modified,  and  distributed under  the  terms  of  the FreeType  project
+license, LICENSE.TXT.  By continuing  to use, modify, or distribute this
+file  you indicate that  you have  read the  license and  understand and
+accept it fully.
 
 
 --- end of INSTALL.ANY ---