1 This directory tree holds version 0.9.0 of the m17n-im-config package.
3 National Institute of Advanced Industrial Science and Technology (AIST)
4 Registration Number H15PRO112
5 See the end for copying conditions.
7 (1) What is this package.
11 (1-1) C library to create a GTK+ widget for per-user configuration of
12 input methods provided by the m17n library.
14 (1-2) Standalone GTK+ program that uses the above widget.
21 This package requires these libralies:
23 * the m17n library of version 1.3.4 or the later.
25 * GTK+ version 2.4.0 or the later
27 (2-2) From CVS working directory
29 Run the script "bootstrap.sh" in this directory. It is tested that
30 the script run successfully with these versions of autotools.
36 Then, proceed to the next step.
38 (2-3) From the tarball.
40 Run the following commands:
51 The library libm17n-im-config has these public functions.
53 GtkWidget *mim_config_new (GCallback func, gpointer data)
55 The mim_config_new () function returns a newly created Gtk+
56 widget for for per-user configuration of input methods
57 provided by the m17n library. If the argument FUNC is not
58 NULL, it is called when the configuration status is changed
59 (because some value is changed or reverted by a user). The
60 function must have two arguments; the widget created by this
63 The widget returned must be the argument to the following
66 This widget is actually a GtkScrolledWindow widget that
67 contains a GtkTreeView widget. You can get this GtkTreeView
68 widget by mim_config_get_tree_view () function.
70 gboolean mim_config_modified (GtkWidget *config)
72 The mim_config_modified () function checks if there are any
73 unsaved configurations. If any, TRUE is returned. Othewise,
76 gboolean mim_config_default (GtkWidget *config)
78 The mim_config_default () function reset all configurations
79 done by a user at the current session, and all customization
80 saved in a per-user customization file to the default state.
81 If there are any configurations actually reverted, TRUE is
82 returned. Othewise FALSE is returned.
84 gboolean mim_config_revert (GtkWidget *config)
86 The mim_config_revert () function reverts all configurations
87 done by a user to the original state. If there are any
88 configurations actually reverted, TRUE is returned. Othewise
91 gboolean mim_config_save (GtkWidget *config)
93 The mim_config_save () function saves all configurations done
94 by a user into a per-user customization file. If the file is
95 actually written, TRUE is returned. If there's no configuraion
96 to save, FALSE is returned.
98 GtkTreeView *mim_config_get_tree_view (GtkWidget *config)
100 The mim_config_get_tree_view () function returns the
101 GtkTreeView widget used in the widget created by
104 (3-2) Compiling and Linking
106 As this package provides pkgconfig data, you can see compiler and
107 linker options by the following commands:
109 % pkg-config --cflags m17n-im-config
110 % pkg-config --libs m17n-im-config
112 (3-3) Usage of the standalone program
114 The program "m17n-im-config" provides a GUI for per-user configuration
115 of input methods of the m17n library. As the GUI is quite straight
116 forward, there's nothing we should explain here.
119 ----------------------------------------------------------------------
120 Copyright information
123 National Institute of Advanced Industrial Science and Technology (AIST)
124 Registration Number H15PRO112
126 This file is part of the m17n-im-config package; a sub-part of the
129 The m17n library is free software; you can redistribute it and/or
130 modify it under the terms of the GNU Lesser General Public License
131 as published by the Free Software Foundation; either version 2.1 of
132 the License, or (at your option) any later version.
134 The m17n library is distributed in the hope that it will be useful,
135 but WITHOUT ANY WARRANTY; without even the implied warranty of
136 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
137 Lesser General Public License for more details.
139 You should have received a copy of the GNU Lesser General Public
140 License along with the m17n library; if not, write to the Free
141 Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
142 Boston, MA 02110-1301, USA.