From owner-freebsd-bugs  Thu Nov  1  0: 0:13 2001
Delivered-To: freebsd-bugs@hub.freebsd.org
Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21])
	by hub.freebsd.org (Postfix) with ESMTP id 2030637B403
	for <freebsd-bugs@hub.freebsd.org>; Thu,  1 Nov 2001 00:00:02 -0800 (PST)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.11.4/8.11.4) id fA1802P98396;
	Thu, 1 Nov 2001 00:00:02 -0800 (PST)
	(envelope-from gnats)
Received: from lion.com.ua (lion.com.ua [213.133.161.130])
	by hub.freebsd.org (Postfix) with ESMTP id 01B3D37B405
	for <FreeBSD-gnats-submit@freebsd.org>; Wed, 31 Oct 2001 23:55:11 -0800 (PST)
Received: from localhost (localhost [127.0.0.1])
	by lion.com.ua (8.11.6/8.11.6) with ESMTP id fA17t7u27457
	for <FreeBSD-gnats-submit@freebsd.org>; Thu, 1 Nov 2001 09:55:08 +0200 (EET)
	(envelope-from sa@simon.org.ua)
Message-Id: <20011101095226.L27435-100000@lion.com.ua>
Date: Thu, 1 Nov 2001 09:55:07 +0200 (EET)
From: Andrey Simonenko <simon@simon.org.ua>
To: FreeBSD-gnats-submit@freebsd.org
Subject: gnu/31685: apropos(1) manual page doesn't tell that keyword can be regular
 expression
Sender: owner-freebsd-bugs@FreeBSD.ORG
Precedence: bulk
List-ID: <freebsd-bugs.FreeBSD.ORG>
List-Archive: <http://docs.freebsd.org/mail/> (Web Archive)
List-Help: <mailto:majordomo@FreeBSD.ORG?subject=help> (List Instructions)
List-Subscribe: <mailto:majordomo@FreeBSD.ORG?subject=subscribe%20freebsd-bugs>
List-Unsubscribe: <mailto:majordomo@FreeBSD.ORG?subject=unsubscribe%20freebsd-bugs>
X-Loop: FreeBSD.org


>Number:         31685
>Category:       gnu
>Synopsis:       apropos(1) manual page doesn't tell that keyword can be regular expression
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-bugs
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Thu Nov 01 00:00:01 PST 2001
>Closed-Date:
>Last-Modified:
>Originator:     Andrey Simonenko
>Release:        FreeBSD 4.4-STABLE i386
>Organization:
>Environment:
	FreeBSD 4.4-STABLE i386

>Description:
	apropos(1) (and whatis(1)) manual page doesn't tell that a keyword can
	be a regular expression.

	apropos(1) uses grep(1), that's why it is possible to run something
	like this:

	$ apropos .			/* list of all manual pages */
	$ apropos '^[^(]*([18])'	/* list of available commands */

	However this is not docummented.

>How-To-Repeat:
>Fix:

--- /usr/src/gnu/usr.bin/man/apropos/apropos.man	Mon Jan 22 13:03:29 2001
+++ apropos.man	Wed Oct 31 02:32:02 2001
@@ -32,6 +32,10 @@
 standard output.
 .Nm whatis
 displays only complete word matches.
+.Pp
+.Ar keyword
+really is a regular expression, read grep(1) manual page for more information
+about its format.
 .Sh RETURN VALUES
 The
 .Nm

>Release-Note:
>Audit-Trail:
>Unformatted:

To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-bugs" in the body of the message