summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--ChangeLog56
-rw-r--r--docs/tmpl/engines.sgml2
-rw-r--r--docs/tmpl/fonts.sgml10
-rw-r--r--docs/tmpl/freetype-fonts.sgml2
-rw-r--r--docs/tmpl/layout.sgml6
-rw-r--r--docs/tmpl/main.sgml4
-rw-r--r--docs/tmpl/modules.sgml2
-rw-r--r--docs/tmpl/opentype.sgml2
-rw-r--r--docs/tmpl/pango-renderer.sgml4
-rw-r--r--docs/tmpl/pango-version.sgml2
-rw-r--r--docs/tmpl/pangofc-font.sgml4
-rw-r--r--docs/tmpl/pangofc-fontmap.sgml2
-rw-r--r--docs/tmpl/text-attributes.sgml2
-rw-r--r--docs/tmpl/win32-fonts.sgml2
-rw-r--r--docs/tmpl/x-fonts.sgml2
-rw-r--r--docs/tmpl/xft-fonts.sgml4
-rw-r--r--pango/ellipsize.c6
-rw-r--r--pango/fonts.c20
-rw-r--r--pango/glyphstring.c8
-rw-r--r--pango/modules.c2
-rw-r--r--pango/pango-attributes.c8
-rw-r--r--pango/pango-context.c16
-rw-r--r--pango/pango-context.h4
-rw-r--r--pango/pango-coverage.c7
-rw-r--r--pango/pango-glyph-item.c14
-rw-r--r--pango/pango-layout.c18
-rw-r--r--pango/pango-layout.h4
-rw-r--r--pango/pango-markup.c6
-rw-r--r--pango/pango-matrix.c10
-rw-r--r--pango/pango-ot-buffer.c2
-rw-r--r--pango/pango-ot-info.c6
-rw-r--r--pango/pango-ot-ruleset.c2
-rw-r--r--pango/pango-renderer.c4
-rw-r--r--pango/pango-script.c8
-rw-r--r--pango/pango-utils.c26
-rw-r--r--pango/pangoatsui-fontmap.c2
-rw-r--r--pango/pangocairo-fontmap.c4
-rw-r--r--pango/pangofc-font.c4
-rw-r--r--pango/pangofc-font.h2
-rw-r--r--pango/pangofc-fontmap.c4
-rw-r--r--pango/pangofc-fontmap.h2
-rw-r--r--pango/pangoft2-fontmap.c6
-rw-r--r--pango/pangoft2-render.c8
-rw-r--r--pango/pangoft2.c4
-rw-r--r--pango/pangowin32-fontcache.c2
-rw-r--r--pango/pangowin32-fontmap.c4
-rw-r--r--pango/pangowin32.c8
-rw-r--r--pango/pangox-fontmap.c14
-rw-r--r--pango/pangox.c4
-rw-r--r--pango/pangoxft-font.c6
-rw-r--r--pango/pangoxft-fontmap.c4
-rw-r--r--pango/pangoxft-render.c6
-rw-r--r--pango/reorder-items.c7
53 files changed, 211 insertions, 157 deletions
diff --git a/ChangeLog b/ChangeLog
index 3947b5dc..ba33af31 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,59 @@
+2007-01-07 Behdad Esfahbod <behdad@gnome.org>
+
+ * docs/tmpl/engines.sgml:
+ * docs/tmpl/fonts.sgml:
+ * docs/tmpl/freetype-fonts.sgml:
+ * docs/tmpl/layout.sgml:
+ * docs/tmpl/main.sgml:
+ * docs/tmpl/modules.sgml:
+ * docs/tmpl/opentype.sgml:
+ * docs/tmpl/pango-renderer.sgml:
+ * docs/tmpl/pango-version.sgml:
+ * docs/tmpl/pangofc-font.sgml:
+ * docs/tmpl/pangofc-fontmap.sgml:
+ * docs/tmpl/text-attributes.sgml:
+ * docs/tmpl/win32-fonts.sgml:
+ * docs/tmpl/x-fonts.sgml:
+ * docs/tmpl/xft-fonts.sgml:
+ * pango/ellipsize.c:
+ * pango/fonts.c:
+ * pango/glyphstring.c:
+ * pango/modules.c:
+ * pango/pango-attributes.c:
+ * pango/pango-context.c:
+ * pango/pango-context.h:
+ * pango/pango-coverage.c:
+ * pango/pango-glyph-item.c:
+ * pango/pango-layout.c:
+ * pango/pango-layout.h:
+ * pango/pango-markup.c:
+ * pango/pango-matrix.c:
+ * pango/pango-ot-buffer.c:
+ * pango/pango-ot-info.c:
+ * pango/pango-ot-ruleset.c:
+ * pango/pango-renderer.c:
+ * pango/pango-script.c:
+ * pango/pango-utils.c:
+ * pango/pangoatsui-fontmap.c:
+ * pango/pangocairo-fontmap.c:
+ * pango/pangofc-font.c:
+ * pango/pangofc-font.h:
+ * pango/pangofc-fontmap.c:
+ * pango/pangofc-fontmap.h:
+ * pango/pangoft2-fontmap.c:
+ * pango/pangoft2-render.c:
+ * pango/pangoft2.c:
+ * pango/pangowin32-fontcache.c:
+ * pango/pangowin32-fontmap.c:
+ * pango/pangowin32.c:
+ * pango/pangox-fontmap.c:
+ * pango/pangox.c:
+ * pango/pangoxft-font.c:
+ * pango/pangoxft-fontmap.c:
+ * pango/pangoxft-render.c:
+ * pango/reorder-items.c:
+ Spell-check the docs.
+
2007-01-07 Tor Lillqvist <tml@novell.com>
* modules/basic/Makefile.am: Fix build on Win32 outside
diff --git a/docs/tmpl/engines.sgml b/docs/tmpl/engines.sgml
index 2f8efcae..20de439f 100644
--- a/docs/tmpl/engines.sgml
+++ b/docs/tmpl/engines.sgml
@@ -45,7 +45,7 @@ engine. It contains the following fields:
<!-- ##### STRUCT PangoEngineScriptInfo ##### -->
<para>
-The PangoEngineScriptInfo structure contains
+The #PangoEngineScriptInfo structure contains
information about how the shaper covers a particular
script.
</para>
diff --git a/docs/tmpl/fonts.sgml b/docs/tmpl/fonts.sgml
index 0c917213..3253dc99 100644
--- a/docs/tmpl/fonts.sgml
+++ b/docs/tmpl/fonts.sgml
@@ -9,7 +9,7 @@ Structures representing abstract fonts
Pango supports a flexible architecture where a
particular rendering architecture can supply an
implementation of fonts. The #PangoFont structure
-represents an abstract rendering-system-indepent font.
+represents an abstract rendering-system-independent font.
Pango provides routines to list available fonts, and
to load a font of a given description.
</para>
@@ -551,9 +551,9 @@ The #GObject type for #PangoFontMetrics.
The #PangoFont structure is used to represent
a font in a rendering-system-independent matter.
To create an implementation of a #PangoFont,
-the rendering-system specific code should malloc
+the rendering-system specific code should allocate
a larger structure that contains a nested
-#PangoFont, fill in the klass member of
+#PangoFont, fill in the <structfield>klass</structfield> member of
the nested #PangoFont with a pointer to
a appropriate #PangoFontClass, then call
pango_font_init() on the structure.
@@ -779,8 +779,8 @@ The #PangoFontMap represents the set of fonts available for a
particular rendering system. This is a virtual object with
implementations being specific to particular rendering systems. To
create an implementation of a #PangoFontMap, the rendering-system
-specific code should malloc a larger structure that contains a nested
-#PangoFontMap, fill in the klass member of the nested #PangoFontMap with a
+specific code should allocate a larger structure that contains a nested
+#PangoFontMap, fill in the <structfield>klass</structfield> member of the nested #PangoFontMap with a
pointer to a appropriate #PangoFontMapClass, then call
pango_font_map_init() on the structure.
</para>
diff --git a/docs/tmpl/freetype-fonts.sgml b/docs/tmpl/freetype-fonts.sgml
index cbe92eb7..06f5006c 100644
--- a/docs/tmpl/freetype-fonts.sgml
+++ b/docs/tmpl/freetype-fonts.sgml
@@ -64,7 +64,7 @@ with the FreeType backend. See %PANGO_RENDER_TYPE_FC for the replacement.
Function type for doing final config tweaking on prepared FcPatterns.
</para>
-@pattern: the FcPattern to tweak.
+@pattern: the <type>FcPattern</type> to tweak.
@data: user data.
diff --git a/docs/tmpl/layout.sgml b/docs/tmpl/layout.sgml
index 1bd70e60..135a706a 100644
--- a/docs/tmpl/layout.sgml
+++ b/docs/tmpl/layout.sgml
@@ -2,7 +2,7 @@
Layout Objects
<!-- ##### SECTION Short_Description ##### -->
-Highlevel layout driver objects
+High-level layout driver objects
<!-- ##### SECTION Long_Description ##### -->
<para>
@@ -212,7 +212,7 @@ has no user-visible fields.
<!-- ##### ENUM PangoWrapMode ##### -->
<para>
-A PangoWrapMode describes how to wrap the lines of a #PangoLayout to the desired width.
+A #PangoWrapMode describes how to wrap the lines of a #PangoLayout to the desired width.
</para>
@PANGO_WRAP_WORD: wrap lines at word boundaries.
@@ -390,7 +390,7 @@ The #GObject type for #PangoEllipsizeMode.
<!-- ##### ENUM PangoAlignment ##### -->
<para>
-A PangoAlignment describes how to align the lines of a #PangoLayout within the
+A #PangoAlignment describes how to align the lines of a #PangoLayout within the
available space. If the #PangoLayout is set to justify
using pango_layout_set_justify(), this only has effect for partial lines.
</para>
diff --git a/docs/tmpl/main.sgml b/docs/tmpl/main.sgml
index 0d948601..204c5de4 100644
--- a/docs/tmpl/main.sgml
+++ b/docs/tmpl/main.sgml
@@ -49,7 +49,7 @@ fields:
@shape_engine: the engine for doing rendering-system-dependent processing.
@lang_engine: the engine for doing rendering-system-independent processing.
@font: the font for this segment.
-@level: the bidrectional level for this segment.
+@level: the bidirectional level for this segment.
@gravity: the glyph orientation for this segment.
@centered_baseline: whether this segment should be shifted to center around
the baseline.
@@ -438,7 +438,7 @@ about the attributes of a single character.
and @is_word_end set for some character.
@is_sentence_boundary: is a sentence boundary.
There are two ways to divide sentences. The first assigns all
- intersentence whitespace/control/format chars to some sentence,
+ inter-sentence whitespace/control/format chars to some sentence,
so all chars are in some sentence; @is_sentence_boundary denotes
the boundaries there. The second way doesn't assign
between-sentence spaces, etc. to any sentence, so
diff --git a/docs/tmpl/modules.sgml b/docs/tmpl/modules.sgml
index 003840a0..0fe8c42f 100644
--- a/docs/tmpl/modules.sgml
+++ b/docs/tmpl/modules.sgml
@@ -27,7 +27,7 @@ loaded module.
@list: a function that lists the engines defined in this module.
@init: a function to initialize the module.
-@exit: a function to finilize the module.
+@exit: a function to finalize the module.
@create: a function to create an engine, given the engine name.
<!-- ##### STRUCT PangoMap ##### -->
diff --git a/docs/tmpl/opentype.sgml b/docs/tmpl/opentype.sgml
index 141d71c3..f1a304fe 100644
--- a/docs/tmpl/opentype.sgml
+++ b/docs/tmpl/opentype.sgml
@@ -70,7 +70,7 @@ 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 #PangoOTRuleSet
-is created with pango_ot_ruleset_new(), features are addded
+is created with pango_ot_ruleset_new(), features are added
to it with pango_ot_ruleset_add_feature(), then it is
applied to a #PangoGlyphString with pango_ot_ruleset_shape().
</para>
diff --git a/docs/tmpl/pango-renderer.sgml b/docs/tmpl/pango-renderer.sgml
index c7e76813..181986f0 100644
--- a/docs/tmpl/pango-renderer.sgml
+++ b/docs/tmpl/pango-renderer.sgml
@@ -7,8 +7,8 @@ Rendering driver base class
<!-- ##### SECTION Long_Description ##### -->
<para>
#PangoRenderer is a base class that contains the necessary logic for
-rendering a PangoLayout or PangoLayoutLine. By subclassing
-PangoRenderer and overriding operations such as @draw_glyphs and
+rendering a #PangoLayout or #PangoLayoutLine. By subclassing
+#PangoRenderer and overriding operations such as @draw_glyphs and
@draw_rectangle, renderers for particular font backends and
destinations can be created.
</para>
diff --git a/docs/tmpl/pango-version.sgml b/docs/tmpl/pango-version.sgml
index dbdb41a2..230946d2 100644
--- a/docs/tmpl/pango-version.sgml
+++ b/docs/tmpl/pango-version.sgml
@@ -72,7 +72,7 @@ A string literal containing the version of Pango available at compile-time.
<!-- ##### MACRO PANGO_VERSION_CHECK ##### -->
<para>
-Checks that the versoin of Pango available at compile-time is not older than
+Checks that the version of Pango available at compile-time is not older than
the provided version number.
</para>
diff --git a/docs/tmpl/pangofc-font.sgml b/docs/tmpl/pangofc-font.sgml
index 6bea63f4..95ac1dd3 100644
--- a/docs/tmpl/pangofc-font.sgml
+++ b/docs/tmpl/pangofc-font.sgml
@@ -6,8 +6,8 @@ Base font class for Fontconfig-based backends
<!-- ##### SECTION Long_Description ##### -->
<para>
-PangoFcFont is a base class for font implementation using the
-FontConfig and FreeType libraries. It is used in the
+#PangoFcFont is a base class for font implementation using the
+Fontconfig and FreeType libraries. It is used in the
<link linkend="pango-Xft-Fonts-and-Rendering">Xft</link> and
<link linkend="pango-FreeType-Fonts-and-Rendering">FreeType</link>
backends shipped with Pango, but can also be used when creating
diff --git a/docs/tmpl/pangofc-fontmap.sgml b/docs/tmpl/pangofc-fontmap.sgml
index 7e3c0ae1..340ad03a 100644
--- a/docs/tmpl/pangofc-fontmap.sgml
+++ b/docs/tmpl/pangofc-fontmap.sgml
@@ -7,7 +7,7 @@ Base fontmap class for Fontconfig-based backends
<!-- ##### SECTION Long_Description ##### -->
<para>
PangoFcFontMap is a base class for font map implementations using the
-FontConfig and FreeType libraries. It is used in the
+Fontconfig and FreeType libraries. It is used in the
<link linkend="pango-Xft-Fonts-and-Rendering">Xft</link> and
<link linkend="pango-FreeType-Fonts-and-Rendering">FreeType</link>
backends shipped with Pango, but can also be used when creating
diff --git a/docs/tmpl/text-attributes.sgml b/docs/tmpl/text-attributes.sgml
index b0872b0c..bcb109c6 100644
--- a/docs/tmpl/text-attributes.sgml
+++ b/docs/tmpl/text-attributes.sgml
@@ -513,7 +513,7 @@ The scale factor for three magnification steps (1.2 * 1.2 * 1.2).
<!-- ##### STRUCT PangoColor ##### -->
<para>
The #PangoColor structure is used to
-represent a color in an uncalibrated RGB colorspace.
+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,
diff --git a/docs/tmpl/win32-fonts.sgml b/docs/tmpl/win32-fonts.sgml
index e4a95d7f..3896e33a 100644
--- a/docs/tmpl/win32-fonts.sgml
+++ b/docs/tmpl/win32-fonts.sgml
@@ -147,7 +147,7 @@ g_quark_from_string()) is used to identify the renderer in pango_find_map().
<!-- ##### STRUCT PangoWin32FontCache ##### -->
<para>
A #PangoWin32FontCache caches
-#HFONTs by their #LOGFONT descriptions.
+HFONTs by their LOGFONT descriptions.
</para>
diff --git a/docs/tmpl/x-fonts.sgml b/docs/tmpl/x-fonts.sgml
index 7d358f25..ca76af76 100644
--- a/docs/tmpl/x-fonts.sgml
+++ b/docs/tmpl/x-fonts.sgml
@@ -271,7 +271,7 @@ glyph index.
<!-- ##### STRUCT PangoXFontCache ##### -->
<para>
A #PangoXFontCache caches
-#XFontStructs for a single display by their XLFD name.
+<type>XFontStructs</type> for a single display by their XLFD name.
</para>
diff --git a/docs/tmpl/xft-fonts.sgml b/docs/tmpl/xft-fonts.sgml
index 9be166db..80c10207 100644
--- a/docs/tmpl/xft-fonts.sgml
+++ b/docs/tmpl/xft-fonts.sgml
@@ -17,7 +17,7 @@ Using the Xft backend is generally straightforward;
pango_xft_get_context() creates a context for a specified display
and screen. You can then create a #PangoLayout with that context
and render it with pango_xft_render_layout(). At a more advanced
-level, the lowlevel fontconfig options used for rendering fonts
+level, the low-level fontconfig options used for rendering fonts
can be affected using pango_xft_set_default_substitute(), and
pango_xft_substitute_changed().
</para>
@@ -30,7 +30,7 @@ is useful to derive from #PangoXftRenderer. Deriving from
support custom attributes by overriding #PangoRendererClass virtual
functions like 'prepare_run' or 'draw_shape'. The reason is to
customize exactly how the final bits are drawn to the destination by
-overring the #PangoXftRendererClass virtual functions
+overriding the #PangoXftRendererClass virtual functions
'composite_glyphs' and 'composite_trapezoids'.
</para>
diff --git a/pango/ellipsize.c b/pango/ellipsize.c
index 22f6e4b4..b1523afe 100644
--- a/pango/ellipsize.c
+++ b/pango/ellipsize.c
@@ -48,7 +48,7 @@ typedef struct _LineIter LineIter;
* us to use a gap position at x=line_width and still have it be part of
* of a run.
*
- * We grow the grap out one "span" at a time, where a span is simply a
+ * We grow the gap out one "span" at a time, where a span is simply a
* consecutive run of clusters that we can't interrupt with an ellipsis.
*
* When choosing whether to grow the gap at the start or the end, we
@@ -236,7 +236,7 @@ line_iter_prev_cluster (EllipsizeState *state,
* - Starts a grapheme - checked here
*
* In the future we'd also like to add a check for cursive connectivity here.
- * This should be an addition to PangoGlyphVisAttr
+ * This should be an addition to #PangoGlyphVisAttr
*
*/
@@ -715,7 +715,7 @@ current_width (EllipsizeState *state)
* @line: a #PangoLayoutLine
* @attrs: Attributes being used for itemization/shaping
*
- * Given a PangoLayoutLine with the runs still in logical order, ellipsize
+ * Given a #PangoLayoutLine with the runs still in logical order, ellipsize
* it according the layout's policy to fit within the set width of the layout.
**/
void
diff --git a/pango/fonts.c b/pango/fonts.c
index 7770a208..43f1dfb6 100644
--- a/pango/fonts.c
+++ b/pango/fonts.c
@@ -208,7 +208,7 @@ pango_font_description_set_style (PangoFontDescription *desc,
*
* Return value: the style field for the font description.
* Use pango_font_description_get_set_fields() to find out if
- * the field was explicitely set or not.
+ * the field was explicitly set or not.
**/
PangoStyle
pango_font_description_get_style (const PangoFontDescription *desc)
@@ -245,7 +245,7 @@ pango_font_description_set_variant (PangoFontDescription *desc,
*
* Return value: the variant field for the font description. Use
* pango_font_description_get_set_fields() to find out if
- * the field was explicitely set or not.
+ * the field was explicitly set or not.
**/
PangoVariant
pango_font_description_get_variant (const PangoFontDescription *desc)
@@ -284,7 +284,7 @@ pango_font_description_set_weight (PangoFontDescription *desc,
*
* Return value: the weight field for the font description. Use
* pango_font_description_get_set_fields() to find out if
- * the field was explicitely set or not.
+ * the field was explicitly set or not.
**/
PangoWeight
pango_font_description_get_weight (const PangoFontDescription *desc)
@@ -321,7 +321,7 @@ pango_font_description_set_stretch (PangoFontDescription *desc,
*
* Return value: the stretch field for the font description. Use
* pango_font_description_get_set_fields() to find out if
- * the field was explicitely set or not.
+ * the field was explicitly set or not.
**/
PangoStretch
pango_font_description_get_stretch (const PangoFontDescription *desc)
@@ -369,7 +369,7 @@ pango_font_description_set_size (PangoFontDescription *desc,
* to find out which is the case. Returns 0 if the size field has not
* previously been set or it has been set to 0 explicitly.
* Use pango_font_description_get_set_fields() to
- * find out if the field was explicitely set or not.
+ * find out if the field was explicitly set or not.
**/
gint
pango_font_description_get_size (const PangoFontDescription *desc)
@@ -412,7 +412,7 @@ pango_font_description_set_absolute_size (PangoFontDescription *desc,
*
* Return value: whether the size for the font description is in
* points or device units. Use pango_font_description_get_set_fields() to
- * find out if the size field of the font description was explicitely set or not.
+ * find out if the size field of the font description was explicitly set or not.
*
* Since: 1.8
**/
@@ -464,7 +464,7 @@ pango_font_description_set_gravity (PangoFontDescription *desc,
*
* Return value: the gravity field for the font description. Use
* pango_font_description_get_set_fields() to find out if
- * the field was explicitely set or not.
+ * the field was explicitly set or not.
*
* Since: 1.16
**/
@@ -679,7 +679,7 @@ pango_font_description_copy (const PangoFontDescription *desc)
*
* Like pango_font_description_copy(), but only a shallow copy is made
* of the family name and other allocated fields. The result can only
- * be used until @desc is modififed or freed. This is meant to be used
+ * be used until @desc is modified or freed. This is meant to be used
* when the copy is only needed temporarily.
*
* Return value: the newly allocated #PangoFontDescription, which should
@@ -704,8 +704,8 @@ pango_font_description_copy_static (const PangoFontDescription *desc)
*
* Compares two font descriptions for equality. Two font descriptions
* are considered equal if the fonts they describe are provably identical.
- * This means that their maskd do not have to match, as long as other fields
- * are all the same. (Two font descrptions may result in identical fonts
+ * This means that their masks do not have to match, as long as other fields
+ * are all the same. (Two font descriptions may result in identical fonts
* being loaded, but still compare %FALSE.)
*
* Return value: %TRUE if the two font descriptions are identical,
diff --git a/pango/glyphstring.c b/pango/glyphstring.c
index 2247d034..691e8c00 100644
--- a/pango/glyphstring.c
+++ b/pango/glyphstring.c
@@ -28,7 +28,7 @@
/**
* pango_glyph_string_new:
*
- * Create a new PangoGlyphString.
+ * Create a new #PangoGlyphString.
*
* Return value: the newly allocated #PangoGlyphString, which
* should be freed with pango_glyph_string_free().
@@ -48,7 +48,7 @@ pango_glyph_string_new (void)
/**
* pango_glyph_string_set_size:
- * @string: a PangoGlyphString.
+ * @string: a #PangoGlyphString.
* @new_len: the new length of the string.
*
* Resize a glyph string to the given length.
@@ -92,7 +92,7 @@ pango_glyph_string_get_type (void)
/**
* pango_glyph_string_copy:
- * @string: a PangoGlyphString.
+ * @string: a #PangoGlyphString.
*
* Copy a glyph string and associated storage.
*
@@ -116,7 +116,7 @@ pango_glyph_string_copy (PangoGlyphString *string)
/**
* pango_glyph_string_free:
- * @string: a PangoGlyphString.
+ * @string: a #PangoGlyphString.
*
* Free a glyph string and associated storage.
*/
diff --git a/pango/modules.c b/pango/modules.c
index 301c098d..7b2993ae 100644
--- a/pango/modules.c
+++ b/pango/modules.c
@@ -702,7 +702,7 @@ append_engines (GSList **engine_list,
* handle this script.
*
* Finds engines in the map that handle the given script. The returned
- * lists should be fred with g_slist_free, but the engines in the
+ * lists should be freed with g_slist_free, but the engines in the
* lists are owned by GLib and will be kept around permanently, so
* they should not be unref'ed.
*
diff --git a/pango/pango-attributes.c b/pango/pango-attributes.c
index a44d499d..eef62ea2 100644
--- a/pango/pango-attributes.c
+++ b/pango/pango-attributes.c
@@ -951,9 +951,9 @@ pango_attr_shape_new_with_data (const PangoRectangle *ink_rect,
* @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 ink and logical rectangle on the result of shaping a
* particular glyph. This might be used, for instance, for
- * embedding a picture or a widget inside a PangoLayout.
+ * embedding a picture or a widget inside a #PangoLayout.
*
* Return value: the newly allocated #PangoAttribute, which should be
* freed with pango_attribute_destroy().
@@ -1410,7 +1410,7 @@ pango_attr_list_change (PangoAttrList *list,
* of each attribute in @other in sequence (offset in position by @pos).
*
* This operation proves useful for, for instance, inserting
- * a preedit string in the middle of an edit buffer.
+ * a pre-edit string in the middle of an edit buffer.
**/
void
pango_attr_list_splice (PangoAttrList *list,
@@ -1820,7 +1820,7 @@ pango_attr_iterator_get_font (PangoAttrIterator *iterator,
/**
* pango_attr_list_filter:
* @list: a #PangoAttrList
- * @func: callback function; returns %TRUE if an atttribute
+ * @func: callback function; returns %TRUE if an attribute
* should be filtered out.
* @data: Data to be passed to @func
*
diff --git a/pango/pango-context.c b/pango/pango-context.c
index 26c20cdb..5875fb72 100644
--- a/pango/pango-context.c
+++ b/pango/pango-context.c
@@ -107,8 +107,8 @@ pango_context_finalize (GObject *object)
* This function is only useful when implementing a new backend
* for Pango, something applications won't do. You should use
* the context creation function for the backend you are using,
- * for example, pango_xft_get_context(), pango_win32_get_context()
- * or, pango_ft2_font_map_create_context().
+ * for example, pango_cairo_font_map_create_context(), pango_xft_get_context(),
+ * pango_win32_get_context() or, pango_ft2_font_map_create_context().
*
* If you are using Pango as part of a higher-level system,
* that system may have it's own ways of create a #PangoContext.
@@ -147,7 +147,7 @@ update_resolved_gravity (PangoContext *context)
* Sets the transformation matrix that will be applied when rendering
* with this context. Note that reported metrics are in the user space
* coordinates before the application of the matrix, not device-space
- * coordiantes after the application of the matrix. So, they don't scale
+ * coordinates after the application of the matrix. So, they don't scale
* with the matrix, though they may change slightly for different
* matrices, depending on how the text is fit to the pixel grid.
*
@@ -238,7 +238,7 @@ pango_context_get_font_map (PangoContext *context)
/**
* pango_context_list_families:
* @context: a #PangoContext
- * @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
*
@@ -1346,9 +1346,9 @@ itemize_state_finish (ItemizeState *state)
*
* Like pango_itemize(), but the base direction to use when
* computing bidirectional levels (see pango_context_set_base_dir ()),
- * is specified explicitely rather than gotten from the #PangoContext.
+ * is specified explicitly rather than gotten from the #PangoContext.
*
- * Return value: a GList of PangoItem structures.
+ * Return value: a #GList of #PangoItem structures.
*
* Since: 1.4
*/
@@ -1430,7 +1430,7 @@ itemize_with_font (PangoContext *context,
* the range covering the position just after @start_index + @length.
* (i.e. if itemizing in a loop, just keep passing in the same @cached_iter).
*
- * Return value: a GList of PangoItem structures.
+ * Return value: a #GList of #PangoItem structures.
*/
GList *
pango_itemize (PangoContext *context,
@@ -1537,7 +1537,7 @@ update_metrics_from_items (PangoFontMetrics *metrics,
* @desc: a #PangoFontDescription structure
* @language: language tag used to determine which script to get the metrics
* for. %NULL means that the language tag from the context will
- * be used. If no language tag is set on the ccontext, metrics
+ * be used. If no language tag is set on the context, metrics
* large enough to cover a range of languages will be returned.
* The process of determining such metrics is slow, so it is best
* to always make sure some real language tag will be used.
diff --git a/pango/pango-context.h b/pango/pango-context.h
index 25bdf4ab..12a2508a 100644
--- a/pango/pango-context.h
+++ b/pango/pango-context.h
@@ -44,7 +44,7 @@ typedef struct _PangoContextClass PangoContextClass;
/* The PangoContext and PangoContextClass structs are private; if you
- * need to create a subclass of these, mail otaylor@redhat.com
+ * need to create a subclass of these, file a bug.
*/
GType pango_context_get_type (void) G_GNUC_CONST;
@@ -89,7 +89,7 @@ G_CONST_RETURN PangoMatrix *pango_context_get_matrix (PangoContext *context
/* Break a string of Unicode characters into segments with
* consistent shaping/language engine and bidrectional level.
- * Returns a GList of PangoItem's
+ * Returns a #GList of #PangoItem's
*/
GList *pango_itemize (PangoContext *context,
const char *text,
diff --git a/pango/pango-coverage.c b/pango/pango-coverage.c
index 620e2b98..83900c96 100644
--- a/pango/pango-coverage.c
+++ b/pango/pango-coverage.c
@@ -73,9 +73,8 @@ pango_coverage_new (void)
* pango_coverage_copy:
* @coverage: a #PangoCoverage
*
- * Copy an existing #PangoCoverage. (This function may now be unecessary
- * since we refcount the structure. Mail otaylor@redhat.com if you
- * use it.)
+ * Copy an existing #PangoCoverage. (This function may now be unnecessary
+ * since we refcount the structure. File a bug if you use it.)
*
* Return value: the newly allocated #PangoCoverage,
* with a reference count of one, which
@@ -354,7 +353,7 @@ pango_coverage_max (PangoCoverage *coverage,
* @bytes: location to store result (must be freed with g_free())
* @n_bytes: location to store size of result
*
- * Convert a PangoCoverage structure into a flat binary format
+ * Convert a #PangoCoverage structure into a flat binary format
**/
void
pango_coverage_to_bytes (PangoCoverage *coverage,
diff --git a/pango/pango-glyph-item.c b/pango/pango-glyph-item.c
index 29216101..65069193 100644
--- a/pango/pango-glyph-item.c
+++ b/pango/pango-glyph-item.c
@@ -235,7 +235,7 @@ _pango_glyph_item_iter_next_cluster (PangoGlyphItemIter *iter)
*
* Moves the iterator to the preceding cluster in the glyph item.
*
- * Return value: %TRUE if the iterator was movedn, %FALSE if we were already on the
+ * Return value: %TRUE if the iterator was moved, %FALSE if we were already on the
* first cluster.
**/
gboolean
@@ -313,14 +313,14 @@ _pango_glyph_item_iter_prev_cluster (PangoGlyphItemIter *iter)
/**
* _pango_glyph_item_iter_init_start:
* @iter: pointer to a #PangoGlyphItemIter structure
- * @glyph_item: the glyph item that the iter points into
+ * @glyph_item: the glyph item that @iter points into
* @text: text corresponding to the glyph item
*
* Initializes a #PangoGlyphItemIter structure to point to the
* first cluster in a glyph item.
*
* Return value: %FALSE if there are no clusters in the glyph item;
- * in this case, the state of the iter is undefined.
+ * in this case, the state of @iter is undefined.
**/
gboolean
_pango_glyph_item_iter_init_start (PangoGlyphItemIter *iter,
@@ -345,14 +345,14 @@ _pango_glyph_item_iter_init_start (PangoGlyphItemIter *iter,
/**
* _pango_glyph_item_iter_init_end:
* @iter: pointer to a #PangoGlyphItemIter structure
- * @glyph_item: the glyph item that the iter points into
+ * @glyph_item: the glyph item that @iter points into
* @text: text corresponding to the glyph item
*
* Initializes a #PangoGlyphItemIter structure to point to the
* last cluster in a glyph item.
*
* Return value: %FALSE if there are no clusters in the glyph item;
- * in this case, the state of the iter is undefined.
+ * in this case, the state of @iter is undefined.
**/
gboolean
_pango_glyph_item_iter_init_end (PangoGlyphItemIter *iter,
@@ -391,7 +391,7 @@ append_attrs (PangoGlyphItem *glyph_item,
g_slist_concat (glyph_item->item->analysis.extra_attrs, attrs);
}
-/* Make a deep copy of a GSlist of PangoAttribute
+/* Make a deep copy of a #GSList of PangoAttribute
*/
static GSList *
attr_slist_copy (GSList *attrs)
@@ -447,7 +447,7 @@ split_before_cluster_start (ApplyAttrsState *state)
*
* All attributes that start or end inside a cluster are applied
* to that cluster; for instance, if half of a cluster is underlined
- * and the other-half strikethough, then the cluster will end
+ * and the other-half strikethrough, then the cluster will end
* up with both underline and strikethrough attributes. In these
* cases, it may happen that item->extra_attrs for some of the
* result items can have multiple attributes of the same type.
diff --git a/pango/pango-layout.c b/pango/pango-layout.c
index cc6edc79..2ea3a8c6 100644
--- a/pango/pango-layout.c
+++ b/pango/pango-layout.c
@@ -1,5 +1,5 @@
/* Pango
- * pango-layout.c: Highlevel layout driver
+ * pango-layout.c: High-level layout driver
*
* Copyright (C) 2000, 2001 Red Hat Software
*
@@ -585,7 +585,7 @@ pango_layout_get_font_description (PangoLayout *layout)
* the justification may be done in more complex ways, like extending
* the characters.
*
- * Note that as of Pango-1.10, this functionality is not yet implemented.
+ * Note that as of Pango-1.16, this functionality is not yet implemented.
**/
void
pango_layout_set_justify (PangoLayout *layout,
@@ -851,7 +851,7 @@ pango_layout_get_ellipsize (PangoLayout *layout)
* @length: maximum length of @text, in bytes. -1 indicates that
* the string is nul-terminated and the length should be
* calculated. The text will also be truncated on
- * encountaring a nul-termination even when @length is
+ * encountering a nul-termination even when @length is
* positive.
*
* Sets the text of the layout.
@@ -958,8 +958,8 @@ pango_layout_set_markup (PangoLayout *layout,
* the current text and attribute list.
*
* If @accel_marker is nonzero, the given character will mark the
- * character following it as an accelerator. For example, the accel
- * marker might be an ampersand or underscore. All characters marked
+ * character following it as an accelerator. For example, @accel_marker
+ * might be an ampersand or underscore. All characters marked
* as an accelerator will receive a %PANGO_UNDERLINE_LOW attribute,
* and the first character so marked will be returned in @accel_char.
* Two @accel_marker characters following each other produce a single
@@ -1439,7 +1439,7 @@ pango_layout_index_to_line_x (PangoLayout *layout,
* value indicates motion to the left.
* @new_index: location to store the new cursor byte index. A value of -1
* indicates that the cursor has been moved off the beginning
- * of the layout. A value of G_MAXINT indicates that
+ * of the layout. A value of %G_MAXINT indicates that
* the cursor has been moved off the end of the layout.
* @new_trailing: number of characters to move forward from the location returned
* for @new_index to get the position where the cursor should
@@ -3082,7 +3082,7 @@ process_item (PangoLayout *layout,
goto retry_break;
}
- if (force_fit || break_width <= state->remaining_width) /* Succesfully broke the item */
+ if (force_fit || break_width <= state->remaining_width) /* Successfully broke the item */
{
if (state->remaining_width >= 0)
{
@@ -4470,14 +4470,14 @@ is_tab_run (PangoLayout *layout,
/* When doing shaping, we add the letter spacing value for a
* run after every grapheme in the run. This produces ugly
- * asymetrical results, so what this routine is redistributes
+ * asymmetrical results, so what this routine is redistributes
* that space to the beginning and the end of the run.
*
* We also trim the letter spacing from runs adjacent to
* tabs and from the outside runs of the lines so that things
* line up properly. The line breaking and tab positioning
* were computed without this trimming so they are no longer
- * exactly correct, but this won't be very noticable in most
+ * exactly correct, but this won't be very noticeable in most
* cases.
*/
static void
diff --git a/pango/pango-layout.h b/pango/pango-layout.h
index df1851c9..6e24a565 100644
--- a/pango/pango-layout.h
+++ b/pango/pango-layout.h
@@ -1,5 +1,5 @@
/* Pango
- * pango-layout.h: Highlevel layout driver
+ * pango-layout.h: High-level layout driver
*
* Copyright (C) 2000 Red Hat Software
*
@@ -86,7 +86,7 @@ struct _PangoLayoutLine
#define PANGO_LAYOUT_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS ((obj), PANGO_TYPE_LAYOUT, PangoLayoutClass))
/* The PangoLayout and PangoLayoutClass structs are private; if you
- * need to create a subclass of these, mail otaylor@redhat.com
+ * need to create a subclass of these, file a bug.
*/
GType pango_layout_get_type (void) G_GNUC_CONST;
diff --git a/pango/pango-markup.c b/pango/pango-markup.c
index afe8a933..8f925830 100644
--- a/pango/pango-markup.c
+++ b/pango/pango-markup.c
@@ -559,11 +559,11 @@ static const GMarkupParser pango_markup_parser = {
*
* Parses marked-up text (see
* <link linkend="PangoMarkupFormat">markup format</link>) to create
- * a plaintext string and an attribute list.
+ * a plain-text string and an attribute list.
*
* If @accel_marker is nonzero, the given character will mark the
- * character following it as an accelerator. For example, the accel
- * marker might be an ampersand or underscore. All characters marked
+ * character following it as an accelerator. For example, @accel_marker
+ * might be an ampersand or underscore. All characters marked
* as an accelerator will receive a %PANGO_UNDERLINE_LOW attribute,
* and the first character so marked will be returned in @accel_char.
* Two @accel_marker characters following each other produce a single
diff --git a/pango/pango-matrix.c b/pango/pango-matrix.c
index 49c05f0b..857cc977 100644
--- a/pango/pango-matrix.c
+++ b/pango/pango-matrix.c
@@ -139,7 +139,7 @@ pango_matrix_scale (PangoMatrix *matrix,
*
* Changes the transformation represented by @matrix to be the
* transformation given by first rotating by @degrees degrees
- * counter-clokwise then applying the original transformation.
+ * counter-clockwise then applying the original transformation.
*
* Since: 1.6
**/
@@ -352,7 +352,7 @@ pango_matrix_transform_point (const PangoMatrix *matrix,
* @matrix: a #PangoMatrix, or %NULL
* @rect: in/out bounding box in Pango units, or %NULL
*
- * First transforms the @rect using @matrix, then calculates the bounding box
+ * First transforms @rect using @matrix, then calculates the bounding box
* of the transformed rectangle. The rectangle should be in Pango units.
*
* This function is useful for example when you want to draw a rotated
@@ -365,7 +365,7 @@ pango_matrix_transform_point (const PangoMatrix *matrix,
* If you have the rectangle in Pango units and want to convert to
* transformed pixel bounding box, it is more accurate to transform it first
* (using this function) and pass the result to pango_extents_to_pixels(),
- * as the ink_rect. However, there is a reason that you may want to convert
+ * as @ink_rect. However, there is a reason that you may want to convert
* to pixels first and then transform, and that is when the transformed
* coordinates may overflow in Pango units (large matrix translation for
* example).
@@ -440,8 +440,8 @@ pango_matrix_transform_rectangle (const PangoMatrix *matrix,
* should be and how much you should shift the layout when rendering.
*
* For better accuracy, you should use pango_matrix_transform_rectangle() on
- * original rectangle in Pango units and convert to pixels afterwards
- * using pango_extents_to_pixels() as the ink_rect.
+ * original rectangle in Pango units and convert to pixels afterward
+ * using pango_extents_to_pixels() as @ink_rect.
*
* Since: 1.16
**/
diff --git a/pango/pango-ot-buffer.c b/pango/pango-ot-buffer.c
index fef5a0c0..eef1f0e8 100644
--- a/pango/pango-ot-buffer.c
+++ b/pango/pango-ot-buffer.c
@@ -140,7 +140,7 @@ pango_ot_buffer_set_rtl (PangoOTBuffer *buffer,
*
* Sets whether characters with a mark class should be forced to zero width.
* This setting is needed for proper positioning of Arabic accents,
- * but will produce incorrect results with standard OpenType indic
+ * but will produce incorrect results with standard OpenType Indic
* fonts.
*
* Since: 1.6
diff --git a/pango/pango-ot-info.c b/pango/pango-ot-info.c
index fa3dd5f4..6c362db5 100644
--- a/pango/pango-ot-info.c
+++ b/pango/pango-ot-info.c
@@ -110,7 +110,7 @@ pango_ot_info_finalizer (void *object)
/**
* pango_ot_info_get:
- * @face: a #FT_Face.
+ * @face: a <type>FT_Face</type>.
*
* Returns the #PangoOTInfo structure for the given FreeType font.
*
@@ -210,7 +210,7 @@ set_unicode_charmap (FT_Face face)
}
/* Synthesize a GDEF table using the font's charmap and the
- * unicode property database. We'll fill in class definitions
+ * Unicode property database. We'll fill in class definitions
* for glyphs not in the charmap as we walk through the tables.
*/
static void
@@ -629,7 +629,7 @@ pango_ot_info_list_languages (PangoOTInfo *info,
* @table_type: the table type to obtain information about.
* @tag: unused parameter.
* @script_index: the index of the script to obtain information about.
- * @language_index: the indes of the language to list features for, or
+ * @language_index: the index of the language to list features for, or
* %PANGO_OT_DEFAULT_LANGUAGE, to list features for the default
* language of the script.
*
diff --git a/pango/pango-ot-ruleset.c b/pango/pango-ot-ruleset.c
index 260f9034..591cd571 100644
--- a/pango/pango-ot-ruleset.c
+++ b/pango/pango-ot-ruleset.c
@@ -196,7 +196,7 @@ pango_ot_ruleset_substitute (PangoOTRuleset *ruleset,
* @ruleset: a #PangoOTRuleset.
* @buffer: a #PangoOTBuffer.
*
- * Performs the OpenType GPOS positionoing on @buffer using the features
+ * Performs the OpenType GPOS positioning on @buffer using the features
* in @ruleset
*
* Since: 1.4
diff --git a/pango/pango-renderer.c b/pango/pango-renderer.c
index 337917b0..b4c4728e 100644
--- a/pango/pango-renderer.c
+++ b/pango/pango-renderer.c
@@ -1111,7 +1111,7 @@ pango_renderer_get_color (PangoRenderer *renderer,
* @renderer: a #PangoRenderer
* @part: the part for which rendering has changed.
*
- * Informs Pango that the way that the renderering is done
+ * Informs Pango that the way that the rendering is done
* for @part has changed in a way that would prevent multiple
* pieces being joined together into one drawing call. For
* instance, if a subclass of #PangoRenderer was to add a stipple
@@ -1146,7 +1146,7 @@ pango_renderer_part_changed (PangoRenderer *renderer,
* @renderer: a #PangoRenderer
* @run: a #PangoLayoutRun
*
- * Set up the state of the PangoRenderer for rendering @run.
+ * Set up the state of the #PangoRenderer for rendering @run.
*
* Since: 1.8
**/
diff --git a/pango/pango-script.c b/pango/pango-script.c
index a3e95ece..67133bac 100644
--- a/pango/pango-script.c
+++ b/pango/pango-script.c
@@ -269,11 +269,11 @@ get_pair_index (gunichar ch)
* pango_script_iter_next:
* @iter: a #PangoScriptIter
*
- * Advances a #PangoScriptIter to the next range. If the iter
+ * Advances a #PangoScriptIter to the next range. If @iter
* is already at the end, it is left unchanged and %FALSE
* is returned.
*
- * Return value: %TRUE if the iter was succesfully advanced.
+ * Return value: %TRUE if @iter was successfully advanced.
*
* Since: 1.4
**/
@@ -419,7 +419,7 @@ script_for_lang_compare (gconstpointer key,
/**
* pango_language_includes_script:
- * @language: a PangoLanguage
+ * @language: a #PangoLanguage
* @script: a #PangoScript
*
* Determines if @script is one of the scripts used to
@@ -477,7 +477,7 @@ pango_language_includes_script (PangoLanguage *language,
* representative of that script. This will usually be the
* most widely spoken or used language written in that script:
* for instance, the sample language for %PANGO_SCRIPT_CYRILLIC
- * is <literal>ru</literal> (Russian), the sample lanugage
+ * is <literal>ru</literal> (Russian), the sample language
* for %PANGO_SCRIPT_ARABIC is <literal>ar</literal>.
*
* For some
diff --git a/pango/pango-utils.c b/pango/pango-utils.c
index c39a9cd9..211b99a3 100644
--- a/pango/pango-utils.c
+++ b/pango/pango-utils.c
@@ -175,10 +175,10 @@ pango_trim_string (const char *str)
/**
* pango_split_file_list:
- * @str: a G_SEARCHPATH_SEPARATOR separated list of filenames
+ * @str: a %G_SEARCHPATH_SEPARATOR separated list of filenames
*
- * Splits a G_SEARCHPATH_SEPARATOR-separated list of files, stripping
- * white space and subsituting ~/ with $HOME/.
+ * Splits a %G_SEARCHPATH_SEPARATOR-separated list of files, stripping
+ * white space and substituting ~/ with $HOME/.
*
* Return value: a list of strings to be freed with g_strfreev()
**/
@@ -376,7 +376,7 @@ pango_skip_space (const char **pos)
* of [A-Za-z_] followed by zero or more [A-Za-z_0-9]
* Leading white space is skipped.
*
- * Return value: %FALSE if a parse error occured.
+ * Return value: %FALSE if a parse error occurred.
**/
gboolean
pango_scan_word (const char **pos, GString *out)
@@ -419,7 +419,7 @@ pango_scan_word (const char **pos, GString *out)
* string with '"'. Instead a quoted string, '\"' represents
* a literal quote. Leading white space outside of quotes is skipped.
*
- * Return value: %FALSE if a parse error occured.
+ * Return value: %FALSE if a parse error occurred.
**/
gboolean
pango_scan_string (const char **pos, GString *out)
@@ -505,7 +505,7 @@ pango_scan_string (const char **pos, GString *out)
* Scans an integer.
* Leading white space is skipped.
*
- * Return value: %FALSE if a parse error occured.
+ * Return value: %FALSE if a parse error occurred.
**/
gboolean
pango_scan_int (const char **pos, int *out)
@@ -1090,7 +1090,7 @@ pango_language_get_type (void)
* Brazil.
*
* On Windows, the C library doesn't use any such environment
- * variables, and setting them won't affect the behaviour of functions
+ * variables, and setting them won't affect the behavior of functions
* like ctime(). The user sets the locale through the Regional Options
* in the Control Panel. The C library (in the setlocale() function)
* does not use country and language codes, but country and language
@@ -1152,7 +1152,7 @@ _pango_get_lc_ctype (void)
* Brazil.
*
* On Windows, the C library does not use any such environment
- * variables, and setting them won't affect the behaviour of functions
+ * variables, and setting them won't affect the behavior of functions
* like ctime(). The user sets the locale through the Regional Options
* in the Control Panel. The C library (in the setlocale() function)
* does not use country and language codes, but country and language
@@ -1161,7 +1161,7 @@ _pango_get_lc_ctype (void)
* variables, and does return a Unix-style locale string based on
* either said environment variables or the thread's current locale.
*
- * Your application should call <literal>setlocale (LC_ALL, "");</literal>
+ * Your application should call <literal>setlocale(LC_ALL, "");</literal>
* for the user settings to take effect. Gtk+ does this in its initialization
* functions automatically (by calling gtk_set_locale()).
* See <literal>man setlocale</literal> for more details.
@@ -1294,7 +1294,7 @@ lang_info_compare (const void *key, const void *val)
/* The following array is supposed to contain enough text to tickle all necessary fonts for each
* of the languages in the following. Yes, it's pretty lame. Not all of the languages
- * in the following have sufficient text to excercise all the accents for the language, and
+ * in the following have sufficient text to exercise all the accents for the language, and
* there are obviously many more languages to include as well.
*/
static const LangInfo lang_texts[] = {
@@ -1368,7 +1368,7 @@ pango_language_get_sample_string (PangoLanguage *language)
* pango_log2vis_get_embedding_levels:
* @text: the text to itemize.
* @length: the number of bytes (not characters) to process, or -1
- * if @text is nul-terminated and the legnth should be calculated.
+ * if @text is nul-terminated and the length should be calculated.
* @pbase_dir: input base direction, and output resolved direction.
*
* This will return the bidirectional embedding levels of the input paragraph
@@ -1750,7 +1750,7 @@ pango_find_base_dir (const gchar *text,
*
* Checks @ch to see if it is a character that should not be
* normally rendered on the screen. This includes all Unicode characters
- * with "ZERO WIDTH" in their name, as well as bidi formatting characters, and
+ * with "ZERO WIDTH" in their name, as well as <firstterm>bidi</firstterm> formatting characters, and
* a few other ones. This is totally different from g_unichar_iszerowidth()
* and is at best misnamed.
*
@@ -1863,7 +1863,7 @@ pango_gravity_to_rotation (PangoGravity gravity)
* pango_units_from_double:
* @d: double floating-point value
*
- * Converts a floating-point number to Pango units: multiplys
+ * Converts a floating-point number to Pango units: multiplies
* it by %PANGO_SCALE and rounds to nearest integer.
*
* Return value: the value in Pango units.
diff --git a/pango/pangoatsui-fontmap.c b/pango/pangoatsui-fontmap.c
index 6f271dcc..28e689f3 100644
--- a/pango/pangoatsui-fontmap.c
+++ b/pango/pangoatsui-fontmap.c
@@ -1,5 +1,5 @@
/* Pango
- * pangatsui-fontmap.c
+ * pangoatsui-fontmap.c
*
* Copyright (C) 2000-2003 Red Hat, Inc.
* Copyright (C) 2005 Imendio AB
diff --git a/pango/pangocairo-fontmap.c b/pango/pangocairo-fontmap.c
index d4ec69ba..f1a4c67f 100644
--- a/pango/pangocairo-fontmap.c
+++ b/pango/pangocairo-fontmap.c
@@ -103,7 +103,7 @@ pango_cairo_font_map_new (void)
*
* Gets a default font map to use with Cairo.
*
- * Return value: the default Cairo fontmap for Pango. This
+ * Return value: the default Cairo fontmap for #Pango. This
* object is owned by Pango and must not be freed.
*
* Since: 1.10
@@ -186,7 +186,7 @@ pango_cairo_font_map_create_context (PangoCairoFontMap *fontmap)
* _pango_cairo_font_map_get_renderer:
* @fontmap: a #PangoCairoFontmap
*
- * Gets the singleton PangoCairoRenderer for this fontmap.
+ * Gets the singleton #PangoCairoRenderer for this fontmap.
*
* Return value: the singleton renderer
**/
diff --git a/pango/pangofc-font.c b/pango/pangofc-font.c
index 1f15644e..5be287e5 100644
--- a/pango/pangofc-font.c
+++ b/pango/pangofc-font.c
@@ -577,11 +577,11 @@ pango_fc_font_real_get_glyph (PangoFcFont *font,
* pango_fc_font_lock_face:
* @font: a #PangoFcFont.
*
- * Gets the FreeType FT_Face associated with a font,
+ * Gets the FreeType <type>FT_Face</type> associated with a font,
* This face will be kept around until you call
* pango_fc_font_unlock_face().
*
- * Return value: the FreeType FT_Face associated with @font.
+ * Return value: the FreeType <type>FT_Face</type> associated with @font.
*
* Since: 1.4
**/
diff --git a/pango/pangofc-font.h b/pango/pangofc-font.h
index 7b5bc4a3..9b198ed8 100644
--- a/pango/pangofc-font.h
+++ b/pango/pangofc-font.h
@@ -59,7 +59,7 @@ typedef struct _PangoFcFontClass PangoFcFontClass;
* PangoFcFont:
*
* #PangoFcFont is a base class for font implementations
- * using the FontConfig and FreeType libraries and is used in
+ * using the Fontconfig and FreeType libraries and is used in
* conjunction with #PangoFcFontMap. When deriving from this
* class, you need to implement all of its virtual functions
* other than shutdown() along with the get_glyph_extents()
diff --git a/pango/pangofc-fontmap.c b/pango/pangofc-fontmap.c
index f383e904..a1e4ee35 100644
--- a/pango/pangofc-fontmap.c
+++ b/pango/pangofc-fontmap.c
@@ -918,7 +918,7 @@ pango_fc_font_map_new_font (PangoFontMap *fontmap,
{
FcMatrix fc_matrix;
- /* FontConfig has the Y axis pointing up, Pango, down.
+ /* Fontconfig has the Y axis pointing up, Pango, down.
*/
fc_matrix.xx = pango_matrix->xx;
fc_matrix.xy = - pango_matrix->xy;
@@ -1473,7 +1473,7 @@ cleanup_font (gpointer key,
*
* Clears all cached information for the fontmap and marks
* all fonts open for the fontmap as dead. (See the shutdown()
- * virtual function of PangoFcFont.) This function might be used
+ * virtual function of #PangoFcFont.) This function might be used
* by a backend when the underlying windowing system for the font
* map exits. This function is only intended to be called from
* only for backend implementations deriving from #PangoFcFontmap.
diff --git a/pango/pangofc-fontmap.h b/pango/pangofc-fontmap.h
index 7e339542..ff540b5d 100644
--- a/pango/pangofc-fontmap.h
+++ b/pango/pangofc-fontmap.h
@@ -47,7 +47,7 @@ typedef struct _PangoFcFontMapPrivate PangoFcFontMapPrivate;
* PangoFcFontMap:
*
* #PangoFcFontMap is a base class for font map implementations
- * using the FontConfig and FreeType libraries. To create a new
+ * using the Fontconfig and FreeType libraries. To create a new
* backend using Fontconfig and FreeType, you derive from this class
* and implement a new_font() virtual function that creates an
* instance deriving from #PangoFcFont.
diff --git a/pango/pangoft2-fontmap.c b/pango/pangoft2-fontmap.c
index 639ddebe..6a1b0ca5 100644
--- a/pango/pangoft2-fontmap.c
+++ b/pango/pangoft2-fontmap.c
@@ -177,7 +177,7 @@ pango_ft2_font_map_set_default_substitute (PangoFT2FontMap *fontmap,
* Call this function any time the results of the
* default substitution function set with
* pango_ft2_font_map_set_default_substitute() change.
- * That is, if your subsitution function will return different
+ * That is, if your substitution function will return different
* results for the same input pattern, you must call this function.
*
* Since: 1.2
@@ -231,8 +231,8 @@ pango_ft2_font_map_create_context (PangoFT2FontMap *fontmap)
/**
* pango_ft2_get_context:
- * @dpi_x: the horizontal dpi of the target device
- * @dpi_y: the vertical dpi of the target device
+ * @dpi_x: the horizontal DPI of the target device
+ * @dpi_y: the vertical DPI of the target device
*
* Retrieves a #PangoContext for the default PangoFT2 fontmap
* (see pango_ft2_fontmap_get_for_display()) and sets the resolution
diff --git a/pango/pangoft2-render.c b/pango/pangoft2-render.c
index 473235fa..00bfeff4 100644
--- a/pango/pangoft2-render.c
+++ b/pango/pangoft2-render.c
@@ -536,7 +536,7 @@ pango_ft2_renderer_draw_trapezoid (PangoRenderer *renderer,
/**
* pango_ft2_render_layout_subpixel:
- * @bitmap: a FT_Bitmap to render the layout onto
+ * @bitmap: a <type>FT_Bitmap</type> to render the layout onto
* @layout: a #PangoLayout
* @x: the X position of the left of the layout (in Pango units)
* @y: the Y position of the top of the layout (in Pango units)
@@ -573,7 +573,7 @@ pango_ft2_render_layout_subpixel (FT_Bitmap *bitmap,
/**
* pango_ft2_render_layout:
- * @bitmap: a FT_Bitmap to render the layout onto
+ * @bitmap: a <type>FT_Bitmap</type> to render the layout onto
* @layout: a #PangoLayout
* @x: the X position of the left of the layout (in pixels)
* @y: the Y position of the top of the layout (in pixels)
@@ -591,7 +591,7 @@ pango_ft2_render_layout (FT_Bitmap *bitmap,
/**
* pango_ft2_render_layout_line_subpixel:
- * @bitmap: a FT_Bitmap to render the line onto
+ * @bitmap: a <type>FT_Bitmap</type> 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)
@@ -628,7 +628,7 @@ pango_ft2_render_layout_line_subpixel (FT_Bitmap *bitmap,
/**
* pango_ft2_render_layout_line:
- * @bitmap: a FT_Bitmap to render the line onto
+ * @bitmap: a <type>FT_Bitmap</type> to render the line onto
* @line: a #PangoLayoutLine
* @x: the x position of start of string (in pixels)
* @y: the y position of baseline (in pixels)
diff --git a/pango/pangoft2.c b/pango/pangoft2.c
index b7f1470e..c16575ce 100644
--- a/pango/pangoft2.c
+++ b/pango/pangoft2.c
@@ -155,14 +155,14 @@ set_transform (PangoFT2Font *ft2font)
* pango_ft2_font_get_face:
* @font: a #PangoFont
*
- * Returns the native FreeType2 FT_Face structure used for this PangoFont.
+ * Returns the native FreeType2 <type>FT_Face</type> structure used for this #PangoFont.
* This may be useful if you want to use FreeType2 functions directly.
*
* Use pango_fc_font_lock_face() instead; when you are done with a
* face from pango_fc_font_lock_face() you must call
* pango_fc_font_unlock_face().
*
- * Return value: a pointer to a #FT_Face structure, with the size set correctly
+ * Return value: a pointer to a <type>FT_Face<type> structure, with the size set correctly
**/
FT_Face
pango_ft2_font_get_face (PangoFont *font)
diff --git a/pango/pangowin32-fontcache.c b/pango/pangowin32-fontcache.c
index 1fd64e19..cec852f2 100644
--- a/pango/pangowin32-fontcache.c
+++ b/pango/pangowin32-fontcache.c
@@ -162,7 +162,7 @@ cache_entry_unref (PangoWin32FontCache *cache,
* @cache: a #PangoWin32FontCache
* @logfont: a pointer to a LOGFONT structure describing the font to load.
*
- * Creates a #HFONT from a LOGFONT. The
+ * Creates a HFONT from a LOGFONT. The
* result may be newly loaded, or it may have been previously
* stored
*
diff --git a/pango/pangowin32-fontmap.c b/pango/pangowin32-fontmap.c
index ad140b72..167f8a13 100644
--- a/pango/pangowin32-fontmap.c
+++ b/pango/pangowin32-fontmap.c
@@ -703,13 +703,13 @@ get_family_name (const LOGFONT *lfp)
* The face name, italicness and weight fields in the LOGFONT are used
* to set up the resulting #PangoFontDescription. If the face name in
* the LOGFONT contains non-ASCII characters the font is temporarily
- * loaded (using CreateFontIndirect) and an ASCII (usually English)
+ * loaded (using CreateFontIndirect()) and an ASCII (usually English)
* name for it is looked up from the font name tables in the font
* data. If that doesn't work, the face name is converted from the
* system codepage to UTF-8 and that is used.
*
* Return value: the newly allocated #PangoFontDescription, which
- * should be freed using pango_font_desciption_free()
+ * should be freed using pango_font_description_free()
*
* Since: 1.12
*/
diff --git a/pango/pangowin32.c b/pango/pangowin32.c
index 71f2ddeb..2fc734be 100644
--- a/pango/pangowin32.c
+++ b/pango/pangowin32.c
@@ -179,7 +179,7 @@ pango_win32_get_dc (void)
/**
* pango_win32_get_debug_flag:
*
- * Returns wether debugging is turned on.
+ * Returns whether debugging is turned on.
*
* Return value: %TRUE if debugging is turned on.
*
@@ -245,7 +245,7 @@ pango_win32_font_new (PangoFontMap *fontmap,
* @x: the x position of start of string (in pixels)
* @y: the y position of baseline (in pixels)
*
- * Render a PangoGlyphString onto a Windows DC
+ * Render a #PangoGlyphString onto a Windows DC
*/
void
pango_win32_render (HDC hdc,
@@ -676,7 +676,7 @@ pango_win32_font_real_get_metrics_factor (PangoFont *font)
* pango_win32_font_logfont:
* @font: a #PangoFont which must be from the Win32 backend
*
- * Determine the LOGFONT struct for the specified bfont.
+ * Determine the LOGFONT struct for the specified font.
*
* Return value: A newly allocated LOGFONT struct. It must be
* freed with g_free().
@@ -704,7 +704,7 @@ pango_win32_font_logfont (PangoFont *font)
* Selects the font into the specified DC and changes the mapping mode
* and world transformation of the DC appropriately for the font.
* You may want to surround the use of this function with calls
- * to SaveDC and RestoreDC. Call pango_win32_font_done_font() when
+ * to SaveDC() and RestoreDC(). Call pango_win32_font_done_font() when
* you are done using the DC to release allocated resources.
*
* See pango_win32_font_get_metrics_factor() for information about
diff --git a/pango/pangox-fontmap.c b/pango/pangox-fontmap.c
index f5d2437c..c8f8556b 100644
--- a/pango/pangox-fontmap.c
+++ b/pango/pangox-fontmap.c
@@ -524,11 +524,11 @@ pango_x_font_map_load_font (PangoFontMap *fontmap,
/* We need to be robust against errors accessing the coverage
* cache window, since it is not our window. So we temporarily
- * set this error handler while accessing it. The error_occured
- * global allows us to tell whether an error occured for
+ * set this error handler while accessing it. The error_occurred
+ * global allows us to tell whether an error occurred for
* XChangeProperty
*/
-static gboolean error_occured;
+static gboolean error_occurred;
static int
ignore_error (Display *d,
@@ -601,7 +601,7 @@ pango_x_real_get_coverage_win (Display *display)
return retval;
}
-/* Find or create the peristant window for caching font coverage
+/* Find or create the persistent window for caching font coverage
* information.
*
* To assure atomic creation, we first look for the window, then if we
@@ -756,7 +756,7 @@ pango_x_store_cached_coverage (PangoXFontMap *xfontmap,
break;
old_handler = XSetErrorHandler (ignore_error);
- error_occured = False;
+ error_occurred = False;
XChangeProperty (xfontmap->display,
coverage_win,
@@ -768,7 +768,7 @@ pango_x_store_cached_coverage (PangoXFontMap *xfontmap,
XSync (xfontmap->display, False);
XSetErrorHandler (old_handler);
- if (!error_occured)
+ if (!error_occurred)
break;
else
{
@@ -1220,7 +1220,7 @@ match_end (const char *a, const char *b)
return (strcmp (a + len_a - len_b, b) == 0);
}
-/* Given a xlfd, charset and size, find the best matching installed X font.
+/* Given a XLFD, charset and size, find the best matching installed X font.
* The XLFD must be a full XLFD (14 fields)
*/
char *
diff --git a/pango/pangox.c b/pango/pangox.c
index 40947d4a..aa8b5918 100644
--- a/pango/pangox.c
+++ b/pango/pangox.c
@@ -315,7 +315,7 @@ pango_x_font_new (PangoFontMap *fontmap, const char *spec, int size)
*
* Loads up a logical font based on a "fontset" style text
* specification. This is not remotely useful (Pango API's generally
- * work in terms of PangoFontDescription) and the result may not
+ * work in terms of #PangoFontDescription) and the result may not
* work correctly in all circumstances. Use of this function should
* be avoided.
*
@@ -1450,7 +1450,7 @@ pango_x_find_glyph (PangoFont *font,
* you should generally use PANGO_GET_UNKNOWN_GLYPH() instead,
* since that may return a glyph that provides a better representation
* of a particular char. (E.g., by showing hex digits, or a glyph
- * representive of a certain Unicode range.)
+ * representative of a certain Unicode range.)
*
* Return value: a glyph index into @font.
**/
diff --git a/pango/pangoxft-font.c b/pango/pangoxft-font.c
index 51fa7fcf..477cc62c 100644
--- a/pango/pangoxft-font.c
+++ b/pango/pangoxft-font.c
@@ -114,7 +114,7 @@ _pango_xft_font_new (PangoXftFontMap *xftfontmap,
* Gets the font used for drawing the digits in the
* missing-character hex squares
*
- * Return value: the PangoFont used for the digits; this
+ * Return value: the #PangoFont used for the digits; this
* value is associated with the main font and will be freed
* along with the main font.
**/
@@ -528,13 +528,13 @@ pango_xft_font_get_unknown_glyph (PangoFont *font,
* pango_xft_font_lock_face:
* @font: a #PangoFont.
*
- * Gets the FreeType FT_Face associated with a font,
+ * Gets the FreeType <type>FT_Face</type> associated with a font,
* This face will be kept around until you call
* pango_xft_font_unlock_face().
*
* Use pango_fc_font_lock_face() instead.
*
- * Return value: the FreeType FT_Face associated with @font.
+ * Return value: the FreeType <type>FT_Face</type> associated with @font.
*
* Since: 1.2
**/
diff --git a/pango/pangoxft-fontmap.c b/pango/pangoxft-fontmap.c
index a033268c..2e6f8996 100644
--- a/pango/pangoxft-fontmap.c
+++ b/pango/pangoxft-fontmap.c
@@ -282,7 +282,7 @@ pango_xft_set_default_substitute (Display *display,
* Call this function any time the results of the
* default substitution function set with
* pango_xft_set_default_substitute() change.
- * That is, if your subsitution function will return different
+ * That is, if your substitution function will return different
* results for the same input pattern, you must call this function.
*
* Since: 1.2
@@ -335,7 +335,7 @@ pango_xft_get_context (Display *display,
* _pango_xft_font_map_get_renderer:
* @fontmap: a #PangoXftFontmap
*
- * Gets the singleton PangoXFTRenderer for this fontmap.
+ * Gets the singleton #PangoXFTRenderer for this fontmap.
*
* Return value:
**/
diff --git a/pango/pangoxft-render.c b/pango/pangoxft-render.c
index 7651cb61..0d104191 100644
--- a/pango/pangoxft-render.c
+++ b/pango/pangoxft-render.c
@@ -642,7 +642,7 @@ release_renderer (PangoRenderer *renderer)
* pango_xft_render_layout:
* @draw: an #XftDraw
* @color: the foreground color in which to draw the layout
- * (may be overriden by color attributes)
+ * (may be overridden by color attributes)
* @layout: a #PangoLayout
* @x: the X position of the left of the layout (in Pango units)
* @y: the Y position of the top of the layout (in Pango units)
@@ -679,7 +679,7 @@ pango_xft_render_layout (XftDraw *draw,
* pango_xft_render_layout_line:
* @draw: an #XftDraw
* @color: the foreground color in which to draw the layout line
- * (may be overriden by color attributes)
+ * (may be overridden 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)
@@ -792,7 +792,7 @@ pango_xft_render (XftDraw *draw,
* pango_xft_picture_render:
* @display: an X display
* @src_picture: the source picture to draw the string with
- * @dest_picture: the destination picture to draw the strign onto
+ * @dest_picture: the destination picture to draw the string onto
* @font: the font in which to draw the string
* @glyphs: the glyph string to draw
* @x: the x position of start of string (in pixels)
diff --git a/pango/reorder-items.c b/pango/reorder-items.c
index 41fb370d..aa9bd8c0 100644
--- a/pango/reorder-items.c
+++ b/pango/reorder-items.c
@@ -31,18 +31,17 @@ static GList *reorder_items_recurse (GList *items, int n_items);
/**
* pango_reorder_items:
- * @logical_items: a GList of #PangoItem in logical order.
+ * @logical_items: a #GList of #PangoItem in logical order.
*
* From a list of items in logical order and the associated
* directional levels, produce a list in visual order.
* The original list is unmodified.
*
- * Returns a GList of PangoItem structures in visual order.
+ * Returns a #GList of #PangoItem structures in visual order.
*
- * (Please mail otaylor@redhat.com if you use this function.
+ * (Please open a bug if you use this function.
* It is not a particularly convenient interface, and the code
* is duplicated elsewhere in Pango for that reason.)
- *
*/
GList *
pango_reorder_items (GList *logical_items)