HEDSUP: man -k cleanup (man -k RAID, some bits are missing)

Andrew Pantyukhin infofarmer at FreeBSD.org
Sat May 19 06:56:20 UTC 2007

On 5/16/07, Roman Kurakin <rik at 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.

More information about the freebsd-current mailing list