From ffe30999887e87ef26ac083ee7c16279067b294d Mon Sep 17 00:00:00 2001 From: Athanasius Date: Mon, 17 May 2021 06:58:02 +0100 Subject: [PATCH] docs/Running-from-source: Windows needs 32-bit python & misc * Last python 3.7-using release is 4.2.7. * macOS Homebrew might be OK now. * Minor grammar fix in tkinter section. --- Running-from-source.md | 16 ++++++++++------ 1 file changed, 10 insertions(+), 6 deletions(-) diff --git a/Running-from-source.md b/Running-from-source.md index a40b538..b3e5d04 100644 --- a/Running-from-source.md +++ b/Running-from-source.md @@ -1,6 +1,6 @@ # Running from source -* `stable` branch, up to version 4.2.4, uses Python 3.7.x, although it +* `stable` branch, up to version 4.2.7, uses Python 3.7.x, although it should work perfectly well with any 3.8 or 3.9 version as well. * `main` is now targeted against Python 3.9, although should also work @@ -12,14 +12,18 @@ ## Ensure Python is installed On Windows or macOS Download and install an appropriate version from -[python.org](https://python.org). Do **not use HomeBrew** on macOS, that -version is known to have a broken `tk`. See [#670 Update requirements.txt for -MacOS](https://github.com/EDCD/EDMarketConnector/issues/670) +[python.org](https://python.org). + +**You need a 32-bit version on Windows as this application has some code +that calls OS APIs that needs changing for 64-bit and we've not yet had the +incentive to resolve this.** + +On macOS you might run into issues with the HomeBrew python, to do with +a broken `tk`. See [#670 Update requirements.txt for MacOS](https://github.com/EDCD/EDMarketConnector/issues/670) for discussion about this. That might be fixed now, but if you're having issues with a HomeBrew version of Python the first thing we'll ask you to do is try again with the python.org version. - On Linux you should use your distribution's Python 3.x packages. Note that at least Debian 10 still has 2.7.x as `python` and `pip`, and you will need to specify `python3` (from the package of that name) and `pip3` (from @@ -134,7 +138,7 @@ when you get to [Use `pip` to install application requirements](#use-pip-to-inst ## Ensure you have dependencies installed ### tkinter -If using a python.org package it will include this. +python.org packages include this. On Debian, Ubuntu, and other Debian derivatives the package you need to install is `python3-tk`: