Encoded in utf-8.

[m17n/m17n-docs.git] / mainpage.txt

diff --git a/mainpage.txt b/mainpage.txt
index 07563aa..a2ac8b8 100644 (file)
--- a/mainpage.txt
+++ b/mainpage.txt
@@ -1,11 +1,9 @@
-/* -*- coding: euc-jp; -*- */
-/***en @mainpage The M17N Library Documentation */
-/***ja @mainpage M17N ¥é¥¤¥Ö¥é¥ê */
+/* -*- coding: utf-8; -*- */
+/***en @mainpage The m17n Library Documentation */
+/***ja @mainpage m17n ライブラリ */

 
 

-/***en @section what What is the m17n library? */
-/***ja @section what M17N ¥é¥¤¥Ö¥é¥ê¤È¤Ï? */
+/***en @section what What is the m17n library? 

 
 

-/***

 The @e m17n @e library is a multilingual text processing library for
 the C language.
 
 The @e m17n @e library is a multilingual text processing library for
 the C language.
 

@@ -43,48 +41,106 @@ characters and more non-Unicode characters.
 <li> @e Chartable: A data structure that contains per-character
 information efficiently.
 
 <li> @e Chartable: A data structure that contains per-character
 information efficiently.
 

-<li> Functions for inputting and displaying M-text on a window
+<li> Functions for inputting and displaying M-texts on a window

 system.
 
 </ul>
 */
 system.
 
 </ul>
 */

-/***en @section usage How to use it? */
-/***ja @section usage ÍøÍÑË¡ */
-/***
-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.  */
+/***ja @section what m17n ライブラリとは? 

 
 

-/***en @section extralib External libraries and data */
-/***ja @section extralib ³°Éô¥é¥¤¥Ö¥é¥ê¡¿¥Ç¡¼¥¿ */
-/***
+@e m17nライブラリ は C 言語用の多言語文書処理ライブラリです。
+
+<ul>
+
+<li> 自由公開ソフトウェアです。
+
+<li> GNU/Linux と Unix のアプリケーションやライブラリから利用できます。
+
+<li> アプリケーションやライブラリのさまざまな側面で、多言語化を実現し
+ます。
+
+</ul> 
+
+"m17n" とは "multilingualization" の省略形です。
+
+m17n ライブラリは多言語を扱うため、以下の機能を提供します。
+
+<ul>
+
+<li> @e M-text: 多言語テキスト用のデータ構造。基本的には文字列であるが、
+テキストプロパティと呼ばれる属性が付いており、C の文字列の代わりになる
+よう設計されている。m17n ライブラリで最も重要なオブジェクト。
+
+<li> M-text を作ったり取り扱ったりするための関数。
+
+<li> M-text と既存のフォーマットでコード化された文字列との間の変換を行
+う関数。
+
+<li> 巨大な文字空間。 Unicode 文字すべてとそれ以上の数の非 Unicode 文
+字を含むことができる。
+
+<li> @e 文字テーブル: 文字毎の情報を効率的に保持するデータ構造。
+
+<li>  M-text をウィンドウシステム上で入力／表示する関数。
+
+</ul>
+*/
+/***en @section usage How to use it? 
+
+Simply include <m17n<EM></EM>.h> in your program, and link it with the m17n
+library by -lm17n.  See @ref m17nIntro for the detail.  */
+
+/***ja @section usage 利用方法 
+
+<m17n<EM></EM>.h> をプログラムに include し、-lm17n で m17n ライブラリ
+とリンクしてください。 @ref m17nIntro を参照。  */
+
+/***en @section extralib External libraries and data 

 
 The m17n library utilizes these external libraries.  They are not
 mandatory but several functions of the m17n library depend on them.
 
 <ul>
 
 The m17n library utilizes these external libraries.  They are not
 mandatory but several functions of the m17n library depend on them.
 
 <ul>

-<li> m17n-db -- http://www.m17n.org/m17n-db/
+<li> m17n-db -- http://www.m17n.org/m17n-lib/download/m17n-db-1.2.0.tar.gz

 
      Used by @ref m17nShell and @ref m17nGUI.
 
 <li> libxml2 -- http://xmlsoft.org/
 
      Used by the functions mtext_serialize () and mtext_deserialize ().
 
      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,
+     Those functions return NULL when libxml2 is not available,

 
 <li> fribidi -- http://fribidi.sourceforge.net/
 
 
 <li> fribidi -- http://fribidi.sourceforge.net/
 

-     Used for BIDI processing.  If it is not avairable, the rendering
-     engine of the m17n library can't handle such scritp as Arabic and
+     Used for BIDI processing.  If it is not available, the rendering
+     engine of the m17n library can't handle such script as Arabic and

      Hebrew correctly.
 
 <li> freetype -- http://www.freetype.org/
 
      Hebrew correctly.
 
 <li> freetype -- http://www.freetype.org/
 

-     Used for handling TrueType and Type1 fonts.
+     Used for handling local fonts.
+
+<li> fontconfig -- http://nexp.cs.pdx.edu/fontconfig/
+
+     Used for handling local fonts supported by the freetype library.
+
+<li> fontconfig -- http://freedesktop.org/Software/fontconfig
+
+     Used for finding local fonts in combination with Xft.
+
+<li> xft -- http://freedesktop.org/Software/Xft
+
+     Used for drawing text with local fonts by X Render Extension of X
+     server in combination with fontconfig.
+
+<li> GD
+
+     Used for rendering text with local fonts on bitmap/pixmap.

 
 <li> libotf  -- http://www.m17n.org/libotf/
 
 
 <li> libotf  -- http://www.m17n.org/libotf/
 

-     Used for handling OpenTypee fonts.
+     Used for handling OpenTypee fonts in combination with freetype
+     and Xft.

 
 <li> anthy -- http://anthy.sourceforge.jp/
 
 
 <li> anthy -- http://anthy.sourceforge.jp/
 

@@ -98,10 +154,62 @@ mandatory but several functions of the m17n library depend on them.
 </ul>
 
 */
 </ul>
 
 */

