(Visiting Functions, Reading from Files, Saving Buffers): Mention code and EOL

conversions by file I/O primitives and subroutines.

2 files changed, 16 insertions, 6 deletions

diff --git a/lispref/ChangeLog b/lispref/ChangeLog
index 1c5d21ffb8b..7b18e8457c4 100644
--- a/lispref/ChangeLog
+++ b/lispref/ChangeLog
@@ -1,5 +1,9 @@
 2006-05-12  Eli Zaretskii  <eliz@gnu.org>
 
+        * files.texi (Visiting Functions, Reading from Files)
+        (Saving Buffers): Mention code and EOL conversions by file I/O
+        primitives and subroutines.
+
         * nonascii.texi (Lisp and Coding Systems): Document
         coding-system-eol-type.  Add index entries for eol conversion.
 
diff --git a/lispref/files.texi b/lispref/files.texi
index 8a566f62ee0..d23b5efdd67 100644
--- a/lispref/files.texi
+++ b/lispref/files.texi
@@ -136,6 +136,10 @@ example, if it needs to create a buffer, and there is no file named
 @var{filename}, it displays the message @samp{(New file)} in the echo
 area, and leaves the buffer empty.
 
+Reading the file(s) into their respective buffers involves decoding
+the files' contents (@pxref{Coding Systems}), including end-of-line
+conversion.
+
 The @code{find-file-noselect} function normally calls
 @code{after-find-file} after reading the file (@pxref{Subroutines of
 Visiting}).  That function sets the buffer major mode, parses local
@@ -395,11 +399,12 @@ You might wish to save the file modes value returned by
 bits of the file that you write.  This is what @code{save-buffer}
 normally does. @xref{Making Backups,, Making Backup Files}.
 
-The hook functions in @code{write-file-functions} are also responsible for
-encoding the data (if desired): they must choose a suitable coding
-system (@pxref{Lisp and Coding Systems}), perform the encoding
-(@pxref{Explicit Encoding}), and set @code{last-coding-system-used} to
-the coding system that was used (@pxref{Encoding and I/O}).
+The hook functions in @code{write-file-functions} are also responsible
+for encoding the data (if desired): they must choose a suitable coding
+system and end-of-line conversion (@pxref{Lisp and Coding Systems}),
+perform the encoding (@pxref{Explicit Encoding}), and set
+@code{last-coding-system-used} to the coding system that was used
+(@pxref{Encoding and I/O}).
 
 If you set this hook locally in a buffer, it is assumed to be
 associated with the file or the way the contents of the buffer were
@@ -496,7 +501,8 @@ appropriate.  @xref{Format Conversion}.  It also calls the functions in
 the list @code{after-insert-file-functions}; see @ref{Saving
 Properties}.  Normally, one of the functions in the
 @code{after-insert-file-functions} list determines the coding system
-(@pxref{Coding Systems}) used for decoding the file's contents.
+(@pxref{Coding Systems}) used for decoding the file's contents,
+including end-of-line conversion.
 
 If @var{visit} is non-@code{nil}, this function additionally marks the
 buffer as unmodified and sets up various fields in the buffer so that it