# dosbox-jp106/README.ja.txt for dosbox-jp106.sh, jp.kl and mapper-0.74-3-3.map

Written by Taiji Yamada <taiji@aihara.co.jp> at 2022/06/08


## シェルスクリプト `dosbox-jp106.sh` 実行の前に

これは dosbox 起動時に生成される "$HOME/.dosbox/dosbox-*.conf"
ファイルが既に存在することを前提に動作します。

ゆえに、一度は dosbox を通常通りに起動して、終了させておいてください。


## シェルスクリプト `dosbox-jp106.sh` でパスが通っている dosbox を起動

このシェルスクリプト `dosbox-jp106.sh` で起動した dosbox によって、

キーが JIS 配列 (JP106) キーボードに酷似します。但し、以下のキーは
DOSBoxの仕様上、別のキーに割り当てざるを得ませんでした。

	\	F12		|	Shift+F12
				_	Shift+0


## 注意事項

jp.kl ファイルは、同名のファイルが

      https://github.com/vivian-ng/dosbox-x-jp/raw/master/jp.kl

にて配布されていますが、本稿で用意したものは別物で、0 のシフトに _ を
割り当てています。

そのソースコードは ./windows/jp.key です。DOS 上で `KC JP.KEY JP.KL`
で生成しました。KC コマンドは下記サイトの keybx.zip bin/ にあります。

	https://www.ibiblio.org/pub/micro/pc-stuff/freedos/files/distributions/1.0/pkgs/


## 詳述

ファンクションキーに割り当てたキーは、DOSBox ではキーコードが定義され
ておらず、DOSBox ではスキャンコードの処理をしていないようなのですが、
ゆえに、ファンクションキーに割り当てるしか方法がないと判断したキーです。

一方、Shift+0 に割り当てたキーは、キーコードは定義されているのですが、
イベント名が未定義なキーであったので、jp.kl にて対応せざるを得なかっ
たものです。元々の jp.kl の Shift+0 と Shift+9 が「)」に重複して割り当
てられていたので、JIS 配列準拠ではない Shift+0 に割り当てさせて頂きま
した。前者のファンクションキーに割り当てる手段は取れないので、この手段
が最も DOSBox 仕様上はベストだと判断した次第です。
