diff options
author | Matthias Clasen <mclasen@redhat.com> | 2021-08-19 11:34:30 -0400 |
---|---|---|
committer | Matthias Clasen <mclasen@redhat.com> | 2021-08-19 11:34:30 -0400 |
commit | 5184be8241f4cb77d069b89db4895f9dd5abbd28 (patch) | |
tree | 61f1299719be67ada2097bde1e401474ff0ee9f3 /pango | |
parent | d730c313c22fb9743a8397ce9f5599d5b97180b4 (diff) | |
download | pango-5184be8241f4cb77d069b89db4895f9dd5abbd28.tar.gz |
Document incompatibility of tabs and justificationdocument-tabs
Not great, but these *are* conflicting features.
Fixes: #595
Diffstat (limited to 'pango')
-rw-r--r-- | pango/pango-layout.c | 13 |
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, |