diff --git a/include/freetype/freetype.h b/include/freetype/freetype.h
index be191f5aa..d02bbd222 100644
--- a/include/freetype/freetype.h
+++ b/include/freetype/freetype.h
@@ -30,6 +30,27 @@ FT_BEGIN_HEADER
 
 
 
+  /**************************************************************************
+   *
+   * @section:
+   *   preamble
+   *
+   * @title:
+   *   Preamble
+   *
+   * @abstract
+   *   What FreeType is and isn't
+   *
+   * @descriptiom
+   *   FreeType is a library that provides access to glyphs in font files.
+   *   It scales the glyph images and their metrics to a requested size but
+   *   it is not a text layout engine.  FreeType rasterizes the glyph images
+   *   and produces pixel or subpixel alpha coverage bitmaps but it does not
+   *   perform alpha blending or compositing itself.
+   *
+   */
+
+
   /**************************************************************************
    *
    * @section:
diff --git a/include/freetype/ftchapters.h b/include/freetype/ftchapters.h
index 2ee26973e..2a41fca05 100644
--- a/include/freetype/ftchapters.h
+++ b/include/freetype/ftchapters.h
@@ -15,6 +15,7 @@
    *   General Remarks
    *
    * @sections:
+   *   preamble
    *   header_inclusion
    *   user_allocation
    *