#
#   $Id: INSTALL.en,v 1.4 2004/05/21 16:39:31 aono Exp $
#

#
# FreeWnn is a network-extensible Kana-to-Kanji conversion system.
# This file is part of FreeWnn.
# 
# Copyright Kyoto University Research Institute for Mathematical Sciences
#                 1987, 1988, 1989, 1990, 1991, 1992
# Copyright OMRON Corporation. 1987, 1988, 1989, 1990, 1991, 1992, 1999
# Copyright ASTEC, Inc. 1987, 1988, 1989, 1990, 1991, 1992
# Copyright FreeWnn Project 1999, 2000, 2002
# 
# Maintainer:  FreeWnn Project   <freewnn@tomo.gr.jp>
# 
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; either version 2 of the License, or
# (at your option) any later version.
# 
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
# GNU General Public License for more details.
# 
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
#

        How to install FreeWnn


[Basic Method of Installation]

1. expand FreeWnn tarball.

        $ gzcat FreeWnn-*.tar.gz | tar xvf -

        *1: You should use appropriate filename depending the FreeWnn version.

2. change directory to FreeWnn-*/

        $ cd FreeWnn-*

3. run configure

        $ ./configure

	*2: For configure options, see below or type `./configure --help'.

4. run make

        $ make

5. To install commands, libraries, dictionaries and so on,
   run make install as a superuser(*3).

        $ su
        # make install

	*3: Currently, install target does not work well for other user.

6. To install manuals, you should do the following as a superuser

        # make install.man

   *4: You can ommit this if you do not want manuals installed.

[Configure options]

Typing

        $ ./configure --help

will give you list of options that configure accepts.
For example, changing install directory from the default /usr/local to
/opt/freewnn, use --prefix option:

	$ ./configure --prefix=/opt/freewnn

Below are the main configure option of FreeWnn.

  enabled by default:
  --enable-libraries    compile and install FreeWnn libraries.
  --enable-server       compile and install FreeWnn servers.
  --enable-Wnn          compile and install Wnn (Japanese).
  --enable-cWnn         compile and install cWnn (Chinese).
  --enable-kWnn         compile and install kWnn (Korean).

  disabled by default:
  --enable-ipv6         enable IPv6 feature.
  --enable-unsafe-path  allow creating files in jserver_dir (*5).
  --enable-client	compile and install uum (*6).
  --with-libwrap	use libwrap (in TCP wrapper) for jserver
			to enable connection-based access control (*7).

*5: If the option --enable-unsafe-path is enabled, the [cjkt]server
  daemons accept creation of an FreeWnn dictionary file in an arbitrary
  path, and they accept request from client of any hosts.
  This feature may be a security hole.
  Unless you used to place FreeWnn dictionary files in a path other than
  jserver_dir (lib/wnn/$LANG/dic/usr), you should not enable this feature.

*6: cuum cannot be compiled yet.

*7: If you specify --enable-ipv6, libwrap need to support IPv6 also.