+/***ja @section extralib 外部ライブラリ／データ 
+
+m17n ライブラリは以下の外部ライブラリを利用しています。必須ではありま
+せんが、m17n ライブラリの幾つかの関数はこれらに依存しています。
+
+<ul>
+<li> m17n-db -- http://www.m17n.org/m17n-lib/download/m17n-db-1.2.0.tar.gz
+
+     @ref m17nShell と @ref m17nGUI が使います。
+
+<li> libxml2 -- http://xmlsoft.org/
+
+     関数 mtext_serialize () と mtext_deserialize () が使います。
+     libxml2 が利用できない時には、これらの関数は NULL を返します。
+
+
+<li> fribidi -- http://fribidi.sourceforge.net/
+
+     BIDI 処理に使います。利用できない時は、m17n ライブラリの表示エン
+     ジンは Arabic やHebrew などのスクリプトを正しく処理できません。
+
+<li> freetype -- http://www.freetype.org/
+
+     ローカルフォントの処理に使います。
+
+<li> fontconfig -- http://nexp.cs.pdx.edu/fontconfig/
+
+     Xft と共に、ローカルフォントの検索に使います。
+
+<li> xft -- http://freedesktop.org/Software/Xft
+
+     fontconfig と共に X サーバの XRender 拡張を利用してテキストをロー
+     カルフォントで表示するために使います。
+
+<li> GD
+     テキストをローカルフォントで bitmap/pixmap 上に表示するのに使いま
+     す。
+
+<li> libotf  -- http://www.m17n.org/libotf/
+
+     freetype と共に OpenType フォントの処理に使います。
+
+<li> anthy -- http://anthy.sourceforge.jp/
+
+     日本語入力メソッド ja-anthy.mim が使います。
+
+<li> wordcut -- http://thaiwordseg.sourceforge.net/
+
+     プログラム例 example/linebreak.c 中でタイ語の語の境界を見つけるた
+     めに使っています。
+
+</ul>
+*/
+
+/***en @section contact Contact us: 

 
 

-/***en @section contact Contact us: */
-/***ja @section contact Ï¢ÍíÀè */
-/***

 Global IT Security Group\n
 National Information Technology Research Institute\n
 Institute of Advanced Industrial Science and Technology
 Global IT Security Group\n
 National Information Technology Research Institute\n
 Institute of Advanced Industrial Science and Technology

@@ -110,13 +218,24 @@ Web: http://www.m17n.org/m17n-lib/
 
 Bug report: m17n-lib-bug@m17n.org
 
 
 Bug report: m17n-lib-bug@m17n.org
 

-Mailing list (English): m17n-lib@m17n.org
+Mailing lists: http://www.m17n.org/m17n-lib/mailinglist.html

 
 

-Mailing list (Japanese): m17n-lib-ja@m17n.org

 */
 */

+/***ja @section contact 連絡先:

 
 

+独立行政法人 産業技術総合研究所\n
+情報技術研究部門\n
+グローバル IT セキュリティグループ
+
+Web: http://www.m17n.org/m17n-lib/
+
+バグレポート: m17n-lib-bug@m17n.org
+
+メイリングリスト: http://www.m17n.org/m17n-lib-ja/mailinglist.htm
+
+*/

 /***en @section ack Acknowledgements */
 /***en @section ack Acknowledgements */

-/***ja @section ack ¼Õ¼­ */
+/***ja @section ack 謝辞 */

 /***
 Special thanks to:
 
 /***
 Special thanks to:
 

@@ -140,7 +259,7 @@ Information-technology Promotion Agency (IPA)
 @htmlonly
 <hr>
 Copyright (C) 2001 Information-technology Promotion Agency (IPA)<p>
 @htmlonly
 <hr>
 Copyright (C) 2001 Information-technology Promotion Agency (IPA)<p>

-Copyright (C) 2001-2004
+Copyright (C) 2001-2006

   National Institute of Advanced Industrial Science and Technology (AIST)<p>
 
 Permission is granted to copy, distribute and/or modify this document
   National Institute of Advanced Industrial Science and Technology (AIST)<p>
 
 Permission is granted to copy, distribute and/or modify this document