Further improvements to online help

diff .//ReadMe.c~current~ .//ReadMe.c

diff --git a/ReadMe.c b/ReadMe.c
index da1a2e878ac9947e5de87f1565bd336c6d50c723..18c263d9cfb47da000ad8e9e305c740132d4318a 100644 (file)
--- a/ReadMe.c
+++ b/ReadMe.c
@@ -182,12 +182,14 @@ char Usage[] =
 ;
 
 char Help[] =
+"mdadm is used for building, managing, and monitoring\n"
+"Linux md devices (aka RAID arrays)\n"
 "Usage: mdadm --create device options...\n"
-"            Create a new array.\n"
+"            Create a new array from unused devices.\n"
 "       mdadm --assemble device options...\n"
 "            Assemble a previously created array.\n"
 "       mdadm --build device options...\n"
-"            Make an array without metadata.\n"
+"            Create or assemble an array without metadata.\n"
 "       mdadm --manage device options...\n"
 "            make changes to an existing array.\n"
 "       mdadm --misc options... devices\n"
@@ -196,8 +198,11 @@ char Help[] =
 "            Monitor one or more array for significant changes.\n"
 "       mdadm device options...\n"
 "            Shorthand for --manage.\n"
-" mdadm is used for building, managing, and monitoring\n"
-" Linux md devices (aka RAID arrays)\n"
+"Any parameter that does not start with '-' is treated as a device name\n"
+"or, for --examine-bitmap, a file name.\n"
+"The first such name is often the name of an md device.  Subsequent\n"
+"names are often names of component devices.\n"
+"\n"
 " For detailed help on the above major modes use --help after the mode\n"
 " e.g.\n"
 "         mdadm --assemble --help\n"
@@ -209,7 +214,7 @@ char OptionHelp[] =
 "Any parameter that does not start with '-' is treated as a device name\n"
 "or, for --examine-bitmap, a file name.\n"
 "The first such name is often the name of an md device.  Subsequent\n"
-"names are often names of component devices."
+"names are often names of component devices.\n"
 "\n"
 "Some common options are:\n"
 "  --help        -h   : General help message or, after above option,\n"
@@ -222,7 +227,7 @@ char OptionHelp[] =
 "  --force       -f   : Override normal checks and be more forceful\n"
 "\n"
 "  --assemble    -A   : Assemble an array\n"
-"  --build       -B   : Build a legacy array\n"
+"  --build       -B   : Build an array without metadata\n"
 "  --create      -C   : Create a new array\n"
 "  --detail      -D   : Display details of an array\n"
 "  --examine     -E   : Examine superblock on an array component\n"