# HG changeset patch
# User Eli Zaretskii <eliz@gnu.org>
# Date 1234007280 0
# Node ID 4e643f5b16ead37e019c94a93281f83790852daa
# Parent  267681f66b59a6e878a9fbb5c67650d01882b727
(Explicit Encoding): Document the `charset' text property produced by
decode-coding-region and decode-coding-string.

diff -r 267681f66b59 -r 4e643f5b16ea doc/lispref/nonascii.texi
--- a/doc/lispref/nonascii.texi	Sat Feb 07 11:09:56 2009 +0000
+++ b/doc/lispref/nonascii.texi	Sat Feb 07 11:48:00 2009 +0000
@@ -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.
+
+@cindex @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:
+
+@example
+@group
+(decode-coding-string "Gr\374ss Gott" 'latin-1)
+     @result{} #("Gr@"uss Gott" 0 9 (charset iso-8859-1))
+@end group
+@end example
 @end defun
 
 @defun decode-coding-inserted-region from to filename &optional visit beg end replace