From: Richard M. Stallman <rms@gnu.org>
Date: Tue, 8 Mar 2005 03:07:54 +0000 (+0000)
Subject: (Text Representations): Clarify position-bytes.
X-Git-Tag: ttn-vms-21-2-B4~1892
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=5ac343acaf287aa8459ac3c725f60d18b9e55cbb;p=emacs.git

(Text Representations): Clarify position-bytes.
(Character Sets): Add list-charset-chars.
(Scanning Charsets): Add charset-after.
(Encoding and I/O): Minor fix.
---

diff --git a/lispref/nonascii.texi b/lispref/nonascii.texi
index 62bd28fd78b..cf9e0acc819 100644
--- a/lispref/nonascii.texi
+++ b/lispref/nonascii.texi
@@ -95,9 +95,10 @@ default value to @code{nil} early in startup.
 
 @defun position-bytes position
 @tindex position-bytes
-Return the byte-position corresponding to buffer position @var{position}
-in the current buffer.  If @var{position} is out of range, the value
-is @code{nil}.
+Return the byte-position corresponding to buffer position
+@var{position} in the current buffer.  This is 1 at the start of the
+buffer, and counts upward in bytes.  If @var{position} is out of
+range, the value is @code{nil}.
 @end defun
 
 @defun byte-to-position byte-position
@@ -359,6 +360,11 @@ as the property list of that symbol.  Charset properties are used for
 special purposes within Emacs.
 @end defun
 
+@deffn Command list-charset-chars charset
+This command displays a list of characters in the character set
+@var{charset}.
+@end deffn
+
 @node Chars and Bytes
 @section Characters and Bytes
 @cindex bytes and characters
@@ -474,6 +480,13 @@ part of a buffer or a string.  One use for this is in determining which
 coding systems (@pxref{Coding Systems}) are capable of representing all
 of the text in question.
 
+@defun charset-after &optional pos
+This function return the charset of a character in the current buffer
+at position @var{pos}.  If @var{pos} is omitted or @code{nil}, it
+defauls to the current value of point.  If @var{pos} is out of range,
+the value is @code{nil}.
+@end defun
+
 @defun find-charset-region beg end &optional translation
 This function returns a list of the character sets that appear in the
 current buffer between positions @var{beg} and @var{end}.
@@ -673,7 +686,7 @@ a coding system for decoding the file data, and @code{write-region}
 uses one to encode the buffer contents.
 
   You can specify the coding system to use either explicitly
-(@pxref{Specifying Coding Systems}), or implicitly using the defaulting
+(@pxref{Specifying Coding Systems}), or implicitly using a default
 mechanism (@pxref{Default Coding Systems}).  But these methods may not
 completely specify what to do.  For example, they may choose a coding
 system such as @code{undefined} which leaves the character code