Merge pull request #4437 from hugovk/upgrade

Docs: Recommend upgrading pip and Pillow
This commit is contained in:
Andrew Murray 2020-02-20 19:13:06 +11:00 committed by GitHub
commit 30f6177f99
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23

View File

@ -47,8 +47,8 @@ Basic Installation
Install Pillow with :command:`pip`:: Install Pillow with :command:`pip`::
python -m pip install pip python -m pip install --upgrade pip
python -m pip install Pillow python -m pip install --upgrade Pillow
Windows Installation Windows Installation
@ -59,8 +59,8 @@ supported Pythons in both 32 and 64-bit versions in wheel, egg, and
executable installers. These binaries have all of the optional executable installers. These binaries have all of the optional
libraries included except for raqm and libimagequant:: libraries included except for raqm and libimagequant::
python -m pip install pip python -m pip install --upgrade pip
python -m pip install Pillow python -m pip install --upgrade Pillow
macOS Installation macOS Installation
@ -71,8 +71,8 @@ versions in the wheel format. These include support for all optional
libraries except libimagequant. Raqm support requires libraqm, libraries except libimagequant. Raqm support requires libraqm,
fribidi, and harfbuzz to be installed separately:: fribidi, and harfbuzz to be installed separately::
python -m pip install pip python -m pip install --upgrade pip
python -m pip install Pillow python -m pip install --upgrade Pillow
Linux Installation Linux Installation
^^^^^^^^^^^^^^^^^^ ^^^^^^^^^^^^^^^^^^
@ -82,8 +82,8 @@ versions in the manylinux wheel format. These include support for all
optional libraries except libimagequant. Raqm support requires optional libraries except libimagequant. Raqm support requires
libraqm, fribidi, and harfbuzz to be installed separately:: libraqm, fribidi, and harfbuzz to be installed separately::
python -m pip install pip python -m pip install --upgrade pip
python -m pip install Pillow python -m pip install --upgrade Pillow
Most major Linux distributions, including Fedora, Debian/Ubuntu and Most major Linux distributions, including Fedora, Debian/Ubuntu and
ArchLinux also include Pillow in packages that previously contained ArchLinux also include Pillow in packages that previously contained
@ -195,8 +195,8 @@ Many of Pillow's features require external libraries:
Once you have installed the prerequisites, run:: Once you have installed the prerequisites, run::
python -m pip install pip python -m pip install --upgrade pip
python -m pip install Pillow python -m pip install --upgrade Pillow
If the prerequisites are installed in the standard library locations If the prerequisites are installed in the standard library locations
for your machine (e.g. :file:`/usr` or :file:`/usr/local`), no for your machine (e.g. :file:`/usr` or :file:`/usr/local`), no
@ -206,7 +206,7 @@ those locations by editing :file:`setup.py` or
:file:`setup.cfg`, or by adding environment variables on the command :file:`setup.cfg`, or by adding environment variables on the command
line:: line::
CFLAGS="-I/usr/pkg/include" python -m pip install pillow CFLAGS="-I/usr/pkg/include" python -m pip install --upgrade Pillow
If Pillow has been previously built without the required If Pillow has been previously built without the required
prerequisites, it may be necessary to manually clear the pip cache or prerequisites, it may be necessary to manually clear the pip cache or
@ -254,7 +254,7 @@ Sample usage::
or using pip:: or using pip::
python -m pip install pillow --global-option="build_ext" --global-option="--enable-[feature]" python -m pip install --upgrade Pillow --global-option="build_ext" --global-option="--enable-[feature]"
Building on macOS Building on macOS
@ -280,8 +280,8 @@ Then see ``depends/install_raqm_cmake.sh`` to install libraqm.
Now install Pillow with:: Now install Pillow with::
python -m pip install pip python -m pip install --upgrade pip
python -m pip install Pillow python -m pip install --upgrade Pillow
or from within the uncompressed source directory:: or from within the uncompressed source directory::