From 3ea5304a5726fbcd2207091e77a5e95d2ab9fb43 Mon Sep 17 00:00:00 2001
From: Matt Davis <6775756+nitzmahone@users.noreply.github.com>
Date: Mon, 30 Oct 2023 16:38:36 -0700
Subject: [PATCH] add pep668 note to pip module docs (#82096)

---
 lib/ansible/modules/pip.py | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/lib/ansible/modules/pip.py b/lib/ansible/modules/pip.py
index aec18570f85..33591aa0ee9 100644
--- a/lib/ansible/modules/pip.py
+++ b/lib/ansible/modules/pip.py
@@ -120,6 +120,8 @@ attributes:
     platform:
         platforms: posix
 notes:
+   - Python installations marked externally-managed (as defined by PEP668) cannot be updated by pip versions >= 23.0.1 without the use of
+     a virtual environment or setting the environment variable ``PIP_BREAK_SYSTEM_PACKAGES=1``.
    - The virtualenv (U(http://www.virtualenv.org/)) must be
      installed on the remote host if the virtualenv parameter is specified and
      the virtualenv needs to be created.