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

[Eli Zaretskii]

CVSROOT:        /cvsroot/emacs
Module name:    emacs
Changes by:     Eli Zaretskii <eliz>    09/02/07 11:48:01

Modified files:
        doc/lispref    : nonascii.texi 

Log message:
        (Explicit Encoding): Document the `charset' text property produced by
        decode-coding-region and decode-coding-string.

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

Patches:
Index: nonascii.texi
===================================================================
RCS file: /cvsroot/emacs/emacs/doc/lispref/nonascii.texi,v
retrieving revision 1.21
retrieving revision 1.22
diff -u -b -r1.21 -r1.22
--- nonascii.texi       7 Feb 2009 11:07:22 -0000       1.21
+++ nonascii.texi       7 Feb 2009 11:48:00 -0000       1.22
@@ -1568,6 +1568,10 @@
 
 If decoded text is inserted in some buffer, this command returns the
 length of the decoded text.
+
+This command puts a @code{charset} text property on the decoded text.
+The value of the property states the character set used to decode the
+original text.
 @end deffn
 
 @defun decode-coding-string string coding-system &optional nocopy buffer
@@ -1583,6 +1587,18 @@
 If optional argument @var{buffer} specifies a buffer, the decoded text
 is inserted in that buffer after point (point does not move).  In this
 case, the return value is the length of the decoded text.
+
address@hidden @code{charset}, text property
+This function puts a @code{charset} text property on the decoded text.
+The value of the property states the character set used to decode the
+original text:
+
address@hidden
address@hidden
+(decode-coding-string "Gr\374ss Gott" 'latin-1)
+     @result{} #("Gr@"uss Gott" 0 9 (charset iso-8859-1))
address@hidden group
address@hidden example
 @end defun
 
 @defun decode-coding-inserted-region from to filename &optional visit beg end 
replace