.\" $Xorg: xkbevd.man,v 1.3 2000/08/17 19:54:49 cpqbld Exp $
.\"
.\" Copyright (c) 1998, 2001 The X Japanese Documentation Project.
.\" 
.\" Permission is hereby granted, free of charge, to any person obtaining a
.\" copy of this software and associated documentation files (the
.\" "Software"), to deal in the Software without restriction, including
.\" without limitation the rights to use, copy, modify, merge, publish, dis-
.\" tribute, sublicense, and/or sell copies of the Software, and to permit
.\" persons to whom the Software is furnished to do so, subject to the fol-
.\" lowing conditions:
.\" 
.\" The above copyright notice and this permission notice shall be included
.\" in all copies or substantial portions of the Software.
.\" 
.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
.\" OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABIL-
.\" ITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT
.\" SHALL  THE X JAPANESE DOCUMENTATION PROJECT  BE  LIABLE  FOR  ANY CLAIM,
.\" DAMAGES OR OTHER LIABILITY,  WHETHER IN AN ACTION OF CONTRACT,  TORT OR
.\" OTHERWISE,  ARISING FROM,  OUT OF OR IN CONNECTION WITH THE SOFTWARE OR
.\" THE USE OR OTHER DEALINGS IN THE SOFTWARE.
.\" 
.\" Except as contained in this notice, the name of The X Japanese
.\" Documentation Project shall not be used in advertising or otherwise to
.\" promote the sale, use or other dealings in this Software without prior
.\" written authorization from The X Japanese Documentation Project.
.\" 
.\" X Window System is a trademark of The Open Group.
.\"
.\" Translated Sun Nov  8 23:58:35 JST 1998
.\"         by FUJIWARA Teruyoshi <fujiwara@linux.or.jp>
.\" Updated Sun Oct 21 13:11:48 JST 2001 for XFree86 4.1.0
.\"         by FUJIWARA Teruyoshi <fujiwara@linux.or.jp>
.\"
.\" $XFree86: xc/programs/xkbevd/xkbevd.man,v 1.7 2001/01/27 18:21:16 dawes Exp $
.\"
.TH XKBCOMP 1 "Release 6.5" "X Version 11"
.SH 名前
.\"0 xkbevd \- XKB event daemon
xkbevd \- XKB イベントデーモン
.SH 書式
.B xkbevd
[ options ]
.SH 説明
.PP
.\"0 This command is very raw and is therefore only partially implemented;  we 
.\"0 present it here as a rough prototype for developers, not as a general purpose 
.\"0 tool for end users.  Something like this might make a suitable replacement
.\"0 for xev;  I'm not signing up, mind you, but it's an interesting idea.
このコマンドは完成度が非常に低く、したがって部分的にしか実装され
ていない。ここで説明をするのは、開発者向けのラフなプロトタイプとしてで
あり、エンドユーザ向けの一般の目的に使うツールとしてではない。このよう
なツールは、xev をうまく置き換えることができるかもしれない。保証は出来
ないが、これは面白いアイディアである。
.PP
.\"0 The
.\"0 .I xkbevd
.\"0 event daemon listens for specified XKB events and executes requested commands
.\"0 if they occur.   The configuration file consists of a list of event 
.\"0 specification/action pairs and/or variable definitions.   
.I xkbevd
イベントデーモンは指定された XKB イベントを監視し、イベントが発生した
ら要求されたコマンドを実行する。設定ファイルはイベント指定/アクション
の組と変数定義からなる。
.PP
.\"0 An event specification consists of a short XKB event name followed by a 
.\"0 string or identifier which serves as a qualifier in parentheses;  empty 
.\"0 parentesis indicate no qualification and serve to specify the default 
.\"0 command which is applied to events which do not match any of the other 
.\"0 specifications.  The interpretation of the qualifier depends on the type 
.\"0 of the event:  Bell events match using the name of the bell, message events 
.\"0 match on the contents of the message string and slow key events accept 
.\"0 any of \fIpress\fP, \fIrelease\fP, \fIaccept\fP, or \fIreject\fP.   No 
.\"0 other events are currently recognized.
イベント指定は、短縮形の XKB イベント名に文字列または識別子を続けたも
のからなる。この文字列や識別子は、括弧内にある修飾子として働く。空の括
弧は指定が無いことを示し、他のいずれのイベントにもマッチしないイベント
に適用されるデフォルトのコマンドを指定する。修飾子の解釈は、イベントの
タイプに依存して決まる。ベルイベントではベルの名前を使ってマッチが行わ
れ、メッセージイベントではメッセージ文字列の内容によってマッチが行われ、
遅いキーイベントは \fIpress\fP, \fIrelease\fP, \fIaccept\fP, \fIreject\fP
を全て受け付ける。現在のところ、これ以外には認識されるイベントは存在し
ない。
.PP
.\"0 An action consists of an optional keyword followed by an optional string 
.\"0 argument.  Currently, \fIxkbev\fP recognizes the actions: \fInone\fP, 
.\"0 \fIignore\fP, \fIecho\fP, \fIprintEvent\fP, \fIsound\fP, and \fIshell\fP.
アクションは、省略可能なキーワードの後に省略可能な引き数を続けて並べた
ものである。現在、\fIxkbev\fP は次のアクションを認識する: \fInone\fP,
\fIignore\fP, \fIecho\fP, \fIprintEvent\fP, \fIsound\fP, \fIshell\fP.
.\"0 If the action is not specified, the string is taken as the name of a sound
.\"0 file to be played unless it begins with an exclamation point, in which case
.\"0 it is taken as a shell command.
アクションが指定されなければ、文字列は再生されるサウンドファイルの名前
として扱われる。ただし、文字列が感嘆符(!)で始まる場合に限っては、これ
はシェルコマンドとして扱われる。
.PP
.\"0 Variable definitions in the argument string are expanded with fields from
.\"0 the event in question before the argument string is passed to the action
.\"0 processor.   The general syntax for a variable is 
.\"0 either $\fIc\P or $(\fIstr\fP), where \fIc\fP is a single character and
.\"0 \fIstr\fP is a string of arbitrary length.  All parameters have both 
.\"0 single-character and long names.    
引き数文字列における変数定義は、引き数文字列がアクションプロセッサに渡
される前に、処理対象のイベントのフィールドを使って拡張される。変数の一
般的な記法は、$\fIcf\P または $(\fIstr\fP) である。ここで、\fIc\fP は1
文字であり、\fIstr\fP は任意の長さの文字列である。全てのパラメータは1
文字と長い名前の両方を持つ。
.PP
.\"0 The list of recognized parameters varies from event to event and is too long 
.\"0 to list here right now.   This is a developer release anyway, so you can
.\"0 be expected to look at the source code (evargs.c is of particular interest).
認識されるパラメータのリストはイベントによって変化し、ここで説明するに
は長すぎる。いずれにせよ、これは開発者用リリースであり、ソースコードを
確認することが期待される(evargs.c が特に興味深いだろう)。
.PP
.\"0 The \fIignore\fP, \fIecho\fP, \fIprintEvent\fP, \fIsound\fP,and \fIshell\fP
.\"0 actions do what you would expect commands named \fIignore\fP, \fIecho\fP,
.\"0 \fIprintEvent\fP, \fIsound\fP, and \fIshell\fP to do, except that the sound
.\"0 command has only been implemented and tested for SGI machines.   It launches
.\"0 an external program right now, so it should be pretty easy to adapt, 
.\"0 especially if you like audio cues that arrive about a half-second after you
.\"0 expect them.
\fIignore\fP, \fIecho\fP, \fIprintEvent\fP, \fIsound\fP, \fIshell\fP 
アクションは、\fIignore\fP, \fIecho\fP, \fIprintEvent\fP, \fIsound\fP,
\fIshell\fP という名前のコマンドに期待される通りの動作を行う。ただし、
\fIsound\fP コマンドは SGI のマシンでしか実装・テストされていない。こ
れはただ外部プログラムを起動するだけなので、期待するよりも半秒ほど遅く
オーディオが始まっても良い場合には特に、簡単に改造することができる。
.PP
.\"0 The only currently recognized variables are \fIsoundDirectory\fP and
.\"0 \fIsoundCmd\fP.  I'm sure you can figure out what they do.
現在認識できる変数は \fIsoundDirectory\fP と \fIsoundCmd\fP だけである。
変数の意味は説明しなくても読者は理解できることと思う。
.SH オプション
.TP 8
.B \-help
.\"0 Prints a usage message that is far more up-to-date than anything in this
.\"0 man page.
このオンラインマニュアルに書いていることよりもずっと新しい使用方法を出
力する。
.TP 8
.B \-cfg \fIfile\fP
.\"0 Specifies the configuration file to read.   If no configuration file is
.\"0 specified, \fIxkbevd\fP looks for ~/.xkb/xkbevd.cf and $(LIBDIR)/xkb/xkbevd.cf
.\"0 in that order.
読み込む設定ファイルを指定する。設定ファイルを指定しなければ、
\fIxkbevd\fP は ~/.xkb/xkbevd.cf と $(LIBDIR)/xkb/xkbevd.cf の順にファ
イルを探す。
.TP 8
.B \-sc\ \fIcmd\fP
.\"0 Specifies the command used to play sounds.
サウンドの再生に使うコマンドを指定する。
.TP 8
.B \-sd\ \fIdirectory\fP
.\"0 Specifies a top-level directory for sound files.
サウンドファイルのトップレベルディレクトリを指定する。
.TP 8
.B \-display\ \fIdisplay\fP
.\"0 Specifies the display to use.  If not present, \fIxkbevd\fP uses $DISPLAY.
使用するディスプレイを指定する。これを指定しなければ、\fIxkbevd\fP は 
$DISPLAY 環境変数を使用する。
.TP 8
.B \-bg
.\"0 Tells \fIxkbevd\fP to fork itself (and run in the background).
このオプションを指定すると \fIxkbevd\fP は自分自身を fork する(そして
バックグラウンドで動作する)。
.TP 8
.B \-synch
.\"0 Forces synchronization of all X requests.  Slow.
X リクエストを強制的に同期させる。このオプションを指定すると動作が遅く
なる。
.TP 8
.B \-v
.\"0 Print more information, including debugging messages.   Multiple 
.\"0 specifications of \fI-v\fP cause more output, to a point.
デバッグ情報を含む、詳しい情報を出力する。\fI-v\fP オプションを複数回
指定すると出力が詳しくなる。
.SH 関連項目
X(7)
.SH 著作権
Copyright 1995, Silicon Graphics Computer Systems
Copyright 1995, 1998  The Open Group
.br
.\"0 See \fIX(7)\fP for a full statement of rights and permissions.
権利と許諾に関する正式な声明については \fIX(1)\fP を参照すること。
.SH 著者
Erik Fortune, Silicon Graphics