emoji: add one-shot candidate search

README.md

@@ -66,12 +66,32 @@ Switch input modes with Ctrl + key:
 	S  Hangul
 	T  English
 	V  Vietnamese (Telex)
-	E  Emoji
-	P  Toggle preedit/candidate popup window
+	P  Toggle preedit echo
 
 Type romanized input. Select candidates with 1-9 or arrow keys.
 Tab or Enter to commit.
 
+### Emoji and symbols
+
+Ctrl+E starts a one-shot symbol search; it is not a mode. Any current preedit
+is committed, then the previous language is kept for the next input. Type an
+English alias or the phonetic keys of the current layout (Korean aliases work,
+for example). The candidate list is shown even when Ctrl+P has hidden normal
+preedit echo.
+
+	안녕 → Ctrl+E → smile → Enter → 😀
+
+There is no auto-insert. Enter commits the first candidate (or the current
+one); arrows and Tab move, Alt+1 through Alt+9 select, Esc cancels. Plain
+digits are part of the query.
+
+`map/emoji.src` is the source of truth: each UTF-8 TSV row is a result followed
+by one or more tab-separated aliases. Aliases may be multilingual. Run
+`map/mkemoji > map/emoji.dict` after editing it; `make verify-map` checks the
+generated dictionary and the Telex map.
+
+	😀	웃음	웃다	스마일	smile	grin
+
 ## Architecture
 
 Threads communicate via CSP channels: