Date: Wed, 23 Jan 2002 07:29:17 -0800 (PST) From: Marian Cerny <cerny@spnv.sk> To: freebsd-gnats-submit@freebsd.org Subject: docs/34209: more difficult way of searching for a port's path in handbook section 4.5.2 Message-ID: <200201231529.g0NFTHn48988@freefall.freebsd.org>
next in thread | raw e-mail | index | archive | help
>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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200201231529.g0NFTHn48988>