diff options
| author | Nathan Willis <nwillis@glyphography.com> | 2018-11-15 15:47:03 -0600 |
|---|---|---|
| committer | Khaled Hosny <khaledhosny@eglug.org> | 2018-11-24 16:46:02 +0200 |
| commit | 939220e57da613e090d247aa1af2396c28370af4 (patch) | |
| tree | 7530f7f9e9a440c9ae532e2d3f378eb0579e2958 /docs | |
| parent | 53ac46e974cf0ee8720b40ef394714eb97ff53b9 (diff) | |
Usermanual: clusters chapter, minor updates.
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/usermanual-clusters.xml | 25 |
1 files changed, 16 insertions, 9 deletions
diff --git a/docs/usermanual-clusters.xml b/docs/usermanual-clusters.xml index f7db0f59..c59818fc 100644 --- a/docs/usermanual-clusters.xml +++ b/docs/usermanual-clusters.xml @@ -30,20 +30,21 @@ <itemizedlist> <listitem> <para> - Correctly positioning the cursor between two characters that - have combined into a single glyph by forming a ligature. + Correctly positioning the cursor within a shaped text run, + even when characters have formed ligatures, composed or + decomposed, reordered, or undergone other shaping operations. </para> </listitem> <listitem> <para> Correctly highlighting a text selection that includes some, - but not all, of the characters comprising a ligature. + but not all, of the characters in a word. </para> </listitem> <listitem> <para> Applying text attributes (such as color or underlining) to - part, but not all, of a composed base-and-mark combination. + part, but not all, of a word. </para> </listitem> <listitem> @@ -54,6 +55,12 @@ </listitem> <listitem> <para> + Determining the mapping between input characters and output + glyphs, such as which glyphs are ligatures. + </para> + </listitem> + <listitem> + <para> Performing line-breaking, justification, and other line-level or paragraph-level operations that must be done after shaping is complete, but which require character-level @@ -69,7 +76,7 @@ This cluster value is an arbitrary number; HarfBuzz uses it only to distinguish between clusters. Many client programs will use the index of each code point in the input text stream as the - cluster value, as a matter of convenience; the actual value does + cluster value, for the sake of convenience; the actual value does not matter. </para> <para> @@ -122,10 +129,10 @@ Level 1 differs from level 0 by not merging the clusters of marks and other modifier code points with the preceding "base" code point's cluster. By preserving the - cluster values of these marks and modifier code points, - script shaping can perform additional operations that might - lead to improved results (for example, reordering a sequence - of marks). + separate cluster values of these marks and modifier code + points, script shapers can perform additional operations + that might lead to improved results (for example, reordering + a sequence of marks). </para> <para> Client programs can specify level 1 behavior for a buffer by |