From owner-freebsd-current@FreeBSD.ORG Sat May 19 13:41:24 2007 Return-Path: X-Original-To: freebsd-current@freebsd.org Delivered-To: freebsd-current@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52]) by hub.freebsd.org (Postfix) with ESMTP id 236EA16A400; Sat, 19 May 2007 13:41:24 +0000 (UTC) (envelope-from rik@inse.ru) Received: from mail.inse.ru (inse.ru [144.206.128.1]) by mx1.freebsd.org (Postfix) with ESMTP id D52A913C448; Sat, 19 May 2007 13:41:23 +0000 (UTC) (envelope-from rik@inse.ru) Received: from [127.0.0.1] (www.inse.ru [144.206.128.1]) by mail.inse.ru (Postfix) with ESMTP id 1A60B33C4C; Sat, 19 May 2007 17:41:17 +0400 (MSD) Message-ID: <464F0063.8000804@inse.ru> From: Roman Kurakin User-Agent: Thunderbird 1.5.0.10 (X11/20070302) MIME-Version: 1.0 To: Andrew Pantyukhin References: <4649E0AD.4060705@inse.ru> <464A03E3.4040805@freebsd.org> <464A1366.3050809@inse.ru> In-Reply-To: Content-Type: text/plain; charset=UTF-8; format=flowed Content-Transfer-Encoding: 7bit Cc: freebsd-current@freebsd.org Subject: Re: HEDSUP: man -k cleanup (man -k RAID, some bits are missing) X-BeenThere: freebsd-current@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Discussions about the use of FreeBSD-current List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Date: Sat, 19 May 2007 13:41:24 -0000 X-Original-Date: Sat, 19 May 2007 17:49:23 +0400 X-List-Received-Date: Sat, 19 May 2007 13:41:24 -0000 Andrew Pantyukhin wrote: > On 5/16/07, Roman Kurakin 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