From 8c454ccf777f426e3c7b46ccba01b4e1e859d9eb Mon Sep 17 00:00:00 2001
From: Thomas Wolff <mintty@users.noreply.github.com>
Date: Mon, 17 Feb 2020 00:00:00 +0100
Subject: [PATCH] Cygwin: describe new locale modifier @cjksingle for user
 guide

---
 winsup/doc/setup-locale.xml | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/winsup/doc/setup-locale.xml b/winsup/doc/setup-locale.xml
index 4872ae202..4b9141e5c 100644
--- a/winsup/doc/setup-locale.xml
+++ b/winsup/doc/setup-locale.xml
@@ -179,6 +179,17 @@ response with this option; it forces wcwidth/wcswidth to return 2 for the
 ambiguous width characters.
 </para></listitem>
 
+<listitem><para>
+As an alternative preference, CJK single-width may be enforced.
+This feature is a
+<ulink url="https://gitlab.freedesktop.org/terminal-wg/specifications/issues/9#note_406682">proposal</ulink>
+in the Terminals Working Group Specifications.
+The mintty terminal implements it as an option with proper glyph scaling.
+The locale modifier "@cjksingle" supports consistent locale response
+with this option; it forces wcwidth/wcswidth to account at most 1 for
+all characters.
+</para></listitem>
+
 </itemizedlist>
 
 </sect2>