[AC21.5R21.4] char-table doc improvements

APPROVE COMMIT 21.5 RECOMMEND 21.4 Patch against 21.4, applied to 21.5 with offset and fuzz. Index: src/ChangeLog =================================================================== RCS file: /pack/xemacscvs/XEmacs/xemacs/src/ChangeLog,v retrieving revision 1.290.2.95 diff -u -U0 -r1.290.2.95 ChangeLog --- src/ChangeLog 14 Feb 2005 04:15:31 -0000 1.290.2.95 +++ src/ChangeLog 6 Apr 2005 03:41:02 -0000 ＠＠ -0,0 +1,8 ＠＠ +2005-04-06 Stephen J. Turnbull <stephen(a)xemacs.org&gt; + + * chartab.c (Fchar_table_p): + (Fget_range_char_table): + (Fput_char_table): + (Fmap_char_table): + Describe range representation and fix typo. + Index: src/chartab.c =================================================================== RCS file: /pack/xemacscvs/XEmacs/xemacs/src/chartab.c,v retrieving revision 1.14.2.1 diff -u -r1.14.2.1 chartab.c --- src/chartab.c 31 Jan 2005 02:55:05 -0000 1.14.2.1 +++ src/chartab.c 6 Apr 2005 03:41:33 -0000 ＠＠ -457,15 +457,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'. ＠＠ -853,8 +855,11 ＠＠ } 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)) { ＠＠ -1142,8 +1147,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. ＠＠ -1441,8 +1447,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)) { -- School of Systems and Information Engineering http://turnbull.sk.tsukuba.ac.jp University of Tsukuba Tennodai 1-1-1 Tsukuba 305-8573 JAPAN Ask not how you can "do" free software business; ask what your business can "do for" free software.