Mercurial > emacs
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