From 86dc3c88160928b16a01d9790ab4294ecd71b1c2 Mon Sep 17 00:00:00 2001
From: "patchback[bot]" <45432694+patchback[bot]@users.noreply.github.com>
Date: Tue, 14 Apr 2026 22:03:13 +0200
Subject: [PATCH] [PR #11815/78d004d9 backport][stable-12] lvg: clarify
 desired-state semantics of pvs parameter in docs (#11821)

lvg: clarify desired-state semantics of pvs parameter in docs (#11815)

lvg: doc adjustment
(cherry picked from commit 78d004d96e326cdf2643b569855e9972125eaa50)

Co-authored-by: Alexei Znamensky <103110+russoz@users.noreply.github.com>
---
 plugins/modules/lvg.py | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/plugins/modules/lvg.py b/plugins/modules/lvg.py
index 93b84c3d1f..3cec86275e 100644
--- a/plugins/modules/lvg.py
+++ b/plugins/modules/lvg.py
@@ -32,7 +32,9 @@ options:
       - List of comma-separated devices to use as physical devices in this volume group.
       - Required when creating or resizing volume group.
       - The module runs C(pvcreate) if needed.
-      - O(remove_extra_pvs) controls whether or not unspecified physical devices are removed from the volume group.
+      - This parameter defines the B(desired state) of the physical volumes in the volume group.
+        When the volume group already exists, physical volumes not listed here are removed from it by default.
+        To add physical volumes without removing existing unlisted ones, set O(remove_extra_pvs=false).
     type: list
     elements: str
   pesize: