[Emacs-diffs] emacs/doc/lispref nonascii.texi

[Eli Zaretskii]

CVSROOT:        /cvsroot/emacs
Module name:    emacs
Changes by:     Eli Zaretskii <eliz>    08/12/05 16:29:35

Modified files:
        doc/lispref    : nonascii.texi 

Log message:
        (Character Sets): Document `map-charset-chars'.

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/emacs/doc/lispref/nonascii.texi?cvsroot=emacs&r1=1.14&r2=1.15

Patches:
Index: nonascii.texi
===================================================================
RCS file: /cvsroot/emacs/emacs/doc/lispref/nonascii.texi,v
retrieving revision 1.14
retrieving revision 1.15
diff -u -b -r1.14 -r1.15
--- nonascii.texi       5 Dec 2008 16:11:03 -0000       1.14
+++ nonascii.texi       5 Dec 2008 16:29:34 -0000       1.15
@@ -628,6 +628,23 @@
 @code{nil}.
 @end defun
 
+  The following function comes in handy for applying a certain
+function to all or part of the characters in a charset:
+
address@hidden map-charset-chars function charset &optional arg from to
+Call @var{function} for characters in @var{charset}.  @var{function}
+is called with two arguments.  The first one is a cons cell
address@hidden(@var{from} .  @var{to})}, where @var{from} and @var{to}
+indicate a range of characters contained in charset.  The second
+argument is the optional argument @var{arg}.
+
+By default, the range of codepoints passed to @var{function} includes
+all the characters in @var{charset}, but optional arguments @var{from}
+and @var{to} limit that to the range of characters between these two
+codepoints.  If either of them is @code{nil}, it defaults to the first
+or last codepoint of @var{charset}, respectively.
address@hidden defun
+
 @node Scanning Charsets
 @section Scanning for Character Sets