From df6fb6fafbefcedd868fac9dab573126f8e4d954 Mon Sep 17 00:00:00 2001
From: Sean Whitton <spwhitton@spwhitton.name>
Date: Sun, 26 Apr 2026 12:21:05 +0100
Subject: [PATCH] ; Fix & improve last change.

---
 doc/emacs/building.texi   | 15 ++++++++-------
 etc/NEWS                  |  2 +-
 lisp/progmodes/compile.el |  3 ++-
 3 files changed, 11 insertions(+), 9 deletions(-)

diff --git a/doc/emacs/building.texi b/doc/emacs/building.texi
index 94b41dd9845..2af98997480 100644
--- a/doc/emacs/building.texi
+++ b/doc/emacs/building.texi
@@ -193,15 +193,16 @@ modify the conditions for automatically visiting the error locus.)
   The actual locus of an error message is determined by
 @code{compilation-search-path}, a list of directory names.  By default,
 Emacs visits the file indicated in the error message under the directory
-where the compilation happens, which is the special directory name
+where the compilation happens, represented by the special directory name
 @code{nil} in the default value for @code{compilation-search-path}
-(i.e. @code{(nil)}).  If you would like Emacs to try to find the file
-under a different directory (e.g. when you compile a nested project),
-customize @code{compilation-search-path} to include that directory.  For
+(i.e. @code{(nil)}).  To make Emacs try to find the file under a
+different directory (e.g. when compiling a nested project), customize
+@code{compilation-search-path} to include that directory.  For
 directory-local customization (@pxref{Directory Variables}), prefer
-using @code{compilation-search-extra-path} instead, which will be
-considered in addition to @code{compilation-search-path}, and takes
-precedence over it.
+setting @code{compilation-search-extra-path} instead, which Emacs
+considers in addition to @code{compilation-search-path}.  Entries in
+@code{compilation-search-extra-path} take precedence over entries in
+@code{compilation-search-path}.
 
   Compilation mode provides the following additional commands.  These
 commands can also be used in @file{*grep*} buffers, where the
diff --git a/etc/NEWS b/etc/NEWS
index 03dfe3b0fc3..43e858352ef 100644
--- a/etc/NEWS
+++ b/etc/NEWS
@@ -793,7 +793,7 @@ compile.el will now use paths specified in both
 'compilation-search-extra-path' and 'compilation-search-path', when
 doing search.  'compilation-search-extra-path' is consulted first.
 One possible use case of this option is to customize add new search
-paths on a per-project basis with directory-local customization.
+paths on a per-project basis with directory-local variables.
 
 
 * Editing Changes in Emacs 31.1
diff --git a/lisp/progmodes/compile.el b/lisp/progmodes/compile.el
index e35acbec042..5222579592e 100644
--- a/lisp/progmodes/compile.el
+++ b/lisp/progmodes/compile.el
@@ -980,7 +980,8 @@ Elements in this list will be searched before those in
 `compilation-search-path'.
 
 The buffer-local value of this variable will be inherited by the
-compilation buffer.")
+compilation buffer."
+  :type '(repeat (string :tag "Directory")))
 
 ;;;###autoload
 (defcustom compile-command