1Environment variables for uim
2=============================
3
4libuim accepts some enviroment variables mainly for debugging purpose.
5
6
7- LIBUIM_USER_SCM_FILE
8
9  This variable takes a file path as a value. If this variable is
10  defined, uim reads the file as user customization file instead of
11  ~/.uim
12
13- LIBUIM_SCM_FILES
14
15  This variable takes a colon-separated list of directories. If this
16  variable is defined, uim add the values to the search path of .scm
17  files.
18
19- LIBUIM_SYSTEM_SCM_FILES
20
21  This variable takes a directory path as a value. If this variable is
22  defined, uim add the value to the search path of .scm files provided
23  by underlying Scheme interpreter (i.e. SigScheme libraries).
24
25- LIBUIM_PLUGIN_LIB_DIR
26
27  This variable takes a directory path as a value. If this variable is
28  defined, uim add the value to the search path of plugin files.
29
30- LIBUIM_VERBOSE
31
32  This variable takes a number as a value. 0-10 can be specified. If
33  LIBUIM_VERBOSE is greater than or equal to 5, uim shows backtrace
34  when error occurred if --enable-backtrace is set by configure.
35
36- LIBUIM_VANILLA
37
38  This variable takes an integer value. uim changes its behavior as
39  follows if variable is defined.
40
41  * LIBUIM_VANILLA=2 : vanilla + toppings
42
43    Disable ~/.uim, user customs and lazy loading, but enable loading
44    modules.
45
46  * LIBUIM_VANILLA=1 : pure vanilla
47
48    Disable ~/.uim, user customs, lazy loading, loading modules.
49
50  * undefined : fully flavored
51
52    Enable ~/.uim, user customs, lazy loading if required, and loading
53    modules.
54
55- LIBUIM_ENABLE_EMERGENCY_KEY
56
57  If this variable is set to 1, the 'emergency key' to toggle these 2
58  modes is enabled.
59
60  * Normal mode
61
62    Key inputs are processed by uim.
63
64  * Emergency mode
65
66    Key inputs are bypassed to application without being processed by uim.
67
68  The emergency key is currently hardcoded to "<Shift>backspace".
69
70- UIM_IM_ENGINE
71
72  This obsolete variable takes an input method name as a value. The
73  specified IM is selected as default IM. This variable is purely
74  provided for debugging purpose and takes effect if and only if
75  --enable-debug option is specified at configure time. The term 'IM
76  engine' is not appropriate for current uim design.
77