Merge pull request #553 from Mkaysi/install3

INSTALL.md: add instructions for using Python 3.
This commit is contained in:
Valentin Lorentz 2014-02-22 00:02:28 +01:00
commit d498f0d510

View File

@ -31,11 +31,11 @@ from there.
# UNIX/Linux/BSD # UNIX/Linux/BSD
If you're installing Python using your distributor's packages, you may If you're installing Python using your distributor's packages, you may
need a python-dev package installed, too. If you don't have a need a python-dev or python3-dev package installed, too. If you don't have
'/usr/lib/python2.x/distutils' directory or a '/usr/lib/python2.x/distutils' directory or
'/usr/lib/python2.x/config/Makefile' (assuming '/usr/lib/python2.x' is '/usr/lib/python2.x/config/Makefile' or with Python 3
where your Python libs are installed), then you will need a python-dev '/usr/lib/python3.x/distutils' or '/usr/lib/python3.x/config/Makefile' (assuming '/usr/lib/python2.x' or '/usr/lib/python3.x' is where your Python
package. libs are installed), then you will need a python-dev or python3-dev package.
First start by git cloning Limnoria and moving to the cloned repository. First start by git cloning Limnoria and moving to the cloned repository.
@ -54,6 +54,10 @@ Run
python setup.py install python setup.py install
``` ```
```python``` can be replaced with ```python2``` (if your distribution
uses Python 3 by default) or ```python3``` if you want to use Python 3
version.
Now you have several new programs installed where Python scripts are normally Now you have several new programs installed where Python scripts are normally
installed on your system ('/usr/bin' or '/usr/local/bin' are common on installed on your system ('/usr/bin' or '/usr/local/bin' are common on
UNIX systems). The two that might be of particular interest to you, the UNIX systems). The two that might be of particular interest to you, the
@ -70,6 +74,10 @@ Run
python setup.py install --user python setup.py install --user
``` ```
```python``` can be replaced with ```python2``` (if your distribution
uses Python 3 by default) or ```python3``` if you want to use
Python 3 version.
and you will have new programs installed in ~/.local/bin. The two that might be of particular interest to you, the and you will have new programs installed in ~/.local/bin. The two that might be of particular interest to you, the
new user, are 'supybot' and 'supybot-wizard'. The former, 'supybot', is new user, are 'supybot' and 'supybot-wizard'. The former, 'supybot', is
the script to run an actual bot; the latter, 'supybot-wizard', is an the script to run an actual bot; the latter, 'supybot-wizard', is an
@ -96,6 +104,19 @@ and then install Limnoria normally. "python setup.py install" doesn't affect con
If you don't have the cloned Limnoria repository, clone it again using the installation instructions. If you don't have the cloned Limnoria repository, clone it again using the installation instructions.
## Upgrading to Python 3
Upgrading Python3 happens the same way, but if you want to move from 2 to 3
or 3 to 2, you must remove the build/ directory and the executable
supybot* files first. The build/ directory is on same directory as this
file and supybot* are usually in /usr/local/bin or ~/.local/bin
```
rm -rf build/
rm /usr/local/bin/supybot*
rm ~/.local/bin/supybot*
```
# Windows # Windows
**Note**: If you are using an IPV6 connection, you will not be able **Note**: If you are using an IPV6 connection, you will not be able