From e5a5d81e4a2d65a56e1371d6ad0abb882ec66347 Mon Sep 17 00:00:00 2001
From: Neil Brown <neilb@suse.de>
Date: Mon, 17 Apr 2006 13:12:41 +0000
Subject: [PATCH] Further improvements to online help

diff .//ReadMe.c~current~ .//ReadMe.c
---
 ReadMe.c | 17 +++++++++++------
 1 file changed, 11 insertions(+), 6 deletions(-)

diff --git a/ReadMe.c b/ReadMe.c
index da1a2e8..18c263d 100644
--- 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"