commands: new method for defining commands

2025-09-30 17:44:21 +03:00 · 2016-09-30 13:11:50 -05:00
4 changed files with 87 additions and 98 deletions
--- a/scripts/command-lines.in
+++ b/scripts/command-lines.in
@@ -85,6 +85,11 @@
 # maxrecoveryrate (raidmaxrecoveryrate)
 # writebehind (raidwritebehind)
 #
+# DESC: describe what the command does, with a separate
+# sentence ending in '.' for each unique operation.
+# A new line is printed after each '.' so be careful
+# about where '.' is used.
+#

 #
 # For efficiency, sets of options can be defined and reused
@@ -285,8 +290,7 @@ DESC: Change the number of mirror images in the LV.
 lvconvert --mirrors SNumber LV_linear_striped
 OO: OO_LVCONVERT_RAID, OO_LVCONVERT
 OP: PV ...
-DESC: Alternate form to convert LV to type raid1 or mirror
-DESC: (use --type raid1|mirror).
+DESC: Alternate form to convert LV to type raid1 or mirror (use --type raid1|mirror).

 lvconvert --splitmirrors Number --name LV_new LV_raid1_mirror_cache
 OO: OO_LVCONVERT
@@ -395,7 +399,7 @@ DESC: Create a mirror LV.
 lvcreate --type raid --size SizeMB VG
 OO: OO_LVCREATE_RAID, OO_LVCREATE
 OP: PV ...
