From e4c65b2e918107287845ab345bc0607bde0323f7 Mon Sep 17 00:00:00 2001 From: Thomas Wolff Date: Thu, 8 Mar 2018 00:29:25 +0100 Subject: [PATCH] describe new locale modifier @cjkwide for user guide --- winsup/doc/setup-locale.xml | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/winsup/doc/setup-locale.xml b/winsup/doc/setup-locale.xml index 29502a23f..4872ae202 100644 --- a/winsup/doc/setup-locale.xml +++ b/winsup/doc/setup-locale.xml @@ -166,6 +166,19 @@ can be used to force wcwidth/wcswidth to return 1 for the ambiguous width characters. + +For the same class of "CJK Ambiguous Width" characters, it may be +desirable to handle them as double-width even when a non-CJK language +setting is selected. This supports e.g. certain graphic symbols used +by "Powerline" and provided by "Powerline fonts". Some terminals have +options to enforce this width handling (xterm -cjk_width, +mintty -o Charwidth=ambig-wide, putty configuration) but that alone +makes character rendering and locale information inconsistent for those +characters. The locale modifier "@cjkwide" supports consistent locale +response with this option; it forces wcwidth/wcswidth to return 2 for the +ambiguous width characters. + +