Make docs a bit more complete

3 files changed, 45 insertions, 7 deletions

diff --git a/docs/tmpl/coretext-fonts.sgml b/docs/tmpl/coretext-fonts.sgml
new file mode 100644
index 00000000..69d5d029
--- /dev/null
+++ b/docs/tmpl/coretext-fonts.sgml
@@ -0,0 +1,40 @@
+<!-- ##### SECTION Title ##### -->
+CoreText Fonts
+
+<!-- ##### SECTION Short_Description ##### -->
+Font handling with CoreText fonts
+
+<!-- ##### SECTION Long_Description ##### -->
+<para>
+The macros and functions in this section are used to access fonts natively on
+OS X using the CoreText text rendering subsystem.
+</para>
+
+<!-- ##### SECTION See_Also ##### -->
+<para>
+
+</para>
+
+<!-- ##### SECTION Stability_Level ##### -->
+
+
+<!-- ##### SECTION Image ##### -->
+
+
+<!-- ##### MACRO PANGO_RENDER_TYPE_CORE_TEXT ##### -->
+<para>
+A string constant identifying the CoreText renderer. The associated quark (see
+g_quark_from_string()) is used to identify the renderer in pango_find_map().
+</para>
+
+
+
+<!-- ##### FUNCTION pango_core_text_font_get_ctfont ##### -->
+<para>
+
+</para>
+
+@font: 
+@Returns: 
+
+
diff --git a/docs/tmpl/text-attributes.sgml b/docs/tmpl/text-attributes.sgml
index 98158f80..d12c0414 100644
--- a/docs/tmpl/text-attributes.sgml
+++ b/docs/tmpl/text-attributes.sgml
@@ -578,12 +578,10 @@ The #PangoColor structure is used to
 represent a color in an uncalibrated RGB color-space.
 </para>
 
-@red: The red component of the color. This is a value between 0 and 65535, 
-      with 65535 indicating full intensity.
-@green: The green component of the color. This is a value between 0 and 65535, 
-      with 65535 indicating full intensity.
-@blue: The blue component of the color. This is a value between 0 and 65535, 
-      with 65535 indicating full intensity.
+@red: the red component of the color. This is a value between 0 and
+    65535, with 65535 indicating full intensity
+@green: the green component of the color
+@blue: the blue component of the color
 
 <!-- ##### MACRO PANGO_TYPE_COLOR ##### -->
 <para>
diff --git a/pango/pango-tabs.c b/pango/pango-tabs.c
index ce488173..6c4a7f31 100644
--- a/pango/pango-tabs.c
+++ b/pango/pango-tabs.c
@@ -103,7 +103,7 @@ pango_tab_array_new (gint initial_size,
  * @positions_in_pixels: whether positions are in pixel units
  * @first_alignment: alignment of first tab stop
  * @first_position: position of first tab stop
- * @varargs: additional alignment/position pairs
+ * @...: additional alignment/position pairs
  *
  * This is a convenience function that creates a #PangoTabArray
  * and allows you to specify the alignment and position of each