# HG changeset patch
# User stephent
# Date 1112759242 0
# Node ID 2eed1f34d39de79f5fbe8c8572017acf29e74230
# Parent  d438c228964741b1ecfbf81e02488263b1e36f64
[xemacs-hg @ 2005-04-06 03:47:16 by stephent]
improve docstrings <87y8bwbmaa.fsf@tleepslib.sk.tsukuba.ac.jp>

diff -r d438c2289647 -r 2eed1f34d39d src/ChangeLog
--- a/src/ChangeLog	Tue Apr 05 21:51:56 2005 +0000
+++ b/src/ChangeLog	Wed Apr 06 03:47:22 2005 +0000
@@ -1,3 +1,11 @@
+2005-04-06  Stephen J. Turnbull  <stephen@xemacs.org>
+
+	* chartab.c (Fchar_table_p):
+	(Fget_range_char_table):
+	(Fput_char_table):
+	(Fmap_char_table):
+	Describe range representation and fix typo.
+
 2005-04-05  Aidan Kehoe  <kehoea@parhasard.net>
 
 	* mule-ccl.c (ccl_driver): Calculate the charset and position code
diff -r d438c2289647 -r 2eed1f34d39d src/chartab.c
--- a/src/chartab.c	Tue Apr 05 21:51:56 2005 +0000
+++ b/src/chartab.c	Wed Apr 06 03:47:22 2005 +0000
@@ -542,15 +542,17 @@
 When Mule support exists, the types of ranges that can be assigned
 values are
 
--- all characters
+-- all characters (represented by t)
 -- an entire charset
--- a single row in a two-octet charset
+-- a single row in a two-octet charset (represented by a vector of two
+   elements: a two-octet charset and a row number; the row must be an
+   integer, not a character)
 -- a single character
 
 When Mule support is not present, the types of ranges that can be
 assigned values are
 
--- all characters
+-- all characters (represented by t)
 -- a single character
 
 To create a char table, use `make-char-table'.
@@ -912,8 +914,11 @@
 #endif /* ERROR_CHECK_TYPES */
 
 DEFUN ("get-range-char-table", Fget_range_char_table, 2, 3, 0, /*
-Find value for a range in CHAR-TABLE.
+Find value for RANGE in CHAR-TABLE.
 If there is more than one value, return MULTI (defaults to nil).
+
+Valid values for RANGE are single characters, charsets, a row in a
+two-octet charset, and all characters.  See `put-char-table'.
 */
        (range, char_table, multi))
 {
@@ -1128,8 +1133,9 @@
 
 -- t (all characters are affected)
 -- A charset (only allowed when Mule support is present)
--- A vector of two elements: a two-octet charset and a row number
-   (only allowed when Mule support is present)
+-- A vector of two elements: a two-octet charset and a row number; the row
+   must be an integer, not a character (only allowed when Mule support is
+   present)
 -- A single character
 
 VALUE must be a value appropriate for the type of CHAR-TABLE.
@@ -1456,8 +1462,8 @@
 each key and value in the table.
 
 RANGE specifies a subrange to map over and is in the same format as
-the RANGE argument to `put-range-table'.  If omitted or t, it defaults to
-the entire table.
+the RANGE argument to `put-char-table'.  If omitted or t, it defaults to
+the entire table.  See also `char-table-p'.
 */
        (function, char_table, range))
 {