Date: Fri, 20 Apr 2001 17:20:02 -0700 (PDT) From: Pete Fritchman <petef@databits.net> To: freebsd-doc@freebsd.org Subject: Re: docs/26690: Update to ports(7) Message-ID: <200104210020.f3L0K2L12684@freefall.freebsd.org>
next in thread | raw e-mail | index | archive | help
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
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?200104210020.f3L0K2L12684>