summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMatthias Clasen <mclasen@redhat.com>2021-08-19 11:34:30 -0400
committerMatthias Clasen <mclasen@redhat.com>2021-08-19 11:34:30 -0400
commit5184be8241f4cb77d069b89db4895f9dd5abbd28 (patch)
tree61f1299719be67ada2097bde1e401474ff0ee9f3
parentd730c313c22fb9743a8397ce9f5599d5b97180b4 (diff)
downloadpango-document-tabs.tar.gz
Document incompatibility of tabs and justificationdocument-tabs
Not great, but these *are* conflicting features. Fixes: #595
-rw-r--r--pango/pango-layout.c13
1 files changed, 12 insertions, 1 deletions
diff --git a/pango/pango-layout.c b/pango/pango-layout.c
index ca5cbe74..ee58243b 100644
--- a/pango/pango-layout.c
+++ b/pango/pango-layout.c
@@ -806,9 +806,13 @@ pango_layout_get_font_description (PangoLayout *layout)
* Note that this setting is not implemented and so is ignored in
* Pango older than 1.18.
*
- * Also see [method@Pango.Layout.set_justify_last_line].
+ * Note that tabs and justification conflict with each other:
+ * Justification will move content away from its tab-aligned
+ * positions.
*
* The default value is %FALSE.
+ *
+ * Also see [method@Pango.Layout.set_justify_last_line].
*/
void
pango_layout_set_justify (PangoLayout *layout,
@@ -1000,9 +1004,16 @@ pango_layout_get_alignment (PangoLayout *layout)
*
* Sets the tabs to use for @layout, overriding the default tabs.
*
+ * `PangoLayout` will place content at the next tab position
+ * whenever it meets a Tab character (U+0009).
+ *
* By default, tabs are every 8 spaces. If @tabs is %NULL, the
* default tabs are reinstated. @tabs is copied into the layout;
* you must free your copy of @tabs yourself.
+ *
+ * Note that tabs and justification conflict with each other:
+ * Justification will move content away from its tab-aligned
+ * positions.
*/
void
pango_layout_set_tabs (PangoLayout *layout,