From 739e15c17839ae1bf03f9a27ed170f3bcb280430 Mon Sep 17 00:00:00 2001
From: rodri <rgl@antares-labs.eu>
Date: Sun, 10 Jul 2022 12:54:09 +0000
Subject: [PATCH] ktrans(1): documented $jisho and made some improvements.
 (thanks to Kenji Okamoto, cinap, BurnZez, romi and Aaron for your work on
 ktrans!)

---
 sys/man/1/ktrans | 27 ++++++++++++++++++---------
 1 file changed, 18 insertions(+), 9 deletions(-)

diff --git a/sys/man/1/ktrans b/sys/man/1/ktrans
index 6e3ba6af1..824ffb67d 100644
--- a/sys/man/1/ktrans
+++ b/sys/man/1/ktrans
@@ -19,7 +19,7 @@ return to default English mode (no transliteration).
 .B ctl-n
 Japanese hiragana: interpret lower-case letters as a Hepburn
 representation of hiragana.  In this mode, typing ctl-\\ looks up the
-last `word' in a hiragana-kanji dictionary and replaces it.
+last `word' in a kana-kanji dictionary and replaces it.
 Subsequent ctl-\\ characters cycle through the possibilities.  A word
 is the longest immediately preceding unbroken string of hiragana
 characters.
@@ -28,15 +28,14 @@ characters.
 Japanese katakana.
 .TP
 .B ctl-l
-If you want to put the hiragana not converted, you can type.
+If you want to put the hiragana without modification.
 .TP
 .B ctl-x
-Read kana-kanji conversion dictionary once more, and renews it.  This
-will be convenient when you updated kana-kanji conversion dictionary
-on such acme editor.In default, the kana-kanji conversion dictionary
-is read once at beginning and to make a hashed table, which will be
-arranged so that the last selected candidate will be the first
-candidate for later search.
+Reload the in-memory kana-kanji conversion dictionary (kanji jisho).
+This is so you can update the kanji jisho on-the-fly.  By default, the
+kanji jisho is read once at the beginning, to make a hash table, which
+will be arranged so that the last selected candidate will be the first
+candidate for later searches.
 .TP
 .B ctl-r
 Russian: interpret letters as Cyrillic; the transliteration is mostly
@@ -62,7 +61,10 @@ Greek.
 .B ctl-s
 Korean.
 .PP
-To use it you have to run it before a rio session. You can put it on your $home/lib/profile like:
+To use
+.I ktrans
+you have to run it before a rio session.  You can put it on your
+$home/lib/profile like:
 .EX
 	...
 	ktrans
@@ -74,6 +76,13 @@ or run it with a sub-rio on a window like:
 	% @{ktrans; rio}
 .EE
 .PP
+The default location of the kanji jisho is
+.LR /lib/kanji.jisho .
+You can change that by means of the
+.L $jisho
+environment variable, so you can keep a customized version of the
+dictionary that fits your personal needs.
+.PP
 .SH SOURCE
 .B /sys/src/cmd/ktrans
 .SH SEE ALSO