X-Git-Url: https://jxself.org/git/?p=open-adventure.git;a=blobdiff_plain;f=INSTALL.adoc;h=747324743cb5027b2cb6b00cd705b01c7997175a;hp=803a644ad90b5cfd163c90278e2fb58615ffa270;hb=42c66160a77370e7f70a9024f5d1eff3ef2710cd;hpb=5fcebc66aeca21c67a8187c462d9091a18121363

diff --git a/INSTALL.adoc b/INSTALL.adoc
index 803a644..7473247 100644
--- a/INSTALL.adoc
+++ b/INSTALL.adoc
@@ -1,12 +1,17 @@
 = Installing Open Adventure =
 
-1. Install PyYAML for Python 3 (which requires Python 3), and libedit
-(aka: editline) on your system.
+The instructions below assume your system uses Python 3 by default,
+but the actual Python code in Open Adventure is 2/3 agnostic. Adjust
+the example commands below accordingly.
+
+1. Install PyYAML for Python 3 (which requires Python 3) and libedit
+from http://thrysoee.dk/editline/ (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.
+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'.
 
@@ -15,3 +20,10 @@ You can also use pip to install PyYAML: 'pip3 install PyYAML'.
 3. Optionally run a regression test on the code with 'make check'.
 
 4. Run the resulting 'advent' binary to play.
+
+If make returns the following message:
+
+./make_dungeon.py Traceback (most recent call last): File "./make_dungeon.py", line 10, in import sys, yaml ImportError: No module named yaml
+
+try editing make_dungeon.py to change #!/usr/bin/env python to read
+#!/usr/bin/env python3