From: Lars Magne Ingebrigtsen Date: Wed, 13 Jul 2011 23:48:35 +0000 (+0200) Subject: Fstring_to_char doc clarification X-Git-Tag: emacs-pretest-24.0.90~104^2~299 X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=837c31f8306d5e21689e325807ef2fff4e5bae9e;p=emacs.git Fstring_to_char doc clarification * editfns.c (Fstring_to_char): Clarify just what is returned (bug#6576). Text by Eli Zaretskii. --- diff --git a/src/ChangeLog b/src/ChangeLog index a045a7ddd21..36a7539b888 100644 --- a/src/ChangeLog +++ b/src/ChangeLog @@ -1,3 +1,8 @@ +2011-07-13 Lars Magne Ingebrigtsen + + * editfns.c (Fstring_to_char): Clarify just what is returned + (bug#6576). Text by Eli Zaretskii. + 2011-07-13 Juanma Barranquero * gnutls.c (init_gnutls_functions): Honor gnutls_log_level (bug#9059). diff --git a/src/editfns.c b/src/editfns.c index bb36d0dee71..6df44352756 100644 --- a/src/editfns.c +++ b/src/editfns.c @@ -194,8 +194,12 @@ DEFUN ("byte-to-string", Fbyte_to_string, Sbyte_to_string, 1, 1, 0, } DEFUN ("string-to-char", Fstring_to_char, Sstring_to_char, 1, 1, 0, - doc: /* Convert arg STRING to a character, the first character of that string. -A multibyte character is handled correctly. */) + doc: /* Return the first character in STRING. +A multibyte character is handled correctly. +The value returned is a Unicode codepoint if it is below #x110000 (in +hex). Codepoints beyond that are Emacs extensions of Unicode. In +particular, eight-bit characters are returned as codepoints in the +range #x3FFF80 through #x3FFFFF, inclusive. */) (register Lisp_Object string) { register Lisp_Object val;