; Improve INSTALL files

* INSTALL:
* java/INSTALL: Improve and clarify instructions.

2 files changed, 13 insertions, 9 deletions

diff --git a/INSTALL b/INSTALL
index 605be366e92..d09216739f6 100644
--- a/INSTALL
+++ b/INSTALL
@@ -4,13 +4,16 @@ Inc.
 See the end of the file for license conditions.
 
 
-This file contains general information on building GNU Emacs.  For
-more information specific to the MS-Windows, GNUstep/macOS, MS-DOS,
-and Android ports, also read the files nt/INSTALL, nextstep/INSTALL,
-msdos/INSTALL, and java/INSTALL.
-
-For information about building from a Git checkout (rather than an
-Emacs release), read the INSTALL.REPO file first.
+This file contains general information on building GNU Emacs.  If you
+are building an Emacs release tarball on a Unix or a GNU system, the
+instructions in this file should be sufficient.  For other
+configurations, we have additional specialized files:
+
+  . INSTALL.REPO if you build from a Git checkout
+  . nt/INSTALL if you build for MS-Windows
+  . nextstep/INSTALL if you build for GNUstep/macOS
+  . java/INSTALL if you build for Android
+  . msdos/INSTALL if you build for MS-DOS
 
 
 BASIC INSTALLATION
diff --git a/java/INSTALL b/java/INSTALL
index 0646db426e0..ef05b811989 100644
--- a/java/INSTALL
+++ b/java/INSTALL
@@ -5,8 +5,9 @@ See the end of the file for license conditions.
 Please read the entirety of this file before attempting to build Emacs
 as an application package which can run on Android devices.
 
-When building from the source repository, make sure to read
-INSTALL.REPO as well.
+When building from the source repository (as opposed to from a release
+tarball), make sure to read INSTALL.REPO in the top-level directory as
+well.