From: Eli Zaretskii <eliz@gnu.org>
Date: Sat, 10 Jan 2009 12:02:28 +0000 (+0000)
Subject: (Lisp and Coding Systems): Document inhibit-null-byte-detection and
X-Git-Tag: emacs-pretest-23.0.90~575
X-Git-Url: http://git.eshelyaron.com/gitweb/?a=commitdiff_plain;h=0b4faef3a5cd5f87ea782d23e33a2610cfd0ff47;p=emacs.git

(Lisp and Coding Systems): Document inhibit-null-byte-detection and
inhibit-iso-escape-detection.
---

diff --git a/doc/lispref/ChangeLog b/doc/lispref/ChangeLog
index d89e71d5646..bf6d58f15db 100644
--- a/doc/lispref/ChangeLog
+++ b/doc/lispref/ChangeLog
@@ -1,3 +1,8 @@
+2009-01-10  Eli Zaretskii  <eliz@gnu.org>
+
+	* nonascii.texi (Lisp and Coding Systems): Document
+	inhibit-null-byte-detection and inhibit-iso-escape-detection.
+
 2009-01-09  Chong Yidong  <cyd@stupidchicken.com>
 
 	* display.texi (Font Lookup): Remove obsolete function
diff --git a/doc/lispref/nonascii.texi b/doc/lispref/nonascii.texi
index 421c849f138..fceabcc3fc1 100644
--- a/doc/lispref/nonascii.texi
+++ b/doc/lispref/nonascii.texi
@@ -1098,6 +1098,9 @@ If the region contains only @acronym{ASCII} characters except for such
 ISO-2022 control characters ISO-2022 as @code{ESC}, the value is
 @code{undecided} or @code{(undecided)}, or a variant specifying
 end-of-line conversion, if that can be deduced from the text.
+
+If the region contains null bytes, the value is @code{no-conversion},
+even if the region contains text encoded in some coding system.
 @end defun
 
 @defun detect-coding-string string &optional highest
@@ -1105,6 +1108,22 @@ This function is like @code{detect-coding-region} except that it
 operates on the contents of @var{string} instead of bytes in the buffer.
 @end defun
 
+@defvar inhibit-null-byte-detection
+If this variable has a non-@code{nil} value, null bytes are ignored
+when detecting the encoding of a region or a string.  This allows to
+correctly detect the encoding of text that contains null bytes, such
+as Info files with Index nodes.
+@end defvar
+
+@defvar inhibit-iso-escape-detection
+If this variable has a non-@code{nil} value, ISO-2022 escape sequences
+are ignored when detecting the encoding of a region or a string.  The
+result is that no text is ever detected as encoded in some ISO-2022
+encoding, and all escape sequences become visible in a buffer.
+@strong{Warning:} @emph{Use this variable with extreme caution,
+because many files in the Emacs distribution use ISO-2022 encoding.}
+@end defvar
+
 @defun coding-system-charset-list coding-system
 This function returns the list of character sets (@pxref{Character
 Sets}) supported by @var{coding-system}.  Some coding systems that