--------------------------------------------------------------
New Xlib of Li18nux based on XFree86-4.0.2.
	Brief instruction.
        Written by MIYASHITA Hisashi (himi@m17n.org)
	on 2000/12/18.
--------------------------------------------------------------

This manual briefly explains on new Xlib of Li18nux project
and instructs how to install it.

o ... What's this?

This is a extended version of Xlib, which can switch XLC, XOM, and XIM
objects dynamically by looking up a locale database.

Such XLC, XOM, and XIM objects are provided by shared libraries, thus
Xlib dynamically loads them by dlopen().

As an XIM object, this Xlib can load xiiimp.so, which allows clients
that uses XIM APIs to use IIIM server.

You can obtain xiiimp.so via CVS pserver by typing something like
--
cvs -d:pserver:anonymous@www.li18nux.org:/cvsroot login
         (no password to login)
cvs -d:pserver:anonymous@www.li18nux.org:/cvsroot co im-sdk
--

And this packages is also distributed via CVS pserver.
You can obtain this package by typing something like
--
cvs -d:pserver:anonymous@www.li18nux.org:/cvsroot co Xlib-I18N
--

o ... Getting started.

(1) Installation

  o ... Install Xlib.

   In the current release, you can choose the following two ways to
   compile this package.

   (A) ... Compile this packages with XFree86-4.0.2 (recommended)

	First, overwrite the `xc' directory of XFree86-4.0.2
	by putting the `xc' directory of this release.

	Second, compile and install XFree86 usually, by
	issuing the commands like `make World ; make install'.

   (B) ... Compile only Xlib in the environment that has XFree86-4.x

	This way is easy, but you meet some problems in case that
	your X environment that have been installed conflicts
	this release.

	Set the current directory to xc/lib/X11 directory, and
	then you can compile and install by issuing the following
	commands:
--
% xmkmf -a
% make
% make install
--
	In this release, Wraphelp.c is not included.  If you need Wraphelp.c
	for Xdmcp, see ftp://ftp.x.org/pub/R6.4/xdm-auth/README, and
	put it to xc/lib/X11/lib/Xdmcp.

	Next, set the current directory to xc/nls, and you can install
	locales by issuing the following commands.  (xuctblgen build
	UCS_TO_CS conversion table if possible.)
--
% xmkmf -a
% make
% make install
--
	That's all.


(2) Use with xiiimp.so.

	Put xiiimp.so to `common' directory of the locale directory
	of X.  The usual location is `/usr/X11R6/lib/X11/locale/common'.

        Create a file .iiimp in your home directory like the following
--
iiimp.server=iiimp://localhost:9010
--
	Set XMODIFIERS environment variable, e.g.:
--
XMODIFIERS="@im=local" ; export XMODIFIERS
--
	Finally, select an appropriate UTF-8 locale, e.g.:
--
LANG="ja_JP.UTF-8" ; export LANG
--
	If your system does not have ja_JP.UTF-8, however, the locale
	you specified probably does not work.  In this case, you
	may be able to resolve it by modifying locale.dir, locale.alias,
	or something else :-).

--------------------------------------------------------------------------------

o ... To whom it may concerns;

	This release adds some include files and add some sources
	so that you can compile it without other sources.
	Therefore, before merging, remove xc/X11/lib and xc/X11/exports
	directory, and erase the following lines from Imakefile.
--
XCOMM After this product is merged, remove this line.
XCOMM and remove ./exports and ./lib directory.
INCLUDES = -I$(INCLUDESRC)
--
