From 65d476e0e04ee66c54e56d371bdb046b5e309126 Mon Sep 17 00:00:00 2001
From: Kirill Ponomarev <krion@FreeBSD.org>
Date: Wed, 16 Jun 2004 07:29:21 +0000
Subject: [PATCH] Add descriptions for new path, info, maint, cat, bdeps, and
 rdeps variables and some new examples for "make search".

Approved by:	josef (mentor)
MFC after:	2 days
---
 share/man/man7/ports.7 | 53 ++++++++++++++++++++++++++++++++++++++----
 1 file changed, 48 insertions(+), 5 deletions(-)

diff --git a/share/man/man7/ports.7 b/share/man/man7/ports.7
index 2b6967d212f6..0aa5404740be 100644
--- a/share/man/man7/ports.7
+++ b/share/man/man7/ports.7
@@ -25,7 +25,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd June 2, 2004
+.Dd June 16, 2004
 .Dt PORTS 7
 .Os
 .Sh NAME
@@ -239,13 +239,27 @@ to create a browsable web of all ports on your system!
 .It Cm search
 Search the
 .Pa INDEX
-file for the pattern specified by either the
+file for the pattern specified by the
 .Va key
-(searches the port name, comment, and dependencies) or
+(searches the port name, comment, and dependencies),
 .Va name
-(searches the port name only)
+(searches the port name only),
+.Va path
+(searches the port path),
+.Va info
+(searches the port info),
+.Va maint
+(searches the port maintainer),
+.Va cat
+(searches the port category),
+.Va bdeps
+(searches the port build-time dependency),
+.Va rdeps
+(searches the port run-time dependency)
 .Xr make 1
-variable.
+variables, and their exclusion counterparts:
+.Va xname , xkey
+etc.
 For example, one would type:
 .Pp
 .Dl "cd /usr/ports && make search name=query"
@@ -255,6 +269,35 @@ name matches
 .Dq Li query .
 Results include the matching ports' path, comment, maintainer,
 build dependencies, and run dependencies.
+.Bd -literal -offset indent
+cd /usr/ports && make search name=pear- \e
+    xbdeps=apache
+.Ed
+.Pp
+To find all ports whose
+names contain
+.Dq Li pear-
+and which do not have apache
+listed in build-time dependencies.
+.Bd -literal -offset indent
+cd /usr/ports && make search name=pear- \e
+    xname='ht(tp|ml)'
+.Ed
+.Pp
+To find all ports whose names contain
+.Dq Li pear- ,
+but not
+.Dq Li html
+or
+.Dq Li http .
+.Bd -literal -offset indent
+make search key=apache display=name,path,info keylim=1
+.Ed
+.Pp
+To find ports that contain
+.Dq Li apache
+in either of the name, path, info
+fields, ignore the rest of the record.
 .It Cm describe
 Generate a one-line description of each port for use in the
 .Pa INDEX