Improve doc for emacs-source-directory (Bug#36527).

diff --git a/INSTALL b/INSTALL
index cb12e4a17aa41e3050adb456404bce1c5f1fee1d..7a1b46872d47c7da453dbbc71a34930f2ff74289 100644 (file)
--- a/INSTALL
+++ b/INSTALL
@@ -219,8 +219,8 @@ DEBUGGING AN INSTALLED EMACS
 
 * Installed Emacs source code
 
-Emacs installs a compressed copy of much of its source code, to make
-it easy for users to read the source code of Emacs via commands like
+Emacs typically installs a compressed copy of much of its source code,
+to make it easy for users to read Emacs source code via commands like
 M-x describe-function (C-h f) to display the definition of a function.
 This compressed copy ordinarily includes both the Elisp source code
 that Emacs is mostly written in, as well as the C source code for the

diff --git a/etc/NEWS b/etc/NEWS
index c3a71ade8acd05f324cb32ba1042a25ed1aff94f..276b8f46e819064fa56b3b0f5ded96230d53680e 100644 (file)
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -148,8 +148,9 @@ called when the function object is garbage-collected.  Use
 ** 'parse-time-string' can now parse ISO 8601 format strings,
 such as "2020-01-15T16:12:21-08:00".
 
-** The new variable 'emacs-source-directory' gives the Emacs source
-code location.
+** The new variable 'emacs-source-directory' gives the location of
+a copy of the Emacs source code, which is now typically installed as a
+set of compressed source-code files.
 
 \f
 * Changes in Emacs 28.1 on Non-Free Operating Systems