xyaku
=====
xyaku is an English-Japanese translation program and more.
Furthermore, xyaku is yet another Web search engine front-end.
xyaku works as follows,
it invokes an add-in commands by specified key combinations.
Then, xyaku sends the contents of X selection buffer(*) into add-in's stdin,
and receives the output from the add-in command (from add-in's stdout).
Finally, xyaku shows the result on a pop-up window.
(Or, when xyaku works as a Web search engine front-end, it's up to Mozilla to show the result.)

(*)If you are not familiar with X selection buffer, it's quite O.K. to imagine something like clipboard.
You can see addin/ADDIN.txt about standard add-in commands.


Usage
=====
xyaku [toolkit options]	[-config {rc-file}]

Select a word by a usual X seletion buffer method.
For example, double-click a word on kterm.
Pressing the key combination specified in .xyakurc, you will see the translation window popped up.
Default key combination is Control plus F1 key.
In the case the translated word isn't found, no window popped up.
You can see what key combinations are assigned to the function in your xyakurc, e.g. ~/.xyakurc or $prefix/libexec/xyaku/xyakurc.
If you want to use xyaku as yet another Web search engine front-end, select a word by the same way.
Press the key combination specified in .xyakurc, such as Control+F2 or Control+F3 keys as default.
The current implemention depends on Netscape's '-remote' feature, and you can see the result of Web search engine on Netscape's browser.


Add-in modules
==============
I believe you can easily create your own add-in module.
It must follow the rules below,
* Get the target word from the standard input.
* Put the result to the standard output.

There is one thing you have to remember.
An add-in module must return.
In other words, the process must end up.
I will show you a simple example, which may help you to understand what I meant.

An illegal script, because it won't return, unless you will kill xterm.
#!/bin/sh
xterm

A legal script, because it will return
(xterm won't return, but it doesn't matter.)
#!/bin/sh
xterm &


Bug report, requests, etc.
==========================
Send e-mail to the address below,
inoue@ainet.or.jp

I'd be happy if you let me know your cool add-in modules.

You can get access to the URL below,
http://www.ainet.or.jp/~inoue/software/xyaku/ (Japanese)
http://www.ainet.or.jp/~inoue/software/xyaku/index-e.html (English)

