X-Git-Url: https://jxself.org/git/?p=open-adventure.git;a=blobdiff_plain;f=INSTALL.adoc;fp=INSTALL.adoc;h=a51b8acd66aa6a870c5ece89e6e5d1490cfaf251;hp=e60fc15bd1fd347d9ac5ce065a44a813593dd634;hb=d9e33a847881bf510c2933aa0801bfda16d89dae;hpb=039c06882ea0631ca918424b66473bc545b60a99 diff --git a/INSTALL.adoc b/INSTALL.adoc index e60fc15..a51b8ac 100644 --- a/INSTALL.adoc +++ b/INSTALL.adoc @@ -1,45 +1,20 @@ = Installing Open Adventure = -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. +Installation now requires Python3 due to a security issue +with the YAML library. -1. Install PyYAML for Python 3 (which requires Python 3) and libedit -from http://thrysoee.dk/editline/ (aka: editline) on your system. +1. Install libedit from http://thrysoee.dk/editline/ (aka: editline) +on your system. + -On Debian and Ubuntu: `apt-get install python3-yaml libedit-dev`. +On Debian and Ubuntu: `apt-get install 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. +On Fedora: `dnf install libedit-devel`. + You can also use pip to install PyYAML: `pip3 install PyYAML`. 2. Change to the top-level directory of the source code (e.g., `cd open-adventure`). 3. Build with `make`. -+ -If make returns the following message: -+ ------------------------------------------------- -Traceback (most recent call last): - File "./make_dungeon.py", line 13, 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` -+ -If you still get the error, use the following command to install yaml with pip: -+ ------------------------------------------------- -pip install pyyaml ------------------------------------------------- -+ -Make sure you have `pip` installed on your system. If not, you should -install it first. See https://pip.pypa.io/en/stable/installing/ 4. Optionally run a regression test on the code with `make check`.