--- /dev/null
+/***@mainpage The M17N Library Documentation
+
+@section what What is the m17n library?
+
+The @e m17n @e library is a multilingual text processing library for
+the C language.
+
+<ul>
+
+<li> It is a free and open source software.
+
+<li> It is for any GNU/Linux and Unix applications/libraries.
+
+<li> It realizes multilingualization of many aspects of
+applications/libraries.
+
+</ul>
+
+The word "m17n" is an abbreviation of "multilingualization".
+
+The m17n library provides following facilities to handle
+multilingual text.
+
+<ul>
+
+<li> @e M-text: A data structure for a multilingual text. It is
+basically a string but with attributes called text property, and
+is designed to substitute for the C string. It is the most important
+object of the m17n library.
+
+<li> Functions for creating and processing M-texts.
+
+<li> Functions for converting M-texts from/to strings encoded in
+various existing formats.
+
+<li> A huge character space, which contains all the Unicode
+characters and more non-Unicode characters.
+
+<li> @e Chartable: A data structure that contains per-character
+information efficiently.
+
+<li> Functions for inputting and displaying M-text on a window
+system.
+
+</ul>
+
+@section usage How to use it?
+
+Just include <m17n.h> in your program, and link it with the m17n
+library by -lm17n. See @ref m17nIntro @latexonly
+(P.\pageref{group__m17nIntro}) @endlatexonly for the detail.
+
+AAA
+
+@section sample images
+
+@image html HELLO.png
+
+@section contact Contact us:
+
+Global IT Security Group\n
+National Information Technology Research Institute\n
+Institute of Advanced Industrial Science and Technology
+
+Web: http://www.m17n.org/m17n-lib/
+
+Bug report: m17n-lib-bug@m17n.org
+
+Mailing list (English): m17n-lib@m17n.org
+
+Mailing list (Japanese): m17n-lib-ja@m17n.org
+*/
+////
<ul>
<li> m17n-db -- http://www.m17n.org/m17n-db/
- Used by @ref m17nShell and @ref m17nGUI..
+ Used by @ref m17nShell and @ref m17nGUI.
<li> libxml2 -- http://xmlsoft.org/
Used by the functions mtext_serialize () and mtext_deserialize ().
+ Those functions return NULL libxml2 is not avairable,
<li> fribidi -- http://fribidi.sourceforge.net/
- Used for BIDI processing.
+ Used for BIDI processing. If it is not avairable, the rendering
+ engine of the m17n library can't handle such scritp as Arabic and
+ Hebrew correctly.
<li> freetype -- http://www.freetype.org/