From 725e49a16c7867512635e6ade0f1ff1e01f8e7c5 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 29502a2..249c125 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
+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.

Reply via email to