aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorDaniel Eklöf <daniel@ekloef.se>2021-06-30 16:00:33 +0000
committerDaniel Eklöf <daniel@ekloef.se>2021-07-01 05:58:06 +0000
commit9817e44c325f5d44f64bfa768107998134ea7f59 (patch)
tree60412220158008983064e696073355dbe0d37c52 /doc
parentvt: limit grapheme width to 2 cells (diff)
config: add tweak.grapheme-width-method=wcswidth|at-most-2
Diffstat (limited to 'doc')
-rw-r--r--doc/foot.ini.5.scd18
1 files changed, 18 insertions, 0 deletions
diff --git a/doc/foot.ini.5.scd b/doc/foot.ini.5.scd
index 2e408b3a..a0829ad7 100644
--- a/doc/foot.ini.5.scd
+++ b/doc/foot.ini.5.scd
@@ -997,8 +997,26 @@ any of these options.
but is necessary to not break cursor synchronization with the
application running in foot.
+ See also: *grapheme-width-method*.
+
Default: _no_
+*grapheme-width-method*
+ Selects which method to use when calculating the width
+ (i.e. number of columns) of a grapheme cluster. One of *at-most-2*
+ and *wcswidth*.
+
+ *wcswidth* simply adds together the individual width of all
+ codepoints making up the cluster.
+
+ *at-most-2* does the same, but limits the maximum number of
+ columns to 2. This is more correct, but is likely to break
+ applications since applications typically use *wcswidth*(3)
+ internally to calculate the width. This results in cursor
+ de-synchronization issues.
+
+ Default: _at-most-2_
+
*max-shm-pool-size-mb*
This option controls the amount of virtual address space used by
the pixmap memory to which the terminal screen content is