X-Git-Url: http://git.chise.org/gitweb/?a=blobdiff_plain;f=mainpage.txt;h=db7351bdedccdb22eef1a63dc6ffe9463746a8e3;hb=2cb6096b0d1b5e2fe4ae6f3558eafdc6d43c5e81;hp=52a07db23ee8b565f41cdd1cf48bd90442e45c11;hpb=41aaefac13776c8aec6d29d009af0082696ef69d;p=m17n%2Fm17n-docs.git
diff --git a/mainpage.txt b/mainpage.txt
index 52a07db..db7351b 100644
--- a/mainpage.txt
+++ b/mainpage.txt
@@ -1,7 +1,8 @@
-/***en
-@mainpage The M17N Library Documentation
+/* -*- coding: euc-jp; -*- */
+/***en @mainpage The m17n Library Documentation */
+/***ja @mainpage m17n ¥é¥¤¥Ö¥é¥ê */
-@section what What is the m17n library?
+/***en @section what What is the m17n library?
The @e m17n @e library is a multilingual text processing library for
the C language.
@@ -40,29 +41,233 @@ characters and more non-Unicode characters.
@e Chartable: A data structure that contains per-character
information efficiently.
- Functions for inputting and displaying M-text on a window
+ Functions for inputting and displaying M-texts on a window
system.
+*/
+/***ja @section what m17n ¥é¥¤¥Ö¥é¥ê¤È¤Ï?
+
+@e m17n¥é¥¤¥Ö¥é¥ê ¤Ï C ¸À¸ìÍѤο¸À¸ìʸ½ñ½èÍý¥é¥¤¥Ö¥é¥ê¤Ç¤¹¡£
+
+
+
+- ¼«Í³¸ø³«¥½¥Õ¥È¥¦¥§¥¢¤Ç¤¹¡£
+
+
- GNU/Linux ¤È Unix ¤Î¥¢¥×¥ê¥±¡¼¥·¥ç¥ó¤ä¥é¥¤¥Ö¥é¥ê¤«¤éÍøÍѤǤ¤Þ¤¹¡£
+
+
- ¥¢¥×¥ê¥±¡¼¥·¥ç¥ó¤ä¥é¥¤¥Ö¥é¥ê¤Î¤µ¤Þ¤¶¤Þ¤Ê¦Ì̤ǡ¢Â¿¸À¸ì²½¤ò¼Â¸½¤·
+¤Þ¤¹¡£
+
+
+
+"m17n" ¤È¤Ï "multilingualization" ¤Î¾Êά·Á¤Ç¤¹¡£
+
+m17n ¥é¥¤¥Ö¥é¥ê¤Ï¿¸À¸ì¤ò°·¤¦¤¿¤á¡¢°Ê²¼¤Îµ¡Ç½¤òÄ󶡤·¤Þ¤¹¡£
+
+
+
+- @e M-text: ¿¸À¸ì¥Æ¥¥¹¥ÈÍѤΥǡ¼¥¿¹½Â¤¡£´ðËÜŪ¤Ë¤Ïʸ»úÎó¤Ç¤¢¤ë¤¬¡¢
+¥Æ¥¥¹¥È¥×¥í¥Ñ¥Æ¥£¤È¸Æ¤Ð¤ì¤ë°À¤¬ÉÕ¤¤¤Æ¤ª¤ê¡¢C ¤Îʸ»úÎó¤ÎÂå¤ï¤ê¤Ë¤Ê¤ë
+¤è¤¦À߷פµ¤ì¤Æ¤¤¤ë¡£m17n ¥é¥¤¥Ö¥é¥ê¤ÇºÇ¤â½ÅÍפʥª¥Ö¥¸¥§¥¯¥È¡£
+
+
- M-text ¤òºî¤Ã¤¿¤ê¼è¤ê°·¤Ã¤¿¤ê¤¹¤ë¤¿¤á¤Î´Ø¿ô¡£
+
+
- M-text ¤È´û¸¤Î¥Õ¥©¡¼¥Þ¥Ã¥È¤Ç¥³¡¼¥É²½¤µ¤ì¤¿Ê¸»úÎó¤È¤Î´Ö¤ÎÊÑ´¹¤ò¹Ô
+¤¦´Ø¿ô¡£
+
+
- µðÂç¤Êʸ»ú¶õ´Ö¡£ Unicode ʸ»ú¤¹¤Ù¤Æ¤È¤½¤ì°Ê¾å¤Î¿ô¤ÎÈó Unicode ʸ
+»ú¤ò´Þ¤à¤³¤È¤¬¤Ç¤¤ë¡£
+
+
- @e ʸ»ú¥Æ¡¼¥Ö¥ë: ʸ»úËè¤Î¾ðÊó¤ò¸úΨŪ¤ËÊÝ»ý¤¹¤ë¥Ç¡¼¥¿¹½Â¤¡£
+
+
- M-text ¤ò¥¦¥£¥ó¥É¥¦¥·¥¹¥Æ¥à¾å¤ÇÆþÎÏ¡¿É½¼¨¤¹¤ë´Ø¿ô¡£
+
+
+*/
+/***en @section usage How to use it?
+
+Simply include .h> in your program, and link it with the m17n
+library by -lm17n. See @ref m17nIntro for the detail. */
+
+/***ja @section usage ÍøÍÑÊýË¡
-@section usage How to use it?
+.h> ¤ò¥×¥í¥°¥é¥à¤Ë include ¤·¡¢-lm17n ¤Ç m17n ¥é¥¤¥Ö¥é¥ê
+¤È¥ê¥ó¥¯¤·¤Æ¤¯¤À¤µ¤¤¡£ @ref m17nIntro ¤ò»²¾È¡£ */
-Just include in your program, and link it with the m17n
-library by -lm17n. See @ref m17nIntro @latexonly
-(P.\pageref{group__m17nIntro}) @endlatexonly for the detail.
+/***en @section extralib External libraries and data
-@section contact Contact us:
+The m17n library utilizes these external libraries. They are not
+mandatory but many functions of the m17n library depend on them.
+
+
+- m17n-db -- http://www.m17n.org/m17n-lib-en/download/m17n-db-1.5.0.tar.gz
+
+ Provide various information to the m17n library.
+
+
- libxml2 -- http://xmlsoft.org/
+
+ Used by the functions mtext_serialize () and mtext_deserialize ().
+ Those functions return NULL when libxml2 is not available,
+
+
- fribidi -- http://fribidi.sourceforge.net/
+
+ 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.
+
+
- freetype -- http://www.freetype.org/
+
+ Used for handling local fonts.
+
+
- fontconfig -- http://www.fontconfig.org/
+
+ Used for handling local fonts supported by the freetype library.
+
+
- fontconfig -- http://freedesktop.org/Software/fontconfig
+
+ Used for finding local fonts in combination with Xft.
+
+
- xft -- http://freedesktop.org/Software/Xft
+
+ Used for drawing text with local fonts by X Render Extension of X
+ server in combination with fontconfig.
+
+
- GD
+
+ Used for rendering text with local fonts on bitmap/pixmap.
+
+
- libotf -- http://www.m17n.org/libotf/
+
+ Used for handling OpenTypee fonts in combination with freetype
+ and Xft.
+
+
- anthy -- http://anthy.sourceforge.jp/
+
+ Used for the Japanese input method ja-anthy.mim.
+
+
- wordcut -- http://thaiwordseg.sourceforge.net/
+
+ Used for finding Thai word boundary in the example program
+ example/linebreak.c.
+
+
+
+*/
+/***ja @section extralib ³°Éô¥é¥¤¥Ö¥é¥ê¡¿¥Ç¡¼¥¿
+
+m17n ¥é¥¤¥Ö¥é¥ê¤Ï°Ê²¼¤Î³°Éô¥é¥¤¥Ö¥é¥ê¤òÍøÍѤ·¤Æ¤¤¤Þ¤¹¡£É¬¿Ü¤Ç¤Ï¤¢¤ê¤Þ
+¤»¤ó¤¬¡¢m17n ¥é¥¤¥Ö¥é¥ê¤Î´ö¤Ä¤«¤Î´Ø¿ô¤Ï¤³¤ì¤é¤Ë°Í¸¤·¤Æ¤¤¤Þ¤¹¡£
+
+
+- m17n-db -- http://www.m17n.org/m17n-lib-ja/download/m17n-db-1.5.0.tar.gz
+
+ m17n ¥é¥¤¥Ö¥é¥ê¤Ë¼ï¡¹¤Î¾ðÊó¤òÄ󶡤·¤Þ¤¹¡£
+
+
- libxml2 -- http://xmlsoft.org/
+
+ ´Ø¿ô mtext_serialize () ¤È mtext_deserialize () ¤¬»È¤¤¤Þ¤¹¡£
+ libxml2 ¤¬ÍøÍѤǤ¤Ê¤¤»þ¤Ë¤Ï¡¢¤³¤ì¤é¤Î´Ø¿ô¤Ï NULL ¤òÊÖ¤·¤Þ¤¹¡£
+
+
+
- fribidi -- http://fribidi.sourceforge.net/
+
+ BIDI ½èÍý¤Ë»È¤¤¤Þ¤¹¡£ÍøÍѤǤ¤Ê¤¤»þ¤Ï¡¢m17n ¥é¥¤¥Ö¥é¥ê¤Îɽ¼¨¥¨¥ó
+ ¥¸¥ó¤Ï Arabic ¤äHebrew ¤Ê¤É¤Î¥¹¥¯¥ê¥×¥È¤òÀµ¤·¤¯½èÍý¤Ç¤¤Þ¤»¤ó¡£
+
+
- freetype -- http://www.freetype.org/
+
+ ¥í¡¼¥«¥ë¥Õ¥©¥ó¥È¤Î½èÍý¤Ë»È¤¤¤Þ¤¹¡£
+
+
- fontconfig -- http://nexp.cs.pdx.edu/fontconfig/
+
+ Xft ¤È¶¦¤Ë¡¢¥í¡¼¥«¥ë¥Õ¥©¥ó¥È¤Î¸¡º÷¤Ë»È¤¤¤Þ¤¹¡£
+
+
- xft -- http://freedesktop.org/Software/Xft
+
+ fontconfig ¤È¶¦¤Ë X ¥µ¡¼¥Ð¤Î XRender ³ÈÄ¥¤òÍøÍѤ·¤Æ¥Æ¥¥¹¥È¤ò¥í¡¼
+ ¥«¥ë¥Õ¥©¥ó¥È¤Çɽ¼¨¤¹¤ë¤¿¤á¤Ë»È¤¤¤Þ¤¹¡£
+
+
- GD
+ ¥Æ¥¥¹¥È¤ò¥í¡¼¥«¥ë¥Õ¥©¥ó¥È¤Ç bitmap/pixmap ¾å¤Ëɽ¼¨¤¹¤ë¤Î¤Ë»È¤¤¤Þ
+ ¤¹¡£
+
+
- libotf -- http://www.m17n.org/libotf/
+
+ freetype ¤È¶¦¤Ë OpenType ¥Õ¥©¥ó¥È¤Î½èÍý¤Ë»È¤¤¤Þ¤¹¡£
+
+
- anthy -- http://anthy.sourceforge.jp/
+
+ ÆüËܸìÆþÎϥ᥽¥Ã¥É ja-anthy.mim ¤¬»È¤¤¤Þ¤¹¡£
+
+
- wordcut -- http://thaiwordseg.sourceforge.net/
+
+ ¥×¥í¥°¥é¥àÎã example/linebreak.c Ãæ¤Ç¥¿¥¤¸ì¤Î¸ì¤Î¶³¦¤ò¸«¤Ä¤±¤ë¤¿
+ ¤á¤Ë»È¤Ã¤Æ¤¤¤Þ¤¹¡£
+
+
+*/
+
+/***en @section contact Contact us:
Global IT Security Group\n
-National Information Technology Research Institute\n
-Institute of Advanced Industrial Science and Technology
+Information Technology Research Institute\n
+National Institute of Advanced Industrial Science and Technology
+
+Web: http://www.m17n.org/m17n-lib-en/
-Web: http://www.m17n.org/m17n-lib/
+Bug report: m17n-lib-bug-XXXX@m17n.org (Replace XXXX with current year in 4 digits.)
-Bug report: m17n-lib-bug@m17n.org
+Mailing lists: http://www.m17n.org/m17n-lib-en/mailinglist.html
-Mailing list (English): m17n-lib@m17n.org
+*/
+/***ja @section contact Ï¢ÍíÀè:
+
+ÆÈΩ¹ÔÀ¯Ë¡¿Í »º¶Èµ»½ÑÁí¹ç¸¦µæ½ê\n
+¾ðÊ󵻽Ѹ¦µæÉôÌç\n
+¥°¥í¡¼¥Ð¥ë IT ¥»¥¥å¥ê¥Æ¥£¥°¥ë¡¼¥×
+
+Web: http://www.m17n.org/m17n-lib-ja/
+
+¥Ð¥°¥ì¥Ý¡¼¥È: m17n-lib-bug-XXXX@m17n.org (XXXX¤ÎÉôʬ¤Ë¤Ï¸½ºß¤Îǯ¡ÊÀ¾Îñ¡Ë¤ò4·å¤ÇÆþ¤ì¤Æ¤¯¤À¤µ¤¤¡£)
+
+¥á¥¤¥ê¥ó¥°¥ê¥¹¥È: http://www.m17n.org/m17n-lib-ja/mailinglist.htm
-Mailing list (Japanese): m17n-lib-ja@m17n.org
*/
+/***en @section ack Acknowledgements */
+/***ja @section ack ¼Õ¼ */
+/***
+Special thanks to:
+
+
+- Dimitri van Heesch
+
+Author of Doxygen . Without
+this tool, it would have been impossible to create this documentation.
+
+
- Information-technology Promotion Agency (IPA), Japan
+
+Writing this documentation was partially funded by
+Information-technology Promotion Agency (IPA)
+ in fiscal year 2001.
+
+
+*/
+
+/***
+@htmlonly
+
+Copyright (C) 2001 Information-technology Promotion Agency (IPA)
+Copyright (C) 2001-2009
+ National Institute of Advanced Industrial Science and Technology (AIST)
+
+Permission is granted to copy, distribute and/or modify this document
+under the terms of the GNU Free Documentation License, Version 1.2 or
+any later version published by the Free Software Foundation; with no
+Invariant Section, no Front-Cover Texts, and no Back-Cover Texts. A
+copy of the license is included in the appendix entitled "GNU Free
+Documentation License".
+
+@endhtmlonly
+*/