diff options
author | Eli Zaretskii <eliz@gnu.org> | 2021-10-03 21:30:34 +0300 |
---|---|---|
committer | Eli Zaretskii <eliz@gnu.org> | 2021-10-03 21:30:34 +0300 |
commit | fc32a3bd958797ad4392a97b66e52bff420ac399 (patch) | |
tree | ae4efded425f21f88cfabcd19eb70ec08d6e25e6 | |
parent | 3cc77aa976f356f2496bd8471cf68b44d26c22a7 (diff) | |
download | emacs-fc32a3bd958797ad4392a97b66e52bff420ac399.tar.gz emacs-fc32a3bd958797ad4392a97b66e52bff420ac399.tar.bz2 emacs-fc32a3bd958797ad4392a97b66e52bff420ac399.zip |
; * doc/lispref/files.texi (Reading from Files): Fix wording.
-rw-r--r-- | doc/lispref/files.texi | 22 |
1 files changed, 11 insertions, 11 deletions
diff --git a/doc/lispref/files.texi b/doc/lispref/files.texi index e73f53b040d..1e05153f3c0 100644 --- a/doc/lispref/files.texi +++ b/doc/lispref/files.texi @@ -565,15 +565,15 @@ In this case, @var{visit} must be @code{nil}. For example, @noindent inserts the characters coded by the first 500 bytes of a file. -If @var{beg} or @var{end} fails to be at a character boundary, Emacs's -character code conversion will insert one or more raw-text characters -(@pxref{Coding System Basics}) into the buffer. If you want to read -part of a file this way, you are recommended to bind -@code{coding-system-for-read} to a suitable value around the call to -this function (@pxref{Specifying Coding Systems}), and to write Lisp -code which will check for raw-text characters at the boundaries, read -the rest of these characters from the file, and convert them back to -valid characters. +If @var{beg} or @var{end} happens to be in the middle of a character's +multibyte sequence, Emacs's character code conversion will insert one +or more eight-bit characters (a.k.a.@: ``raw bytes'') +(@pxref{Character Sets}) into the buffer. If you want to read part of +a file this way, we recommend to bind @code{coding-system-for-read} to +a suitable value around the call to this function (@pxref{Specifying +Coding Systems}), and to write Lisp code which will check for raw +bytes at the boundaries, read the entire sequence of these bytes, and +convert them back to valid characters. If the argument @var{replace} is non-@code{nil}, it means to replace the contents of the buffer (actually, just the accessible portion) with the @@ -588,8 +588,8 @@ with @code{insert-file-contents}, as long as @var{replace} and @defun insert-file-contents-literally filename &optional visit beg end replace This function works like @code{insert-file-contents} except that each -byte in the file is handled separately, being converted into a -raw-text character if needed. It does not run +byte in the file is handled separately, being converted into an +eight-bit character if needed. It does not run @code{after-insert-file-functions}, and does not do format decoding, character code conversion, automatic uncompression, and so on. @end defun |