--- nono/doc/index.php	2026/04/29 17:04:57	1.1.1.9
+++ nono/doc/index.php	2026/04/29 17:05:00	1.1.1.10
@@ -46,20 +46,20 @@ nono は NetBSD とかで動作する OM
 
 <h4>Index of this page:</h4>
 <div class="main">
-<a href="#build">ビルド方法 <q>How to build</q></a><br>
-<a href="#commandline">コマンドラインオプション <q>Command Line Option</q></a><br>
-<a href="#configuration">設定 <q>Configuration</q></a><br>
-<a href="#aboutvm">VM について <q>About VM</q></a><br>
-<a href="#tryit">実行してみる <q>Try it</q></a><br>
-<a href="#network">ネットワーク設定例 <q>Example of network setup</q></a><br>
-<a href="#migrate">過去のバージョンからの移行方法
+<a href="#build">1. ビルド方法 <q>How to build</q></a><br>
+<a href="#commandline">2. コマンドラインオプション <q>Command Line Option</q></a><br>
+<a href="#configuration">3. 設定 <q>Configuration</q></a><br>
+<a href="#aboutvm">4. VM について <q>About VM</q></a><br>
+<a href="#tryit">5. 実行してみる <q>Try it</q></a><br>
+<a href="#network">6. ネットワーク設定例 <q>Example of network setup</q></a><br>
+<a href="#migrate">7. 過去のバージョンからの移行方法
 <q>How to migrate from old versions</q></a><br>
-<a href="#changes">変更履歴 <q>Changes</q></a><br>
-<a href="#license">連絡先、ライセンス等 <q>Contact, License, etc</q></a><br>
+<a href="#changes">8. 変更履歴 <q>Changes</q></a><br>
+<a href="#license">9. 連絡先、ライセンス等 <q>Contact, License, etc</q></a><br>
 </div>
 
 <a name="build"></a>
-<h4>ビルド方法 <q>How to build</q></h4>
+<h4>1. ビルド方法 <q>How to build</q></h4>
 <div class="main">
 ビルドには以下が必要です。
 NetBSD(pkgsrc) なら wxWidgets は pkgsrc/x11/wxGTK30 です
@@ -81,7 +81,7 @@ For clang, 7.0 and 8.0 works at least.)
 <p>
 (NetBSD 以外でのビルドはサポートしていませんが)
 Ubuntu 20.04 ではたぶん以下のパッケージが必要です。
