procyberian/emacs
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

; * doc/lispref/files.texi (Reading from Files): Fix wording.

Browse source
This commit is contained in:
Eli Zaretskii 2021-10-03 21:30:34 +03:00
parent 3cc77aa976
commit fc32a3bd95
1 changed files with 11 additions and 11 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

22
doc/lispref/files.texi
View file

@ -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