1 /* -*- coding: euc-jp; -*- */
2 /***en @mainpage The m17n Library Documentation */
3 /***ja @mainpage m17n ¥é¥¤¥Ö¥é¥ê */
5 /***en @section what What is the m17n library?
7 The @e m17n @e library is a multilingual text processing library for
12 <li> It is a free and open source software.
14 <li> It is for any GNU/Linux and Unix applications/libraries.
16 <li> It realizes multilingualization of many aspects of
17 applications/libraries.
21 The word "m17n" is an abbreviation of "multilingualization".
23 The m17n library provides following facilities to handle
28 <li> @e M-text: A data structure for a multilingual text. It is
29 basically a string but with attributes called text property, and
30 is designed to substitute for the C string. It is the most important
31 object of the m17n library.
33 <li> Functions for creating and processing M-texts.
35 <li> Functions for converting M-texts from/to strings encoded in
36 various existing formats.
38 <li> A huge character space, which contains all the Unicode
39 characters and more non-Unicode characters.
41 <li> @e Chartable: A data structure that contains per-character
42 information efficiently.
44 <li> Functions for inputting and displaying M-texts on a window
49 /***ja @section what m17n ¥é¥¤¥Ö¥é¥ê¤È¤Ï?
51 @e m17n¥é¥¤¥Ö¥é¥ê ¤Ï C ¸À¸ìÍѤο¸À¸ìʸ½ñ½èÍý¥é¥¤¥Ö¥é¥ê¤Ç¤¹¡£
55 <li> ¼«Í³¸ø³«¥½¥Õ¥È¥¦¥§¥¢¤Ç¤¹¡£
57 <li> GNU/Linux ¤È Unix ¤Î¥¢¥×¥ê¥±¡¼¥·¥ç¥ó¤ä¥é¥¤¥Ö¥é¥ê¤«¤éÍøÍѤǤ¤Þ¤¹¡£
59 <li> ¥¢¥×¥ê¥±¡¼¥·¥ç¥ó¤ä¥é¥¤¥Ö¥é¥ê¤Î¤µ¤Þ¤¶¤Þ¤Ê¦Ì̤ǡ¢Â¿¸À¸ì²½¤ò¼Â¸½¤·
64 "m17n" ¤È¤Ï "multilingualization" ¤Î¾Êά·Á¤Ç¤¹¡£
66 m17n ¥é¥¤¥Ö¥é¥ê¤Ï¿¸À¸ì¤ò°·¤¦¤¿¤á¡¢°Ê²¼¤Îµ¡Ç½¤òÄ󶡤·¤Þ¤¹¡£
70 <li> @e M-text: ¿¸À¸ì¥Æ¥¥¹¥ÈÍѤΥǡ¼¥¿¹½Â¤¡£´ðËÜŪ¤Ë¤Ïʸ»úÎó¤Ç¤¢¤ë¤¬¡¢
71 ¥Æ¥¥¹¥È¥×¥í¥Ñ¥Æ¥£¤È¸Æ¤Ð¤ì¤ë°À¤¬ÉÕ¤¤¤Æ¤ª¤ê¡¢C ¤Îʸ»úÎó¤ÎÂå¤ï¤ê¤Ë¤Ê¤ë
72 ¤è¤¦À߷פµ¤ì¤Æ¤¤¤ë¡£m17n ¥é¥¤¥Ö¥é¥ê¤ÇºÇ¤â½ÅÍפʥª¥Ö¥¸¥§¥¯¥È¡£
74 <li> M-text ¤òºî¤Ã¤¿¤ê¼è¤ê°·¤Ã¤¿¤ê¤¹¤ë¤¿¤á¤Î´Ø¿ô¡£
76 <li> M-text ¤È´û¸¤Î¥Õ¥©¡¼¥Þ¥Ã¥È¤Ç¥³¡¼¥É²½¤µ¤ì¤¿Ê¸»úÎó¤È¤Î´Ö¤ÎÊÑ´¹¤ò¹Ô
79 <li> µðÂç¤Êʸ»ú¶õ´Ö¡£ Unicode ʸ»ú¤¹¤Ù¤Æ¤È¤½¤ì°Ê¾å¤Î¿ô¤ÎÈó Unicode ʸ
80 »ú¤ò´Þ¤à¤³¤È¤¬¤Ç¤¤ë¡£
82 <li> @e ʸ»ú¥Æ¡¼¥Ö¥ë: ʸ»úËè¤Î¾ðÊó¤ò¸úΨŪ¤ËÊÝ»ý¤¹¤ë¥Ç¡¼¥¿¹½Â¤¡£
84 <li> M-text ¤ò¥¦¥£¥ó¥É¥¦¥·¥¹¥Æ¥à¾å¤ÇÆþÎÏ¡¿É½¼¨¤¹¤ë´Ø¿ô¡£
88 /***en @section usage How to use it?
90 Simply include <m17n.h> in your program, and link it with the m17n
91 library by -lm17n. See @ref m17nIntro @latexonly
92 (P.\pageref{group__m17nIntro}) @endlatexonly for the detail. */
94 /***ja @section usage ÍøÍÑÊýË¡
96 <m17n.h> ¤ò¥×¥í¥°¥é¥à¤Ë include ¤·¡¢-lm17n ¤Ç m17n ¥é¥¤¥Ö¥é¥ê¤È¥ê¥ó¥¯
97 ¤·¤Æ¤¯¤À¤µ¤¤¡£ @ref m17nIntro ¤ò»²¾È¡£@latexonly
98 (P.\pageref{group__m17nIntro}) @endlatexonly */
100 /***en @section extralib External libraries and data
102 The m17n library utilizes these external libraries. They are not
103 mandatory but several functions of the m17n library depend on them.
106 <li> m17n-db -- http://www.m17n.org/m17n-lib/download/m17n-db-1.0.tar.gz
108 Used by @ref m17nShell and @ref m17nGUI.
110 <li> libxml2 -- http://xmlsoft.org/
112 Used by the functions mtext_serialize () and mtext_deserialize ().
113 Those functions return NULL when libxml2 is not avairable,
115 <li> fribidi -- http://fribidi.sourceforge.net/
117 Used for BIDI processing. If it is not avairable, the rendering
118 engine of the m17n library can't handle such scritp as Arabic and
121 <li> freetype -- http://www.freetype.org/
123 Used for handling TrueType and Type1 fonts.
125 <li> libotf -- http://www.m17n.org/libotf/
127 Used for handling OpenTypee fonts.
129 <li> anthy -- http://anthy.sourceforge.jp/
131 Used for the Japanese input method ja-anthy.mim.
133 <li> wordcut -- http://thaiwordseg.sourceforge.net/
135 Used for finding Thai word boundary in the example program
141 /***ja @section extralib ³°Éô¥é¥¤¥Ö¥é¥ê¡¿¥Ç¡¼¥¿
143 m17n ¥é¥¤¥Ö¥é¥ê¤Ï°Ê²¼¤Î³°Éô¥é¥¤¥Ö¥é¥ê¤òÍøÍѤ·¤Æ¤¤¤Þ¤¹¡£É¬¿Ü¤Ç¤Ï¤¢¤ê¤Þ
144 ¤»¤ó¤¬¡¢m17n ¥é¥¤¥Ö¥é¥ê¤Î´ö¤Ä¤«¤Î´Ø¿ô¤Ï¤³¤ì¤é¤Ë°Í¸¤·¤Æ¤¤¤Þ¤¹¡£
147 <li> m17n-db -- http://www.m17n.org/m17n-lib/download/m17n-db-1.0.tar.gz
149 @ref m17nShell ¤È @ref m17nGUI ¤¬»È¤¤¤Þ¤¹¡£
151 <li> libxml2 -- http://xmlsoft.org/
153 ´Ø¿ô mtext_serialize () ¤È mtext_deserialize () ¤¬»È¤¤¤Þ¤¹¡£
154 libxml2 ¤¬ÍøÍѤǤ¤Ê¤¤»þ¤Ë¤Ï¡¢¤³¤ì¤é¤Î´Ø¿ô¤Ï NULL ¤òÊÖ¤·¤Þ¤¹¡£
157 <li> fribidi -- http://fribidi.sourceforge.net/
159 BIDI ½èÍý¤Ë»È¤¤¤Þ¤¹¡£ÍøÍѤǤ¤Ê¤¤»þ¤Ï¡¢m17n ¥é¥¤¥Ö¥é¥ê¤Îɽ¼¨¥¨¥ó
160 ¥¸¥ó¤Ï Arabic ¤äHebrew ¤Ê¤É¤Î¥¹¥¯¥ê¥×¥È¤òÀµ¤·¤¯½èÍý¤Ç¤¤Þ¤»¤ó¡£
162 <li> freetype -- http://www.freetype.org/
164 TrueType ¤È Type1 ¥Õ¥©¥ó¥È¤Î½èÍý¤Ë»È¤¤¤Þ¤¹¡£
166 <li> libotf -- http://www.m17n.org/libotf/
168 OpenType ¥Õ¥©¥ó¥È¤Î½èÍý¤Ë»È¤¤¤Þ¤¹¡£
170 <li> anthy -- http://anthy.sourceforge.jp/
172 ÆüËܸìÆþÎϥ᥽¥Ã¥É ja-anthy.mim ¤¬»È¤¤¤Þ¤¹¡£
174 <li> wordcut -- http://thaiwordseg.sourceforge.net/
176 ¥×¥í¥°¥é¥àÎã example/linebreak.c Ãæ¤Ç¥¿¥¤¸ì¤Î¸ì¤Î¶³¦¤ò¸«¤Ä¤±¤ë¤¿
182 /***en @section contact Contact us:
184 Global IT Security Group\n
185 National Information Technology Research Institute\n
186 Institute of Advanced Industrial Science and Technology
188 Web: http://www.m17n.org/m17n-lib/
190 Bug report: m17n-lib-bug@m17n.org
192 Subscribe the mailing list
193 @li (English): http://www.m17n.org/m17n-lib/m17n-lib-archive/index.html
194 @li (Japanese): http://www.m17n.org/m17n-lib/m17n-lib-ja-archive/index.html
196 /***ja @section contact Ï¢ÍíÀè:
198 ÆÈΩ¹ÔÀ¯Ë¡¿Í »º¶Èµ»½ÑÁí¹ç¸¦µæ½ê\n
200 ¥°¥í¡¼¥Ð¥ë IT ¥»¥¥å¥ê¥Æ¥£¥°¥ë¡¼¥×
202 Web: http://www.m17n.org/m17n-lib/
204 ¥Ð¥°¥ì¥Ý¡¼¥È: m17n-lib-bug@m17n.org
206 ¥á¥¤¥ê¥ó¥°¥ê¥¹¥È¹ØÆÉ (±Ñ¸ì): http://www.m17n.org/m17n-lib/m17n-lib-archive/index.html
208 ¥á¥¤¥ê¥ó¥°¥ê¥¹¥È¹ØÆÉ (ÆüËܸì): http://www.m17n.org/m17n-lib/m17n-lib-ja-archive/index.html
210 /***en @section ack Acknowledgements */
211 /***ja @section ack ¼Õ¼ */
217 <li> Dimitri van Heesch <dimitri@stack.nl>
219 Author of Doxygen <http://www.stack.nl/~dimitri/doxygen/>. Without
220 this tool, it would have been impossible to create this documentation.
222 <li> Information-technology Promotion Agency (IPA), Japan
224 Writing this documentation was partially funded by
225 Information-technology Promotion Agency (IPA)
226 <http://www.ipa.go.jp/about/english/index.html> in fiscal year 2001.
234 Copyright (C) 2001 Information-technology Promotion Agency (IPA)<p>
235 Copyright (C) 2001-2004
236 National Institute of Advanced Industrial Science and Technology (AIST)<p>
238 Permission is granted to copy, distribute and/or modify this document
239 under the terms of the GNU Free Documentation License, Version 1.2 or
240 any later version published by the Free Software Foundation; with no
241 Invariant Section, Front-Cover Texts "The m17n library documentation",
242 and no Back-Cover Texts. A copy of the license is included in the
243 appendix entitled "GNU Free Documentation License".