; Improve INSTALL files

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

diff --git a/INSTALL b/INSTALL
index 605be366e920cc3a2f0804c59c080f60343a9f57..d09216739f6316bcdb7332f8d4b2cf9abece7c6e 100644 (file)
--- 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 0646db426e0f72d825cdb2dcd7154f6df18ecb06..ef05b811989f0ee88bd998ba9cc7349a40b1409f 100644 (file)
--- 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.
 
 \f