From bade98dc8f2cc7c5e41f44f75d70a88187932bc7 Mon Sep 17 00:00:00 2001
From: Matt Davis <6775756+nitzmahone@users.noreply.github.com>
Date: Mon, 27 Nov 2023 06:55:29 -0800
Subject: [PATCH] add pep668 note to pip module docs (#82096) (#82099)

(cherry picked from commit 3ea5304a5726fbcd2207091e77a5e95d2ab9fb43)
---
 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 15c8c4420aa..f6a20f87903 100644
--- a/lib/ansible/modules/pip.py
+++ b/lib/ansible/modules/pip.py
@@ -121,6 +121,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.