Revision: 7351
Author: [email protected]
Date: Sun Oct 30 01:48:54 2011
Log: * InstallUim.wiki
- Update.
http://code.google.com/p/uim/source/detail?r=7351
Modified:
/wiki/InstallUim.wiki
=======================================
--- /wiki/InstallUim.wiki Sat Oct 29 22:04:02 2011
+++ /wiki/InstallUim.wiki Sun Oct 30 01:48:54 2011
@@ -1,19 +1,13 @@
-= How to get uim =
-
-== How to get the Source Code ==
-
-You can download the source code [UimDownload here]. It includes the core
library, many input method modules, GTK-2.x immodule, Qt immodule, XIM
bridge, FEP bridge, Emacs bridge, tools for configuration, and other tools.
-
-= How to build uim =
+= How to install uim =
== Requirements ==
-The requirements for building uim are listed below.
+You need to install the following software and libraries to compile uim:
* gcc
* GNU make
* iconv
* gettext
* intltool
-The relations between a feature and build requirements are as follows.
+You also need to install additional software and libraries to enable
features which uim support. See the table below:
|| *Feature* || *Description* || *Build Requirements* || *Configure
Option* ||
|| Anthy || Japanese Anthy module || anthy || --with-anthy ||
|| Anthy (UTF-8) || UTF-8 version of Japanese Anthy module ||anthy >= 8622
|| --with-anthy-utf8 ||
@@ -51,21 +45,18 @@
|| Wnn || Wnn module || wnn || --with-wnn ||
|| [UimXim XIM] || uim-xim || X11 || --with-x ||
+Note
* GTK+2 tools include uim-dict-gtk, uim-im-switcher-gtk,
uim-input-pad-ja, uim-toolbar-gtk, and uim-toolbar-gtk-systray.
* Qt3 tools include uim-chardict-qt, uim-im-switcher-qt, and
uim-toolbar-qt.
* Qt4 tools include uim-chardict-qt4, uim-im-switcher-qt4, and
uim-toolbar-qt4.
-If you want to install development version (non-release version),
additional requirements are as follows:
- * subversion
- * libtool
- * ruby
- * ed
- * pkg-config
- * rsvg
-
== Compiling ==
+You have two options on which version of uim you will use.
+ * If you want to a use stable uim, select a release version.
+ * If you want to use an unstable but more newer version, select the
development version.
+
=== Release version ===
-If you want to use a release version, go to
[http://code.google.com/p/uim/downloads/list Download Page] and download a
tar ball and extract source files from the tar ball.
+If you want to use a release version, first, go to
[http://code.google.com/p/uim/downloads/list Download Page] and download a
tar ball and extract source files from the tar ball.
{{{
$ tar xvzf uim-x.x.x.tar.gz
@@ -78,7 +69,6 @@
}}}
Following configure options are disabled by default.
-
* --enable-anthy-static : build static library for Anthy
* --enable-anthy-utf8-static : build static library for UTF-8 version of
Anthy
* --enable-backtrace : build internal scheme interpreter to show backtrace
@@ -114,6 +104,14 @@
By default, uim is installed under /usr/local, but this directory may not
be on the system search path. Should that be the case, add the line
/usr/local/lib to /etc/ld.conf and then, run ldconfig.
=== Development version ===
+If you want to install development version (non-release version),
additional requirements are as follows:
+ * subversion
+ * libtool
+ * ruby
+ * ed
+ * pkg-config
+ * librsvg
+
First, obtain development version from the Subversion repository.
{{{
$ svn checkout http://uim.googlecode.com/svn/trunk/ uim-read-only
@@ -132,6 +130,7 @@
}}}
== Troubleshooting ==
+In this section, we describe troubles you may encounter and how to address
the troubles. In most cases, the cause of a trouble is that required
packages are missing.
=== no acceptable C compiler found in $PATH ===
Q. When I ran configure, the following error occurred:
@@ -139,7 +138,7 @@
configure: error: no acceptable C compiler found in $PATH
}}}
-A. You may forget to install gcc. If so, install it.
+A. You may forget to install gcc. If so, install it. gcc is a C compiler.
=== GNU make is currently required to run ax_feature_configurator.m4 ===
Q. When I ran configure, the following error occurred:
@@ -149,13 +148,13 @@
A. You may forget to install GNU make. If so, install it.
-=== intltool is too old ===
+=== Your intltool is too old ===
Q. When I ran configure, the following error occurred:
{{{
configure: error: Your intltool is too old. You need intltool 0.36.3 or
later.
}}}
-A. You may forget to install intltool. If so, install it.
+A. You may forget to install *intltool*. If so, install it.
=== xxx feature is disabled even if I enable it with
--enable-xxx/--with-xxx" ===
A. When build requirements for the xxx feature are missing in your
environment, the feature will be automatically disabled. See the table
above and config.log in your build directory, and check if build
requirements are installed in your environment.
@@ -180,7 +179,7 @@
./autogen.sh: line 27: libtoolize: command not found
}}}
-A. You may forget to install libtool. If so, install it.
+A. You may forget to install *libtool*. If so, install it.
=== possibly undefined macro: AC_MSG_ERROR ===
Q. When I ran make-wc.sh to install development version, the following
error occurred:
@@ -190,7 +189,7 @@
See the Autoconf documentation.
}}}
-A. You may forget to install pkg-config. If so, install it.
+A. You may forget to install *pkg-config*. If so, install it.
=== ed: command not found ===
Q. When I ran make-wc.sh to install development version, the following
error occurred:
@@ -198,7 +197,7 @@
./autogen.sh: line 27: ed: command not found
}}}
-A. You may forget to install ed. If so, install it.
+A. You may forget to install *ed*. If so, install it.
=== functable-r5rs-syntax.c: No such file or directory ==
Q. When I ran make to install development version, the following error
occurred:
@@ -214,7 +213,7 @@
../sigscheme/src/module-srfi60.c:86: error: ‘scm_functable_srfi60’
undeclared (first use in this function)
}}}
-A. You may forget to install ruby. If so, install it.
+A. You may forget to install *ruby*. If so, install it. Some source files
such as functable-r5rs-syntax.c are generated with ruby.
=== No rule to make target `unknown.png' ===
Q. When I ran "make install" to install development version, the following
error occurred:
@@ -222,4 +221,4 @@
make[1]: *** No rule to make target `unknown.png', needed by `all-am'.
Stop.
}}}
-A. You may forget to install rsvg. If so, install it and run make-wc.sh
again.
+A. You may forget to install *librsvg*. If so, install it and run
make-wc.sh again. The rsvg command in librsvg is used to generate PNG files
from SVG files.
