From owner-freebsd-doc  Fri Apr 20 17:20: 9 2001
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 5EE3537B423
	for <freebsd-doc@freebsd.org>; Fri, 20 Apr 2001 17:20:02 -0700 (PDT)
	(envelope-from gnats@FreeBSD.org)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.11.1/8.11.1) id f3L0K2L12684;
	Fri, 20 Apr 2001 17:20:02 -0700 (PDT)
	(envelope-from gnats)
Date: Fri, 20 Apr 2001 17:20:02 -0700 (PDT)
Message-Id: <200104210020.f3L0K2L12684@freefall.freebsd.org>
To: freebsd-doc@freebsd.org
Cc: 
From: Pete Fritchman <petef@databits.net>
Subject: Re:  docs/26690: Update to ports(7)
Reply-To: Pete Fritchman <petef@databits.net>
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
X-Loop: FreeBSD.org

The following reply was made to PR docs/26690; it has been noted by GNATS.

From: Pete Fritchman <petef@databits.net>
To: Dima Dorfman <dima@unixfreak.org>
Cc: FreeBSD-gnats-submit@FreeBSD.org
Subject: Re:  docs/26690: Update to ports(7)
Date: Fri, 20 Apr 2001 20:12:38 -0400

 ++ 18/04/01 19:20 -0700 - Dima Dorfman:
 | The following reply was made to PR docs/26690; it has been noted by GNATS.
 | 
 
 Thanks for your constructive comments, here's another go at it.  The one
 thing I was unsure of is when I was giving an example of make search, I
 used:
 
 +.Bd -literal -offset indent
 +cd /usr/ports && make search name=query
 +.Ed
 +.Pp
 
 Is that the best way to give an example command?  
 
 Thanks!
 
 --
 Pete Fritchman <petef@databits.net>
 Databits Network Services, Inc. <http://databits.net>
 finger petef@databits.net for PGP key
 
 
 [ also available http://hex.databits.net/~petef/freebsd/ports.7.diff ]
 
 Index: ports.7
 ===================================================================
 RCS file: /home/ncvs/src/share/man/man7/ports.7,v
 retrieving revision 1.21
 diff -u -r1.21 ports.7
 --- ports.7	2000/12/29 09:18:42	1.21
 +++ ports.7	2001/04/21 00:00:46
 @@ -92,8 +92,9 @@
  .Ar install ,
  and so on all the way to
  .Ar fetch .
 -You will usually only target
 -.Ar install .
 +Usually, you will only use the
 +.Ar install
 +target.
  .Bl -tag -width configure
  .It Ar fetch
  Fetch all of the files needed to build this port from the site(s)
 @@ -102,7 +103,8 @@
  and
  .Ev MASTER_SITE_OVERRIDE .
  .It Ar checksum
 -Verify that the fetched distfile matches the one the port was tested against.
 +Verify that the fetched distfile's checksum matches the one the port was
 +tested against.
  Defining
  .Ev NO_CHECKSUM
  will skip this step.
 @@ -152,7 +154,8 @@
  .It Ar distclean
  Remove the port's distfile(s) and perform the
  .Ar clean
 -operation.  The
 +target.
 +The
  .Sq clean
  portion recurses to dependencies unless
  .Ev NOCLEANDEPENDS
 @@ -186,6 +189,36 @@
  This can be used from
  .Pa /usr/ports
  to create a browsable web of all ports on your system!
 +.It Ar search
 +Search the
 +.Pa INDEX
 +file for the pattern specified by either the
 +.Pa key
 +(searches the port name, comment, and depends) or
 +.Pa name
 +(just searches the port name) make argument.
 +For example, one would type 
 +.Bd -literal -offset indent
 +cd /usr/ports && make search name=query
 +.Ed
 +.Pp
 +to find all ports whose
 +name matches
 +.Pa query .
 +Results include the matching ports' path, comment, maintainer, build depends,
 +and run depends.
 +.It Ar index
 +Create
 +.Pa /usr/ports/INDEX ,
 +which is used by the
 +.Ar pretty-print-*
 +and
 +.Ar search
 +targets.
 +While the master INDEX file in the CVS repository is periodically
 +updated, running the
 +.Pa index
 +target will ensure your INDEX file is up to date with your ports tree.
  .El
  .Sh ENVIRONMENT
  You can change all of these.
 

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