-DESC: Create a raid LV (a specific raid level must be used, e.g. raid1.
+DESC: Create a raid LV (a specific raid level must be used, for example, raid1).

 lvcreate --type snapshot --size SizeMB LV
 OO: OO_LVCREATE
@@ -427,20 +431,17 @@ DESC: Create a thin LV that is a snapshot of an existing thin LV.

 lvcreate --type thin --snapshot --thinpool LV_thinpool LV
 OO: OO_LVCREATE_POOL, OO_LVCREATE_THIN, OO_LVCREATE
-DESC: Create a thin LV that is a snapshot of an external origin LV
-DESC: named in arg pos 1.
+DESC: Create a thin LV that is a snapshot of an external origin LV named in arg pos 1.

 lvcreate --type thin --virtualsize SizeMB --size SizeMB --thinpool LV_new
 OO: OO_LVCREATE_POOL, OO_LVCREATE_THIN, OO_LVCREATE
 OP: PV ...
-DESC: Create a thin LV, first creating a thin pool for it,
-DESC: where the new thin pool is named by the --thinpool arg.
+DESC: Create a thin LV, first creating a thin pool for it, where the new thin pool is named by the --thinpool arg.

 lvcreate --type thin --virtualsize SizeMB --size SizeMB LV_new
 OO: OO_LVCREATE_POOL, OO_LVCREATE_THIN, OO_LVCREATE
 OP: PV ...
-DESC: Create a thin LV, first creating a thin pool for it,
-DESC: where the new thin pool is named in arg pos 1.
+DESC: Create a thin LV, first creating a thin pool for it, where the new thin pool is named in arg pos 1.

 lvcreate --type thin --virtualsize SizeMB --size SizeMB VG
 OO: OO_LVCREATE_POOL, OO_LVCREATE_THIN, OO_LVCREATE
@@ -451,14 +452,12 @@ DESC: Create a thin LV, first creating a thin pool for it.
 lvcreate --type cache --size SizeMB LV
 OO: OO_LVCREATE_POOL, OO_LVCREATE_CACHE, OO_LVCREATE
 OP: PV ...
-DESC: Convert the specified LV to type cache after creating a new
-DESC: cache pool LV to use.
+DESC: Convert the specified LV to type cache after creating a new cache pool LV to use.

 lvcreate --type cache --size SizeMB --cachepool LV_cachepool
 OO: OO_LVCREATE_POOL, OO_LVCREATE_CACHE, OO_LVCREATE
 OP: PV ...
-DESC: Create a cache LV, first creating a new origin LV,
-DESC: then combining it with the existing cache pool in arg pos 1.
+DESC: Create a cache LV, first creating a new origin LV, then combining it with the existing cache pool in arg pos 1.

 lvcreate --size SizeMB VG
 OO: --type linear, OO_LVCREATE
@@ -478,8 +477,7 @@ DESC: Create a raid1 or mirror LV (infers --type raid1|mirror).
 lvcreate --snapshot --size SizeMB LV
 OO: --type snapshot, OO_LVCREATE
 OP: PV ...
-DESC: Create a COW snapshot LV of the origin LV in arg pos 1
-DESC: (infers --type snapshot).
+DESC: Create a COW snapshot LV of the origin LV in arg pos 1 (infers --type snapshot).

 lvcreate --thin --size SizeMB VG
 OO: --type thin-pool, OO_LVCREATE_POOL, OO_LVCREATE_THIN, OO_LVCREATE
@@ -493,13 +491,11 @@ DESC: Create a cache pool (infers --type cache-pool).

 lvcreate --snapshot LV_thin
 OO: --type thin, OO_LVCREATE_THIN, OO_LVCREATE
-DESC: Create a thin LV that is a snapshot of an existing thin LV
-DESC: (infers --type thin).
+DESC: Create a thin LV that is a snapshot of an existing thin LV (infers --type thin).

 lvcreate --snapshot --thinpool LV_thinpool LV
 OO: --type thin, OO_LVCREATE_THIN, OO_LVCREATE
-DESC: Create a thin LV that is a snapshot of an external origin LV
-DESC: (infers --type thin).
+DESC: Create a thin LV that is a snapshot of an external origin LV (infers --type thin).

 lvcreate --virtualsize SizeMB --thinpool LV_thinpool
 OO: --type thin, OO_LVCREATE_THIN, OO_LVCREATE
@@ -508,20 +504,17 @@ DESC: Create a thin LV in a thin pool (infers --type thin).
 lvcreate --size SizeMB --cachepool LV_cachepool
 OO: --type cache, OO_LVCREATE_CACHE, OO_LVCREATE
 OP: PV ...
-DESC: Create a new origin LV, combining it with an existing
-DESC: cache pool to create a new cache LV (infers --type cache).
+DESC: Create a new origin LV, combining it with an existing cache pool to create a new cache LV (infers --type cache).

 lvcreate --thin --virtualsize SizeMB --size SizeMB --thinpool LV_new
 OO: --type thin, OO_LVCREATE_POOL, OO_LVCREATE_THIN, OO_LVCREATE
 OP: PV ...
-DESC: Create a thin LV, first creating a thin pool for it, where the new
-DESC: thin pool is named by the --thinpool arg (infers --type thin).
+DESC: Create a thin LV, first creating a thin pool for it, where the new thin pool is named by the --thinpool arg (infers --type thin).

 lvcreate --thin --virtualsize SizeMB --size SizeMB LV_new
 OO: --type thin, OO_LVCREATE_POOL, OO_LVCREATE_THIN, OO_LVCREATE
 OP: PV ...
-DESC: Create a thin LV, first creating a thin pool for it, where the new
-DESC: thin pool is named in arg pos 1 (infers --type thin).
+DESC: Create a thin LV, first creating a thin pool for it, where the new thin pool is named in arg pos 1 (infers --type thin).

 lvcreate --size SizeMB --virtualsize SizeMB VG
 OO: --type thin, --type snapshot, --thin, --snapshot,
--- a/scripts/create-commands.c
+++ b/scripts/create-commands.c
@@ -1487,7 +1487,7 @@ int main(int argc, char *argv[])
 		}

 		if (is_desc_line(line_argv[0])) {
-			char *desc = strdup(line_orig);
+			char *desc = strdup(strstr(line_orig, ":") + 2);
 			if (cmd->desc) {
 				cmd->desc = realloc((char *)cmd->desc, strlen(cmd->desc) + strlen(desc) + 2);
 				strcat((char *)cmd->desc, "  ");
--- a/tools/command-lines.h
+++ b/tools/command-lines.h
@@ -1054,7 +1054,7 @@ commands[16].ro_count = 1;
 commands[16].rp_count = 1;
 commands[16].oo_count = 12;
 commands[16].op_count = 0;
-commands[16].desc = "DESC: Merge LV that was previously split from a mirror.  DESC: Merge thin LV into its origin LV.  DESC: Merge COW snapshot LV into its origin.";
+commands[16].desc = "Merge LV that was previously split from a mirror.  Merge thin LV into its origin LV.  Merge COW snapshot LV into its origin.";
 commands[16].usage = "lvconvert --merge VG|LV_linear_striped_snapshot_raid_thin|Tag ..."
 " [ --background, --interval Number ]";
 commands[16].usage_common = 
@@ -1088,7 +1088,7 @@ commands[17].ro_count = 1;
 commands[17].rp_count = 2;
 commands[17].oo_count = 18;
 commands[17].op_count = 0;
-commands[17].desc = "DESC: Combine LV with a previously split snapshot LV.";
+commands[17].desc = "Combine LV with a previously split snapshot LV.";
 commands[17].usage = "lvconvert --type snapshot LV_linear_striped_raid LV_snapshot"
 " [ --chunksize Number[k|unit], --zero y|n, --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit, --background, --usepolicies ]";
 commands[17].usage_common = 
@@ -1134,7 +1134,7 @@ commands[18].ro_count = 2;
 commands[18].rp_count = 1;
 commands[18].oo_count = 22;
 commands[18].op_count = 0;
-commands[18].desc = "DESC: Convert LV to type thin with an external origin.";
+commands[18].desc = "Convert LV to type thin with an external origin.";
 commands[18].usage = "lvconvert --type thin --thinpool LV LV_linear_striped_raid"
 " [ --originname LV_new, --poolmetadata LV, --poolmetadatasize Number[m|unit], --poolmetadataspare y|n, --readahead auto|none|NumberSectors, --chunksize Number[k|unit], --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit, --background, --usepolicies ]";
 commands[18].usage_common = 
@@ -1188,7 +1188,7 @@ commands[19].ro_count = 2;
 commands[19].rp_count = 1;
 commands[19].oo_count = 23;
 commands[19].op_count = 0;
-commands[19].desc = "DESC: Convert LV to type thin with an external origin (infers --type thin).";
+commands[19].desc = "Convert LV to type thin with an external origin (infers --type thin).";
 commands[19].usage = "lvconvert --thin --thinpool LV LV_linear_striped_raid"
 " [ --type thin, --originname LV_new, --poolmetadata LV, --poolmetadatasize Number[m|unit], --poolmetadataspare y|n, --readahead auto|none|NumberSectors, --chunksize Number[k|unit], --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit, --background, --usepolicies ]";
 commands[19].usage_common = 
@@ -1243,7 +1243,7 @@ commands[20].ro_count = 2;
 commands[20].rp_count = 1;
 commands[20].oo_count = 23;
 commands[20].op_count = 0;
-commands[20].desc = "DESC: Convert LV to type cache.";
+commands[20].desc = "Convert LV to type cache.";
 commands[20].usage = "lvconvert --type cache --cachepool LV LV_linear_striped_raid_thinpool"
 " [ --cachepolicy String, --cachesettings String, --poolmetadata LV, --poolmetadatasize Number[m|unit], --poolmetadataspare y|n, --readahead auto|none|NumberSectors, --chunksize Number[k|unit], --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit, --background, --usepolicies ]";
 commands[20].usage_common = 
@@ -1298,7 +1298,7 @@ commands[21].ro_count = 2;
 commands[21].rp_count = 1;
 commands[21].oo_count = 24;
 commands[21].op_count = 0;
-commands[21].desc = "DESC: Convert LV to type cache (infers --type cache).";
+commands[21].desc = "Convert LV to type cache (infers --type cache).";
 commands[21].usage = "lvconvert --cache --cachepool LV LV_linear_striped_raid_thinpool"
 " [ --type cache, --cachepolicy String, --cachesettings String, --poolmetadata LV, --poolmetadatasize Number[m|unit], --poolmetadataspare y|n, --readahead auto|none|NumberSectors, --chunksize Number[k|unit], --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit, --background, --usepolicies ]";
 commands[21].usage_common = 
@@ -1354,7 +1354,7 @@ commands[22].ro_count = 1;
 commands[22].rp_count = 1;
 commands[22].oo_count = 23;
 commands[22].op_count = 0;
-commands[22].desc = "DESC: Convert LV to type thin-pool.";
+commands[22].desc = "Convert LV to type thin-pool.";
 commands[22].usage = "lvconvert --type thin-pool LV_linear_striped_raid_cache"
 " [ --discards passdown|nopassdown|ignore, --zero y|n, --poolmetadata LV, --poolmetadatasize Number[m|unit], --poolmetadataspare y|n, --readahead auto|none|NumberSectors, --chunksize Number[k|unit], --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit, --background, --usepolicies ]";
 commands[22].usage_common = 
@@ -1407,7 +1407,7 @@ commands[23].ro_count = 1;
 commands[23].rp_count = 1;
 commands[23].oo_count = 21;
 commands[23].op_count = 0;
-commands[23].desc = "DESC: Convert LV to type cache-pool.";
+commands[23].desc = "Convert LV to type cache-pool.";
 commands[23].usage = "lvconvert --type cache-pool LV_linear_striped_raid"
 " [ --poolmetadata LV, --poolmetadatasize Number[m|unit], --poolmetadataspare y|n, --readahead auto|none|NumberSectors, --chunksize Number[k|unit], --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit, --background, --usepolicies ]";
 commands[23].usage_common = 
@@ -1456,7 +1456,7 @@ commands[24].ro_count = 1;
 commands[24].rp_count = 1;
 commands[24].oo_count = 20;
 commands[24].op_count = 1;
-commands[24].desc = "DESC: Convert LV to type mirror.";
+commands[24].desc = "Convert LV to type mirror.";
 commands[24].usage = "lvconvert --type mirror LV_linear_striped_raid"
 " [ --mirrors [+|-]Number, --stripes Number, --stripesize Number[k|unit], --regionsize Number[m|unit], --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit, --background, --usepolicies ]"
 " [ PV ... ]";
@@ -1507,7 +1507,7 @@ commands[25].ro_count = 1;
 commands[25].rp_count = 1;
 commands[25].oo_count = 20;
 commands[25].op_count = 1;
-commands[25].desc = "DESC: Convert LV to type raid.  DESC: Change LV raid type.";
+commands[25].desc = "Convert LV to type raid.  Change LV raid type.";
 commands[25].usage = "lvconvert --type raid LV_linear_striped_mirror_raid"
 " [ --mirrors [+|-]Number, --stripes Number, --stripesize Number[k|unit], --regionsize Number[m|unit], --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit, --background, --usepolicies ]"
 " [ PV ... ]";
@@ -1558,7 +1558,7 @@ commands[26].ro_count = 1;
 commands[26].rp_count = 1;
 commands[26].oo_count = 16;
 commands[26].op_count = 1;
-commands[26].desc = "DESC: Change the number of mirror images in the LV.";
+commands[26].desc = "Change the number of mirror images in the LV.";
 commands[26].usage = "lvconvert --mirrors [+|-]Number LV_mirror_raid"
 " [ --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit, --background, --usepolicies ]"
 " [ PV ... ]";
@@ -1600,7 +1600,7 @@ commands[27].ro_count = 1;
 commands[27].rp_count = 1;
 commands[27].oo_count = 20;
 commands[27].op_count = 1;
-commands[27].desc = "DESC: Alternate form to convert LV to type raid1 or mirror  DESC: (use --type raid1|mirror).";
+commands[27].desc = "Alternate form to convert LV to type raid1 or mirror (use --type raid1|mirror).";
 commands[27].usage = "lvconvert --mirrors [+|-]Number LV_linear_striped"
 " [ --mirrors [+|-]Number, --stripes Number, --stripesize Number[k|unit], --regionsize Number[m|unit], --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit, --background, --usepolicies ]"
 " [ PV ... ]";
@@ -1650,7 +1650,7 @@ commands[28].ro_count = 2;
 commands[28].rp_count = 1;
 commands[28].oo_count = 16;
 commands[28].op_count = 0;
-commands[28].desc = "DESC: Split images from a raid1 or mirror LV and use them to create a new LV.";
+commands[28].desc = "Split images from a raid1 or mirror LV and use them to create a new LV.";
 commands[28].usage = "lvconvert --splitmirrors Number --name LV_new LV_mirror_raid1_cache"
 " [ --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit, --background, --usepolicies ]";
 commands[28].usage_common = 
@@ -1691,7 +1691,7 @@ commands[29].ro_count = 2;
 commands[29].rp_count = 1;
 commands[29].oo_count = 16;
 commands[29].op_count = 0;
-commands[29].desc = "DESC: Split images from a raid1 LV and use them to create a new LV.";
+commands[29].desc = "Split images from a raid1 LV and use them to create a new LV.";
 commands[29].usage = "lvconvert --splitmirrors Number --trackchanges LV_raid1_cache"
 " [ --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit, --background, --usepolicies ]";
 commands[29].usage_common = 
@@ -1730,7 +1730,7 @@ commands[30].ro_count = 1;
 commands[30].rp_count = 1;
 commands[30].oo_count = 16;
 commands[30].op_count = 0;
-commands[30].desc = "DESC: Replace failed PVs in a mirror or raid LV.  DESC: Repair a thin pool.";
+commands[30].desc = "Replace failed PVs in a mirror or raid LV.  Repair a thin pool.";
 commands[30].usage = "lvconvert --repair LV_mirror_raid_thinpool"
 " [ --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit, --background, --usepolicies ]";
 commands[30].usage_common = 
@@ -1767,7 +1767,7 @@ commands[31].ro_count = 1;
 commands[31].rp_count = 1;
 commands[31].oo_count = 16;
 commands[31].op_count = 1;
-commands[31].desc = "DESC: Replace specific PV(s) in a raid* LV with another PV.";
+commands[31].desc = "Replace specific PV(s) in a raid* LV with another PV.";
 commands[31].usage = "lvconvert --replace PV LV_raid"
 " [ --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit, --background, --usepolicies ]"
 " [ PV ... ]";
@@ -1809,7 +1809,7 @@ commands[32].ro_count = 1;
 commands[32].rp_count = 1;
 commands[32].oo_count = 20;
 commands[32].op_count = 1;
-commands[32].desc = "DESC: Convert LV to type striped.";
+commands[32].desc = "Convert LV to type striped.";
 commands[32].usage = "lvconvert --type striped LV_raid"
 " [ --mirrors [+|-]Number, --stripes Number, --stripesize Number[k|unit], --regionsize Number[m|unit], --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit, --background, --usepolicies ]"
 " [ PV ... ]";
@@ -1860,7 +1860,7 @@ commands[33].ro_count = 1;
 commands[33].rp_count = 1;
 commands[33].oo_count = 16;
 commands[33].op_count = 0;
-commands[33].desc = "DESC: Convert LV to type linear.";
+commands[33].desc = "Convert LV to type linear.";
 commands[33].usage = "lvconvert --type linear LV_mirror_raid"
 " [ --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit, --background, --usepolicies ]";
 commands[33].usage_common = 
@@ -1899,7 +1899,7 @@ commands[34].ro_count = 1;
 commands[34].rp_count = 1;
 commands[34].oo_count = 16;
 commands[34].op_count = 0;
-commands[34].desc = "DESC: Change the type of log used by LV.";
+commands[34].desc = "Change the type of log used by LV.";
 commands[34].usage = "lvconvert --mirrorlog core|disk LV_mirror"
 " [ --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit, --background, --usepolicies ]";
 commands[34].usage_common = 
@@ -1937,7 +1937,7 @@ commands[35].ro_count = 1;
 commands[35].rp_count = 1;
 commands[35].oo_count = 16;
 commands[35].op_count = 0;
-commands[35].desc = "DESC: Separate and preserve a cache pool from a cache LV.";
+commands[35].desc = "Separate and preserve a cache pool from a cache LV.";
 commands[35].usage = "lvconvert --splitcache LV_thinpool_cache_cachepool"
 " [ --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit, --background, --usepolicies ]";
 commands[35].usage_common = 
@@ -1974,7 +1974,7 @@ commands[36].ro_count = 1;
 commands[36].rp_count = 1;
 commands[36].oo_count = 16;
 commands[36].op_count = 0;
-commands[36].desc = "DESC: Separate and remove a cache pool from a cache LV.";
+commands[36].desc = "Separate and remove a cache pool from a cache LV.";
 commands[36].usage = "lvconvert --uncache LV_thinpool_cache"
 " [ --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit, --background, --usepolicies ]";
 commands[36].usage_common = 
@@ -2011,7 +2011,7 @@ commands[37].ro_count = 1;
 commands[37].rp_count = 1;
 commands[37].oo_count = 16;
 commands[37].op_count = 0;
-commands[37].desc = "DESC: Separate a COW snapshot from its origin LV.";
+commands[37].desc = "Separate a COW snapshot from its origin LV.";
 commands[37].usage = "lvconvert --splitsnapshot LV_snapshot"
 " [ --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit, --background, --usepolicies ]";
 commands[37].usage_common = 
@@ -2048,7 +2048,7 @@ commands[38].ro_count = 1;
 commands[38].rp_count = 0;
 commands[38].oo_count = 21;
 commands[38].op_count = 0;
-commands[38].desc = "DESC: Alternate form to convert LV to type thin-pool (use --type thin-pool).";
+commands[38].desc = "Alternate form to convert LV to type thin-pool (use --type thin-pool).";
 commands[38].usage = "lvconvert --thinpool LV"
 " [ --poolmetadata LV, --poolmetadatasize Number[m|unit], --poolmetadataspare y|n, --readahead auto|none|NumberSectors, --chunksize Number[k|unit], --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit, --background, --usepolicies ]";
 commands[38].usage_common = 
@@ -2093,7 +2093,7 @@ commands[39].ro_count = 1;
 commands[39].rp_count = 0;
 commands[39].oo_count = 21;
 commands[39].op_count = 0;
-commands[39].desc = "DESC: Alternate form to convert LV to type cache-pool (use --type cache-pool).";
+commands[39].desc = "Alternate form to convert LV to type cache-pool (use --type cache-pool).";
 commands[39].usage = "lvconvert --cachepool LV"
 " [ --poolmetadata LV, --poolmetadatasize Number[m|unit], --poolmetadataspare y|n, --readahead auto|none|NumberSectors, --chunksize Number[k|unit], --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit, --background, --usepolicies ]";
 commands[39].usage_common = 
@@ -2138,7 +2138,7 @@ commands[40].ro_count = 0;
 commands[40].rp_count = 1;
 commands[40].oo_count = 10;
 commands[40].op_count = 0;
-commands[40].desc = "DESC: Poll LV to collapse resync layers.";
+commands[40].desc = "Poll LV to collapse resync layers.";
 commands[40].usage = "lvconvert LV_mirror";
 commands[40].usage_common = 
 " [ --commandprofile String, --config String, --debug, --driverloaded y|n, --help, --profile String, --quiet, --verbose, --version, --yes, --force, --test, --noudevsync ]";
@@ -2166,7 +2166,7 @@ commands[41].ro_count = 1;
 commands[41].rp_count = 1;
 commands[41].oo_count = 10;
 commands[41].op_count = 0;
-commands[41].desc = "DESC: Swap metadata LV in a thin pool or cache pool (temporary command).";
+commands[41].desc = "Swap metadata LV in a thin pool or cache pool (temporary command).";
 commands[41].usage = "lvconvert --poolmetadata LV LV_thinpool_cachepool";
 commands[41].usage_common = 
 " [ --commandprofile String, --config String, --debug, --driverloaded y|n, --help, --profile String, --quiet, --verbose, --version, --yes, --force, --test, --noudevsync ]";
@@ -2196,7 +2196,7 @@ commands[42].ro_count = 2;
 commands[42].rp_count = 1;
 commands[42].oo_count = 32;
 commands[42].op_count = 0;
-commands[42].desc = "DESC: Create an LV that returns errors when used.";
+commands[42].desc = "Create an LV that returns errors when used.";
 commands[42].usage = "lvcreate --type error --size Number[m|unit] VG"
 " [ --addtag Tag, --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit, --autobackup y|n, --activate y|n|ay, --contiguous y|n, --ignoreactivationskip, --ignoremonitoring, --major Number, --metadataprofile String, --minor Number, --monitor y|n, --name String, --nosync, --permission rw|r, --persistent y|n, --readahead auto|none|NumberSectors, --reportformat String, --setactivationskip y|n, --wipesignatures y|n, --zero y|n ]";
 commands[42].usage_common = 
@@ -2268,7 +2268,7 @@ commands[43].ro_count = 2;
 commands[43].rp_count = 1;
 commands[43].oo_count = 32;
 commands[43].op_count = 0;
-commands[43].desc = "DESC: Create an LV that returns zeros when read.";
+commands[43].desc = "Create an LV that returns zeros when read.";
 commands[43].usage = "lvcreate --type zero --size Number[m|unit] VG"
 " [ --addtag Tag, --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit, --autobackup y|n, --activate y|n|ay, --contiguous y|n, --ignoreactivationskip, --ignoremonitoring, --major Number, --metadataprofile String, --minor Number, --monitor y|n, --name String, --nosync, --permission rw|r, --persistent y|n, --readahead auto|none|NumberSectors, --reportformat String, --setactivationskip y|n, --wipesignatures y|n, --zero y|n ]";
 commands[43].usage_common = 
@@ -2340,7 +2340,7 @@ commands[44].ro_count = 2;
 commands[44].rp_count = 1;
 commands[44].oo_count = 32;
 commands[44].op_count = 1;
-commands[44].desc = "DESC: Create a linear LV.";
+commands[44].desc = "Create a linear LV.";
 commands[44].usage = "lvcreate --type linear --size Number[m|unit] VG"
 " [ --addtag Tag, --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit, --autobackup y|n, --activate y|n|ay, --contiguous y|n, --ignoreactivationskip, --ignoremonitoring, --major Number, --metadataprofile String, --minor Number, --monitor y|n, --name String, --nosync, --permission rw|r, --persistent y|n, --readahead auto|none|NumberSectors, --reportformat String, --setactivationskip y|n, --wipesignatures y|n, --zero y|n ]"
 " [ PV ... ]";
@@ -2416,7 +2416,7 @@ commands[45].ro_count = 2;
 commands[45].rp_count = 1;
 commands[45].oo_count = 34;
 commands[45].op_count = 1;
-commands[45].desc = "DESC: Create a striped LV.";
+commands[45].desc = "Create a striped LV.";
 commands[45].usage = "lvcreate --type striped --size Number[m|unit] VG"
 " [ --stripes Number, --stripesize Number[k|unit], --addtag Tag, --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit, --autobackup y|n, --activate y|n|ay, --contiguous y|n, --ignoreactivationskip, --ignoremonitoring, --major Number, --metadataprofile String, --minor Number, --monitor y|n, --name String, --nosync, --permission rw|r, --persistent y|n, --readahead auto|none|NumberSectors, --reportformat String, --setactivationskip y|n, --wipesignatures y|n, --zero y|n ]"
 " [ PV ... ]";
@@ -2496,7 +2496,7 @@ commands[46].ro_count = 2;
 commands[46].rp_count = 1;
 commands[46].oo_count = 36;
 commands[46].op_count = 1;
-commands[46].desc = "DESC: Create a mirror LV.";
+commands[46].desc = "Create a mirror LV.";
 commands[46].usage = "lvcreate --type mirror --size Number[m|unit] VG"
 " [ --mirrors [+|-]Number, --mirrorlog core|disk, --corelog, --regionsize Number[m|unit], --addtag Tag, --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit, --autobackup y|n, --activate y|n|ay, --contiguous y|n, --ignoreactivationskip, --ignoremonitoring, --major Number, --metadataprofile String, --minor Number, --monitor y|n, --name String, --nosync, --permission rw|r, --persistent y|n, --readahead auto|none|NumberSectors, --reportformat String, --setactivationskip y|n, --wipesignatures y|n, --zero y|n ]"
 " [ PV ... ]";
@@ -2579,7 +2579,7 @@ commands[47].ro_count = 2;
 commands[47].rp_count = 1;
 commands[47].oo_count = 38;
 commands[47].op_count = 1;
-commands[47].desc = "DESC: Create a raid LV (a specific raid level must be used, e.g. raid1.";
+commands[47].desc = "Create a raid LV (a specific raid level must be used, for example, raid1).";
 commands[47].usage = "lvcreate --type raid --size Number[m|unit] VG"
 " [ --mirrors [+|-]Number, --stripes Number, --stripesize Number[k|unit], --regionsize Number[m|unit], --minrecoveryrate Number[k|unit], --maxrecoveryrate Number[k|unit], --addtag Tag, --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit, --autobackup y|n, --activate y|n|ay, --contiguous y|n, --ignoreactivationskip, --ignoremonitoring, --major Number, --metadataprofile String, --minor Number, --monitor y|n, --name String, --nosync, --permission rw|r, --persistent y|n, --readahead auto|none|NumberSectors, --reportformat String, --setactivationskip y|n, --wipesignatures y|n, --zero y|n ]"
 " [ PV ... ]";
@@ -2667,7 +2667,7 @@ commands[48].ro_count = 2;
 commands[48].rp_count = 1;
 commands[48].oo_count = 32;
 commands[48].op_count = 1;
-commands[48].desc = "DESC: Create a COW snapshot from an origin LV.";
+commands[48].desc = "Create a COW snapshot from an origin LV.";
 commands[48].usage = "lvcreate --type snapshot --size Number[m|unit] LV"
 " [ --addtag Tag, --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit, --autobackup y|n, --activate y|n|ay, --contiguous y|n, --ignoreactivationskip, --ignoremonitoring, --major Number, --metadataprofile String, --minor Number, --monitor y|n, --name String, --nosync, --permission rw|r, --persistent y|n, --readahead auto|none|NumberSectors, --reportformat String, --setactivationskip y|n, --wipesignatures y|n, --zero y|n ]"
 " [ PV ... ]";
@@ -2743,7 +2743,7 @@ commands[49].ro_count = 3;
 commands[49].rp_count = 1;
 commands[49].oo_count = 33;
 commands[49].op_count = 1;
-commands[49].desc = "DESC: Create a sparse COW snapshot LV of a virtual origin LV.";
+commands[49].desc = "Create a sparse COW snapshot LV of a virtual origin LV.";
 commands[49].usage = "lvcreate --type snapshot --size Number[m|unit] --virtualsize Number[m|unit] VG"
 " [ --virtualoriginsize Number[m|unit], --addtag Tag, --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit, --autobackup y|n, --activate y|n|ay, --contiguous y|n, --ignoreactivationskip, --ignoremonitoring, --major Number, --metadataprofile String, --minor Number, --monitor y|n, --name String, --nosync, --permission rw|r, --persistent y|n, --readahead auto|none|NumberSectors, --reportformat String, --setactivationskip y|n, --wipesignatures y|n, --zero y|n ]"
 " [ PV ... ]";
@@ -2823,7 +2823,7 @@ commands[50].ro_count = 2;
 commands[50].rp_count = 1;
 commands[50].oo_count = 37;
 commands[50].op_count = 1;
-commands[50].desc = "DESC: Create a thin pool.";
+commands[50].desc = "Create a thin pool.";
 commands[50].usage = "lvcreate --type thin-pool --size Number[m|unit] VG"
 " [ --poolmetadatasize Number[m|unit], --poolmetadataspare y|n, --chunksize Number[k|unit], --discards passdown|nopassdown|ignore, --errorwhenfull y|n, --addtag Tag, --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit, --autobackup y|n, --activate y|n|ay, --contiguous y|n, --ignoreactivationskip, --ignoremonitoring, --major Number, --metadataprofile String, --minor Number, --monitor y|n, --name String, --nosync, --permission rw|r, --persistent y|n, --readahead auto|none|NumberSectors, --reportformat String, --setactivationskip y|n, --wipesignatures y|n, --zero y|n ]"
 " [ PV ... ]";
@@ -2909,7 +2909,7 @@ commands[51].ro_count = 2;
 commands[51].rp_count = 1;
 commands[51].oo_count = 38;
 commands[51].op_count = 1;
-commands[51].desc = "DESC: Create a cache pool.";
+commands[51].desc = "Create a cache pool.";
 commands[51].usage = "lvcreate --type cache-pool --size Number[m|unit] VG"
 " [ --poolmetadatasize Number[m|unit], --poolmetadataspare y|n, --chunksize Number[k|unit], --cachemode writethrough|writeback, --cachepolicy String, --cachesettings String, --addtag Tag, --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit, --autobackup y|n, --activate y|n|ay, --contiguous y|n, --ignoreactivationskip, --ignoremonitoring, --major Number, --metadataprofile String, --minor Number, --monitor y|n, --name String, --nosync, --permission rw|r, --persistent y|n, --readahead auto|none|NumberSectors, --reportformat String, --setactivationskip y|n, --wipesignatures y|n, --zero y|n ]"
 " [ PV ... ]";
@@ -2997,7 +2997,7 @@ commands[52].ro_count = 3;
 commands[52].rp_count = 0;
 commands[52].oo_count = 37;
 commands[52].op_count = 0;
-commands[52].desc = "DESC: Create a thin LV in a thin pool.";
+commands[52].desc = "Create a thin LV in a thin pool.";
 commands[52].usage = "lvcreate --type thin --virtualsize Number[m|unit] --thinpool LV_thinpool"
 " [ --poolmetadatasize Number[m|unit], --poolmetadataspare y|n, --chunksize Number[k|unit], --discards passdown|nopassdown|ignore, --errorwhenfull y|n, --addtag Tag, --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit, --autobackup y|n, --activate y|n|ay, --contiguous y|n, --ignoreactivationskip, --ignoremonitoring, --major Number, --metadataprofile String, --minor Number, --monitor y|n, --name String, --nosync, --permission rw|r, --persistent y|n, --readahead auto|none|NumberSectors, --reportformat String, --setactivationskip y|n, --wipesignatures y|n, --zero y|n ]";
 commands[52].usage_common = 
@@ -3080,7 +3080,7 @@ commands[53].ro_count = 2;
 commands[53].rp_count = 1;
 commands[53].oo_count = 37;
 commands[53].op_count = 0;
-commands[53].desc = "DESC: Create a thin LV that is a snapshot of an existing thin LV.";
+commands[53].desc = "Create a thin LV that is a snapshot of an existing thin LV.";
 commands[53].usage = "lvcreate --type thin --snapshot LV_thin"
 " [ --poolmetadatasize Number[m|unit], --poolmetadataspare y|n, --chunksize Number[k|unit], --discards passdown|nopassdown|ignore, --errorwhenfull y|n, --addtag Tag, --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit, --autobackup y|n, --activate y|n|ay, --contiguous y|n, --ignoreactivationskip, --ignoremonitoring, --major Number, --metadataprofile String, --minor Number, --monitor y|n, --name String, --nosync, --permission rw|r, --persistent y|n, --readahead auto|none|NumberSectors, --reportformat String, --setactivationskip y|n, --wipesignatures y|n, --zero y|n ]";
 commands[53].usage_common = 
@@ -3162,7 +3162,7 @@ commands[54].ro_count = 3;
 commands[54].rp_count = 1;
 commands[54].oo_count = 37;
 commands[54].op_count = 0;
-commands[54].desc = "DESC: Create a thin LV that is a snapshot of an external origin LV  DESC: named in arg pos 1.";
+commands[54].desc = "Create a thin LV that is a snapshot of an external origin LV named in arg pos 1.";
 commands[54].usage = "lvcreate --type thin --snapshot --thinpool LV_thinpool LV"
 " [ --poolmetadatasize Number[m|unit], --poolmetadataspare y|n, --chunksize Number[k|unit], --discards passdown|nopassdown|ignore, --errorwhenfull y|n, --addtag Tag, --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit, --autobackup y|n, --activate y|n|ay, --contiguous y|n, --ignoreactivationskip, --ignoremonitoring, --major Number, --metadataprofile String, --minor Number, --monitor y|n, --name String, --nosync, --permission rw|r, --persistent y|n, --readahead auto|none|NumberSectors, --reportformat String, --setactivationskip y|n, --wipesignatures y|n, --zero y|n ]";
 commands[54].usage_common = 
@@ -3246,7 +3246,7 @@ commands[55].ro_count = 4;
 commands[55].rp_count = 0;
 commands[55].oo_count = 37;
 commands[55].op_count = 1;
-commands[55].desc = "DESC: Create a thin LV, first creating a thin pool for it,  DESC: where the new thin pool is named by the --thinpool arg.";
+commands[55].desc = "Create a thin LV, first creating a thin pool for it, where the new thin pool is named by the --thinpool arg.";
 commands[55].usage = "lvcreate --type thin --virtualsize Number[m|unit] --size Number[m|unit] --thinpool LV_new"
 " [ --poolmetadatasize Number[m|unit], --poolmetadataspare y|n, --chunksize Number[k|unit], --discards passdown|nopassdown|ignore, --errorwhenfull y|n, --addtag Tag, --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit, --autobackup y|n, --activate y|n|ay, --contiguous y|n, --ignoreactivationskip, --ignoremonitoring, --major Number, --metadataprofile String, --minor Number, --monitor y|n, --name String, --nosync, --permission rw|r, --persistent y|n, --readahead auto|none|NumberSectors, --reportformat String, --setactivationskip y|n, --wipesignatures y|n, --zero y|n ]"
 " [ PV ... ]";
@@ -3335,7 +3335,7 @@ commands[56].ro_count = 3;
 commands[56].rp_count = 1;
 commands[56].oo_count = 37;
 commands[56].op_count = 1;
-commands[56].desc = "DESC: Create a thin LV, first creating a thin pool for it,  DESC: where the new thin pool is named in arg pos 1.";
+commands[56].desc = "Create a thin LV, first creating a thin pool for it, where the new thin pool is named in arg pos 1.";
 commands[56].usage = "lvcreate --type thin --virtualsize Number[m|unit] --size Number[m|unit] LV_new"
 " [ --poolmetadatasize Number[m|unit], --poolmetadataspare y|n, --chunksize Number[k|unit], --discards passdown|nopassdown|ignore, --errorwhenfull y|n, --addtag Tag, --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit, --autobackup y|n, --activate y|n|ay, --contiguous y|n, --ignoreactivationskip, --ignoremonitoring, --major Number, --metadataprofile String, --minor Number, --monitor y|n, --name String, --nosync, --permission rw|r, --persistent y|n, --readahead auto|none|NumberSectors, --reportformat String, --setactivationskip y|n, --wipesignatures y|n, --zero y|n ]"
 " [ PV ... ]";
@@ -3424,7 +3424,7 @@ commands[57].ro_count = 3;
 commands[57].rp_count = 1;
 commands[57].oo_count = 37;
 commands[57].op_count = 1;
-commands[57].desc = "DESC: Create a thin LV, first creating a thin pool for it.";
+commands[57].desc = "Create a thin LV, first creating a thin pool for it.";
 commands[57].usage = "lvcreate --type thin --virtualsize Number[m|unit] --size Number[m|unit] VG"
 " [ --poolmetadatasize Number[m|unit], --poolmetadataspare y|n, --chunksize Number[k|unit], --discards passdown|nopassdown|ignore, --errorwhenfull y|n, --addtag Tag, --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit, --autobackup y|n, --activate y|n|ay, --contiguous y|n, --ignoreactivationskip, --ignoremonitoring, --major Number, --metadataprofile String, --minor Number, --monitor y|n, --name String, --nosync, --permission rw|r, --persistent y|n, --readahead auto|none|NumberSectors, --reportformat String, --setactivationskip y|n, --wipesignatures y|n, --zero y|n ]"
 " [ PV ... ]";
@@ -3512,7 +3512,7 @@ commands[58].ro_count = 2;
 commands[58].rp_count = 1;
 commands[58].oo_count = 38;
 commands[58].op_count = 1;
-commands[58].desc = "DESC: Convert the specified LV to type cache after creating a new  DESC: cache pool LV to use.";
+commands[58].desc = "Convert the specified LV to type cache after creating a new cache pool LV to use.";
 commands[58].usage = "lvcreate --type cache --size Number[m|unit] LV"
 " [ --poolmetadatasize Number[m|unit], --poolmetadataspare y|n, --chunksize Number[k|unit], --cachemode writethrough|writeback, --cachepolicy String, --cachesettings String, --addtag Tag, --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit, --autobackup y|n, --activate y|n|ay, --contiguous y|n, --ignoreactivationskip, --ignoremonitoring, --major Number, --metadataprofile String, --minor Number, --monitor y|n, --name String, --nosync, --permission rw|r, --persistent y|n, --readahead auto|none|NumberSectors, --reportformat String, --setactivationskip y|n, --wipesignatures y|n, --zero y|n ]"
 " [ PV ... ]";
@@ -3600,7 +3600,7 @@ commands[59].ro_count = 3;
 commands[59].rp_count = 0;
 commands[59].oo_count = 38;
 commands[59].op_count = 1;
-commands[59].desc = "DESC: Create a cache LV, first creating a new origin LV,  DESC: then combining it with the existing cache pool in arg pos 1.";
+commands[59].desc = "Create a cache LV, first creating a new origin LV, then combining it with the existing cache pool in arg pos 1.";
 commands[59].usage = "lvcreate --type cache --size Number[m|unit] --cachepool LV_cachepool"
 " [ --poolmetadatasize Number[m|unit], --poolmetadataspare y|n, --chunksize Number[k|unit], --cachemode writethrough|writeback, --cachepolicy String, --cachesettings String, --addtag Tag, --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit, --autobackup y|n, --activate y|n|ay, --contiguous y|n, --ignoreactivationskip, --ignoremonitoring, --major Number, --metadataprofile String, --minor Number, --monitor y|n, --name String, --nosync, --permission rw|r, --persistent y|n, --readahead auto|none|NumberSectors, --reportformat String, --setactivationskip y|n, --wipesignatures y|n, --zero y|n ]"
 " [ PV ... ]";
@@ -3689,7 +3689,7 @@ commands[60].ro_count = 1;
 commands[60].rp_count = 1;
 commands[60].oo_count = 33;
 commands[60].op_count = 1;
-commands[60].desc = "DESC: Create a linear LV, --name is usually specified (default --type linear).";
+commands[60].desc = "Create a linear LV, --name is usually specified (default --type linear).";
 commands[60].usage = "lvcreate --size Number[m|unit] VG"
 " [ --type linear, --addtag Tag, --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit, --autobackup y|n, --activate y|n|ay, --contiguous y|n, --ignoreactivationskip, --ignoremonitoring, --major Number, --metadataprofile String, --minor Number, --monitor y|n, --name String, --nosync, --permission rw|r, --persistent y|n, --readahead auto|none|NumberSectors, --reportformat String, --setactivationskip y|n, --wipesignatures y|n, --zero y|n ]"
 " [ PV ... ]";
@@ -3765,7 +3765,7 @@ commands[61].ro_count = 2;
 commands[61].rp_count = 1;
 commands[61].oo_count = 34;
 commands[61].op_count = 1;
-commands[61].desc = "DESC: Create a striped LV (infers --type striped).";
+commands[61].desc = "Create a striped LV (infers --type striped).";
 commands[61].usage = "lvcreate --stripes Number --size Number[m|unit] VG"
 " [ --type striped, --stripesize Number[k|unit], --addtag Tag, --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit, --autobackup y|n, --activate y|n|ay, --contiguous y|n, --ignoreactivationskip, --ignoremonitoring, --major Number, --metadataprofile String, --minor Number, --monitor y|n, --name String, --nosync, --permission rw|r, --persistent y|n, --readahead auto|none|NumberSectors, --reportformat String, --setactivationskip y|n, --wipesignatures y|n, --zero y|n ]"
 " [ PV ... ]";
@@ -3845,7 +3845,7 @@ commands[62].ro_count = 2;
 commands[62].rp_count = 1;
 commands[62].oo_count = 42;
 commands[62].op_count = 1;
-commands[62].desc = "DESC: Create a raid1 or mirror LV (infers --type raid1|mirror).";
+commands[62].desc = "Create a raid1 or mirror LV (infers --type raid1|mirror).";
 commands[62].usage = "lvcreate --mirrors [+|-]Number --size Number[m|unit] VG"
 " [ --type raid1, --type mirror, --mirrorlog core|disk, --corelog, --mirrors [+|-]Number, --stripes Number, --stripesize Number[k|unit], --regionsize Number[m|unit], --minrecoveryrate Number[k|unit], --maxrecoveryrate Number[k|unit], --addtag Tag, --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit, --autobackup y|n, --activate y|n|ay, --contiguous y|n, --ignoreactivationskip, --ignoremonitoring, --major Number, --metadataprofile String, --minor Number, --monitor y|n, --name String, --nosync, --permission rw|r, --persistent y|n, --readahead auto|none|NumberSectors, --reportformat String, --setactivationskip y|n, --wipesignatures y|n, --zero y|n ]"
 " [ PV ... ]";
@@ -3941,7 +3941,7 @@ commands[63].ro_count = 2;
 commands[63].rp_count = 1;
 commands[63].oo_count = 33;
 commands[63].op_count = 1;
-commands[63].desc = "DESC: Create a COW snapshot LV of the origin LV in arg pos 1  DESC: (infers --type snapshot).";
+commands[63].desc = "Create a COW snapshot LV of the origin LV in arg pos 1 (infers --type snapshot).";
 commands[63].usage = "lvcreate --snapshot --size Number[m|unit] LV"
 " [ --type snapshot, --addtag Tag, --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit, --autobackup y|n, --activate y|n|ay, --contiguous y|n, --ignoreactivationskip, --ignoremonitoring, --major Number, --metadataprofile String, --minor Number, --monitor y|n, --name String, --nosync, --permission rw|r, --persistent y|n, --readahead auto|none|NumberSectors, --reportformat String, --setactivationskip y|n, --wipesignatures y|n, --zero y|n ]"
 " [ PV ... ]";
@@ -4018,7 +4018,7 @@ commands[64].ro_count = 2;
 commands[64].rp_count = 1;
 commands[64].oo_count = 38;
 commands[64].op_count = 1;
-commands[64].desc = "DESC: Create a thin pool (infers --type thin-pool).";
+commands[64].desc = "Create a thin pool (infers --type thin-pool).";
 commands[64].usage = "lvcreate --thin --size Number[m|unit] VG"
 " [ --type thin-pool, --poolmetadatasize Number[m|unit], --poolmetadataspare y|n, --chunksize Number[k|unit], --discards passdown|nopassdown|ignore, --errorwhenfull y|n, --addtag Tag, --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit, --autobackup y|n, --activate y|n|ay, --contiguous y|n, --ignoreactivationskip, --ignoremonitoring, --major Number, --metadataprofile String, --minor Number, --monitor y|n, --name String, --nosync, --permission rw|r, --persistent y|n, --readahead auto|none|NumberSectors, --reportformat String, --setactivationskip y|n, --wipesignatures y|n, --zero y|n ]"
 " [ PV ... ]";
@@ -4105,7 +4105,7 @@ commands[65].ro_count = 2;
 commands[65].rp_count = 1;
 commands[65].oo_count = 39;
 commands[65].op_count = 1;
-commands[65].desc = "DESC: Create a cache pool (infers --type cache-pool).";
+commands[65].desc = "Create a cache pool (infers --type cache-pool).";
 commands[65].usage = "lvcreate --cache --size Number[m|unit] VG"
 " [ --type cache-pool, --poolmetadatasize Number[m|unit], --poolmetadataspare y|n, --chunksize Number[k|unit], --cachemode writethrough|writeback, --cachepolicy String, --cachesettings String, --addtag Tag, --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit, --autobackup y|n, --activate y|n|ay, --contiguous y|n, --ignoreactivationskip, --ignoremonitoring, --major Number, --metadataprofile String, --minor Number, --monitor y|n, --name String, --nosync, --permission rw|r, --persistent y|n, --readahead auto|none|NumberSectors, --reportformat String, --setactivationskip y|n, --wipesignatures y|n, --zero y|n ]"
 " [ PV ... ]";
@@ -4194,7 +4194,7 @@ commands[66].ro_count = 1;
 commands[66].rp_count = 1;
 commands[66].oo_count = 35;
 commands[66].op_count = 0;
-commands[66].desc = "DESC: Create a thin LV that is a snapshot of an existing thin LV  DESC: (infers --type thin).";
+commands[66].desc = "Create a thin LV that is a snapshot of an existing thin LV (infers --type thin).";
 commands[66].usage = "lvcreate --snapshot LV_thin"
 " [ --type thin, --discards passdown|nopassdown|ignore, --errorwhenfull y|n, --addtag Tag, --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit, --autobackup y|n, --activate y|n|ay, --contiguous y|n, --ignoreactivationskip, --ignoremonitoring, --major Number, --metadataprofile String, --minor Number, --monitor y|n, --name String, --nosync, --permission rw|r, --persistent y|n, --readahead auto|none|NumberSectors, --reportformat String, --setactivationskip y|n, --wipesignatures y|n, --zero y|n ]";
 commands[66].usage_common = 
@@ -4270,7 +4270,7 @@ commands[67].ro_count = 2;
 commands[67].rp_count = 1;
 commands[67].oo_count = 35;
 commands[67].op_count = 0;
-commands[67].desc = "DESC: Create a thin LV that is a snapshot of an external origin LV  DESC: (infers --type thin).";
+commands[67].desc = "Create a thin LV that is a snapshot of an external origin LV (infers --type thin).";
 commands[67].usage = "lvcreate --snapshot --thinpool LV_thinpool LV"
 " [ --type thin, --discards passdown|nopassdown|ignore, --errorwhenfull y|n, --addtag Tag, --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit, --autobackup y|n, --activate y|n|ay, --contiguous y|n, --ignoreactivationskip, --ignoremonitoring, --major Number, --metadataprofile String, --minor Number, --monitor y|n, --name String, --nosync, --permission rw|r, --persistent y|n, --readahead auto|none|NumberSectors, --reportformat String, --setactivationskip y|n, --wipesignatures y|n, --zero y|n ]";
 commands[67].usage_common = 
@@ -4348,7 +4348,7 @@ commands[68].ro_count = 2;
 commands[68].rp_count = 0;
 commands[68].oo_count = 35;
 commands[68].op_count = 0;
-commands[68].desc = "DESC: Create a thin LV in a thin pool (infers --type thin).";
+commands[68].desc = "Create a thin LV in a thin pool (infers --type thin).";
 commands[68].usage = "lvcreate --virtualsize Number[m|unit] --thinpool LV_thinpool"
 " [ --type thin, --discards passdown|nopassdown|ignore, --errorwhenfull y|n, --addtag Tag, --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit, --autobackup y|n, --activate y|n|ay, --contiguous y|n, --ignoreactivationskip, --ignoremonitoring, --major Number, --metadataprofile String, --minor Number, --monitor y|n, --name String, --nosync, --permission rw|r, --persistent y|n, --readahead auto|none|NumberSectors, --reportformat String, --setactivationskip y|n, --wipesignatures y|n, --zero y|n ]";
 commands[68].usage_common = 
@@ -4425,7 +4425,7 @@ commands[69].ro_count = 2;
 commands[69].rp_count = 0;
 commands[69].oo_count = 36;
 commands[69].op_count = 1;
-commands[69].desc = "DESC: Create a new origin LV, combining it with an existing  DESC: cache pool to create a new cache LV (infers --type cache).";
+commands[69].desc = "Create a new origin LV, combining it with an existing cache pool to create a new cache LV (infers --type cache).";
 commands[69].usage = "lvcreate --size Number[m|unit] --cachepool LV_cachepool"
 " [ --type cache, --cachemode writethrough|writeback, --cachepolicy String, --cachesettings String, --addtag Tag, --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit, --autobackup y|n, --activate y|n|ay, --contiguous y|n, --ignoreactivationskip, --ignoremonitoring, --major Number, --metadataprofile String, --minor Number, --monitor y|n, --name String, --nosync, --permission rw|r, --persistent y|n, --readahead auto|none|NumberSectors, --reportformat String, --setactivationskip y|n, --wipesignatures y|n, --zero y|n ]"
 " [ PV ... ]";
@@ -4508,7 +4508,7 @@ commands[70].ro_count = 4;
 commands[70].rp_count = 0;
 commands[70].oo_count = 38;
 commands[70].op_count = 1;
-commands[70].desc = "DESC: Create a thin LV, first creating a thin pool for it, where the new  DESC: thin pool is named by the --thinpool arg (infers --type thin).";
+commands[70].desc = "Create a thin LV, first creating a thin pool for it, where the new thin pool is named by the --thinpool arg (infers --type thin).";
 commands[70].usage = "lvcreate --thin --virtualsize Number[m|unit] --size Number[m|unit] --thinpool LV_new"
 " [ --type thin, --poolmetadatasize Number[m|unit], --poolmetadataspare y|n, --chunksize Number[k|unit], --discards passdown|nopassdown|ignore, --errorwhenfull y|n, --addtag Tag, --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit, --autobackup y|n, --activate y|n|ay, --contiguous y|n, --ignoreactivationskip, --ignoremonitoring, --major Number, --metadataprofile String, --minor Number, --monitor y|n, --name String, --nosync, --permission rw|r, --persistent y|n, --readahead auto|none|NumberSectors, --reportformat String, --setactivationskip y|n, --wipesignatures y|n, --zero y|n ]"
 " [ PV ... ]";
@@ -4598,7 +4598,7 @@ commands[71].ro_count = 3;
 commands[71].rp_count = 1;
 commands[71].oo_count = 38;
 commands[71].op_count = 1;
-commands[71].desc = "DESC: Create a thin LV, first creating a thin pool for it, where the new  DESC: thin pool is named in arg pos 1 (infers --type thin).";
+commands[71].desc = "Create a thin LV, first creating a thin pool for it, where the new thin pool is named in arg pos 1 (infers --type thin).";
 commands[71].usage = "lvcreate --thin --virtualsize Number[m|unit] --size Number[m|unit] LV_new"
 " [ --type thin, --poolmetadatasize Number[m|unit], --poolmetadataspare y|n, --chunksize Number[k|unit], --discards passdown|nopassdown|ignore, --errorwhenfull y|n, --addtag Tag, --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit, --autobackup y|n, --activate y|n|ay, --contiguous y|n, --ignoreactivationskip, --ignoremonitoring, --major Number, --metadataprofile String, --minor Number, --monitor y|n, --name String, --nosync, --permission rw|r, --persistent y|n, --readahead auto|none|NumberSectors, --reportformat String, --setactivationskip y|n, --wipesignatures y|n, --zero y|n ]"
 " [ PV ... ]";
@@ -4688,7 +4688,7 @@ commands[72].ro_count = 2;
 commands[72].rp_count = 1;
 commands[72].oo_count = 42;
 commands[72].op_count = 1;
-commands[72].desc = "DESC: Create a thin LV, first creating a thin pool for it (infers --type thin).  DESC: Create a sparse snapshot of a virtual origin LV (infers --type snapshot).  DESC: Infers --type thin or --type snapshot according to sparse_segtype_default.";
+commands[72].desc = "Create a thin LV, first creating a thin pool for it (infers --type thin).  Create a sparse snapshot of a virtual origin LV (infers --type snapshot).  Infers --type thin or --type snapshot according to sparse_segtype_default.";
 commands[72].usage = "lvcreate --size Number[m|unit] --virtualsize Number[m|unit] VG"
 " [ --type thin, --type snapshot, --thin, --snapshot, --virtualoriginsize Number[m|unit], --poolmetadatasize Number[m|unit], --poolmetadataspare y|n, --chunksize Number[k|unit], --discards passdown|nopassdown|ignore, --errorwhenfull y|n, --addtag Tag, --alloc contiguous|cling|cling_by_tags|normal|anywhere|inherit, --autobackup y|n, --activate y|n|ay, --contiguous y|n, --ignoreactivationskip, --ignoremonitoring, --major Number, --metadataprofile String, --minor Number, --monitor y|n, --name String, --nosync, --permission rw|r, --persistent y|n, --readahead auto|none|NumberSectors, --reportformat String, --setactivationskip y|n, --wipesignatures y|n, --zero y|n ]"
 " [ PV ... ]";
--- a/tools/lvmcmdline.c
+++ b/tools/lvmcmdline.c
@@ -1006,7 +1006,6 @@ static void _print_usage(const char *usage)
 		if (usage[ui] == ',') {
 			buf[bi++] = '\n';
 			buf[bi++] = '\t';
-			buf[bi++] = ' ';
 		}

 		if (bi == (HELP_LINE_SIZE - 1))
@@ -1051,7 +1050,6 @@ static void _print_usage(const char *usage)
 		if (usage[ui] == ',') {
 			buf[bi++] = '\n';
 			buf[bi++] = '\t';
-			buf[bi++] = ' ';
 		}

 		if (bi == (HELP_LINE_SIZE - 1))
@@ -1100,6 +1098,11 @@ static void _print_usage(const char *usage)
 	return;
 }

+/*
+ * A description is a string with multiple sentences each ending in periods.
+ * Print each sentence on a new line.
+ */
+
 static void _print_description(int ci)
 {
 	const char *desc = _cmdline.commands[ci].desc;
@@ -1113,27 +1116,20 @@ static void _print_description(int ci)
 		if (desc[di] == '\n')
 			continue;

-		if (!strncmp(&desc[di], "DESC:", 5)) {
-			if (bi) {
-				log_print("%s", buf);
-				memset(buf, 0, sizeof(buf));
-				bi = 0;
-			}
-			di += 5;
-			continue;
-		}
-
 		if (!bi && desc[di] == ' ')
 			continue;

 		buf[bi++] = desc[di];

+		if (desc[di] == '.') {
+			log_print("%s", buf);
+			memset(buf, 0, sizeof(buf));
+			bi = 0;
+		}
+
 		if (bi == (HELP_LINE_SIZE - 1))
 			break;
 	}
-
-	if (bi)
-		log_print("%s", buf);
 }

 static struct command *_find_command(struct cmd_context *cmd, const char *path, int *argc, char **argv)