* 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.

1 files changed, 19 insertions, 18 deletions

diff --git a/docs/VERSION.DLL b/docs/VERSION.DLL
index f7cf88c02..b880ffc6b 100644
--- a/docs/VERSION.DLL
+++ b/docs/VERSION.DLL
@@ -1,4 +1,4 @@
-Due  to our  use of  "libtool" to  generate and  install the  FreeType 2
+Due  to our  use of  `libtool' to  generate and  install the  FreeType 2
 libraries on  Unix systems,  as well as  other historical events,  it is
 generally very  difficult to  know precisely which  release of  the font
 engine is installed on a given system.
@@ -7,19 +7,19 @@ This file tries  to explain why and to document  ways to properly detect
 FreeType on Unix.
 
 
-1. Version & Release numbers
-----------------------------
+1. Version and Release numbers
+------------------------------
 
 For each new  public release of FreeType 2,  there are generally *three*
-distinct "version" numbers to consider:
+distinct `version' numbers to consider:
 
   * The official FT2 release number, like 2.0.9, or 2.1.3.
 
-  * The libtool (and Unix)  specific version number, like "9.2.3".  This
-    is what "freetype-config --version" will return.
+  * The libtool (and Unix) specific version number, like 9.2.3.  This is
+    what `freetype-config --version' returns.
 
   * The platform-specific  shared object  number, used for  example when
-    the library is installed as "/usr/lib/libfreetype.so.6.3.2".
+    the library is installed as `/usr/lib/libfreetype.so.6.3.2'.
 
 The platform-specific  number is, unsurprisingly,  platform-specific and
 varies  with the  operating system  you are  using (several  variants of
@@ -32,14 +32,14 @@ tied to it.
 The release number is available  at *compile* time through the following
 macros defined in FT_FREETYPE_H:
 
-  - FREETYPE_MAJOR : major release number
-  - FREETYPE_MINOR : minor release number
-  - FREETYPE_PATCH : patch release number
+  - FREETYPE_MAJOR: major release number
+  - FREETYPE_MINOR: minor release number
+  - FREETYPE_PATCH: patch release number
 
 See below for a small autoconf fragment.
 
 The  release   number  is  also  available  at   *runtime*  through  the
-"FT_Library_Version" API.   Unfortunately, this one  wasn't available or
+`FT_Library_Version' API.   Unfortunately, this one  wasn't available or
 working correctly before the 2.1.3 official release.
 
 
@@ -50,6 +50,7 @@ The following table gives,  for each official release, the corresponding
 libtool  number, as well  as the  shared object  number found  on _most_
 systems, but not all of them:
 
+
     release    libtool      so
   -------------------------------
      2.2.0      9.9.3     6.3.9
@@ -74,10 +75,10 @@ The libtool numbers are a bit inconsistent due to the library's history:
   - 2.1.0 was created as a development branch from 2.0.8 (hence the same
     libtool numbers).
 
-  - 2.0.9  was  a  bug-fix  release  of  the  "stable"  branch,  and  we
+  - 2.0.9  was  a  bug-fix  release  of  the  `stable'  branch,  and  we
     incorrectly increased its libtool number.
 
-  - 2.1.4 is  still in  the "development" branch,  however it  is stable
+  - 2.1.4 is  still in  the `development' branch,  however it  is stable
     enough to be the basis of an upcoming 2.2.0 release.
 
 
@@ -86,7 +87,7 @@ The libtool numbers are a bit inconsistent due to the library's history:
 
 Lars Clausen contributed the following autoconf fragment to detect which
 version of  FreeType is  installed on  a system.  This  one tests  for a
-version that  is at least 2.0.9;  you should change  it to check against
+version that  is at least 2.0.9;  you should change it  to check against
 other release numbers.
 
 
@@ -113,10 +114,10 @@ other release numbers.
 Copyright 2002, 2003, 2004, 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
+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.