Date: Sat, 19 May 2007 13:41:24 -0000 From: Roman Kurakin <rik@inse.ru> To: Andrew Pantyukhin <infofarmer@FreeBSD.org> Cc: freebsd-current@freebsd.org Subject: Re: HEDSUP: man -k cleanup (man -k RAID, some bits are missing) Message-ID: <464F0063.8000804@inse.ru> In-Reply-To: <cb5206420705182331l547a425dy4ddea24f54f232cc@mail.gmail.com> References: <4649E0AD.4060705@inse.ru> <464A03E3.4040805@freebsd.org> <464A1366.3050809@inse.ru> <cb5206420705182331l547a425dy4ddea24f54f232cc@mail.gmail.com>
next in thread | previous in thread | raw e-mail | index | archive | help
Andrew Pantyukhin wrote: > On 5/16/07, Roman Kurakin <rik@inse.ru> wrote: >> Eric Anderson wrote: >> > On 05/15/07 11:32, Roman Kurakin wrote: >> >> Hi all, >> >> >> >> Trying to obtain information about supported RAID devices in >> >> the system via `man -k RAID` I've found that not all known >> >> by me devices are there. So a grep-ed a bit and going to commit >> >> the following patchset. I think that keyword RAID should present >> >> in description of all these man pages. But may be I am wrong? >> >> >> >> There is also some bits I was not able to fix. >> >> 1) Is it safe to s/Array/RAID/ in ida(4)? >> > >> > I don't think that's good - an array isn't necessarily a RAID, and a >> > s/r of that name yields bad results. >> I am about brief description (.Nd) only. If driver supports some RAID >> arrays it >> should be marked as such. So may be "Array" => "Array (including RAID)" >> in .Nd? > We usually keep .Nd as short as possible. It's a pity > apropos(1) uses it exclusively for its lookups, but I > don't believe that's a good excuse for stuffing keywords, > tags and comments into the field. Probably, but there is almost nothing except man -K to find appropriate man page. rik
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?464F0063.8000804>