From owner-freebsd-doc@FreeBSD.ORG  Mon Sep 12 08:44:35 2005
Return-Path: <owner-freebsd-doc@FreeBSD.ORG>
X-Original-To: freebsd-doc@FreeBSD.org
Delivered-To: freebsd-doc@FreeBSD.org
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 95D5C16A41F;
	Mon, 12 Sep 2005 08:44:35 +0000 (GMT)
	(envelope-from keramida@ceid.upatras.gr)
Received: from aiolos.otenet.gr (aiolos.otenet.gr [195.170.0.93])
	by mx1.FreeBSD.org (Postfix) with ESMTP id D7D1E43D45;
	Mon, 12 Sep 2005 08:44:34 +0000 (GMT)
	(envelope-from keramida@ceid.upatras.gr)
Received: from orion.daedalusnetworks.priv (aris.bedc.ondsl.gr [62.103.39.226])
	by aiolos.otenet.gr (8.13.4/8.13.4/Debian-1) with SMTP id
	j8C8iVXu008154; Mon, 12 Sep 2005 11:44:32 +0300
Received: from orion.daedalusnetworks.priv (orion [127.0.0.1])
	by orion.daedalusnetworks.priv (8.13.4/8.13.4) with ESMTP id
	j8C8iVoX016188; Mon, 12 Sep 2005 11:44:31 +0300 (EEST)
	(envelope-from keramida@ceid.upatras.gr)
Received: (from keramida@localhost)
	by orion.daedalusnetworks.priv (8.13.4/8.13.4/Submit) id j8C8iUdI016187;
	Mon, 12 Sep 2005 11:44:30 +0300 (EEST)
	(envelope-from keramida@ceid.upatras.gr)
X-Authentication-Warning: orion.daedalusnetworks.priv: keramida set sender to
	keramida@ceid.upatras.gr using -f
Date: Mon, 12 Sep 2005 11:44:30 +0300
From: Giorgos Keramidas <keramida@ceid.upatras.gr>
To: Leonidas Tsampros <ltsampros@upnet.gr>
Message-ID: <20050912084430.GD16029@orion.daedalusnetworks.priv>
References: <200509112100.j8BL0asq017028@freefall.freebsd.org>
	<20050912104621.GA12835@bifteki.lan>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <20050912104621.GA12835@bifteki.lan>
Cc: freebsd-doc@FreeBSD.org, "Simon L. Nielsen" <simon@FreeBSD.org>
Subject: Re: docs/85986: FreeBSD keyword missing if you display security(7)
	with apropos
X-BeenThere: freebsd-doc@freebsd.org
X-Mailman-Version: 2.1.5
Precedence: list
List-Id: Documentation project <freebsd-doc.freebsd.org>
List-Unsubscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=unsubscribe>
List-Archive: <http://lists.freebsd.org/pipermail/freebsd-doc>
List-Post: <mailto:freebsd-doc@freebsd.org>
List-Help: <mailto:freebsd-doc-request@freebsd.org?subject=help>
List-Subscribe: <http://lists.freebsd.org/mailman/listinfo/freebsd-doc>,
	<mailto:freebsd-doc-request@freebsd.org?subject=subscribe>
X-List-Received-Date: Mon, 12 Sep 2005 08:44:35 -0000

On 2005-09-12 10:46, Leonidas Tsampros <ltsampros@upnet.gr> wrote:
>On Sun, Sep 11, 2005 at 09:00:36PM +0000, Simon L. Nielsen wrote:
>>On 2005.09.11 20:12:46 +0000, Matthias Schmidt wrote:
>>
>>> If you type apropos security to get the security(7) man page the
>>> word "FreeBSD" is missing,
>>>
>>> matthias@c0re:/ % apropos security
>>> security(7)              - introduction to security under
>>>                                                          ^^^^
>>
>> I would say this should be fixed in apropos rather than adding a
>> workaround to a specific manual page, especially since I would
>> suspect that other manual pages are also affected.
>>
>> That said, I have no idea how complicated it would be to fix it in
>> apropos.
>
> I took a look to src/gnu/usr.bin/man/apropos/apropos.sh , and really
> apropos is nothing more than a grep -Ehi. The problem is that grep is
> just working right. It doesn't find the word 'FreeBSD' in the
> description line (where it got the 'security' match) so grep cannot
> display that word.

True.

This would still work fine, though, if catman(1) was smart enough to
extract the full text of the NAME line, even if the NAME line contains
groff macro calls.