update changelog about version_option

package name must match installed name, or be passed with package_name=

1 files changed, 4 insertions, 1 deletions

diff --git a/src/click/decorators.py b/src/click/decorators.py
index 0c095ca..5940e69 100644
--- a/src/click/decorators.py
+++ b/src/click/decorators.py
@@ -330,7 +330,10 @@ def version_option(
         value for messages.
 
     .. versionchanged:: 8.0
-        Use :mod:`importlib.metadata` instead of ``pkg_resources``.
+        Use :mod:`importlib.metadata` instead of ``pkg_resources``. The
+        version is detected based on the package name, not the entry
+        point name. The Python package name must match the installed
+        package name, or be passed with ``package_name=``.
     """
     if message is None:
         message = _("%(prog)s, version %(version)s")