Scim Bridge User Manual

Up

How to install?

The most component of scim-bridge can be installed just by "make install". However, there are some steps you have to do before you use it.

The first step is registering the IMModule. Please run "update-gtk-immodules (host-triplet)" for GTK+ from the terminal with the root privilege. "(host-triplet)" is the architecture you use, for example, "x86_64-redhat-linux-gnu" in my case. If you have no error, go for the next step.

The second step is choosing the new IMModule as the default IMModule. This is achived by exporting an environmental value as "GTK_IM_MODULE=scim-bridge" for GTK+. You can test this temporary from a X terminal. Please export it and launch "gedit". If the scim-bridge works correctly, you see "scim-bridge-agent" in the output of "ps -A". Most os have their own ways to export it it a X session. There seems no standard way to achieve this. Please follow the instruction of yours. :(

How to debug it?

The debug output from the client is easily gotten by exporting environmental variables, that is "SCIM_BRIDGE_DEBUG_LEVEL". This variable decides the verbosity of the debug output. If you set it "9", you get all the debug output from the client. On the other hand, "0" makes it quiet, kills all the debug output.

On the other hand, the debug output from the agent is difficult to get, because it detaches itself from the console and fork as soon as it launches. You can disable this feature by launch it manually (kill the agent process beforehand) with the argument "--standalone", which prevent the process to daemonize itself. You can get the debug output by giving the argument "--verbose". There is also another usefull argument for debugging. That is "--noexit". Without it, the agent exits automatically when the last client is gone.

Is there any undocumnented features?

There are some undocumented features in scim-bridge. They are written only for dealing with bugs of famous (infamous?) applications, so they might be removed in the feature releases without any notification.

- Key snooper. (enabled by the environmental variable, "SCIM_BRIDGE_KEY_SNOOPER=true")
  - Use "key snooper" to sneak all the key events in gtk+ apps.
  - Please use it for OpenOffice.org, which doesn't pass the key releasing events to IMModules.
  - Note, it might kill key accelerators of the applications.

Where can I send a bug report?

Scim-bridge is developed as the part of SCIM project. You can report it directly into the mailing list of that. (The most recommanded one is scim-devel-list, I won't miss it if you post there) But please note that you have to tell the distributors first if you use the package included in the distribution, or the package maden by someone else. They might know the better way to solve your problem than I do. :)

Copyright (c) 2006 Ryo Dairiki <ryo-dairiki@users.sourceforge.net>