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:
@@ -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
|
||||||
|
|||||||
Reference in New Issue
Block a user