ref: b4e31923d4c4d447eb5c5a9153f26f05a56c9d08
parent: 7ea770830e0b91046332ddbf350154a58713c386
author: Jacob Moody <moody@posixcafe.org>
date: Wed Oct 12 14:48:51 EDT 2022
ktrans(1): remove README files While the logic described in these has been preserved carefully and still accurate, the man page now covers all that is presented and includes documentation on newer features.
--- a/sys/man/1/ktrans
+++ b/sys/man/1/ktrans
@@ -197,10 +197,6 @@
.SH SEE ALSO
.IR rio (4)
.IR kbdfs (8)
-.br
-.IR /sys/src/cmd/ktrans/README.kenji
-.br
-.IR /sys/src/cmd/ktrans/READMEJ.kenji
.SH BUGS
.PP
There is no hint from rio when the user moves the cursor, as such
--- a/sys/src/cmd/ktrans/README.kenji
+++ /dev/null
@@ -1,108 +1,0 @@
-This version of ktrans works with pipefile by Rob Pike, which replaces /dev/kbd of
-2nd Edition Plan 9 by Dennis Ritchie. By this new idea, we can input Japanese
-anytime onto any windows. I included his post to 9fans mailing-list here (pipefile
-file).
-
-This is a distribution as a derived work license of Plan 9, and I included the
-Plan 9 License term here. Please refer to it on the details of this license.
-
-
-Main features are as follows:
-
-1) There is a "local" dictionary file for translation from kana to kanji, which can
- easily be edited by the user. The default file name is $home/lib/ktrans-jisho.
- If you want to use another dictionary file, set the KTJISHO environment
- variable to point to that file. This dictionary comprises many lines of
- edittable text strings.
-
-2) Capital romaji input is used for words such as verbs or adjectives with okurigana,
- which follows the idea of the SKK system by Masahiko Sato of Kyoto Univ.
- (masahiko@kuis.kyoto-u.ac.jp). If you want to get the kanji string (runes)
- "動かす", which is a verb, you may input "ugoKasu" from the keyboard.
- Note here the Kasu's k is a capital (important). You will see hiragana
- runes "うごかす", and then the kanji runes of "動かす", when you type
- "Shift+Space".
- If you are satisfied by that translation, continue to input the next word.
- If you are not pleased with that candidate, hit 'Shift+Space' once more
- to see more candiates for that hiragana input. When there are no more candidates
- registered in your dictionary, you will see the initial hiragana input.
-
-3) For Japanese "joshi", a post-positioned short word after a noun, you can use another
- method that I developed for this work. If you want the kanji string (runes) "私は",
- then type "watashiHA" from the keyboard. Note that the sound of "wa(ha)" is expressed
- as capitalized "HA". You will see a hiragana string of "わたしは", and then "私は"
- after `Shift+Space'.
-
-4) A control sequence of 'ctl-l' is introduced to leave input hiragana runes unchanged.
- This is occasionally neccessary.
-
-5) A simple leaning mechanism has been implemented for the in-memory hashing
- dictinary, in which the most recently used kanji runes (candidate) moves to the top
- of the list of candidates. This is valid only during the session you called ktrans.
- It is done this way intentionally, because the present learning method is ..well...
- naive. ^_^ I know this; however, I believe you can solve it by making a good
- dictionary best fitted to your purposes on your own.
-
-6) 'ctl-x' re-reads the new kana-kanji translation dictionary when you have edited your
- kana-kanji translation, and want to incorporate it into your current in-memory translation
- dictionary. The kana-kanji translation dictionary is usually read only once, at the
- beginning of the ktrans session. I believe this simplification is not a serious constraint,
- because you can edit the dictionary anytime by co-working with acme and using this ctl-x
- mechanism.
-
-7) A mode change to kana-input is triggered by 'ctl-n', ctl-k for katakana mode,
- ctl-g for Greek mode, and ctl-r for Russian mode.
-
-8) As the starting $home/lib/ktrans-jisho, you may re-format the SKK-JISYO.S (66.9KB) of the
- SKK system, which can be retrieved from ftp.kuis.kyoto-u.ac.jp. The next three lines
- show the short sed filter to transform from an SKK type dictionary to Plan 9. Before
- this, you should change the kanji code of the SKK dictionary from ujis(euc) to UTF-8 by
- the tcs utility, of course.
- s/\// /g
- s/ / /g
- s/ $//g
- The header items are sorted in a strange order in the original SKK dictionary.
- This implementation does not care about the order, therefore, you can change it on
- your own.
-
-9) SKK jisho, such as SKK-JISYO.S, is composed of two parts, okuri-ari and okuri-nashi
- entries. This greatly depends on the Japanese grammer, and okuri-ari may represent
- verb/adjective etc., i.e., not noun. These two parts work differently in the original
- SKK system, however, I did not employ that method; rather, I took a simple approarch
- as described in (2) and (3). Here, we make no difference between these two parts,
- and the reason why I left the two-part structure is just to make it easier to read for
- editting. Of course, you can change it without any side-effects.
-
-10) The essence of this Japanese input method is to convert every one word by one key
- triggering. This may cause some cumbersome feelings for Nihongo users who are accustomed
- to, say, Windows. I know this. However, I intended to keep the codes as compact as
- possible as a first step towards developing a Nihongo input system on Plan 9.
- Furthermore, I've never seen the latter work perfectly. I think the conversion failed
- essentially when we see more than, say, five/six candidates for one set of hiragana runes.
- Finaly, I'd like to add that I have no problem to write long Japanese documents by
- this version.
-
-11) The translation trigger key has been changed from ^t to Shift+Space, because
- we experienced butting of the trigger key sequence sometime. For this reason,
- you have to edit the key-binding table, such as kbtabshift[0x39] in /sys/src/9/pc/kbd.c
- or keymapshift[0x79] in /sys/src/9/ss/screen.c to assign Shift+Space to '^\'.
- I use here '^\' as the trigger key. Therefore, you can trigger translation
- from kana to kanji by Shit+Space or just '^\'.
-
-12) A usage example: If you want to make the Japanese text as below:
-
- 私は毎日35分以上歩いて、 更に10分電車に乗って学校に通います。
- 健康の維持にも役だっていますが、 なかなかたのしいものです。
-
- your keyboard typing stream should be:
-
- watashiHA[^t]mainichi[^t]35[^l]fun[^t]ijou[^t]aruIte, [^t]saraNI[^t]
- 10[^l]fun[^t]denshaNI[^t]noTte[^t]gakkouNI[^t]kayoImasu.[^t]
- kenkouNO[^t]ijiNImo[^t]yakuDAtteimasuga, [^t]nakanaka[^l]tanoshiI[^t]
- monodesu.[^l]
-
- where [^t], [^l] indicates 'Shift+Space' and 'ctl-l', respectively.
-
-
- Kenji Okamoto August 14, 2000
-
--- a/sys/src/cmd/ktrans/READMEJ.kenji
+++ /dev/null
@@ -1,126 +1,0 @@
-Plan 9がRelase 3になってソースが公開されました。このため、更に多くのユーザがPlan 9を
-使い始める事になると思います。このバージョンになって、Windowシステムが8½からrioに
-変更になり、それにともなって、release 2に含まれていたktransが無くなりました。
-
-そこで、Rob Pikeさんにお願いしたら、pipefileというすばらしいアイデアを考えて戴け
-ました。これはrelease 2でDennis Ritchieさんが提供した/dev/kbdを置き替えるもので、
-このいきさつは、Pikeさんの9fansのlmailing-listへの投稿を同封してありますので、
-そちら(pipefile)を御覧下さい。この方法は何時でもどのウィンドへも日本語を入力出来る
-ので、以前のバージョンの様にウィンド毎にktransを起動する必要がなくなりました。
-pipefileはrioより前に起動される必要がありますので、ここに同封したKanjiという
-スクリプトを各自のlib/profileにrioを起動する替わりに、このKanjiスクリプトを
-起動する様にして下さい。
-
-
-Main features are as follows:
-
-1) There is a "local" dictionary file for translation from kana to kanji, which can
- easily be edited by the user. The default file name is $home/lib/ktrans-jisho.
- If you want to use another dictionary file, set the KTJISHO environment
- variable to point to that file. This dictionary comprises many lines of
- edittable text strings.
-
-2) Capital romaji input is used for words such as verbs or adjectives with okurigana,
- which follows the idea of the SKK system by Masahiko Sato of Kyoto Univ.
- (masahiko@kuis.kyoto-u.ac.jp). If you want to get the kanji string (runes)
- "動かす", which is a verb, you may input "ugoKasu" from the keyboard.
- Note here the Kasu's k is a capital (important). You will see hiragana
- runes "うごかす", and then the kanji runes of "動かす", when you type
- "Shift+Space".
- If you are satisfied by that translation, continue to input the next word.
- If you are not pleased with that candidate, hit 'Shift+Space' once more
- to see more candiates for that hiragana input. When there are no more candidates
- registered in your dictionary, you will see the initial hiragana input.
-
-3) For Japanese "joshi", a post-positioned short word after a noun, you can use another
- method that I developed for this work. If you want the kanji string (runes) "私は",
- then type "watashiHA" from the keyboard. Note that the sound of "wa(ha)" is expressed
- as capitalized "HA". You will see a hiragana string of "わたしは", and then "私は"
- after `Shift+Space'.
-
-4) A control sequence of 'ctl-l' is introduced to leave input hiragana runes unchanged.
- This is occasionally neccessary.
-
-5) A simple leaning mechanism has been implemented for the in-memory hashing
- dictinary, in which the most recently used kanji runes (candidate) moves to the top
- of the list of candidates. This is valid only during the session you called ktrans.
- It is done this way intentionally, because the present learning method is ..well...
- naive. ^_^ I know this; however, I believe you can solve it by making a good
- dictionary best fitted to your purposes on your own.
-
-6) 'ctl-x' re-reads the new kana-kanji translation dictionary when you have edited your
- kana-kanji translation, and want to incorporate it into your current in-memory translation
- dictionary. The kana-kanji translation dictionary is usually read only once, at the
- beginning of the ktrans session. I believe this simplification is not a serious constraint,
- because you can edit the dictionary anytime by co-working with acme and using this ctl-x
- mechanism.
-
-7) A mode change to kana-input is triggered by 'ctl-n', ctl-k for katakana mode,
- ctl-g for Greek mode, and ctl-r for Russian mode.
-
-8) As the starting $home/lib/ktrans-jisho, you may re-format the SKK-JISYO.S (66.9KB) of the
- SKK system, which can be retrieved from ftp.kuis.kyoto-u.ac.jp. The next three lines
- show the short sed filter to transform from an SKK type dictionary to Plan 9. Before
- this, you should change the kanji code of the SKK dictionary from ujis(euc) to UTF-8 by
- the tcs utility, of course.
- s/\// /g
- s/ / /g
- s/ $//g
- The header items are sorted in a strange order in the original SKK dictionary.
- This implementation does not care about the order, therefore, you can change it on
- your own.
-
-9) SKK jisho, such as SKK-JISYO.S, is composed of two parts, okuri-ari and okuri-nashi
- entries. This greatly depends on the Japanese grammer, and okuri-ari may represent
- verb/adjective etc., i.e., not noun. These two parts work differently in the original
- SKK system, however, I did not employ that method; rather, I took a simple approarch
- as described in (2) and (3). Here, we make no difference between these two parts,
- and the reason why I left the two-part structure is just to make it easier to read for
- editting. Of course, you can change it without any side-effects.
-
-10) The essence of this Japanese input method is to convert every one word by one key
- triggering. This may cause some cumbersome feelings for Nihongo users who are accustomed
- to, say, Windows. I know this. However, I intended to keep the codes as compact as
- possible as a first step towards developing a Nihongo input system on Plan 9.
- Furthermore, I've never seen the latter work perfectly. I think the conversion failed
- essentially when we see more than, say, five/six candidates for one set of hiragana runes.
- Finaly, I'd like to add that I have no problem to write long Japanese documents by
- this version.
-
-11) The translation trigger key has been changed from ^t to Shift+Space, because
- we experienced butting of the trigger key sequence sometime. For this reason,
- you have to edit the key-binding table, such as kbtabshift[0x39] in /sys/src/9/pc/kbd.c
- or keymapshift[0x79] in /sys/src/9/ss/screen.c to assign Shift+Space to '^\'.
- I use here '^\' as the trigger key. Therefore, you can trigger translation
- from kana to kanji by Shit+Space or just '^\'.
-
-12) A usage example: If you want to make the Japanese text as below:
-
- 私は毎日35分以上歩いて、 更に10分電車に乗って学校に通います。
- 健康の維持にも役だっていますが、 なかなかたのしいものです。
-
- your keyboard typing stream should be:
-
- watashiHA[^t]mainichi[^t]35[^l]fun[^t]ijou[^t]aruIte, [^t]saraNI[^t]
- 10[^l]fun[^t]denshaNI[^t]noTte[^t]gakkouNI[^t]kayoImasu.[^t]
- kenkouNO[^t]ijiNImo[^t]yakuDAtteimasuga, [^t]nakanaka[^l]tanoshiI[^t]
- monodesu.[^l]
-
- where [^t], [^l] indicates 'Shift+Space' and 'ctl-l', respectively.
-
-
- Kenji Okamoto August 14, 2000
-
-
-これはRelease 2のPlan 9に含まれていたDennis Ritchieさんのktransを機能強化したもので、
-大阪府立大学の岡本健二が作成いたしました。 疑問、提案等がございましたら、
-okamoto@granite.cias.osakafu-u.ac.jpまで御連絡ください。
-なお, Plan 9そのものにつきましては、
- http://basalt.cias.osakafu-u.ac.jp/plan9/p9index.html に95年度より
-ささやかなWeb Pageをもっていますので、そちらも参照くださいませ。
-
-なおこのプログラムはPlan 9のderived workとしてのライセンスを持った配布となります。
-Plan 9のLicense fileを同封してありますので、ここに書かれている事を守ってお使い
-下さいませ。
-
-大阪府立大学総合科学部 岡本健二 August 14, 2000