From 2adc42c03f1a4469679d38b6ba03655e634f954d Mon Sep 17 00:00:00 2001
From: Andrey Yugai <andrhua@pm.me>
Date: Sat, 22 Jul 2023 13:50:39 +0600
Subject: [PATCH] Add instructions for using with non-qwerty system layout

---
 README.md | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/README.md b/README.md
index 687a383..d20cbac 100644
--- a/README.md
+++ b/README.md
@@ -6,3 +6,14 @@ Hangul Wrapper for Fcitx.
 
 [![Coverity Scan Status](https://img.shields.io/coverity/scan/14725.svg)](https://scan.coverity.com/projects/fcitx-fcitx5-hangul)
 
+## Using with non-qwerty English system layout
+The addon handles key input based on its string value, not keycode, so pressing `t` in Colemak is interpreted as ㅅ rather than ㄹ for Dubeolsik. To fix this, set `Default` (qwerty) layout for Hangul.
+
+Via `fcitx5-configtool`: in `Input Method` tab, select Hangul, then press `Select Layout` and choose Layout: English (US), Variant: Default. 
+Or edit profile config file:
+```
+# group and item numbers may be different
+[Groups/1/Items/0]
+Name=hangul
+Layout=us
+```