<h1>IIIMF FAQ for Fedora Core Project</h1>

<hr>
<h2> General FAQ </h2>

<h3>Q: Which languages have been enabled for IIIMF?</h3>
<p>
Currently CJK (Simplified Chinese, Traditional Chinese, Japanese and Korean) and Indic (Hindi, Tamil, Bengali, Gujarati, Punjabi) are being IIIMF enabled in Fedora Core by default.
</p>
<h3> Q: Which LEs (language engines) are included in Fedora Core? </h3>
<p>
<ul>
<li> iiimf-le-canna - Japanese</li>
<li> iiimf-le-hangul - Korean</li>
<li> iiimf-le-xcin - Traditional Chinese</li>
<li> iiimf-le-chinput - Simplified Chinese</li>
<li> iiimf-le-unit - Indic, European, Unicode</li>
<li> iiimf-le-sun-thai - Thai</li>
</ul>
</p>
<h3> Q: What locales should have language engines if I have installed all of above? </h3>
<p>
<ul>
<li> iiimf-le-canna - ja_JP.UTF-8</li>
<li> iiimf-le-hangul - ko_KR.UTF-8</li>
<li> iiimf-le-xcin - zh_TW.UTF-8</li>
<li> iiimf-le-chinput - zh_CN.UTF-8</li>
<li> iiimf-le-unit - bn_IN.UTF-8, gu_IN.UTF-8, pa_IN.UTF-8, ta_IN.UTF-8, hi_IN.UTF-8</li>
</ul>
</p>
<h3> Q: What can I use to switch to different language engines? </h3>
<p>
For example, if you are running your desktop in Japanese environment (ja_JP.UTF-8), by default you should have iiimf-le-canna enabled. If you like to use iiimf-le-xcin in your Japanese environment, you can use GIMLET applet located on your top panel to switch between different installed LE.
</p>
<hr>

<h2> Running IIIMF FAQ </h2>
<h3> Q: What's the list of default hotkeys in IIIMF?</h3>
<p>
<ul>
<h4>General:</h4>
<li>Ctrl+Space: Activate/Deactivate language engine</li>
<li>Shift+Space: Activate/Deactivate language engine</li>
<h4>iiimf-le-unit:</h4>
<li>F6: Switch to different layout within the language</li>
<li>F5: Switch to different languages within UNIT LE</li>
</ul>
</p>
<h3> Q: Can I manually enable IIIMF for other locales or all locales so that I can use [insert your favorite language engine name]? </h3>
<p>
Yes. To enable IIIMF regardless locale in your current user environment. Please do:
<pre>
$ mkdir ~/.xinput.d
$ ln -s /etc/X11/xinit/xinput.d/iiimf ~/.xinput.d/default
</pre>
To enable IIIMF in your current user environment on specific locale (i.e. en_US). Please do:
<pre>
$ mkdir ~/.xinput.d
$ ln -s /etc/X11/xinit/xinput.d/iiimf ~/.xinput.d/en_US
</pre>
Then restart X.
</p>
<h3> Q: I do not have GIMLET (gnome-im-switcher) enabled on my desktop. What should I do?</h3>
<p>
<ul>
<li>Right click on your panel</li>
<li>Press "add to panel"</li>
<li>Select "InputMethod Switcher"</li>
<li>Press "Add"</li>
</ul>
</p>
<hr>

<h2> Troubleshooting IIIMF FAQ </h2>
<h3>Q: OK! It is still not working in GNOME. What can I check? </h3>
<p>
<ul>
<li> Check if you have installed <i>iiimf-server, iiimf-x, iiimf-libs, iiimf-gtk, iiimf-gnome-im-switcher, and one of the language engine above</i></li>
<li> Check if you have started IIIM service: i.e. <i>service iiim status</i>. If not please start the service in root: <i>service iiim start</i> </li>
<li> Check manually if the server is working by running <i>LANG=ja_JP.UTF-8 GTK_IM_MODULE=iiim gedit</i> (if you have installed iiimf-le-canna. Please check the previous question for locale reference to language engine)</li>
<li> If it is working, that's mean you do not have the environment variable or correct locale. Please check what locale are you in by running <i>locale</i> in command line, or check if you have ~/.xinput.d setup correctly.</li>
</ul>
</p>
<h3>Q: OK! It is still not working in KDE. What can I check? </h3>
<p>
<ul>
<li> Check if you have installed <i>iiimf-server, iiimf-x, iiimf-libs, iiimf-gtk, iiimf-gnome-im-switcher, and one of the language engine above</i></li>
<li> Check if you have started IIIM service: i.e. <i>service iiim status</i>. If not please start the service in root: <i>service iiim start</i> </li>
<li> Check if you have started XIM/IIIMF bridge server: i.e. <i>ps auxwww | grep httx</i>. If not please run <i>LANG=ja_JP.UTF-8 httx</i> (if you have installed iiimf-le-canna. Please check the previous question for locale reference to language engine)</li>
<li> Run another terminal emulator, and check manually if the server is working by running <i>LANG=ja_JP.UTF-8 XMODIFIERS=@im=htt kedit</i> (if you have installed iiimf-le-canna. Please check the previous question for locale reference to language engine)</li>
<li> If it is working, that's mean you do not have the environment variable or correct locale. Please check what locale are you in by running <i>locale</i> in command line, or check if you have ~/.xinput.d setup correctly.</li>
</ul>
</p>
<h3>Q: I cannot see my any languages in "Add or Remove" dialog in GIMLET applet. What should I do? </h3>
<p>
GIMLET applet can only fetch the language list when you have already ran a application. For example, please run <i>gedit</i> and then try again.
</p>
<hr>

<h2> Bug submission FAQ </h2>
<h3> Q: Which component should I post against?</h3>
<p>
<ul>
<li>iiimf-le-xcin please post against <i>iiimf-le-xcin</i> component.</li>
<li>iiimf-le-chinput please post against <i>iiimf-le-chinput</i> component.</li>
<li>For all other iiimf-* packages, please post against <i>im-sdk</i> component.</li>
</ul>
</p>
<hr>