[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
emacs-28 fc32a3b: ; * doc/lispref/files.texi (Reading from Files): Fix w
From: |
Eli Zaretskii |
Subject: |
emacs-28 fc32a3b: ; * doc/lispref/files.texi (Reading from Files): Fix wording. |
Date: |
Sun, 3 Oct 2021 14:30:59 -0400 (EDT) |
branch: emacs-28
commit fc32a3bd958797ad4392a97b66e52bff420ac399
Author: Eli Zaretskii <eliz@gnu.org>
Commit: Eli Zaretskii <eliz@gnu.org>
; * doc/lispref/files.texi (Reading from Files): Fix wording.
---
doc/lispref/files.texi | 22 +++++++++++-----------
1 file changed, 11 insertions(+), 11 deletions(-)
diff --git a/doc/lispref/files.texi b/doc/lispref/files.texi
index e73f53b..1e05153 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
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- emacs-28 fc32a3b: ; * doc/lispref/files.texi (Reading from Files): Fix wording.,
Eli Zaretskii <=