From: Kenichi Handa <handa@m17n.org>
Date: Tue, 11 Nov 2008 07:25:27 +0000 (+0000)
Subject: (map_char_table_for_charset): Add comment.
X-Git-Tag: emacs-pretest-23.0.90~1892
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=a68053337d32d9a114ce4c45e26a89c55d0c4be4;p=emacs.git

(map_char_table_for_charset): Add comment.
---

diff --git a/src/chartab.c b/src/chartab.c
index f8c1bba85b9..eb56fcf4194 100644
--- a/src/chartab.c
+++ b/src/chartab.c
@@ -980,6 +980,27 @@ map_sub_char_table_for_charset (c_function, function, table, arg, range,
 }
 
 
+/* Support function for `map-charset-chars'.  Map C_FUNCTION or
+   FUNCTION over TABLE, calling it for each cahracter or a group of
+   succeeding characters that have non-nil value in TABLE.  TABLE is a
+   "mapping table" or a "deunifier table" of a certain charset.
+
+   If CHARSET is not NULL (this is the case that `map-charset-chars'
+   is called with non-nil FROM-CODE and TO-CODE), it is a charset who
+   owns TABLE, and the function is called only on a character in the
+   range FROM and TO.  FROM and TO are not character codes, but code
+   points of a character in CHARSET.
+
+   This function is called in these two cases:
+
+   (1) A charset has a mapping file name in :map property.
+
+   (2) A charset has an upper code space in :offset property and a
+   mapping file name in :unify-map property.  In this case, this
+   function is called only for characters in the Unicode code space.
+   Characters in upper code space are handled directly in
+   map_charset_chars.  */
+
 void
 map_char_table_for_charset (c_function, function, table, arg,
 			    charset, from, to)