From a0b47905e765aeeda6220c2dece4d959b7b25a5f Mon Sep 17 00:00:00 2001
From: Steve Chaplin <stevech1097@yahoo.com.au>
Date: Fri, 14 Aug 2009 15:28:10 +0800
Subject: Add notes on why freetype and xlib surface is not supported.

---
 doc/reference/surfaces.rst |  7 +++++--
 doc/reference/text.rst     | 24 ++++++++++++++++++++++++
 2 files changed, 29 insertions(+), 2 deletions(-)

diff --git a/doc/reference/surfaces.rst b/doc/reference/surfaces.rst
index aea848c..8c6332a 100644
--- a/doc/reference/surfaces.rst
+++ b/doc/reference/surfaces.rst
@@ -637,8 +637,11 @@ if it is available.
 
 .. class:: XlibSurface
 
-   *XlibSurface* cannot be instantiated directly. But an XlibSurface instance
-   can be returned from a function call when using pygtk.
+   .. note:: *XlibSurface* cannot be instantiated directly because Python
+      interaction with Xlib would require open source Python bindings to Xlib
+      which provided a C API.
+      However, an *XlibSurface* instance can be returned from a function call
+      when using pygtk http://www.pygtk.org/.
 
    .. method:: get_depth()
 
diff --git a/doc/reference/text.rst b/doc/reference/text.rst
index 58a0e7d..b0a261f 100644
--- a/doc/reference/text.rst
+++ b/doc/reference/text.rst
@@ -46,6 +46,17 @@ use.
 
 
 
+class FreeTypeFontFace(:class:`FontFace`)
+=========================================
+
+FreeType Fonts - Font support for FreeType.
+
+The FreeType font backend is primarily used to render text on GNU/Linux
+systems, but can be used on other platforms too.
+
+   .. note:: FreeType Fonts are not implemented in pycairo because there is no open source Python bindings to FreeType (and fontconfig) that provides a C API. This a possible project idea for anyone interested in adding FreeType support to pycairo.
+
+
 class ToyFontFace(:class:`FontFace`)
 ====================================
 
@@ -93,6 +104,19 @@ The *cairo.ToyFontFace* class can be used instead of :meth:`Context.select_font_
       .. versionadded:: 1.8.4
 
 
+class UserFontFace(:class:`FontFace`)
+=====================================
+
+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.
+
+   .. note:: UserFontFace support has not (yet) been added to pycairo. If you
+      need this feature in pycairo register your interest by sending a message
+      to the cairo mailing list, or by opening a pycairo bug report.
+
+
 class ScaledFont()
 ==================
 
-- 
cgit v1.2.1