summaryrefslogtreecommitdiff
path: root/pango/pango-item.h
diff options
context:
space:
mode:
Diffstat (limited to 'pango/pango-item.h')
-rw-r--r--pango/pango-item.h25
1 files changed, 16 insertions, 9 deletions
diff --git a/pango/pango-item.h b/pango/pango-item.h
index d4162f90..a1e95086 100644
--- a/pango/pango-item.h
+++ b/pango/pango-item.h
@@ -34,7 +34,8 @@ typedef struct _PangoItem PangoItem;
* PANGO_ANALYSIS_FLAG_CENTERED_BASELINE:
*
* Whether the segment should be shifted to center around the baseline.
- * Used in vertical writing directions mostly.
+ *
+ * This is mainly used in vertical writing directions.
*
* Since: 1.16
*/
@@ -43,8 +44,7 @@ typedef struct _PangoItem PangoItem;
/**
* PANGO_ANALYSIS_FLAG_IS_ELLIPSIS:
*
- * This flag is used to mark runs that hold ellipsized text,
- * in an ellipsized layout.
+ * Whether this run holds ellipsized text.
*
* Since: 1.36.7
*/
@@ -53,8 +53,7 @@ typedef struct _PangoItem PangoItem;
/**
* PANGO_ANALYSIS_FLAG_NEED_HYPHEN:
*
- * This flag tells Pango to add a hyphen at the end of the
- * run during shaping.
+ * Whether to add a hyphen at the end of the run during shaping.
*
* Since: 1.44
*/
@@ -66,19 +65,24 @@ typedef struct _PangoItem PangoItem;
* @lang_engine: unused
* @font: the font for this segment.
* @level: the bidirectional level for this segment.
- * @gravity: the glyph orientation for this segment (A #PangoGravity).
+ * @gravity: the glyph orientation for this segment (A `PangoGravity`).
* @flags: boolean flags for this segment (Since: 1.16).
- * @script: the detected script for this segment (A #PangoScript) (Since: 1.18).
+ * @script: the detected script for this segment (A `PangoScript`) (Since: 1.18).
* @language: the detected language for this segment.
* @extra_attrs: extra attributes for this segment.
*
- * The #PangoAnalysis structure stores information about
+ * The `PangoAnalysis` structure stores information about
* the properties of a segment of text.
*/
struct _PangoAnalysis
{
+#ifndef __GI_SCANNER__
PangoEngineShape *shape_engine;
PangoEngineLang *lang_engine;
+#else
+ gpointer shape_engine;
+ gpointer lang_engine;
+#endif
PangoFont *font;
guint8 level;
@@ -98,7 +102,10 @@ struct _PangoAnalysis
* @num_chars: number of Unicode characters in the item.
* @analysis: analysis results for the item.
*
- * The #PangoItem structure stores information about a segment of text.
+ * The `PangoItem` structure stores information about a segment of text.
+ *
+ * You typically obtain `PangoItems` by itemizing a piece of text
+ * with [func@itemize].
*/
struct _PangoItem
{