Revision: 1a60a79868a5
Author: nogu.dev <[email protected]>
Date: Wed Nov 14 01:22:55 2012
Log: Update InstallUim.wiki.
* InstallUim.wiki
- Restructure document.
http://code.google.com/p/uim/source/detail?r=1a60a79868a5&repo=wiki
Modified:
/InstallUim.wiki
=======================================
--- /InstallUim.wiki Wed Nov 14 00:50:26 2012
+++ /InstallUim.wiki Wed Nov 14 01:22:55 2012
@@ -2,12 +2,15 @@
<wiki:toc max_depth="3" />
-If your distribution has uim packages, you can install uim with the
packages. But you need to install uim from sources when your distribution
doesn't have uim packages, uim packages in your distribution are outdated
or you want to use latest development version of uim. We show how to
install uim from sources here.
+If your distribution has uim packages, you can install uim with the
packages. But you need to install uim from sources when your distribution
doesn't have uim packages, uim packages in your distribution are outdated
or you want to use latest development version of uim. We explain how to
install uim from sources here.
Before installing uim, you need to install required packages and compile
uim.
+If you encounter troubles during compilation and installation, see the
[#Troubleshooting Troubleshooting] section.
+
= How to install uim =
-== Requirements ==
+== Installing required packages ==
+=== Installing basic packages ===
First of all, you need to install the following required software and
libraries before compiling and installing uim:
* gcc
* GNU make
@@ -27,9 +30,34 @@
$ sudo yum install gcc intltool
}}}
+=== Installing packages for development version ===
+If you want to install development version (non-release version),
additional requirements are as follows:
+ * automake
+ * ed
+ * librsvg
+ * libtool
+ * pkg-config
+ * ruby
+ * git
+
+If you want to install a release version, you don't need to install these
software above.
+
+The actual commands for Ubuntu and Fedora are as follows.
+
+Ubuntu:
+{{{
+$ sudo apt-get install librsvg2-bin libtool ruby git
+}}}
+
+Fedora:
+{{{
+$ sudo yum install libtool ruby
+}}}
+
+=== Installing packages for features ===
You also need to install additional software and libraries to enable
features which uim supports.
-Let us think that we want to enable Anthy, GTK+2, GTK+3 and Qt4 features.
+Let us assume that we want to enable Anthy, GTK+2, GTK+3 and Qt4 features.
In this case, issue the following commands for Ubuntu and Fedora
respectively.
Ubuntu:
{{{
@@ -87,14 +115,14 @@
* 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.
-== Compiling ==
+== Compiling uim ==
After installing required packages, you need to compile uim.
You have two options on which version of uim you will use.
- * If you want to a use stable uim, select a [#Release_version release
version].
- * If you want to use an unstable but more newer version, select the
[#Development_version development version].
+ * If you want to a use stable uim, select a [#Compiling_release_version
release version].
+ * If you want to use an unstable but more newer version, select the
[#Compiling_development_version development version].
-=== Release version ===
+=== Compiling release version ===
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.
{{{
@@ -137,41 +165,13 @@
For example, you want Qt4 tools and immodule, issue the command below:
{{{
$ ./configure --with-qt4 --with-qt4-immodule
-}}}
-
-Finally, make and install it.
-{{{
$ make
-$ sudo make install
}}}
-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.
+Go to the [#Installing_uim Installing uim] section to install uim.
-=== Development version ===
-If you want to install development version (non-release version),
additional requirements are as follows:
- * automake
- * ed
- * librsvg
- * libtool
- * pkg-config
- * ruby
- * git
-
-The actual commands for Ubuntu and Fedora are as follows.
-
-Ubuntu:
-{{{
-$ sudo apt-get install librsvg2-bin libtool ruby git
-}}}
-
-Fedora:
-{{{
-$ sudo yum install libtool ruby
-}}}
-
-Now, all the required packages are installed.
-
-First, obtain development version from the Git repository.
+=== Compiling development version ===
+If you want to install development version (non-release version), first,
obtain development version from the Git repository.
{{{
$ git clone https://github.com/uim/uim.git
}}}
@@ -180,6 +180,7 @@
{{{
$ cd uim
$ ./make-wc.sh
+$ make
}}}
You can pass arguments to ./make-wc.sh as ./configure:
@@ -189,16 +190,20 @@
The detail options of ./configure, which are same as ./make-wc.sh, are
described in the section [#Release_version release version].
-Finally, make and install it.
+Go to the [#Installing_uim Installing uim] section to install uim.
+
+== Installing uim ==
+You have already installed required packages and compiled uim. Now,
install uim.
{{{
-$ make
$ sudo make install
}}}
-== Troubleshooting ==
+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.
+
+= 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 ===
+== no acceptable C compiler found in $PATH ==
Q. When I ran configure, the following error occurred:
{{{
configure: error: no acceptable C compiler found in $PATH
@@ -206,7 +211,7 @@
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 ===
+== GNU make is currently required to run ax_feature_configurator.m4 ==
Q. When I ran configure, the following error occurred:
{{{
configure: error: GNU make is currently required to run
ax_feature_configurator.m4
@@ -214,7 +219,7 @@
A. You may forget to install GNU make. If so, install it.
-=== Your 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.
@@ -222,10 +227,10 @@
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 ===
+== 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.
-=== relink `libuim-scm.la' with the above command before installing it ===
+== relink `libuim-scm.la' with the above command before installing it ==
Q. When I ran "make install", the following error occurred:
{{{
/usr/bin/ld: cannot find -lgcroots
@@ -239,7 +244,7 @@
}}}
where the prefix is /usr/local or what you set with --prefix in running
configure.
-=== automake-1.xx: not found ===
+== automake-1.xx: not found ==
Q. When I ran make-wc.sh to install development version, the following
error occurred:
{{{
./autogen.sh: 16: automake-1.11: not found
@@ -251,7 +256,7 @@
A. You may forget to install *automake*. If so, install it.
-=== libtoolize: command not found ===
+== libtoolize: command not found ==
Q. When I ran make-wc.sh to install development version, the following
error occurred:
{{{
./autogen.sh: line 27: libtoolize: command not found
@@ -259,7 +264,7 @@
A. You may forget to install *libtool*. If so, install it.
-=== intltoolize: not found ===
+== intltoolize: not found ==
Q. When I ran make-wc.sh to install development version, the following
error occurred:
{{{
./autogen.sh: 57: intltoolize: not found
@@ -267,7 +272,7 @@
A. You may forget to install *intltool*. If so, install it.
-=== possibly undefined macro: AC_MSG_ERROR ===
+== possibly undefined macro: AC_MSG_ERROR ==
Q. When I ran make-wc.sh to install development version, the following
error occurred:
{{{
configure.in:300: error: possibly undefined macro: AC_MSG_ERROR
@@ -277,7 +282,7 @@
A. You may forget to install *pkg-config*. If so, install it.
-=== ed: command not found ===
+== ed: command not found ==
Q. When I ran make-wc.sh to install development version, the following
error occurred:
{{{
./autogen.sh: line 27: ed: command not found
@@ -285,7 +290,7 @@
A. You may forget to install *ed*. If so, install it.
-=== functable-r5rs-syntax.c: No such file or directory ==
+== functable-r5rs-syntax.c: No such file or directory ==
Q. When I ran make to install development version, the following error
occurred:
{{{
../sigscheme/src/syntax.c:96:35: fatal error: functable-r5rs-syntax.c: No
such file or directory
@@ -301,7 +306,7 @@
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' ===
+== No rule to make target `unknown.png' ==
Q. When I ran "make install" to install development version, the following
error occurred:
{{{
make[1]: *** No rule to make target `unknown.png', needed by `all-am'.
Stop.
