Comment 2 for bug 567928

Yes, it does show under --misc --help (which I overlooked), but my thought was that the most commonly used options should show up under --help. Here's what I was thinking - please feel free to close if you disagree ;o)

For someone who doesn't set up a lot of machines, the mdadm help and man page would be reviewed more thoroughly when creating a RAID array. Once created, however, they might not have occasion to run mdadm other than to check the status, and that might occur infrequently enough that they need to look it up. From that point of view, it might be nice to have --detail a bit more accessible, i.e. on the initial --help page.

Looking at it again, I have an alternate suggestion. It might be better to show the output from "mdadm --help-options" as the default output of "mdadm --help", and move the default output to "mdadm --help-modes" or similar. I think that would better serve folks who are looking for "quick" help via --help, and still provide what's needed to those who are doing something more involved.

Or not - just a thought ;o)