summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorBehdad Esfahbod <behdad@gnome.org>2005-11-17 04:56:14 +0000
committerBehdad Esfahbod <behdad@src.gnome.org>2005-11-17 04:56:14 +0000
commite1cfe6720d1fea7aa47882a31656b24da2a7380f (patch)
treeb28a047334662aa1317e312c3a10fbedab6e5a2a
parent2e44c9c2b46b896dfa867b749702e483eda0c3c1 (diff)
downloadpango-e1cfe6720d1fea7aa47882a31656b24da2a7380f.tar.gz
Various documentation improvements.
2005-11-16 Behdad Esfahbod <behdad@gnome.org> * docs/pango_markup.sgml docs/tmpl/coverage-maps.sgml docs/tmpl/engines.sgml docs/tmpl/fonts.sgml docs/tmpl/freetype-fonts.sgml docs/tmpl/glyphs.sgml docs/tmpl/layout.sgml docs/tmpl/main.sgml docs/tmpl/modules.sgml docs/tmpl/opentype.sgml docs/tmpl/pango-engine-lang.sgml docs/tmpl/pango-engine-shape.sgml docs/tmpl/pango-renderer.sgml docs/tmpl/pangocairo.sgml docs/tmpl/pangofc-decoder.sgml docs/tmpl/pangofc-font.sgml docs/tmpl/pangofc-fontmap.sgml docs/tmpl/scripts.sgml docs/tmpl/tab-stops.sgml docs/tmpl/text-attributes.sgml docs/tmpl/win32-fonts.sgml docs/tmpl/x-fonts.sgml docs/tmpl/xft-fonts.sgml pango/break.c pango/ellipsize.c pango/fonts.c pango/pango-attributes.c pango/pango-color.c pango/pango-context.c pango/pango-coverage.c pango/pango-fontmap.c pango/pango-glyph-item.c pango/pango-layout.c pango/pango-markup.c pango/pango-tabs.c pango/pango-types.h pango/pango-utils.c pango/pangoft2-render.c pango/pangox.c pango/pangoxft-render.c: Various documentation improvements.
-rw-r--r--ChangeLog25
-rw-r--r--docs/pango_markup.sgml4
-rw-r--r--docs/tmpl/coverage-maps.sgml3
-rw-r--r--docs/tmpl/engines.sgml3
-rw-r--r--docs/tmpl/fonts.sgml14
-rw-r--r--docs/tmpl/freetype-fonts.sgml3
-rw-r--r--docs/tmpl/glyphs.sgml17
-rw-r--r--docs/tmpl/layout.sgml9
-rw-r--r--docs/tmpl/main.sgml14
-rw-r--r--docs/tmpl/modules.sgml3
-rw-r--r--docs/tmpl/opentype.sgml11
-rw-r--r--docs/tmpl/pango-engine-lang.sgml3
-rw-r--r--docs/tmpl/pango-engine-shape.sgml3
-rw-r--r--docs/tmpl/pango-renderer.sgml3
-rw-r--r--docs/tmpl/pangocairo.sgml3
-rw-r--r--docs/tmpl/pangofc-decoder.sgml3
-rw-r--r--docs/tmpl/pangofc-font.sgml3
-rw-r--r--docs/tmpl/pangofc-fontmap.sgml3
-rw-r--r--docs/tmpl/scripts.sgml3
-rw-r--r--docs/tmpl/tab-stops.sgml7
-rw-r--r--docs/tmpl/text-attributes.sgml45
-rw-r--r--docs/tmpl/win32-fonts.sgml7
-rw-r--r--docs/tmpl/x-fonts.sgml7
-rw-r--r--docs/tmpl/xft-fonts.sgml3
-rw-r--r--pango/break.c4
-rw-r--r--pango/ellipsize.c8
-rw-r--r--pango/fonts.c18
-rw-r--r--pango/pango-attributes.c38
-rw-r--r--pango/pango-color.c2
-rw-r--r--pango/pango-context.c6
-rw-r--r--pango/pango-coverage.c2
-rw-r--r--pango/pango-fontmap.c6
-rw-r--r--pango/pango-glyph-item.c2
-rw-r--r--pango/pango-layout.c4
-rw-r--r--pango/pango-markup.c10
-rw-r--r--pango/pango-tabs.c27
-rw-r--r--pango/pango-types.h2
-rw-r--r--pango/pango-utils.c2
-rw-r--r--pango/pangoft2-render.c8
-rw-r--r--pango/pangox.c2
-rw-r--r--pango/pangoxft-render.c4
41 files changed, 155 insertions, 189 deletions
diff --git a/ChangeLog b/ChangeLog
index 29e521c3..f6c49f56 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,6 +1,25 @@
-2005-11-15 Behdad Esfahbod <behdad@gnome.org>
-
- * pango/pango-types.h: Added % to PANGO_DIRECTION_LTR in doc comments.
+2005-11-16 Behdad Esfahbod <behdad@gnome.org>
+
+ * docs/pango_markup.sgml docs/tmpl/coverage-maps.sgml
+ docs/tmpl/engines.sgml docs/tmpl/fonts.sgml
+ docs/tmpl/freetype-fonts.sgml docs/tmpl/glyphs.sgml
+ docs/tmpl/layout.sgml docs/tmpl/main.sgml
+ docs/tmpl/modules.sgml docs/tmpl/opentype.sgml
+ docs/tmpl/pango-engine-lang.sgml
+ docs/tmpl/pango-engine-shape.sgml
+ docs/tmpl/pango-renderer.sgml docs/tmpl/pangocairo.sgml
+ docs/tmpl/pangofc-decoder.sgml docs/tmpl/pangofc-font.sgml
+ docs/tmpl/pangofc-fontmap.sgml docs/tmpl/scripts.sgml
+ docs/tmpl/tab-stops.sgml docs/tmpl/text-attributes.sgml
+ docs/tmpl/win32-fonts.sgml docs/tmpl/x-fonts.sgml
+ docs/tmpl/xft-fonts.sgml pango/break.c pango/ellipsize.c
+ pango/fonts.c pango/pango-attributes.c pango/pango-color.c
+ pango/pango-context.c pango/pango-coverage.c
+ pango/pango-fontmap.c pango/pango-glyph-item.c
+ pango/pango-layout.c pango/pango-markup.c pango/pango-tabs.c
+ pango/pango-types.h pango/pango-utils.c
+ pango/pangoft2-render.c pango/pangox.c pango/pangoxft-render.c:
+ Various documentation improvements.
2005-11-15 Behdad Esfahbod <behdad@gnome.org>
diff --git a/docs/pango_markup.sgml b/docs/pango_markup.sgml
index 3b4c1a5c..72b0179d 100644
--- a/docs/pango_markup.sgml
+++ b/docs/pango_markup.sgml
@@ -1,12 +1,12 @@
<refentry id="PangoMarkupFormat" revision="11 Dec 2002">
<refmeta>
-<refentrytitle>Pango Text Attribute Markup</refentrytitle>
+<refentrytitle>Text Attribute Markup</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>Pango Library</refmiscinfo>
</refmeta>
<refnamediv>
-<refname>Pango Text Attribute Markup</refname><refpurpose>Simple
+<refname>Text Attribute Markup</refname><refpurpose>Simple
markup language to encode text with attributes</refpurpose>
</refnamediv>
diff --git a/docs/tmpl/coverage-maps.sgml b/docs/tmpl/coverage-maps.sgml
index 5dc89ff1..d673d65e 100644
--- a/docs/tmpl/coverage-maps.sgml
+++ b/docs/tmpl/coverage-maps.sgml
@@ -17,9 +17,6 @@ to represent that information.
</para>
-<!-- ##### SECTION Stability_Level ##### -->
-
-
<!-- ##### ENUM PangoCoverageLevel ##### -->
<para>
Used to indicate how well a font can represent a particular ISO 10646
diff --git a/docs/tmpl/engines.sgml b/docs/tmpl/engines.sgml
index 063c7454..fb7fdfd2 100644
--- a/docs/tmpl/engines.sgml
+++ b/docs/tmpl/engines.sgml
@@ -28,9 +28,6 @@ function is used when building a catalog of all available modules.
</para>
-<!-- ##### SECTION Stability_Level ##### -->
-
-
<!-- ##### STRUCT PangoEngineInfo ##### -->
<para>
The #PangoEngineInfo structure contains information about a particular
diff --git a/docs/tmpl/fonts.sgml b/docs/tmpl/fonts.sgml
index 4e5caa62..34232cfa 100644
--- a/docs/tmpl/fonts.sgml
+++ b/docs/tmpl/fonts.sgml
@@ -19,9 +19,6 @@ to load a font of a given description.
</para>
-<!-- ##### SECTION Stability_Level ##### -->
-
-
<!-- ##### STRUCT PangoFontDescription ##### -->
<para>
The #PangoFontDescription structure represents the description
@@ -535,7 +532,7 @@ pango_font_init() on the structure.
</para>
<para>
The #PangoFont structure contains one member
-which the implementation fills in:
+which the implementation fills in.
</para>
@@ -751,7 +748,8 @@ pointer to a appropriate #PangoFontMapClass, then call
pango_font_map_init() on the structure.
</para>
<para>
-The #PangoFont structure contains one member which the implementation fills in:
+The #PangoFontMap structure contains one member which the implementation
+fills in.
</para>
@@ -932,10 +930,10 @@ a particular #PangoFontset implementation.
<!-- ##### STRUCT PangoFontsetSimple ##### -->
<para>
-#PangoFontSetSimple is a implementation of the abstract
-#PangoFontSet base class in terms of an array of fonts,
+#PangoFontsetSimple is a implementation of the abstract
+#PangoFontset base class in terms of an array of fonts,
which the creator provides when constructing the
-#PangoFontSetSimple.
+#PangoFontsetSimple.
</para>
diff --git a/docs/tmpl/freetype-fonts.sgml b/docs/tmpl/freetype-fonts.sgml
index b554fe57..9877c200 100644
--- a/docs/tmpl/freetype-fonts.sgml
+++ b/docs/tmpl/freetype-fonts.sgml
@@ -14,9 +14,6 @@ Functions for shape engines to manipulate FreeType fonts
</para>
-<!-- ##### SECTION Stability_Level ##### -->
-
-
<!-- ##### STRUCT PangoFT2FontMap ##### -->
<para>
The #PangoFT2FontMap is the #PangoFontMap implementation for FreeType fonts.
diff --git a/docs/tmpl/glyphs.sgml b/docs/tmpl/glyphs.sgml
index 0f9c1bfe..a25e5895 100644
--- a/docs/tmpl/glyphs.sgml
+++ b/docs/tmpl/glyphs.sgml
@@ -17,15 +17,12 @@ glyphs.
</para>
-<!-- ##### SECTION Stability_Level ##### -->
-
-
<!-- ##### MACRO PANGO_SCALE ##### -->
<para>
-The PANGO_SCALE macro represents the scale between dimensions used
+The %PANGO_SCALE macro represents the scale between dimensions used
for Pango distances and device units. (The definition of device
units is dependent on the output device; it will typically be pixels
-for a screen, and points for a printer.) PANGO_SCALE is currently
+for a screen, and points for a printer.) %PANGO_SCALE is currently
1024, but this may be changed in the future.
</para>
<para>
@@ -214,12 +211,12 @@ information for a single glyph.
<!-- ##### TYPEDEF PangoGlyphUnit ##### -->
<para>
The #PangoGlyphUnit type is used to store dimensions within
-Pango. Dimensions are stored in 1/PANGO_SCALE of a device unit.
+Pango. Dimensions are stored in 1/%PANGO_SCALE of a device unit.
(A device unit might be a pixel for screen display, or
-a point on a printer.) PANGO_SCALE is currently 1024, and
-is unlikely to change, but you should not depend on its
-exact value. The PANGO_PIXELS() macro can be used to convert
-from glyph units into device units with correct rounding.
+a point on a printer.) %PANGO_SCALE is currently 1024, and
+may change in the future (unlikely though), but you should not
+depend on its exact value. The PANGO_PIXELS() macro can be used
+to convert from glyph units into device units with correct rounding.
</para>
diff --git a/docs/tmpl/layout.sgml b/docs/tmpl/layout.sgml
index 8b84b65d..d358115a 100644
--- a/docs/tmpl/layout.sgml
+++ b/docs/tmpl/layout.sgml
@@ -9,7 +9,7 @@ Highlevel layout driver objects
While complete access to the layout capabilities of Pango is provided
using the detailed interfaces for itemization and shaping, using
that functionality directly involves writing a fairly large amount
-of code. The objects and functions in this structure provide a
+of code. The objects and functions in this section provide a
high-level driver for formatting entire paragraphs of text
at once.
</para>
@@ -19,9 +19,6 @@ at once.
</para>
-<!-- ##### SECTION Stability_Level ##### -->
-
-
<!-- ##### STRUCT PangoLayout ##### -->
<para>
The #PangoLayout structure represents and entire paragraph
@@ -53,11 +50,11 @@ fields.
<!-- ##### STRUCT PangoLayoutIter ##### -->
<para>
-A <structname>PangoLayoutIter</structname> structure can be used to
+A #PangoLayoutIter structure can be used to
iterate over the visual extents of a #PangoLayout.
</para>
<para>
-The <structname>PangoLayoutIter</structname> structure is opaque, and
+The #PangoLayoutIter structure is opaque, and
has no user-visible fields.
</para>
diff --git a/docs/tmpl/main.sgml b/docs/tmpl/main.sgml
index 4f373d4b..0f5695f6 100644
--- a/docs/tmpl/main.sgml
+++ b/docs/tmpl/main.sgml
@@ -17,9 +17,6 @@ various steps of this process.
</para>
-<!-- ##### SECTION Stability_Level ##### -->
-
-
<!-- ##### STRUCT PangoContext ##### -->
<para>
The #PangoContext structure stores global information
@@ -296,6 +293,15 @@ The GObject type for #PangoDirection.
@Returns:
+<!-- ##### FUNCTION pango_unichar_direction ##### -->
+<para>
+
+</para>
+
+@ch:
+@Returns:
+
+
<!-- ##### FUNCTION pango_find_base_dir ##### -->
<para>
@@ -378,7 +384,7 @@ about the attributes of a single character.
(e.g. letter + diacritics) is considered a
unit, while in others, each decomposed
character in the grapheme is a unit. In the
- default implementation of #pango_break, this
+ default implementation of pango_break(), this
bit is set on all grapheme boundaries except
those following Latin, Cyrillic or Greek base
characters.
diff --git a/docs/tmpl/modules.sgml b/docs/tmpl/modules.sgml
index a4dd32ac..2d74a8ad 100644
--- a/docs/tmpl/modules.sgml
+++ b/docs/tmpl/modules.sgml
@@ -14,9 +14,6 @@ Support for loadable modules
</para>
-<!-- ##### SECTION Stability_Level ##### -->
-
-
<!-- ##### STRUCT PangoIncludedModule ##### -->
<para>
The #PangoIncludedModule structure for a statically linked module
diff --git a/docs/tmpl/opentype.sgml b/docs/tmpl/opentype.sgml
index fde93bee..8cfe4405 100644
--- a/docs/tmpl/opentype.sgml
+++ b/docs/tmpl/opentype.sgml
@@ -14,9 +14,6 @@ Obtaining information from OpenType tables
</para>
-<!-- ##### SECTION Stability_Level ##### -->
-
-
<!-- ##### TYPEDEF PangoOTTag ##### -->
<para>
The <type>PangoOTTag</type> typedef is used to represent TrueType and OpenType
@@ -28,10 +25,10 @@ create <type>PangoOTTag</type>s manually.
<!-- ##### STRUCT PangoOTInfo ##### -->
<para>
-The <structname>PangoOTInfo</structname> struct contains the various
+The #PangoOTInfo struct contains the various
tables associated with an OpenType font. It contains only private fields and
should only be accessed via the <function>pango_ot_info_*</function> functions
-which are documented below. To obtain a <structname>PangoOTInfo</structname>,
+which are documented below. To obtain a #PangoOTInfo,
use pango_ot_info_new().
</para>
@@ -56,11 +53,11 @@ use pango_ot_info_new().
<!-- ##### STRUCT PangoOTRuleset ##### -->
<para>
-The <structname>PangoOTRuleSet</structname> structure holds a
+The #PangoOTRuleSet structure holds a
set of features selected from the tables in an OpenType font.
(A feature is an operation such as adjusting glyph positioning
that should be applied to a text feature such as a certain
-type of accent.) A <structname>PangoOTRuleSet</structname>
+type of accent.) A #PangoOTRuleSet
is created with pango_ot_ruleset_new(), features are addded
to it with pango_ot_ruleset_add_feature(), then it is
applied to a #PangoGlyphString with pango_ot_ruleset_shape().
diff --git a/docs/tmpl/pango-engine-lang.sgml b/docs/tmpl/pango-engine-lang.sgml
index 42ddfb07..79b08f21 100644
--- a/docs/tmpl/pango-engine-lang.sgml
+++ b/docs/tmpl/pango-engine-lang.sgml
@@ -14,9 +14,6 @@ Rendering-system independent script engines
</para>
-<!-- ##### SECTION Stability_Level ##### -->
-
-
<!-- ##### STRUCT PangoEngineLang ##### -->
<para>
</para>
diff --git a/docs/tmpl/pango-engine-shape.sgml b/docs/tmpl/pango-engine-shape.sgml
index 8b6c8b98..d1aff7d0 100644
--- a/docs/tmpl/pango-engine-shape.sgml
+++ b/docs/tmpl/pango-engine-shape.sgml
@@ -14,9 +14,6 @@ Rendering-system dependent script engines
</para>
-<!-- ##### SECTION Stability_Level ##### -->
-
-
<!-- ##### STRUCT PangoEngineShape ##### -->
<para>
</para>
diff --git a/docs/tmpl/pango-renderer.sgml b/docs/tmpl/pango-renderer.sgml
index 5ffd48bc..f88a679b 100644
--- a/docs/tmpl/pango-renderer.sgml
+++ b/docs/tmpl/pango-renderer.sgml
@@ -18,9 +18,6 @@ destinations can be created.
</para>
-<!-- ##### SECTION Stability_Level ##### -->
-
-
<!-- ##### STRUCT PangoRenderer ##### -->
<para>
diff --git a/docs/tmpl/pangocairo.sgml b/docs/tmpl/pangocairo.sgml
index da1d7e3f..0c58c923 100644
--- a/docs/tmpl/pangocairo.sgml
+++ b/docs/tmpl/pangocairo.sgml
@@ -139,9 +139,6 @@ int main (int argc, char **argv)
</para>
-<!-- ##### SECTION Stability_Level ##### -->
-
-
<!-- ##### STRUCT PangoCairoFontMap ##### -->
<para>
diff --git a/docs/tmpl/pangofc-decoder.sgml b/docs/tmpl/pangofc-decoder.sgml
index b8191c73..ad033b6a 100644
--- a/docs/tmpl/pangofc-decoder.sgml
+++ b/docs/tmpl/pangofc-decoder.sgml
@@ -15,9 +15,6 @@ for handling a font that is encoded in a custom way.
</para>
-<!-- ##### SECTION Stability_Level ##### -->
-
-
<!-- ##### STRUCT PangoFcDecoder ##### -->
<para>
diff --git a/docs/tmpl/pangofc-font.sgml b/docs/tmpl/pangofc-font.sgml
index 6bea63f4..c87b2617 100644
--- a/docs/tmpl/pangofc-font.sgml
+++ b/docs/tmpl/pangofc-font.sgml
@@ -31,9 +31,6 @@ Fontconfig-based backend involves deriving from both
</variablelist>
</para>
-<!-- ##### SECTION Stability_Level ##### -->
-
-
<!-- ##### STRUCT PangoFcFont ##### -->
<para>
diff --git a/docs/tmpl/pangofc-fontmap.sgml b/docs/tmpl/pangofc-fontmap.sgml
index e24dc050..34c99b77 100644
--- a/docs/tmpl/pangofc-fontmap.sgml
+++ b/docs/tmpl/pangofc-fontmap.sgml
@@ -31,9 +31,6 @@ Fontconfig-based backend involves deriving from both
</variablelist>
</para>
-<!-- ##### SECTION Stability_Level ##### -->
-
-
<!-- ##### STRUCT PangoFcFontMap ##### -->
<para>
diff --git a/docs/tmpl/scripts.sgml b/docs/tmpl/scripts.sgml
index 6c6fd580..f68c9341 100644
--- a/docs/tmpl/scripts.sgml
+++ b/docs/tmpl/scripts.sgml
@@ -16,9 +16,6 @@ and of ranges within a larger text string.
</para>
-<!-- ##### SECTION Stability_Level ##### -->
-
-
<!-- ##### STRUCT PangoScriptIter ##### -->
<para>
diff --git a/docs/tmpl/tab-stops.sgml b/docs/tmpl/tab-stops.sgml
index d131b162..b06289b8 100644
--- a/docs/tmpl/tab-stops.sgml
+++ b/docs/tmpl/tab-stops.sgml
@@ -2,7 +2,7 @@
Tab Stops
<!-- ##### SECTION Short_Description ##### -->
-Structures for storing Tab Stops
+Structures for storing tab stops
<!-- ##### SECTION Long_Description ##### -->
<para>
@@ -14,12 +14,9 @@ Structures for storing Tab Stops
</para>
-<!-- ##### SECTION Stability_Level ##### -->
-
-
<!-- ##### STRUCT PangoTabArray ##### -->
<para>
-A <structname>PangoTabArray</structname> struct contains an array
+A #PangoTabArray struct contains an array
of tab stops. Each tab stop has an alignment and a position.
</para>
diff --git a/docs/tmpl/text-attributes.sgml b/docs/tmpl/text-attributes.sgml
index f69700f7..8d56424b 100644
--- a/docs/tmpl/text-attributes.sgml
+++ b/docs/tmpl/text-attributes.sgml
@@ -18,11 +18,9 @@ of attributes applied to a portion of text.
</para>
-<!-- ##### SECTION Stability_Level ##### -->
-
-
<!-- ##### ENUM PangoAttrType ##### -->
<para>
+The #PangoAttrType
distinguishes between different types of attributes. Along with the
predefined values, it is possible to allocate additional values
for custom attributes using pango_attr_type_register(). The predefined
@@ -37,7 +35,7 @@ attribute is listed in parentheses after the description.
@PANGO_ATTR_WEIGHT: font weight (#PangoAttrInt)
@PANGO_ATTR_VARIANT: font variant (normal or small caps) (#PangoAttrInt)
@PANGO_ATTR_STRETCH: font stretch (#PangoAttrInt)
-@PANGO_ATTR_SIZE: font size in points divided by PANGO_SCALE (#PangoAttrInt)
+@PANGO_ATTR_SIZE: font size in points divided by %PANGO_SCALE (#PangoAttrInt)
@PANGO_ATTR_FONT_DESC: font description (#PangoAttrFontDesc)
@PANGO_ATTR_FOREGROUND: foreground color (#PangoAttrColor)
@PANGO_ATTR_BACKGROUND: background color (#PangoAttrColor)
@@ -45,7 +43,7 @@ attribute is listed in parentheses after the description.
@PANGO_ATTR_STRIKETHROUGH: whether the text is struck-through (#PangoAttrInt)
@PANGO_ATTR_RISE: baseline displacement (#PangoAttrInt)
@PANGO_ATTR_SHAPE: shape (#PangoAttrShape)
-@PANGO_ATTR_SCALE: font size scale factor (#PangoAttrScale)
+@PANGO_ATTR_SCALE: font size scale factor (#PangoAttrFloat)
@PANGO_ATTR_FALLBACK: whether fallback is enabled (#PangoAttrInt)
@PANGO_ATTR_LETTER_SPACING:
@PANGO_ATTR_UNDERLINE_COLOR:
@@ -84,7 +82,7 @@ applies.
@klass: the class structure holding information about the type of the attribute
@start_index: the start index of the range (in bytes).
@end_index: end index of the range (in bytes). The character at this index
- not included in the range.
+ is not included in the range.
<!-- ##### STRUCT PangoAttrString ##### -->
<para>
@@ -97,7 +95,7 @@ a string value.
<!-- ##### STRUCT PangoAttrLanguage ##### -->
<para>
-The #PangoAttrColor structure is used to represent attributes that
+The #PangoAttrLanguage structure is used to represent attributes that
are languages.
</para>
@@ -116,7 +114,7 @@ are colors.
<!-- ##### STRUCT PangoAttrInt ##### -->
<para>
The #PangoAttrInt structure is used to represent attributes with
-a integer or enumeration value.
+an integer or enumeration value.
</para>
@attr: the common portion of the attribute
@@ -160,12 +158,12 @@ set font size.
</para>
@attr: the common portion of the attribute
-@size: size of font, in units of 1/PANGO_SCALE of a point (for
- PANGO_ATTR_SIZE) or of a device uni (for PANGO_ATTR_ABSOLUTE_SIZE)
+@size: size of font, in units of 1/%PANGO_SCALE of a point (for
+ %PANGO_ATTR_SIZE) or of a device uni (for %PANGO_ATTR_ABSOLUTE_SIZE)
@absolute: whether the font size is in device units or points.
This field is only present for compatibility with Pango-1.8.0
- (PANGO_ATTR_ABSOLUTE_SIZE was added in 1.8.1); and always will
- be %FALSE for PANGO_ATTR_SIZE and %TRUE for PANGO_ATTR_ABSOLUTE_SIZE.
+ (%PANGO_ATTR_ABSOLUTE_SIZE was added in 1.8.1); and always will
+ be %FALSE for %PANGO_ATTR_SIZE and %TRUE for %PANGO_ATTR_ABSOLUTE_SIZE.
<!-- ##### FUNCTION pango_parse_markup ##### -->
<para>
@@ -368,9 +366,9 @@ whether text should be underlined, and if so, the type
of underlining.
</para>
-@PANGO_UNDERLINE_NONE: no underline should be drawn.
-@PANGO_UNDERLINE_SINGLE: a single underline should be drawn.
-@PANGO_UNDERLINE_DOUBLE: a double underline should be drawn.
+@PANGO_UNDERLINE_NONE: no underline should be drawn
+@PANGO_UNDERLINE_SINGLE: a single underline should be drawn
+@PANGO_UNDERLINE_DOUBLE: a double underline should be drawn
@PANGO_UNDERLINE_LOW: a single underline should be drawn at a position
beneath the ink extents of the text being
underlined. This should be used only for underlining
@@ -380,7 +378,7 @@ of underlining.
@PANGO_UNDERLINE_ERROR: a wavy underline should be drawn below.
This underline is typically used to indicate
an error such as a possilble mispelling; in some
- cases an contrasting color may automatically
+ cases a contrasting color may automatically
be used. This type of underlining is available
since Pango 1.4.
@@ -416,11 +414,12 @@ The GObject type for #PangoUnderline.
<!-- ##### USER_FUNCTION PangoAttrDataCopyFunc ##### -->
<para>
-
+A copy function passed to attribute new functions that take
+user data.
</para>
-@data:
-@Returns:
+@data: the user data
+@Returns: a new copy of @data.
<!-- ##### FUNCTION pango_attr_scale_new ##### -->
@@ -510,7 +509,7 @@ The scale factor for three magnification steps (1.2 * 1.2 * 1.2).
<!-- ##### STRUCT PangoColor ##### -->
<para>
-The <structname>PangoColor</structname> structure is used to
+The #PangoColor structure is used to
represent a color in an uncalibrated RGB colorspace.
</para>
@@ -557,11 +556,11 @@ The GObject type for #PangoColor.
<!-- ##### STRUCT PangoLanguage ##### -->
<para>
-The <structname>PangoLanguage</structname> structure is used to
+The #PangoLanguage structure is used to
represent a language.
</para>
<para>
-<structname>PangoLanguage</structname> pointers can be efficiently
+#PangoLanguage pointers can be efficiently
copied and compared with each other.
</para>
@@ -730,7 +729,7 @@ to filter out a subset of attributes for a list.
<!-- ##### STRUCT PangoAttrIterator ##### -->
<para>
The #PangoAttrIterator structure is used to represent an
-iterator through a #PangoList. A new iterator is created
+iterator through a #PangoAttrList. A new iterator is created
with pango_attr_list_get_iterator(). Once the iterator
is created, it can be advanced through the style changes
in the text using pango_attr_iterator_next(). At each
diff --git a/docs/tmpl/win32-fonts.sgml b/docs/tmpl/win32-fonts.sgml
index 50a9133f..d0aca19f 100644
--- a/docs/tmpl/win32-fonts.sgml
+++ b/docs/tmpl/win32-fonts.sgml
@@ -14,9 +14,6 @@ Functions for shape engines to manipulate Win32 fonts
</para>
-<!-- ##### SECTION Stability_Level ##### -->
-
-
<!-- ##### MACRO PANGO_RENDER_TYPE_WIN32 ##### -->
<para>
A string constant identifying the Win32 renderer. The associated quark (see
@@ -145,8 +142,8 @@ g_quark_from_string()) is used to identify the renderer in pango_find_map().
<!-- ##### STRUCT PangoWin32FontCache ##### -->
<para>
-A <structname>PangoWin32FontCache</structname> caches
-<structname>HFONT</structname>s by their <structname>LOGFONT</structname> descriptions.
+A #PangoWin32FontCache caches
+#HFONTs by their #LOGFONT descriptions.
</para>
diff --git a/docs/tmpl/x-fonts.sgml b/docs/tmpl/x-fonts.sgml
index ee19346b..875fa26b 100644
--- a/docs/tmpl/x-fonts.sgml
+++ b/docs/tmpl/x-fonts.sgml
@@ -17,9 +17,6 @@ unpredictable results. Use the <link linkend="pango-Xft-Fonts-and-Rendering">Xft
</para>
-<!-- ##### SECTION Stability_Level ##### -->
-
-
<!-- ##### MACRO PANGO_RENDER_TYPE_X ##### -->
<para>
A string constant identifying the X renderer. The associated quark (see
@@ -269,8 +266,8 @@ glyph index.
<!-- ##### STRUCT PangoXFontCache ##### -->
<para>
-A <structname>PangoXFontCache</structname> caches
-<structname>XFontStruct</structname>s for a single display by their XLFD name.
+A #PangoXFontCache caches
+#XFontStructs for a single display by their XLFD name.
</para>
diff --git a/docs/tmpl/xft-fonts.sgml b/docs/tmpl/xft-fonts.sgml
index a572c94b..fc4d6cae 100644
--- a/docs/tmpl/xft-fonts.sgml
+++ b/docs/tmpl/xft-fonts.sgml
@@ -39,9 +39,6 @@ overring the #PangoXftRendererClass virtual functions
</para>
-<!-- ##### SECTION Stability_Level ##### -->
-
-
<!-- ##### STRUCT PangoXftFont ##### -->
<para>
diff --git a/pango/break.c b/pango/break.c
index 3d0a2996..158fb362 100644
--- a/pango/break.c
+++ b/pango/break.c
@@ -494,7 +494,7 @@ typedef enum
* engine overrides it. Normally you should use pango_break()
* instead; this function is mostly useful for chaining up
* from a language engine override. Unlike pango_break(),
- * @analysis can be NULL, but only do that if you know what
+ * @analysis can be %NULL, but only do that if you know what
* you're doing. (If you need an analysis to pass to pango_break(),
* you need to pango_itemize() or use pango_get_log_attrs().)
*
@@ -515,7 +515,7 @@ pango_default_break (const gchar *text,
*/
/* FIXME one cheesy optimization here would be to memset attrs to 0
- * before we start, and then never assign FALSE to anything
+ * before we start, and then never assign %FALSE to anything
*/
const gchar *next;
diff --git a/pango/ellipsize.c b/pango/ellipsize.c
index 8a7b190a..d81b9e76 100644
--- a/pango/ellipsize.c
+++ b/pango/ellipsize.c
@@ -84,11 +84,11 @@ struct _EllipsizeState
RunInfo *run_info; /* Array of information about each run */
int n_runs;
- int total_width; /* Original width of line in pango units */
+ int total_width; /* Original width of line in Pango units */
int gap_center; /* Goal for center of gap */
PangoGlyphItem *ellipsis_run; /* Run created to hold ellipsis */
- int ellipsis_width; /* Width of ellipsis, in pango units */
+ int ellipsis_width; /* Width of ellipsis, in Pango units */
int ellipsis_is_cjk; /* Whether the first character in the ellipsized
* is wide; this triggers us to try to use a
* mid-line ellipsis instead of a baseline
@@ -97,12 +97,12 @@ struct _EllipsizeState
PangoAttrIterator *line_start_attr; /* Cached PangoAttrIterator for the start of the run */
LineIter gap_start_iter; /* Iteratator pointig to the first cluster in gap */
- int gap_start_x; /* x position of start of gap, in pango units */
+ int gap_start_x; /* x position of start of gap, in Pango units */
PangoAttrIterator *gap_start_attr; /* Attribute iterator pointing to a range containing
* the first character in gap */
LineIter gap_end_iter; /* Iterator pointing to last cluster in gap */
- int gap_end_x; /* x position of end of gap, in pango units */
+ int gap_end_x; /* x position of end of gap, in Pango units */
};
/* Compute global information needed for the itemization process
diff --git a/pango/fonts.c b/pango/fonts.c
index f41a4292..e0679a9a 100644
--- a/pango/fonts.c
+++ b/pango/fonts.c
@@ -379,7 +379,7 @@ pango_font_description_get_size (const PangoFontDescription *desc)
/**
* pango_font_description_set_absolute_size:
* @desc: a #PangoFontDescription
- * @size: the new size, in pango units. There are #PANGO_SCALE Pango units in one
+ * @size: the new size, in Pango units. There are #PANGO_SCALE Pango units in one
* device unit. For an output backend where a device unit is a pixel, a @size
* value of 10 * PANGO_SCALE gives a 10 pixel font.
*
@@ -447,7 +447,7 @@ pango_font_description_get_set_fields (const PangoFontDescription *desc)
* settings for those fields, to clear a family name set with
* pango_font_description_set_family_static() so that it won't
* be returned by subsequent calls to pango_font_description_get_family(),
- * you must actually call pango_font_description_set_family (desc, NULL);
+ * you must actually call pango_font_description_set_family (desc, %NULL);
**/
void
pango_font_description_unset_fields (PangoFontDescription *desc,
@@ -1141,7 +1141,7 @@ pango_font_get_coverage (PangoFont *font,
* pango_font_find_shaper:
* @font: a #PangoFont
* @language: the language tag
- * @ch: the ISO-10646 character code.
+ * @ch: a unicode character.
*
* Finds the best matching shaper for a font for a particular
* language tag and character point.
@@ -1310,7 +1310,7 @@ pango_font_metrics_unref (PangoFontMetrics *metrics)
* actual drawn ink. It is necessary to lay out the text to figure
* where the ink will be.)
*
- * Return value: the ascent, in pango units. (1 point == #PANGO_SCALE pango units.)
+ * Return value: the ascent, in Pango units. (1 point == #PANGO_SCALE Pango units.)
**/
int
pango_font_metrics_get_ascent (PangoFontMetrics *metrics)
@@ -1330,7 +1330,7 @@ pango_font_metrics_get_ascent (PangoFontMetrics *metrics)
* actual drawn ink. It is necessary to lay out the text to figure
* where the ink will be.)
*
- * Return value: the descent, in pango units. (1 point == #PANGO_SCALE pango units.)
+ * Return value: the descent, in Pango units. (1 point == #PANGO_SCALE Pango units.)
**/
int
pango_font_metrics_get_descent (PangoFontMetrics *metrics)
@@ -1349,7 +1349,7 @@ pango_font_metrics_get_descent (PangoFontMetrics *metrics)
* determining the initial size for a window. Actual characters in
* text will be wider and narrower than this.
*
- * Return value: the character width, in pango units. (1 point == #PANGO_SCALE pango units.)
+ * Return value: the character width, in Pango units. (1 point == #PANGO_SCALE Pango units.)
**/
int
pango_font_metrics_get_approximate_char_width (PangoFontMetrics *metrics)
@@ -1370,7 +1370,7 @@ pango_font_metrics_get_approximate_char_width (PangoFontMetrics *metrics)
* is generally somewhat more accurate than the result of
* pango_font_metrics_get_approximate_digit_width().
*
- * Return value: the digit width, in pango units. (1 point == #PANGO_SCALE pango units.)
+ * Return value: the digit width, in Pango units. (1 point == #PANGO_SCALE Pango units.)
**/
int
pango_font_metrics_get_approximate_digit_width (PangoFontMetrics *metrics)
@@ -1532,7 +1532,7 @@ pango_font_family_list_faces (PangoFontFamily *family,
* of pango_font_metrics_get_approximate_char_width() may be affected
* by double-width characters.
*
- * Return value: TRUE if the family is monospace.
+ * Return value: %TRUE if the family is monospace.
**/
gboolean
pango_font_family_is_monospace (PangoFontFamily *family)
@@ -1611,7 +1611,7 @@ pango_font_face_get_face_name (PangoFontFace *face)
* List the available sizes for a font. This is only applicable to bitmap
* fonts. For scalable fonts, stores %NULL at the location pointed to by
* @sizes and 0 at the location pointed to by @n_sizes. The sizes returned
- * are in pango units and are sorted in ascending order.
+ * are in Pango units and are sorted in ascending order.
*
* Since: 1.4
**/
diff --git a/pango/pango-attributes.c b/pango/pango-attributes.c
index c4b8cd93..7af76c06 100644
--- a/pango/pango-attributes.c
+++ b/pango/pango-attributes.c
@@ -72,11 +72,11 @@ pango_attr_type_register (const gchar *name)
/**
* pango_attribute_copy:
- * @attr: a #PangoAttribute.
+ * @attr: a #PangoAttribute
*
* Make a copy of an attribute.
*
- * Return value: a newly allocated #PangoAttribute.
+ * Return value: the new #PangoAttribute.
**/
PangoAttribute *
pango_attribute_copy (const PangoAttribute *attr)
@@ -595,13 +595,13 @@ pango_attr_font_desc_equal (const PangoAttribute *attr1,
/**
* pango_attr_font_desc_new:
- * @desc:
+ * @desc: the font description
*
- * Create a new font description attribute. (This attribute
+ * Create a new font description attribute. This attribute
* allows setting family, style, weight, variant, stretch,
- * and size simultaneously.)
+ * and size simultaneously.
*
- * Return value:
+ * Return value: the new #PangoAttribute.
**/
PangoAttribute *
pango_attr_font_desc_new (const PangoFontDescription *desc)
@@ -625,7 +625,7 @@ pango_attr_font_desc_new (const PangoFontDescription *desc)
* pango_attr_underline_new:
* @underline: the underline style.
*
- * Create a new underline-style object.
+ * Create a new underline-style attribute.
*
* Return value: the new #PangoAttribute.
**/
@@ -673,7 +673,7 @@ pango_attr_underline_color_new (guint16 red,
* pango_attr_strikethrough_new:
* @strikethrough: %TRUE if the text should be struck-through.
*
- * Create a new font strike-through attribute.
+ * Create a new strike-through attribute.
*
* Return value: the new #PangoAttribute.
**/
@@ -859,19 +859,19 @@ pango_attr_shape_equal (const PangoAttribute *attr1,
/**
* pango_attr_shape_new_with_data:
* @ink_rect: ink rectangle to assign to each character
- * @logical_rect: logical rectangle assign to each character
+ * @logical_rect: logical rectangle to assign to each character
* @data: user data pointer
* @copy_func: function to copy @data when the attribute
* is copied. If %NULL, @data is simply copied
* as a pointer.
* @destroy_func: function to free @data when the attribute
- * is freed, or %NULL.
+ * is freed, or %NULL
*
* Like pango_attr_shape_new(), but a user data pointer is also
- * provided; this pointer can be accessed when rendering later
+ * provided; this pointer can be accessed when later
* rendering the glyph.
*
- * Return value: the newly created attribute
+ * Return value: the new #PangoAttribute.
*
* Since: 1.8
**/
@@ -908,14 +908,14 @@ pango_attr_shape_new_with_data (const PangoRectangle *ink_rect,
/**
* pango_attr_shape_new:
* @ink_rect: ink rectangle to assign to each character
- * @logical_rect: logical rectangle assign to each character
+ * @logical_rect: logical rectangle to assign to each character
*
* Create a new shape attribute. A shape is used to impose a
* particular ink and logical rect on the result of shaping a
* particular glyph. This might be used, for instance, for
* embedding a picture or a widget inside a PangoLayout.
*
- * Return value: the newly created attribute
+ * Return value: the new #PangoAttribute
**/
PangoAttribute *
pango_attr_shape_new (const PangoRectangle *ink_rect,
@@ -946,7 +946,7 @@ pango_attr_list_get_type (void)
*
* Create a new empty attribute list with a reference count of 1.
*
- * Return value: the newly allocated #PangoAttrList.
+ * Return value: new #PangoAttrList.
**/
PangoAttrList *
pango_attr_list_new (void)
@@ -966,7 +966,9 @@ pango_attr_list_new (void)
*
* Increase the reference count of the given attribute list by one.
*
- * Return value: The attribute list passed in (since 1.10)
+ * Return value: The attribute list passed in
+ *
+ * Since: 1.10
**/
PangoAttrList *
pango_attr_list_ref (PangoAttrList *list)
@@ -1618,7 +1620,7 @@ pango_attr_iterator_get (PangoAttrIterator *iterator,
* @iterator: a #PangoAttrIterator
* @desc: a #PangoFontDescription to fill in with the current values.
* The family name in this structure will be set using
- * pango_font_description_set_family_static using values from
+ * pango_font_description_set_family_static() using values from
* an attribute in the #PangoAttrList associated with the iterator,
* so if you plan to keep it around, you must call:
* <literal>pango_font_description_set_family (desc, pango_font_description_get_family (desc))</literal>.
@@ -1778,7 +1780,7 @@ pango_attr_iterator_get_font (PangoAttrIterator *iterator,
* of @list for which @func returns %TRUE and inserts them into
* a new list.
*
- * Return value: a newly allocated #PangoAttrList or %NULL if
+ * Return value: the new #PangoAttrList or %NULL if
* no attributes of the given types were found.
**/
PangoAttrList *
diff --git a/pango/pango-color.c b/pango/pango-color.c
index 18f18392..3c0c8a1a 100644
--- a/pango/pango-color.c
+++ b/pango/pango-color.c
@@ -47,7 +47,7 @@ pango_color_get_type (void)
* not that useful otherwise (since colors can just be copied
* by assignment in C).
*
- * Return value: an allocated #PangoColor
+ * Return value: the new #PangoColor
**/
PangoColor*
pango_color_copy (const PangoColor *src)
diff --git a/pango/pango-context.c b/pango/pango-context.c
index a064c807..de53ceac 100644
--- a/pango/pango-context.c
+++ b/pango/pango-context.c
@@ -1154,7 +1154,7 @@ itemize_state_finish (ItemizeState *state)
* This must be >= 0.
* @base_dir: base direction to use for bidirectional processing
* @attrs: the set of attributes that apply to @text.
- * @cached_iter: Cached attribute iterator, or NULL
+ * @cached_iter: Cached attribute iterator, or %NULL
*
* Like pango_itemize(), but the base direction to use when
* computing bidirectional levels (see pango_context_set_base_dir ()),
@@ -1227,7 +1227,7 @@ itemize_with_font (PangoContext *context,
* after @start_index.
* This must be >= 0.
* @attrs: the set of attributes that apply to @text.
- * @cached_iter: Cached attribute iterator, or NULL
+ * @cached_iter: Cached attribute iterator, or %NULL
*
* Breaks a piece of text into segments with consistent
* directional level and shaping engine. Each byte of @text will
@@ -1349,7 +1349,7 @@ update_metrics_from_items (PangoFontMetrics *metrics,
* The process of determining such metrics is slow, so it is best
* to always make sure some real language tag will be used.
*
- * Get overall metric information for a font particular font
+ * Get overall metric information for a particular font
* description. Since the metrics may be substantially different for
* different scripts, a language tag can be provided to indicate that
* the metrics should be retrieved that correspond to the script(s)
diff --git a/pango/pango-coverage.c b/pango/pango-coverage.c
index 5fd7ccab..615d152e 100644
--- a/pango/pango-coverage.c
+++ b/pango/pango-coverage.c
@@ -439,7 +439,7 @@ pango_coverage_get_uint32 (guchar **ptr)
* Convert data generated from pango_converage_to_bytes() back
* to a #PangoCoverage
*
- * Return value: a newly allocated #PangoCoverage, or NULL if
+ * Return value: a newly allocated #PangoCoverage, or %NULL if
* the data was invalid.
**/
PangoCoverage *
diff --git a/pango/pango-fontmap.c b/pango/pango-fontmap.c
index c518ae74..1e5ae738 100644
--- a/pango/pango-fontmap.c
+++ b/pango/pango-fontmap.c
@@ -66,9 +66,9 @@ pango_font_map_load_font (PangoFontMap *fontmap,
/**
* pango_font_map_list_families:
* @fontmap: a #PangoFontMap
- * @families: location to store a pointer to an array of PangoFontFamily *.
+ * @families: location to store a pointer to an array of #PangoFontFamily *.
* This array should be freed with g_free().
- * @n_families: location to store the number of elements in @descs
+ * @n_families: location to store the number of elements in @families
*
* List all families for a fontmap.
**/
@@ -230,7 +230,7 @@ pango_font_map_real_load_fontset (PangoFontMap *fontmap,
/**
* pango_font_map_get_shape_engine_type:
- * @fontmap: a #PangoFontmap
+ * @fontmap: a #PangoFontMap
*
* Returns the render ID for shape engines for this fontmap.
* See the <structfield>render_type</structfield> field of
diff --git a/pango/pango-glyph-item.c b/pango/pango-glyph-item.c
index 065871f8..b774add8 100644
--- a/pango/pango-glyph-item.c
+++ b/pango/pango-glyph-item.c
@@ -594,7 +594,7 @@ pango_glyph_item_apply_attrs (PangoGlyphItem *glyph_item,
* negative values will give ugly results.
*
* Adds spacing between the graphemes of @glyph_item to
- * give the effect of typographic letter spacing.b
+ * give the effect of typographic letter spacing.
*
* Since: 1.6
**/
diff --git a/pango/pango-layout.c b/pango/pango-layout.c
index c4aa2bfe..bc60f4e8 100644
--- a/pango/pango-layout.c
+++ b/pango/pango-layout.c
@@ -362,7 +362,7 @@ pango_layout_get_wrap (PangoLayout *layout)
* @layout: a #PangoLayout.
* @indent: the amount by which to indentset
*
- * Sets the width in pango units to indent each paragraph. A negative value
+ * Sets the width in Pango units to indent each paragraph. A negative value
* of @indent will produce a hanging indent. That is, the first line will
* have the full width, and subsequent lines will be indented by the
* absolute value of @indent.
@@ -384,7 +384,7 @@ pango_layout_set_indent (PangoLayout *layout,
* pango_layout_get_indent:
* @layout: a #PangoLayout
*
- * Gets the paragraph indent width in pango units. A negative value
+ * Gets the paragraph indent width in Pango units. A negative value
* indicates a hanging indent.
*
* Return value: the indent
diff --git a/pango/pango-markup.c b/pango/pango-markup.c
index bd268d6b..a8c2996b 100644
--- a/pango/pango-markup.c
+++ b/pango/pango-markup.c
@@ -552,10 +552,10 @@ static const GMarkupParser pango_markup_parser = {
* @markup_text: markup to parse (see <link linkend="PangoMarkupFormat">markup format</link>)
* @length: length of @markup_text, or -1 if nul-terminated
* @accel_marker: character that precedes an accelerator, or 0 for none
- * @attr_list: address of return location for a #PangoAttrList, or NULL
- * @text: address of return location for text with tags stripped, or NULL
- * @accel_char: address of return location for accelerator char, or NULL
- * @error: address of return location for errors, or NULL
+ * @attr_list: address of return location for a #PangoAttrList, or %NULL
+ * @text: address of return location for text with tags stripped, or %NULL
+ * @accel_char: address of return location for accelerator char, or %NULL
+ * @error: address of return location for errors, or %NULL
*
*
* Parses marked-up text (see
@@ -570,7 +570,7 @@ static const GMarkupParser pango_markup_parser = {
* Two @accel_marker characters following each other produce a single
* literal @accel_marker character.
*
- * Return value: FALSE if @error is set, otherwise TRUE
+ * Return value: %FALSE if @error is set, otherwise %TRUE
**/
gboolean
pango_parse_markup (const char *markup_text,
diff --git a/pango/pango-tabs.c b/pango/pango-tabs.c
index 09eeefb8..5728733b 100644
--- a/pango/pango-tabs.c
+++ b/pango/pango-tabs.c
@@ -59,10 +59,10 @@ init_tabs (PangoTabArray *array, gint start, gint end)
* @positions_in_pixels: whether positions are in pixel units
*
* Creates an array of @initial_size tab stops. Tab stops are specified in
- * pixel units if @positions_in_pixels is TRUE, otherwise in Pango
+ * pixel units if @positions_in_pixels is %TRUE, otherwise in Pango
* units. All stops are initially at position 0.
*
- * Return value: a #PangoTabArray
+ * Return value: the new #PangoTabArray
**/
PangoTabArray*
pango_tab_array_new (gint initial_size,
@@ -107,7 +107,7 @@ pango_tab_array_new (gint initial_size,
* tab stop. You <emphasis>must</emphasis> provide an alignment
* and position for @size tab stops.
*
- * Return value: a new #PangoTabArray
+ * Return value: the new #PangoTabArray
**/
PangoTabArray *
pango_tab_array_new_with_positions (gint size,
@@ -170,7 +170,7 @@ pango_tab_array_get_type (void)
*
* Copies a #PangoTabArray
*
- * Return value: Newly-allocated #PangoTabArray
+ * Return value: the new #PangoTabArray.
**/
PangoTabArray*
pango_tab_array_copy (PangoTabArray *src)
@@ -226,6 +226,7 @@ pango_tab_array_get_size (PangoTabArray *tab_array)
*
* Resizes a tab array. You must subsequently initialize any tabs that
* were added as a result of growing the array.
+ *
**/
void
pango_tab_array_resize (PangoTabArray *tab_array,
@@ -256,7 +257,7 @@ pango_tab_array_resize (PangoTabArray *tab_array,
* @tab_array: a #PangoTabArray
* @tab_index: the index of a tab stop
* @alignment: tab alignment
- * @location: tab location in pango units
+ * @location: tab location in Pango units
*
* Sets the alignment and location of a tab stop.
* @alignment must always be #PANGO_TAB_LEFT in the current
@@ -285,12 +286,10 @@ pango_tab_array_set_tab (PangoTabArray *tab_array,
* pango_tab_array_get_tab:
* @tab_array: a #PangoTabArray
* @tab_index: tab stop index
- * @alignment: location to store alignment
- * @location: location to store tab position
+ * @alignment: location to store alignment, or %NULL
+ * @location: location to store tab position, or %NULL
*
* Gets the alignment and position of a tab stop.
- * @alignment or @location may be NULL if you aren't
- * interested in their value.
*
**/
void
@@ -313,10 +312,10 @@ pango_tab_array_get_tab (PangoTabArray *tab_array,
/**
* pango_tab_array_get_tabs:
* @tab_array: a #PangoTabArray
- * @alignments: location to store an array of tab stop alignments
- * @locations: location to store an array of tab positions
+ * @alignments: location to store an array of tab stop alignments, or %NULL
+ * @locations: location to store an array of tab positions, or %NULL
*
- * If non-NULL, @alignments and @locations are filled with allocated
+ * If non-%NULL, @alignments and @locations are filled with allocated
* arrays of length pango_tab_array_get_size(). You must free the
* returned array.
*
@@ -352,10 +351,10 @@ pango_tab_array_get_tabs (PangoTabArray *tab_array,
* pango_tab_array_get_positions_in_pixels:
* @tab_array: a #PangoTabArray
*
- * Returns TRUE if the tab positions are in pixels, FALSE if they are
+ * Returns %TRUE if the tab positions are in pixels, %FALSE if they are
* in Pango units.
*
- * Return value: whether positions are in pixels
+ * Return value: whether positions are in pixels.
**/
gboolean
pango_tab_array_get_positions_in_pixels (PangoTabArray *tab_array)
diff --git a/pango/pango-types.h b/pango/pango-types.h
index 4b59e9b3..1e3a0305 100644
--- a/pango/pango-types.h
+++ b/pango/pango-types.h
@@ -160,7 +160,7 @@ void pango_matrix_concat (PangoMatrix *matrix,
* or %PANGO_DIRECTION_WEAK_RTL, since every character is either
* neutral or has a strong direction; on the other hand
* %PANGO_DIRECTION_NEUTRAL doesn't make sense to pass
- * to pango_log2vis_get_embedding_levels().
+ * to pango_itemize_with_base_dir().
*
* The %PANGO_DIRECTION_TTB_LTR, %PANGO_DIRECTION_TTB_RTL
* values come from an earlier interpretation of this
diff --git a/pango/pango-utils.c b/pango/pango-utils.c
index f6fe3765..8d31c997 100644
--- a/pango/pango-utils.c
+++ b/pango/pango-utils.c
@@ -1277,7 +1277,7 @@ pango_language_from_string (const char *language)
* %NULL is allowed and matches nothing but '*'
* @range_list: a list of language ranges, separated by ';' characters.
* each element must either be '*', or a RFC 3066 language range
- * canonicalized as by pango_language_from_string().
+ * canonicalized as by pango_language_from_string()
*
* Checks if a language tag matches one of the elements in a list of
* language ranges. A language tag is considered to match a range
diff --git a/pango/pangoft2-render.c b/pango/pangoft2-render.c
index 49908ca5..1ad03b09 100644
--- a/pango/pangoft2-render.c
+++ b/pango/pangoft2-render.c
@@ -448,7 +448,7 @@ pango_ft2_renderer_draw_trapezoid (PangoRenderer *renderer,
* @y: the Y position of the top of the layout (in Pango units)
*
* Render a #PangoLayout onto a FreeType2 bitmap, with he
- * location specified in fixed-point pango units rather than
+ * location specified in fixed-point Pango units rather than
* pixels. (Using this will avoid extra inaccuracies from
* rounding to integer pixels multiple times, even if the
* final glyph positions are integers.)
@@ -499,11 +499,11 @@ pango_ft2_render_layout (FT_Bitmap *bitmap,
* pango_ft2_render_layout_line_subpixel:
* @bitmap: a FT_Bitmap to render the line onto
* @line: a #PangoLayoutLine
- * @x: the x position of start of string (in pango units)
- * @y: the y position of baseline (in pango units)
+ * @x: the x position of start of string (in Pango units)
+ * @y: the y position of baseline (in Pango units)
*
* Render a #PangoLayoutLine onto a FreeType2 bitmap, with he
- * location specified in fixed-point pango units rather than
+ * location specified in fixed-point Pango units rather than
* pixels. (Using this will avoid extra inaccuracies from
* rounding to integer pixels multiple times, even if the
* final glyph positions are integers.)
diff --git a/pango/pangox.c b/pango/pangox.c
index 7fec7542..23f76728 100644
--- a/pango/pangox.c
+++ b/pango/pangox.c
@@ -813,7 +813,7 @@ get_font_metrics_from_subfonts (PangoFont *font,
if (get_int_prop (avg_width_atom, fs, &avg_width))
{
- /* convert decipoints --> pango units.
+ /* convert decipoints --> Pango units.
* Resolution is in (points * PANGO_SCALE) / pixel,
* avg_width in decipoints.
* We want pixels * PANGO_SCALE
diff --git a/pango/pangoxft-render.c b/pango/pangoxft-render.c
index b97bb859..c1825b31 100644
--- a/pango/pangoxft-render.c
+++ b/pango/pangoxft-render.c
@@ -639,8 +639,8 @@ pango_xft_render_layout (XftDraw *draw,
* @color: the foreground color in which to draw the layout line
* (may be overriden by color attributes)
* @line: a #PangoLayoutLine
- * @x: the x position of start of string (in pango units)
- * @y: the y position of baseline (in pango units)
+ * @x: the x position of start of string (in Pango units)
+ * @y: the y position of baseline (in Pango units)
*
* Render a #PangoLayoutLine onto a #XftDraw
*