diff --git a/doc/public/tmpl/cairo-user-fonts.sgml b/doc/public/tmpl/cairo-user-fonts.sgml
index b64bf2509..c1cf8c41c 100644
--- a/doc/public/tmpl/cairo-user-fonts.sgml
+++ b/doc/public/tmpl/cairo-user-fonts.sgml
@@ -2,11 +2,16 @@
 User Fonts
 
 <!-- ##### SECTION Short_Description ##### -->
-
+Font support with font data provided by the user
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
+The user-font feature allows the cairo user to provide drawings for glyphs
+in a font.  This is most useful in implementing fonts in non-standard
+formats, like SVG fonts and Flash fonts, but can also be used by games and
+other application to draw "funky" fonts.
 
+<!-- Include samples here -->
 </para>
 
 <!-- ##### SECTION See_Also ##### -->