tools: args: update description for --refresh

diff --git a/man/lvchange.8_pregen b/man/lvchange.8_pregen
index 661130105c7e9fa426807af44fc597d0cdfeb941..80bc0e680b8297b64f955af525d45532467d22cb 100644 (file)
--- a/man/lvchange.8_pregen
+++ b/man/lvchange.8_pregen
@@ -848,9 +848,12 @@ See \fBlvmraid\fP(7) for more information.
 \fB--refresh\fP
 .br
 If the LV is active, reload its metadata.
-This is not necessary in normal operation, but may be useful
-if something has gone wrong, or if some form of manual LV
-sharing is being used.
+In an environment where udev is used to manage the /dev content,
+usage of this option is highly recommended. This is because refresh
+also regenerates udev events for an LV based on which existing udev 
+rules are applied to set the /dev content and permissions.
+Also, this operation may be useful if something has gone wrong,
+or if some form of manual LV sharing is being used.
 .
 .HP
 \fB--reportformat\fP \fBbasic\fP|\fBjson\fP|\fBjson_std\fP

diff --git a/man/vgchange.8_pregen b/man/vgchange.8_pregen
index bbe914c4c8387adc400e668193e65a93d0c7f0fc..f67e04d0b171c24400abf9a08a0102a13a13bfed 100644 (file)
--- a/man/vgchange.8_pregen
+++ b/man/vgchange.8_pregen
@@ -783,9 +783,12 @@ metadata updates.
 \fB--refresh\fP
 .br
 If the LV is active, reload its metadata.
-This is not necessary in normal operation, but may be useful
-if something has gone wrong, or if some form of manual LV
-sharing is being used.
+In an environment where udev is used to manage the /dev content,
+usage of this option is highly recommended. This is because refresh
+also regenerates udev events for an LV based on which existing udev 
+rules are applied to set the /dev content and permissions.
+Also, this operation may be useful if something has gone wrong,
+or if some form of manual LV sharing is being used.
 .
 .HP
 \fB--reportformat\fP \fBbasic\fP|\fBjson\fP|\fBjson_std\fP

diff --git a/man/vgmknodes.8_pregen b/man/vgmknodes.8_pregen
index c099fbb56fac49a55d35dcebbfd6e7d661558862..c766a8f905481f76a8d163fd225c5ebfa124717f 100644 (file)
--- a/man/vgmknodes.8_pregen
+++ b/man/vgmknodes.8_pregen
@@ -192,9 +192,12 @@ Repeat once to also suppress any prompts with answer 'no'.
 \fB--refresh\fP
 .br
 If the LV is active, reload its metadata.
-This is not necessary in normal operation, but may be useful
-if something has gone wrong, or if some form of manual LV
-sharing is being used.
+In an environment where udev is used to manage the /dev content,
+usage of this option is highly recommended. This is because refresh
+also regenerates udev events for an LV based on which existing udev 
+rules are applied to set the /dev content and permissions.
+Also, this operation may be useful if something has gone wrong,
+or if some form of manual LV sharing is being used.
 .
 .HP
 \fB--reportformat\fP \fBbasic\fP|\fBjson\fP|\fBjson_std\fP

diff --git a/tools/args.h b/tools/args.h
index 7fc2251717b129edebdfce62e6f80f1c94471762..6b4192400dba7afb70efc5c6a327beddf26e0457 100644 (file)
--- a/tools/args.h
+++ b/tools/args.h
@@ -689,9 +689,12 @@ arg(refresh_ARG, '\0', "refresh", 0, 0, 0,
     "#lvchange\n"
     "#vgmknodes\n"
     "If the LV is active, reload its metadata.\n"
-    "This is not necessary in normal operation, but may be useful\n"
-    "if something has gone wrong, or if some form of manual LV\n"
-    "sharing is being used.\n")
+    "In an environment where udev is used to manage the /dev content,\n"
+    "usage of this option is highly recommended. This is because refresh\n"
+    "also regenerates udev events for an LV based on which existing udev \n"
+    "rules are applied to set the /dev content and permissions.\n"
+    "Also, this operation may be useful if something has gone wrong,\n"
+    "or if some form of manual LV sharing is being used.\n")
 
 arg(removemissing_ARG, '\0', "removemissing", 0, 0, 0,
     "Removes all missing PVs from the VG, if there are no LVs allocated\n"