From 885c9cb206f47b8edd02d5d61a191f61c1f1d92c Mon Sep 17 00:00:00 2001 From: Alex Clark Date: Sun, 1 Jul 2018 07:58:25 -0400 Subject: [PATCH] Add version confusion resolution notes [ci skip] --- docs/releasenotes/5.2.0.rst | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/docs/releasenotes/5.2.0.rst b/docs/releasenotes/5.2.0.rst index 024aaed04..e440be118 100644 --- a/docs/releasenotes/5.2.0.rst +++ b/docs/releasenotes/5.2.0.rst @@ -52,3 +52,18 @@ Fix _i2f compilation with some GCC versions ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ For example, this allows compilation with GCC 4.8 on NetBSD. + +Resolve confusion getting PIL / Pillow version string +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +As user gnbl notes in #3082: + +- it's confusing that PIL.VERSION returns the version string of the former PIL instead of Pillow's +- there does not seem to be documentation on this version number (why this, will it ever change, ..) e.g. at https://pillow.readthedocs.io/en/5.1.x/about.html#why-a-fork +- it's confusing that PIL.version is a module and does not return the version information directly or hints on how to get it +- the package information header is essentially useless (placeholder, does not even mention Pillow, nor the version) +- PIL.version module documentation comment could explain how to access the version information + +We have attempted to resolve these issues here: + +- https://github.com/python-pillow/Pillow/pull/3218