From 78d004d96e326cdf2643b569855e9972125eaa50 Mon Sep 17 00:00:00 2001
From: Alexei Znamensky <103110+russoz@users.noreply.github.com>
Date: Tue, 14 Apr 2026 22:19:32 +1200
Subject: [PATCH] lvg: clarify desired-state semantics of pvs parameter in docs
 (#11815)

lvg: doc adjustment
---
 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: