On Sat, 12 Apr 2014 19:17:00 +0200 (CEST) Istvan Gabor wrote:

This is not an openSUSE issue I guess. Not only the manual but the mdadm/mdraid wiki site (https://raid.wiki.kernel.org/index.php/RAID_setup) is puzzling too. They say there is a raid-howto but it is obsolete and the wiki pages are cecommended. The wiki site is very badly organized, definitely hard to use for a begginer to raid configuration and setup.

(rant redacted) Unfortunately, this is the universal status quo and is apparently perfectly acceptable. Else people be lighting fires under code authors to get the documentation done and done right. jd -- To unsubscribe, e-mail: opensuse+unsubscribe@opensuse.org To contact the owner, e-mail: opensuse+owner@opensuse.org

On Tue, 15 Apr 2014 08:28:32 +0930 Rodney Baker wrote:

On Sat, 12 Apr 2014 12:21:16 jdebert wrote:

...

Unfortunately, this is the universal status quo and is apparently perfectly acceptable. Else people be lighting fires under code authors to get the documentation done and done right.

People who write the code don't need the documentation, and some seem to expect everyone else to be able to figure it out by reading the source code...

People who write the code also need the documentation. People tend to forget. I can't count all the times I've heard someone, including gurus, complain about neglecting to document their own code when they've forgotten what it does. The standards of documentation are well-known and have existed for well over 30 years. Unfortunately the standards are being ignored. To paraphrase one of those gurus: "Without proper docs, the code is just a hack." jd -- To unsubscribe, e-mail: opensuse+unsubscribe@opensuse.org To contact the owner, e-mail: opensuse+owner@opensuse.org

On 2014-04-12 21:57 (GMT+0400) Andrey Borzenkov composed:

÷ Sat, 12 Apr 2014 02:19:21 -0400 Felix Miata composed:

...

Like most man pages, examples that would clarify meanings are absent. What does that last parameter mean exactly in the following example I found Googling?

...

mdadm --assemble /dev/md/alpha --name=alpha --update=name /dev/sd[fg]

If under "last parameter" you mean /dev/sd[fg], it means names of devices from which array is being assembled. It is simply shell glob syntax.

You are right. That's what I don't understand, and the precise reason why I posted. As I understand it, the example means /dev/sdf and /dev/sdg. That doesn't help me, because I need it to be /dev/sda9 and /dev/sdb9 and have found nothing that explains how that would be done. -- "The wise are known for their understanding, and pleasant words are persuasive." Proverbs 16:21 (New Living Translation) Team OS/2 ** Reg. Linux User #211409 ** a11y rocks! Felix Miata *** http://fm.no-ip.com/ -- To unsubscribe, e-mail: opensuse+unsubscribe@opensuse.org To contact the owner, e-mail: opensuse+owner@opensuse.org