0

docs/building: clarify Linux build instructions

python3-imaging doesn't exist but python3-pil does, which
python3-pillow is aliased to. It also includes the necessary headers.

Add a note about pip missing the headers and warn of ABI mismatches if
people do weird things.
This commit is contained in:
Nicolas F
2019-07-29 16:27:15 +02:00
parent e2ee37393b
commit cf5dad5539

View File

@@ -128,13 +128,20 @@ Linux
You will need the gcc compiler and a working build environment. On Ubuntu and You will need the gcc compiler and a working build environment. On Ubuntu and
Debian, this can be done by installing the ``build-essential`` package. Debian, this can be done by installing the ``build-essential`` package.
You will need the following packages (at least): You will need the following packages on Debian-derived distributions (e.g. Ubuntu):
* python3-imaging or python3-pillow * python3-pil or python3-pillow (the latter is usually aliased to the former)
* python3-imaging-dev or python3-pillow-dev
* python3-dev * python3-dev
* python3-numpy * python3-numpy
.. note::
If you choose to install pillow through pip instead of your distribution's package
manager, you won't get the pillow headers which Overviewer requires to build its C
extension. In that case, you should manually download the header files specific to
the version of pillow you installed, and point at them with the ``PIL_INCLUDE_DIR``
environment variable. A version mismatch between the installed pillow library and
the headers can lead to segfaults while running Overviewer due to an ABI mismatch.
Then to build:: Then to build::
python3 setup.py build python3 setup.py build