APPENDIX 2 - KEYBOARD HANDLING

Keystroke handling is a very complicated business! There are so many layers between the physical keyboard and the application; in this case THE. These layers can be best described with the following diagrams:
キーストローク操作は、とても複雑なビジネスです!フィジカル・キーボードとアプリケーションの間にとても多くの層がいます;このケースTHEで。これらの層は、最もよく以下のダイヤグラムで述べることができます:

Each layer is described below
それぞれの層は下に述べられます

Physical keyboard
フィジカル・キーボード

Each keyboard is potentially different from every other. The similarity that they do posess is that when a key is pressed, a unique code is generated. The state of the Shift, Control, Num Lock, Alt modifiers either alter the unique code generated or a seperate code is generated to identify to the next layer that the key pressed should be modified.
それぞれのキーボードは、潜在的にその他すべてと違います。posessがキーが押されるときに、独特のコードが発生させられるということである彼(それ)らがする類似。Shift、管理、Numロック、Alt修飾子の状態どちらか発生させられた独特のコード、あるいはコードが発生させられるseperateを変えてキーが押すところでは、変更されるべき次の層に識別して下さい。

terminal emulator
端末エミュレータ

This is a required layer if the user is connected to the host via some emulation software. eg a PC connected to a U*ix host requires a terminal emulator of one sort or another.
もしユーザーがあるエミュレーション・ソフトウェア経由でホストとつながっていれば、これは要求された層です。PCがU* ixホストに結んだegは、なんらかのソートに端末エミュレータを要求します。

The terminal emulator translates the unique codes generated by the keyboard usually into physical escape sequences that are passed to the U*ix shell. These escape sequences can be seen by running the U*ix command cat -v . When you press a key on the keyboard while in cat -v , the escape sequences that the terminal emulator has generated are displayed. Some systems require the Enter key to be pressed before the escape sequence is displayed. The term "escape sequence" is used because in most cases, the first character generated is an Escape character (hex 1B). Following the escape is any number of other characters, which together form a unique sequence of characters.
端末エミュレータは、U* ixシェルにフィジカルパスされるエスケープ・シーケンスへ通常キーボードによって発生させられた独特のコードを訳します。これらのエスケープ・シーケンスは、U* ixコマンド・ネコ- vを走らせることによって見ることができます。ネコ- vで(いる)、あなたがキーボードでキーを押すときに、端末エミュレータが発生させたエスケープ・シーケンスは、表示されます。いくつかのシステムは、エスケープ・シーケンスの前に押される(べき)エンター・キーが表示されることが必要です。( hexの１B)たいていの場合は、文字が発生させた最初であるもの(人)がエスケープ・キャラクタであるという理由で、期間「エスケープ・シーケンス」は、使われます。エスケープの後を追うことは、かなり多くの他の文字です、(共に文字の独特のシーケンスを形づくる)。

When using a terminal directly, firmware on the terminal does the generation of the escape sequences. Some terminals allow the user to specify what escape sequence will be generated when particular keys are pressed.
直接に端末を使うときに、端末のファームウェアは、エスケープ・シーケンスの世代をします。いくつかの端末は、ユーザーに何を(に)特定のキーが押されるときに、エスケープ・シーケンスが発生させられるだろうかを示すことを可能にします。

Termcap/Terminfo
Termcap / Terminfo

Each terminal that connects to a U*ix host is identified by the value of the TERM environment variable. The value of TERM is used to setup various settings for the terminal. These settings are stored in a database; either in a flat file termcap or in a compiled format terminfo . Which one a particular system uses is dependant on the version of the U*ix Operating System being run.
U* ixホストに接続するそれぞれの端末は、期間環境変数の値によって識別されます。期間の値を使って端末のためのいろいろな設定をセットアップします。これらの設定は、データベースで保存されます;平らなファイルtermcapで、またはコンパイルされたフォーマットterminfoで。特定のシステムが使うどちらの１(人)は、動かされるU* ixオペレーティングシステムのバージョンで依存しています。

One of the capabilites of the termcap/terminfo databases is to translate an escape sequence into a keyboard mnemonic that is used by the Curses library functions. This translation can also be changed by the user.
termcap / terminfoデータベースのcapabilitesの１つは、エスケープ・シーケンスをカーソルコントロールライブラリー機能によって使われるキーボード・ニーモニックに訳すはず(こと，予定)です。この翻訳は、また、ユーザーによって変えることができます。

An example of this is:
これの例は:

Termcap: ku=\E[A
Termcap :ku = \ E[ A
Terminfo: kcuu1=\E[A
Terminfo :kcuu１= \ E[ A

This translates the escape sequence ESC [ A into the mnemonic ku or kccu1.
これは、エスケープ・シーケンスESCを訳します[ニーモニックku、あるいはkccu１へのA。

Curses
カーソルコントロール

The Curses library contains definitions of many keys. These can be seen by looking in the Curses header file; usually /usr/include/curses.h Here you will see defintions like:
カーソルコントロールライブラリーは、多くのキーの定義を含みます。これらは、カーソルコントロールヘッダー・ファイルをのぞいて見ることによって見ることができます;通常あなたがdefintionsが好きなのを見るだろうここでの/usr/include/curses.h :

#define KEY_UP 0403 /* up arrow key */
#は、矢キー*上へKEY _ UP０４０３/*を定義します/

THE
THE

As THE is a Curses-based application, it recognises the Curses key definitions defined in curses.h. As not all escape sequences are usually defined in the Termcap/Terminfo databases, or are defined in curses.h, THE also has special code to decipher other escape sequences.
THEがカーソルコントロールベースのアプリケーションであるので、それは、カーソルコントロールキー定義がcurses.hで定義したことを認めます。必ずしもすべてのエスケープ・シーケンスがTermcap / Terminfoデータベースで通常定義されるかあるいはcurses.hで定義されないので、THEは、他のエスケープ・シーケンスを判読するために、また特別のコードを持っています。

When a key is pressed, and is interpreted by THE, the first action is to check if the value passed to THE is a known curses key. If it is THE carries out any command associated with the key. If the value is not a known curses key, THE assumes that an escape sequence is forthcoming. The module getch.c has code for deciphering many escape sequences that are not normally defined in the Termcap/Terminfo database. Later in this document is a table of escape sequences and its associated curses key.
キーが押されてTHEによって解釈されるときに、最初の活動は、THEにパスされた値が知られたカーソルコントロールキーかどうか確かめるはず(こと，予定)です。もしそれがキャリーなら、外へ、いくらかの(どんな)コマンドは、キーに関連しました。もし値が知られたカーソルコントロールキーでなければ、THEは、エスケープ・シーケンスがまさに現れようとすると仮定します。getch.cにTermcapで多くの通常定義されないエスケープ・シーケンスを判読するためのコードがあるモジュール/ TERMINFOデータベース。後で、このドキュメントで、エスケープ・シーケンスおよびその連合させられたカーソルコントロールのテーブルはキーです。

X11 Server
X１１サーバー

When THE is run in a X environemnt, the X server acts in a similar way to terminal emulation software. The principal difference is that there are more layers within the X server. The translation of physical keyboard codes to an X mnemonic is the first layer. The code generated is called a keycode. This keycode is then translated into another higher level mnemonic; a keysym. The keysym is usually a name that resembles the label on the physical keyboard.
THEがX environemntで走らせられるときに、Xサーバーは、ターミナル・エミュレーション・ソフトウェアへの同様の道に出演します。主な違いは、Xサーバーの中により多くの層がいるということです。Xニーモニックへのフィジカル・キーボード・コードの翻訳は、初層です。発生させられたコードは、keycodeと呼ばれます。このkeycodeは、もう一つのより高度なレベル・ニーモニックへその時訳されます;keysym。keysymは、通常フィジカル・キーボードでラベルに似ている名前です。

The X environment provides a mechanism to assign keycodes to keysyms. This is done with the xmodmap command, and any assignment of keycode to keysym is done for all applications within the current X environemnt.
X環境は、keycodesをkeysymsに割り当てるために、機構を提供します。これは、keysymへのkeycodeのコマンド、およびいくらかの(どんな)割り当てが現在のx environemntの中にすべてのアプリケーションのために終わったxmodmapを完全に終えています。

xterm
xterm

The xterm program is a terminal emulation program, and as such has many of the properties of the terminal emulator described above. The xterm program takes keysyms from the X11 server and generates escape sequences, which are defined in the xterm entry in the Termcap/ Terminfo database.
xtermプログラムは、ターミナル・エミュレーション・プログラムです、そして、そのようなものがターミナルの多くの資産を持っているので、エミュレーターは上について述べました。xtermプログラムは、X１１サーバーからkeysymsを取って、エスケープ・シーケンスを発生させます、(Termcap / Terminfoデータベースでxtermエントリーで定義される)。

One of the features of xterm is the ability to alter the standard keysym to escape sequence translation. Surprisingly this is via a feature called translations . Not only do these translations enable the user to specify a different escape sequences to be generated, but internal xterm commands can also be assigned. These are beyond the scope of this description. An example of an xterm translation follows:
xtermの特徴の１つは、シーケンス翻訳から逃げるためにスタンダードのkeysymを変える能力です。驚くほど、これは、翻訳と呼ばれる特徴経由でです。これらの翻訳はユーザーが異なるエスケープが発生させられることを順番にならべることを示すことを可能にするというだけではなく、内部のxtermコマンドは、また割当てることができます。これらは、この記述の範囲を越えてです。xterm翻訳の例が後を追うAn :

*VT100.Translations: #override\n\
* VT１００.Translations : #手数料\ n \
<Key>F1: string(0x1b) string("[192z")\n\
<キー> F１:ストリング(０x１b )ストリング( " [１９２z " ) \ n \
<Key>F2: string(0x1b) string("[193z")\n
<キー> F２:ストリング(０x１b )ストリング( " [１９３z " ) \ n

This specification is typically part of your own $HOME/.Xdefaults file. This file is usually read dynamically by the xterm program on startup. On some systems, the .Xdefaults file is ignored. To ensure the entries are incorporated into the X server resource database, run the command:
この規格が一般的に一部分は自分自身のものですHOMEの/.Xdefaultsがファイルする$。このファイルは、スタートアップでxtermプログラムによって通常動的に読まれます。いくつかのシステムで、その。Xdefaultsファイルは無視されます。エントリーがXサーバー・リソース・データベースへ編入されるということを確認するために、コマンドを走らせて下さい:

xrdb -merge .Xdefaults
xrdb -マージします。Xdefaults

The above example will generate the escape sequence ESC [ 1 9 2 z when the F1 key is pressed. The trailing "\" is a continuation character.
上記の例は、エスケープ・シーケンスESCを発生させるでしょう[１９２つのF１キーが押されるz。後から追っている「\」は、継続文字です。

So, if you had the above translation in effect, and were running THE in an xterm, and ran the SHOWKEY command, pressing the F1 key would result in THE responding with F11.
したがって、もしあなたがF１を押して、上記の事実上の翻訳をしてxtermの走っているTHEであってSHOWKEYコマンドを動かしたらキーは、F１１で答えるTHEの結果になるでしょう。

PDCurses
PDCurses

The actions performed by PDCurses in the X environment combine the xterm, Termcap/Terminfo and curses actions. This results in fewer layers to be traversed.
X環境でPDCursesによってされた活動は、xterm、Termcap / Terminfo、およびカーソルコントロール活動を結び合わせます。これは、横ぎられる(べき)よりわずかな層の結果になります。

PDCurses takes a keysym from the X server and converts it into a Curses key code. PDCurses also has the same translation capabilities as does xterm. The xterm example above would look like:
PDCursesは、Xサーバーからkeysymを取って、カーソルコントロールキー・コードへそれを変えます。PDCursesは、また、雌xtermと同じ翻訳能力を持っています。上記の例が似ているだろうxterm :

*the.Translations: #override\n\
* the.Translations : #手数料\ n \
<Key>F1: string(0x1b) string("[192z")\n\
<キー> F１:ストリング(０x１b )ストリング( " [１９２z " ) \ n \
<Key>F2: string(0x1b) string("[193z")\n
<キー> F２:ストリング(０x１b )ストリング( " [１９３z " ) \ n

All the details described in xterm as far as translations are concerned hold for translations in PDCurses.
翻訳に関する限りxtermで述べられたすべての詳細は、PDCursesで翻訳のために保持します。

Another capability that translations offer is the ability to assign international characters to alphabetic characters, while still having the alphabetic characters available. For example, the translations below assigns the action of the Shifted Meta key and A, giving a capital A with a grave accent, and the unshifted Meta key and A giving a small A with a grave accent.
翻訳が提供するもう一つの能力は、アルファベットの文字にとってインターナショナルの文字を割当てる能力です、まだ持っている間にアルファベットの文字あります．例えば、以下の翻訳は、Shifted Metaキー、およびA、墓のアクセント、およびunshiftedのMetaキーがある首都Aを与えることおよび墓のアクセントをもつ小さいAを与えることの活動を割当てます。

*the.Translations: #override\n\
* the.Translations : #手数料\ n \
!Shift Meta <Key>a: string(0xc0) \n\
!ShiftMeta <キー> a:ストリング(０xc０) \n\
!Meta <Key>a: string(0xe0) \n
!Meta <キー> a:ストリング(０xe０) \n

The examples above assume you are using a font with a character set that is compatible with ISO 8859-1.
上記の例は、あなたがISOと互換性があるキャラクタ・セット８８５９-１をもつフォントを使っていると仮定します。

THE Escape Sequence to Key Name Mapping
キー名前マッピングへのエスケープ・シーケンス