Mercurial > emacs

--- a/man/mule.texi	Fri Jul 21 19:42:57 2000 +0000
+++ b/man/mule.texi	Sat Jul 22 10:12:00 2000 +0000
@@ -576,6 +576,7 @@
 the third argument says which coding system to use for these files.

 @vindex inhibit-eol-conversion
+@cindex DOS-style end-of-line display
   Emacs recognizes which kind of end-of-line conversion to use based on
 the contents of the file: if it sees only carriage-returns, or only
 carriage-return linefeed sequences, then it chooses the end-of-line
@@ -583,6 +584,29 @@
 end-of-line conversion by setting the variable @code{inhibit-eol-conversion}
 to non-@code{nil}.

+@vindex inhibit-iso-escape-detection
+@cindex escape sequences in files
+  By default, the automatic detection of coding system is sensitive to
+escape sequences.  If Emacs sees a sequence of characters that begin
+with an @key{ESC} character, and the sequence is valid as an ISO-2022
+code, the code is determined as one of ISO-2022 encoding, and the file
+is decoded by the corresponding coding system
+(e.g. @code{iso-2022-7bit}).
+
+  However, there may be cases that you want to read escape sequences in
+a file as is.  In such a case, you can set th variable
+@code{inhibit-iso-escape-detection} to non-@code{nil}.  Then the code
+detection will ignore any escape sequences, and so no file is detected
+as being encoded in some of ISO-2022 encoding.  The result is that all
+escape sequences become visible in a buffer.
+
+  The default value of @code{inhibit-iso-escape-detection} is
+@code{nil}, and it is strongly recommended not to change it.  That's
+because many Emacs Lisp source files that contain non-ASCII characters
+are encoded in the coding system @code{iso-2022-7bit} in the Emacs
+distribution, and they won't be decoded correctly when you visit those
+files if you suppress the escape sequence detection.
+
 @vindex coding
   You can specify the coding system for a particular file using the
 @samp{-*-@dots{}-*-} construct at the beginning of a file, or a local