doc: Move tmpl/ docs to inline docs

I did this manually so I could review the docs at the same time.
If anyone finds typos or other mistakes I did, please complain to me (or
better: fix them).

1 files changed, 17 insertions, 0 deletions

diff --git a/src/cairo-font-face.c b/src/cairo-font-face.c
index 3d619114f..a66054ead 100644
--- a/src/cairo-font-face.c
+++ b/src/cairo-font-face.c
@@ -41,6 +41,23 @@
 #include "cairoint.h"
 #include "cairo-error-private.h"
 
+/**
+ * SECTION:cairo-font-face
+ * @Title: cairo_font_face_t
+ * @Short_Description: Base class for font faces
+ * @See_Also: #cairo_scaled_font_t
+ *
+ * #cairo_font_face_t represents a particular font at a particular weight,
+ * slant, and other characteristic but no size, transformation, or size.
+ * 
+ * Font faces are created using <firstterm>font-backend</firstterm>-specific
+ * constructors, typically of the form
+ * cairo_<emphasis>backend</emphasis>_font_face_create(), or implicitly
+ * using the <firstterm>toy</firstterm> text API by way of 
+ * cairo_select_font_face().  The resulting face can be accessed using
+ * cairo_get_font_face().
+ */
+
 /* #cairo_font_face_t */
 
 const cairo_font_face_t _cairo_font_face_nil = {