From owner-freebsd-doc Wed Jan 23 7:30:11 2002 Delivered-To: freebsd-doc@freebsd.org Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21]) by hub.freebsd.org (Postfix) with ESMTP id 1A85937B41B for ; Wed, 23 Jan 2002 07:30:01 -0800 (PST) Received: (from gnats@localhost) by freefall.freebsd.org (8.11.6/8.11.6) id g0NFU1E49290; Wed, 23 Jan 2002 07:30:01 -0800 (PST) (envelope-from gnats) Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21]) by hub.freebsd.org (Postfix) with ESMTP id 7ABD737B448 for ; Wed, 23 Jan 2002 07:29:17 -0800 (PST) Received: (from nobody@localhost) by freefall.freebsd.org (8.11.6/8.11.6) id g0NFTHn48988; Wed, 23 Jan 2002 07:29:17 -0800 (PST) (envelope-from nobody) Message-Id: <200201231529.g0NFTHn48988@freefall.freebsd.org> Date: Wed, 23 Jan 2002 07:29:17 -0800 (PST) From: Marian Cerny To: freebsd-gnats-submit@freebsd.org X-Send-Pr-Version: www-1.0 Subject: docs/34209: more difficult way of searching for a port's path in handbook section 4.5.2 Sender: owner-freebsd-doc@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org >Number: 34209 >Category: docs >Synopsis: more difficult way of searching for a port's path in handbook section 4.5.2 >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Wed Jan 23 07:30:00 PST 2002 >Closed-Date: >Last-Modified: >Originator: Marian Cerny >Release: FreeBSD 4.4-RELEASE >Organization: private >Environment: FreeBSD ivetka 4.4-RELEASE FreeBSD 4.4-RELEASE #0: Tue Sep 18 11:57:08 PDT 2001 murray@builder.FreeBSD.org:/usr/src/sys/compile/GENERIC i386 >Description: In handbook, section 4.5.2 - 4.5.2 Installing Ports: > Yet another way of finding a particular port is by using the ports > collection's built-in search mechanism. To use the search feature, you > will need to be in the /usr/ports directory. Once in that directory, > run make search key=program-name where ``program-name'' is the name of ^^^ > the program you want to find. For example, if you were looking for > lsof: > # cd /usr/ports > # make search key=lsof ^^^ > Port: lsof-4.56.4 > Path: /usr/ports/sysutils/lsof > Info: Lists information about open files (similar to fstat(1)) > Maint: obrien@FreeBSD.org > Index: sysutils > B-deps: > R-deps: > The part of the output you want to pay particular attention to is the > ``Path:'' line, since that tells you where to find it. The other > information provided is not needed in order to install the port > directly, so it will not be covered here. This works fine, but "make search key=lsof" finds 7 matching ports on my machine and some of them do not even include the string "lsof" in the information shown (because it also looks into port description, etc.). For example "Port: xwpe-1.5.22a" is listed, because of the line "WWW: http://www.identicalsoftware.com/xwpe/" in pkg-descr. ^^^^ Better way (IMHO) is to do "make search name=lsof". This gives ^^^^ only one match. >How-To-Repeat: Have a look at the handbook, section 4.5.2. >Fix: I know "search key=" is important as well, so I think both should have been noticed in the text explaining the difference between "search name=" and "search key=". >Release-Note: >Audit-Trail: >Unformatted: To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message