changeset 70624:97f1ae99fe30

(Visiting Functions, Reading from Files, Saving Buffers): Mention code and EOL conversions by file I/O primitives and subroutines.
author Eli Zaretskii <eliz@gnu.org>
date Fri, 12 May 2006 17:56:20 +0000
parents 2ed5d4bbedbf
children 92ebe8a9117c
files lispref/files.texi
diffstat 1 files changed, 12 insertions(+), 6 deletions(-) [+]
line wrap: on
line diff
--- a/lispref/files.texi	Fri May 12 17:48:40 2006 +0000
+++ b/lispref/files.texi	Fri May 12 17:56:20 2006 +0000
@@ -136,6 +136,10 @@
 @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 @@
 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 @@
 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