summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMatthias Clasen <mclasen@redhat.com>2021-12-10 19:24:41 -0500
committerMatthias Clasen <mclasen@redhat.com>2021-12-10 19:24:41 -0500
commit6723792a086fe44cc615c1d1c98c4e2e70255494 (patch)
treed14a3952c7708d1085bd1121a4d41e7cc59cf1f3
parentf57ac8a80197774718cdf5fd1b5d5290e3a5da3b (diff)
downloadpango-6723792a086fe44cc615c1d1c98c4e2e70255494.tar.gz
docs: Expand PangoTabArray docs
-rw-r--r--pango/pango-tabs.c12
-rw-r--r--pango/pango-tabs.h6
2 files changed, 11 insertions, 7 deletions
diff --git a/pango/pango-tabs.c b/pango/pango-tabs.c
index 947b7e9b..bc8a7cb4 100644
--- a/pango/pango-tabs.c
+++ b/pango/pango-tabs.c
@@ -549,9 +549,11 @@ success:
* @tab_index: the index of a tab stop
* @decimal_point: the decimal point to use
*
- * Sets the decimal point to use.
+ * Sets the Unicode character to use as decimal point.
*
- * This is only relevant for %PANGO_TAB_DECIMAL.
+ * This is only relevant for tabs with %PANGO_TAB_DECIMAL alignment,
+ * which align content at the first occurrence of the decimal point
+ * character.
*
* By default, Pango uses the decimal point according
* to the current locale.
@@ -577,9 +579,11 @@ pango_tab_array_set_decimal_point (PangoTabArray *tab_array,
* @tab_array: a `PangoTabArray`
* @tab_index: the index of a tab stop
*
- * Gets the decimal point to use.
+ * Gets the Unicode character to use as decimal point.
*
- * This is only relevant for %PANGO_TAB_DECIMAL.
+ * This is only relevant for tabs with %PANGO_TAB_DECIMAL alignment,
+ * which align content at the first occurrence of the decimal point
+ * character.
*
* The default value of 0 means that Pango will use the
* decimal point according to the current locale.
diff --git a/pango/pango-tabs.h b/pango/pango-tabs.h
index a804977b..40837ba0 100644
--- a/pango/pango-tabs.h
+++ b/pango/pango-tabs.h
@@ -35,9 +35,9 @@ typedef struct _PangoTabArray PangoTabArray;
* until the available space is filled
* @PANGO_TAB_CENTER: the text is centered at the tab stop position
* until the available space is filled
- * @PANGO_TAB_DECIMAL: text before the first '.' appears to the left of the
- * tab stop position (until the available space is filled), the rest to
- * the right
+ * @PANGO_TAB_DECIMAL: text before the first occurrence of the decimal point
+ * character appears to the left of the tab stop position (until the available
+ * space is filled), the rest to the right
*
* `PangoTabAlign` specifies where the text appears relative to the tab stop
* position.