From 45838e3ae723aa50835c75e78fd38c03497fee2c Mon Sep 17 00:00:00 2001 From: Eli Zaretskii Date: Sat, 15 Jun 2024 15:59:55 +0300 Subject: [PATCH] Better documentation of 'emacs-internal' encoding * doc/lispref/nonascii.texi (Coding System Basics): Recommend 'emacs-internal' encoding for caching. (cherry picked from commit 2cbea4f35cbfb25f53f23ebba81ffe89ce77b136) --- doc/lispref/nonascii.texi | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/doc/lispref/nonascii.texi b/doc/lispref/nonascii.texi index 9a160ba0730..1c5cc0e20b4 100644 --- a/doc/lispref/nonascii.texi +++ b/doc/lispref/nonascii.texi @@ -1135,7 +1135,10 @@ conversion happens, but different in that the result is multibyte data. The name @code{emacs-internal} is an alias for @code{utf-8-emacs-unix} (so it forces no conversion of end-of-line, unlike @code{utf-8-emacs}, which can decode all 3 kinds of -end-of-line conventions). +end-of-line conventions). Since this coding system can represent all +the characters supported by Emacs in its buffers and strings, we +recommend using it whenever saving text for internal purposes, such as +caching. @defun coding-system-get coding-system property This function returns the specified property of the coding system -- 2.39.2