procyberian/emacs
2
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
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 @noindent
inserts the characters coded by the first 500 bytes of a file. 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 If @var{beg} or @var{end} happens to be in the middle of a character's
character code conversion will insert one or more raw-text characters multibyte sequence, Emacs's character code conversion will insert one
(@pxref{Coding System Basics}) into the buffer. If you want to read or more eight-bit characters (a.k.a.@: ``raw bytes'')
part of a file this way, you are recommended to bind (@pxref{Character Sets}) into the buffer. If you want to read part of
@code{coding-system-for-read} to a suitable value around the call to a file this way, we recommend to bind @code{coding-system-for-read} to
this function (@pxref{Specifying Coding Systems}), and to write Lisp a suitable value around the call to this function (@pxref{Specifying
code which will check for raw-text characters at the boundaries, read Coding Systems}), and to write Lisp code which will check for raw
the rest of these characters from the file, and convert them back to bytes at the boundaries, read the entire sequence of these bytes, and
valid characters. convert them back to valid characters.
If the argument @var{replace} is non-@code{nil}, it means to replace the 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 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 @defun insert-file-contents-literally filename &optional visit beg end replace
This function works like @code{insert-file-contents} except that each This function works like @code{insert-file-contents} except that each
byte in the file is handled separately, being converted into a byte in the file is handled separately, being converted into an
raw-text character if needed. It does not run eight-bit character if needed. It does not run
@code{after-insert-file-functions}, and does not do format decoding, @code{after-insert-file-functions}, and does not do format decoding,
character code conversion, automatic uncompression, and so on. character code conversion, automatic uncompression, and so on.
@end defun @end defun