-<q>You may need the following packages on Ubuntu 18.04
+<q>You may need the following packages on Ubuntu 20.04
 (though we won't support non-NetBSD platform).</q>
 </p>
 <ul>
@@ -126,7 +126,7 @@ the command line executable.</q>
 
 
 <a name="commandline"></a>
-<h4>コマンドラインオプション <q>Command Line Option</q></h4>
+<h4>2. コマンドラインオプション <q>Command Line Option</q></h4>
 <div class="main">
 <dl>
 <?php
@@ -310,7 +310,7 @@ _EOM_
 
 
 <a name="configuration"></a>
-<h4>設定 <q>Configuration</q></h4>
+<h4>3. 設定 <q>Configuration</q></h4>
 <div class="main">
 VM の設定ファイルはその VM ディレクトリ内の nono.cfg
 (または -c で指定したファイル) です。
@@ -322,7 +322,7 @@ VM の設定ファイルはその VM デ
 (or the file specified by -c option) in the VM directory.
 Its syntax is <tt>key = value</tt> format, one per line.
 White spaces before and after <tt>key</tt> and <tt>value</tt> are ignored.
-And, blank lines, lines beginning with "<tt>#</tt>", and
+Blank lines, lines beginning with "<tt>#</tt>", and
 lines with unrecognized key are also ignored.
 </q>
 <p>
@@ -382,6 +382,20 @@ config_item("ethernet-macaddr = <i>strin
 _EOM_
 );
 
+config_item("hostkbd-input = <i>string</i>", <<<_EOM_
+ホストキーボードの入力モードを指定します。
+<tt>char</tt> ならキャラクタ入力モード、
+<tt>jp</tt> なら日本語キーボードモードです。
+デフォルトは <tt>char</tt> です。
+詳細は <a href="#aboutvm">VM について</a> の章を参照してください。
+<q>Specifies the input mode of the host keyboard.
+<tt>char</tt> means the character mode,
+<tt>jp</tt> means the Japanese keyboard mode.
+The defualt is <tt>char</tt>.
+See <a href="#aboutvm">About VM</a> for details.</q>
+_EOM_
+);
+
 config_item("hostnet-driver = <i>string</i>", <<<_EOM_
 イーサネットデバイスのホスト側ドライバを指定します。
 <tt>afpacket</tt>、<tt>bpf</tt>、<tt>tap</tt> のうち
@@ -787,8 +801,8 @@ _EOM_
 
 
 <a name="aboutvm"></a>
-<h4>VM について <q>About VM</q></h4>
-<h5>ステータスパネル <q>Status Panel</q></h5>
+<h4>4. VM について <q>About VM</q></h4>
+<h5>4.1. ステータスパネル <q>Status Panel</q></h5>
 <div class="main">
 ステータスパネル中央にあるパフォーマンスメータのアイコンは
 高速モードの状態を表示しています。
@@ -830,7 +844,343 @@ the VM is running in full speed mode.
 </table>
 </div>
 
-<h5>キー入力 <q>Key input</q></h5>
+<h5>4.2. キー入力モード <q>Key input mode</q></h5>
+<div class="main">
+LUNA のキーボードは通常日本語キーボードです
+(英語キーボードも存在するようですが…)。
+そのため、ホストが日本語キーボードの場合とそうでない場合のために
+2つの入力モードを用意しています。
+どちらも一長一短があります。
+<q>Most LUNAs have the Japanese keyboard
+(though I ever heard there are the US keyboard...).
+So nono provides two input modes
+for Japanese keyboard users and non Japanese keyboard users.
+Both have advantages and disadvantages.</q>
+<p>
+JP キーボードモードは、ホストが日本語キーボードであることを前提に
+対応するキーの押下、開放をその都度 VM に入力します。
+メリットとしては動作が実機に近くなり、
+特にキーリピート(をハードウェアが行わないこと)も忠実に再現可能です。
+デメリットは ALT + TAB やアクセラレータキーでメニューを開く場合などに
+キー入力が残ることがあることです
+(キーを押した後でフォーカスが外れるとキーを離したことが
+アプリケーションに通知されないため)。
+またホストが日本語キーボードでなければ使いづらいです。
+<q>JP keyboard mode assumes that the host uses the Japanese keyboard.
+Each time you presses and releases a key,
+nono sends the corresponding key-pressed or key-released to the VM.
+One advantage is that it's close to the real machine behavior,
+and another is that it can reproduce
+the LUNA keyboard itself does not perform a key repeat.
+On the other hand,
+one disadvantage is that key sometimes remains pressed,
+especially when you enter ALT + TAB to switch the application
+or enter accelerator key to open the menu
+(If the application loses the focus after the key is pressed,
+the application will not receive the subsequent key release).
+And another disadvantage is that
+it will be hard to use for non Japenese keyboard users.
+</q>
+<p>
+一方、キャラクタ入力モードは、ホストから入力された「文字」を
+再び LUNA のキーコードに解釈し直して VM に入力するモードです。
+例えばゲスト OS に "@" を入力したい場合、
+US キーボードなら [SHIFT] + [2] を、
+JP キーボードなら [@] キーを押しますが、
+どちらも VM には [@] キーの押下、[@] キーの開放が連続して送られます。
+US キーボードで [SHIFT] を押したことは通知されません。
+逆に "=" を入力したい場合、
+US キーボードなら [=] キーを、
+JP キーボードなら [SHIFT] + [-] を押しますが、
+どちらも VM には
+[SHIFT]押下 → [-]押下 → [-]開放 → [SHIFT]開放のシーケンスが送られます。
+このようにホストキーボードのレイアウトによらず、
+入力したい文字が入力できるようになり、
+通常のタイピングで困ることはないと思います。
+デメリットは、通常の文字入力以外のタイピングはほぼ出来ないことです。
+[SHIFT] キーを押したままにすることや、
+文字が入力できないキーの組み合わせは入力出来ません。
+もう一つのデメリットはキーリピート(をハードウェアが行わないこと)が再現できず、
+ホスト側のキーリピートが効いてしまうことです
+(本来キーリピートが動作しない ROM やブートローダでもキーリピートが効くことは
+一般ユーザからはメリットに感じられるかも知れませんが)。
+<q>In contrast, in the character mode, when you type a character,
+nono re-converts it into the LUNA's key code and sends it to the VM.
+For example if you want to type "@" in the guest OS,
+you would press [SHIFT] + [2] on the US keyboard or [@] on the JP keyboard.
+In both cases, the sequence of
+[@]-pressed and [@]-released will be sent to the VM.
+Note that the fact that you pressed [SHIFT] key on the US keyboard
+will not be sent to the VM.
+Another example, if you want to type "=",
+you would press [=] on the US keyboard or [SHIFT] + [-] on the JP keyboard.
+In both cases, the sequence of
+[SHIFT]-pressed, [-]-pressed, [-]-released, and [SHIFT]-released
+will be sent to the VM.
+Thus, you can type what character you want to type,
+regardless of your keyboard layout.
+Of course there are some disadvantages.
+Firstly, it's hard to type any special characters,
+for example, you can not type any key conbinations
+that don't generate a character.
+Or you can not hold [SHIFT] key pressed.
+Secondly, the key repeat works (by the host),
+even though it should not work as a correct emulation
+(Although some of you may feel it an advantage).</q>
+</div>
+
+<h5>4.3. キャラクタ入力モードのキーコード対応表
+<q>Keycode table in the character mode</h5>
+<div class="main">
+キャラクタ入力モードでの、ホストから入力した文字と
+VM に送信されるキーの対応は次の通りです。
+ファンクションキーとカーソルキーは文字ではありませんが
+特別に対応しています。
+HostChar が N/A で示してあるキーはソフトウェアキーボードからのみ入力できます。
+<q>The following table shows the correspondence between
+the character that typed from the host
+and the key that will be sent to the VM.
+nono can recognize the function keys and arrow keys.
+The keys where the HostChar is N/A can
+only be typed from the software keyboard window.</q>
+<p>
+<center>
+<style type="text/css">
+.keytable-whole {
+	display: inline-block;
+	vertical-align: top;
+	border: solid 1px;
+}
+.keytable-middle {
+	margin-left: 1em;
+	margin-right: 1em;
+}
+
+.keytable-head {
+	text-align: left;
+	border-bottom: solid 1px;
+}
+.keytable-headl {
+	padding-right: 1em;
+}
+
+.keytable-tdl {
+	padding-right: 1em;
+}
+.keytable-tdr {
+}
+</style>
+<?php
+	$str = <<<__EOM__
+		<tt>a</tt> 〜 <tt>z</tt>	[A] 〜 [Z]
+		<tt>0</tt> 〜 <tt>9</tt>	[0] 〜 [9]
+		SPACE		[SPACE]
+		<tt>-</tt>	[-]
+		<tt>^</tt>	[^]
+		<tt>&bsol;</tt>	[&bsol;]
+		<tt>@</tt>	[@]
+		<tt>[</tt>	[[]
+		<tt>;</tt>	[;]
+		<tt>:</tt>	[:]
+		<tt>]</tt>	[]]
+		<tt>,</tt>	[,]
+		<tt>.</tt>	[.]
+		<tt>/</tt>	[/]
+		<tt>^@</tt>	[CTRL]+[@]
+		<tt>^A</tt> 〜 <tt>^Z</tt>	[CTRL]+[A] 〜 [CTRL]+[Z]
+		<tt>^[</tt>	[ESC]
+		<tt>^\</tt>	[CTRL]+[&bsol;]
+		<tt>^]</tt>	[CTRL]+[]]
+		<tt>^^</tt>	[CTRL]+[^]
+		<tt>^_</tt>	[CTRL]+[_]
+		<tt>^H</tt>	[BS]
+		<tt>^I</tt>	[TAB]
+		<tt>^M</tt>	[Enter]
+
+		<tt>A</tt> 〜 <tt>Z</tt>	[SHIFT]+[A] 〜 [SHIFT]+[Z]
+		<tt>!</tt>	[SHIFT]+[1]
+		<tt>"</tt>	[SHIFT]+[2]
+		<tt>#</tt>	[SHIFT]+[3]
+		<tt>$</tt>	[SHIFT]+[4]
+		<tt>%</tt>	[SHIFT]+[5]
+		<tt>&amp;</tt>	[SHIFT]+[6]
+		<tt>'</tt>	[SHIFT]+[7]
+		<tt>(</tt>	[SHIFT]+[8]
+		<tt>)</tt>	[SHIFT]+[9]
+		<tt>=</tt>	[SHIFT]+[-]
+		<tt>~</tt>	[SHIFT]+[^]
+		<tt>|</tt>	[SHIFT]+[&bsol;]
+		<tt>`</tt>	[SHIFT]+[@]
+		<tt>{</tt>	[SHIFT]+[[]
+		<tt>+</tt>	[SHIFT]+[;]
+		<tt>*</tt>	[SHIFT]+[:]
+		<tt>]</tt>	[SHIFT]+[]]
+		<tt>&lt;</tt>	[SHIFT]+[,]
+		<tt>&gt;</tt>	[SHIFT]+[.]
+		<tt>?</tt>	[SHIFT]+[/]
+		<tt>_</tt>	[SHIFT]+[_]
+
+		F1 〜 F10	[PF1] 〜 [PF10]
+		↑		[↑]
+		←		[←]
+		→		[→]
+		↓		[↓]
+		N/A		[確定]
+		N/A		[前面]
+		N/A		[CAP]
+		N/A		[かな]
+		N/A		[変換]
+		N/A		[消去]
+		N/A		[呼出]
+		N/A		[文節←]
+		N/A		[文節→]
+		N/A		Numpad[0]〜[9]
+		N/A		Numpad[+]
+		N/A		Numpad[-]
+		N/A		Numpad[*]
+		N/A		Numpad[/]
+		N/A		Numpad[=]
+		N/A		Numpad[.]
+		N/A		Numpad[Enter]
+__EOM__;
+	$table = array();
+	$table[0] = array();
+	$table[1] = array();
+	$table[2] = array();
+	$i = 0;
+	foreach (split("\n", $str) as $s) {
+		if ($s == "") {
+			$i++;
+			continue;
+		}
+		$s = preg_replace("/^\t+/", "", $s);
+		list ($hkey, $gkey) = preg_split("/\t+/", $s);
+		$table[$i][] = array($hkey, $gkey);
+	}
+
+	for ($j = 0; $j < count($table); $j++) {
+		switch ($j) {
+		 case 0:	$classname = "left";	break;
+		 case 1:	$classname = "middle";	break;
+		 case 2:	$classname = "right";	break;
+		}
+		print "<table class='keytable-whole keytable-${classname}'";
+		print " cellspacing=0 cellpadding=1>\n";
+		print "<tr>";
+		print "<th class='keytable-head keytable-headl'>HostChar";
+		print "<th class='keytable-head keytable-headr'>GuestKey\n";
+		for ($i = 0; $i < count($table[$j]); $i++) {
+			list ($h, $g) = $table[$j][$i];
+			print "<tr>";
+			print "<td class='keytable-tdl'>{$h}";
+			print "<td class='keytable-tdr'>${g}\n";
+		}
+		print "</table>\n";
+	}
+?>
+</center>
+</div>
+
+<h5>4.4. JP キーボードモードのキーコード対応表
+<q>Keycode table in the JP keyboard mode</q></h5>
+<div class="main">
+JP キーボードモードでの、ホストキーと VM に送信されるキーの対応は次の通りです。
+HostKey が N/A で示してあるキーは
+ソフトウェアキーボードからのみ入力出来ます。
+<q>The following table shows the correspondence between
+the host key and the guest key.
+The keys where the HostKey is N/A can only be enter from
+the software keyboard window.</q>
+<p>
+<center>
+<?php
+	$str = <<<__EOM__
+		[0] 〜 [9]		[0] 〜 [9]
+		[A] 〜 [Z]		[A] 〜 [Z]
+		[-]				[-]
+		[^]				[^]
+		[&bsol;]		[&bsol;]
+		[@]				[@]
+		[[]				[[]
+		[;]				[;]
+		[:]				[:]
+		[]]				[]]
+		[,]				[,]
+		[.]				[.]
+		[/]				[/]
+		[_]				[_]
+
+		[ESC]			[ESC]
+		[TAB]			[TAB]
+		[CTRL]			[CTRL]
+		[BS]			[BS]
+		[Enter]			[Enter]
+		[F1] 〜 [F10]	[PF1] 〜 [PF10]
+		[DEL]			Numpad[DEL]
+		Numpad[0]〜[9]	Numpad[0]〜[9]
+		Numpad[+]		Numpad[+]
+		Numpad[-]		Numpad[-]
+		Numpad[*]		Numpad[*]
+		Numpad[/]		Numpad[/]
+		Numpad[=]		Numpad[=]
+		Numpad[.]		Numpad[.]
+		Numpad[Enter]	Numpad[Enter]
+
+		[SHIFT-L]		[SHIFT-L]
+		[SHIFT-R]		[SHIFT-R]
+		[↑]			[↑]
+		[←]			[←]
+		[→]			[→]
+		[↓]			[↓]
+		N/A				[確定]
+		N/A				[前面]
+		N/A				[CAP]
+		N/A				[かな]
+		N/A				[変換]
+		N/A				[消去]
+		N/A				[呼出]
+		N/A				[文節←]
+		N/A				[文節→]
+__EOM__;
+	$table = array();
+	$table[0] = array();
+	$table[1] = array();
+	$table[2] = array();
+	$i = 0;
+	foreach (split("\n", $str) as $s) {
+		if ($s == "") {
+			$i++;
+			continue;
+		}
+		$s = preg_replace("/^\t+/", "", $s);
+		list ($hkey, $gkey) = preg_split("/\t+/", $s);
+		$table[$i][] = array($hkey, $gkey);
+	}
+
+	for ($j = 0; $j < count($table); $j++) {
+		switch ($j) {
+		 case 0:	$classname = "left";	break;
+		 case 1:	$classname = "middle";	break;
+		 case 2:	$classname = "right";	break;
+		}
+		print "<table class='keytable-whole keytable-${classname}'";
+		print " cellspacing=0 cellpadding=0>\n";
+		print "<tr>";
+		print "<th class='keytable-head keytable-headl'>HostKey";
+		print "<th class='keytable-head keytable-headr'>GuestKey\n";
+		for ($i = 0; $i < count($table[$j]); $i++) {
+			list ($h, $g) = $table[$j][$i];
+			print "<tr>";
+			print "<td class='keytable-tdl'>{$h}";
+			print "<td class='keytable-tdr'>${g}\n";
+		}
+		print "</table>\n";
+	}
+?>
+</center>
+</div>
+
+<h5>4.5. キーリピート <q>Key Repeat</q></h5>
 <div class="main">
 LUNA では、キーボードがハードウェア側でキーリピートを行わず、
 ソフトウェア(OS など)がキーリピートの処理を行います。
@@ -848,8 +1198,7 @@ VM が高速動作するとキーリピ�
 (ALT + TAB やアクセラレータキーでメニューを開くと起きがちです)
 高速モードが抑制されたままということが起きえます。
 その場合はソフトウェアキーボードからキー入力を解除するなどしてください。
-<q>
-On LUNA,
+<q>On LUNA,
 key repeat is done by software(OS), not by the keyboard hardware.
 For this reason,
 key repeat doesn't occur on LUNA's PROM or NetBSD/luna68k's bootloader
@@ -870,8 +1219,8 @@ In this case, you can resolve it by usin
 
 
 <a name="tryit"></a>
-<h4>実行してみる <q>Try it</q></h4>
-<h5>NetBSD/luna68k を実行してみる <q>Try NetBSD/luna68k</q></h5>
+<h4>5. 実行してみる <q>Try it</q></h4>
+<h5>5.1. NetBSD/luna68k を実行してみる <q>Try NetBSD/luna68k</q></h5>
 <div class="main">
 つついさんが NetBSD/luna68k 9.2 の liveimage を用意されています。
 <q>Tsutsui-san has provided a liveimage of NetBSD/luna68k 9.2.</q>
@@ -978,7 +1327,7 @@ and nono will terminate when the VM is p
 </ol>
 </div>
 
-<h5>OpenBSD/luna88k を実行してみる <q>Try OpenBSD/luna88k</q></h5>
+<h5>5.2. OpenBSD/luna88k を実行してみる <q>Try OpenBSD/luna88k</q></h5>
 <div class="main">
 あおやまさんが OpenBSD/luna88k 6.9 の liveimage を用意されています。
 <q>Aoyama-san has provided a liveimage of OpenBSD/luna88k 6.9.</q>
@@ -1063,7 +1412,7 @@ and nono will terminate when the VM is p
 
 
 <a name="network"></a>
-<h4>ネットワーク設定例 <q>Example of network setup</q></h4>
+<h4>6. ネットワーク設定例 <q>Example of network setup</q></h4>
 <div class=main>
 wm0 を持つ NetBSD ホストに tap(4) デバイスを用いて
 nono のゲスト OS を接続する場合の設定例です。
@@ -1156,14 +1505,8 @@ It's OK if you can see "HostNet Driver:
 </div>
 
 
-<a name="changes"></a>
-<h4>変更履歴 <q>Changes</q></h4>
-<div class="main">
-See <a href="changes.html">changes.html</a>.
-</div>
-
 <a name="migrate"></a>
-<h4>過去のバージョンからの移行方法 <q>How to migrate from old versions</q></h4>
+<h4>7. 過去のバージョンからの移行方法 <q>How to migrate from old versions</q></h4>
 <div class="main">
 バージョンアップに伴い設定ファイル等に非互換が発生する場合があります。
 その場合は以下の移行方法を参照して設定ファイル等を更新してください。
@@ -1174,14 +1517,21 @@ In such case, you may need to upgrade it
 </ul>
 </div>
 
+<a name="changes"></a>
+<h4>8. 変更履歴 <q>Changes</q></h4>
+<div class="main">
+See <a href="changes.html">changes.html</a>.
+</div>
+
 <a name="license"></a>
-<h4>ライセンス <q>License</q></h4>
+<h4>9. 連絡先、ライセンス等 <q>Contact, License, etc</q></h4>
+
+<h5>9.1. ライセンス <q>License</q></h5>
 <div class="main">
 See <a href="nono-license.txt">nono-license.txt</a>.
 </div>
 
-
-<h4>連絡先 <q>Contact us</q></h4>
+<h5>9.2. 連絡先 <q>Contact us</q></h5>
 <div class="main">
 バグ報告などは以下にお願いします。日本語でおk。
 <q>If you find any problems, please let me know.
@@ -1190,8 +1540,7 @@ You may write in English.</q><br>
 >https://github.com/isaki68k/nono-issue/issues</a>
 </div>
 
-
-<h4>パッチの提供について <q>About contributes</q></h4>
+<h5>9.3. パッチの提供について <q>About contributes</q></h5>
 <div class="main">
 パッチを提供してくださる場合は以下に同意したものとします。
 <q>If you provide a patch to nono, you must agree to the following conditions:
@@ -1207,8 +1556,7 @@ You may write in English.</q><br>
 <ul>
 </div>
 
-
-<h4>Acknowledgements</h4>
+<h5>9.4. Acknowledgements</h5>
 <div class="main">
 nono は以下の広告条項を含むソースコードを利用しています。
 <q>nono uses source code with the following advertising clause.</q>