Move most build instructions into INSTALL.adoc.

diff --git a/INSTALL.adoc b/INSTALL.adoc
new file mode 100644 (file)
index 0000000..803a644
--- /dev/null
+++ b/INSTALL.adoc
@@ -0,0 +1,17 @@
+= Installing Open Adventure =
+
+1. Install PyYAML for Python 3 (which requires Python 3), and libedit
+(aka: editline) on your system.
+
+On Debian and Ubuntu: 'apt-get install python3-yaml libedit-dev'.
+On Fedora: 'dnf install python3-PyYAML libedit-devel'.
+
+If you are using MacPorts on OS X: 'port install py3{5,6}-yaml', as appropriate for your Python 3 version.
+
+You can also use pip to install PyYAML: 'pip3 install PyYAML'.
+
+2. 'make'.
+
+3. Optionally run a regression test on the code with 'make check'.
+
+4. Run the resulting 'advent' binary to play.

diff --git a/Makefile b/Makefile
index 9d94c11d35239855a5bb03b7d6e04114650e8146..8be6564988b16ed4a7af7d3e204103df5356f509 100644 (file)
--- a/Makefile
+++ b/Makefile
@@ -1,21 +1,5 @@
 # Makefile for the open-source release of adventure 2.5
 
-# The libedit (aka: editline) library is required to build. On
-# Debian or Ubuntu:
-#
-# apt-get install libedit-dev
-
-# You will also need Python 3 YAML.  Under Debian or ubuntu:
-#
-# apt-get install python3-yaml
-#
-# If you have pip installed,
-#
-# pip3 install PyYAML
-#
-# If you are using MacPorts on OS X:
-# port install py3{5,6}-yaml as appropriate for your Python 3 version.
-#
 # To build with save/resume disabled, pass CCFLAGS="-D ADVENT_NOSAVE"
 
 VERS=$(shell sed -n <NEWS '/^[0-9]/s/:.*//p' | head -1)

diff --git a/README.adoc b/README.adoc
index a838651dfc2b6ef4b7ee01ca7cb11adcaa8f822e..dca92f3074f63299f9c5432161ebc303c6e27e61 100644 (file)
--- a/README.adoc
+++ b/README.adoc
@@ -16,13 +16,11 @@ original 6-character name on the PDP-10 has been reverted to for the
 executable in order to avoid a collision with the BSD games port of
 the ancestral 1977 version.
 
-The distribution has three build-time dependencies: Python 3, Python 3
-YAML, and libedit.  It builds a pure C executable.
+Please see INSTALL.adoc for build info.
 
-You can run a regression test on the code with 'make check'. Extreme
-care has been taken to not silently change gameplay. By policy, all
-user-visible changes from 2.5 are revertible with the -o (oldstyle)
-option.
+Extreme care has been taken to not silently change gameplay. By
+policy, all user-visible changes from 2.5 are revertible with the
+-o (oldstyle) option.
 
 If you encounter a bug (not likely; this code is old and well tested)
 please try to make a test log that reproduces it, using the -l option,