Skip site navigation (1)Skip section navigation (2)
Date:      Wed, 18 Apr 2001 21:39:05 -0400 (EDT)
From:      petef@databits.net
To:        FreeBSD-gnats-submit@freebsd.org
Subject:   docs/26690: Update to ports(7)
Message-ID:  <200104190139.f3J1d5O47518@electron.databits.net>

next in thread | raw e-mail | index | archive | help

>Number:         26690
>Category:       docs
>Synopsis:       Update to ports(7)
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Wed Apr 18 18:50:01 PDT 2001
>Closed-Date:
>Last-Modified:
>Originator:     Pete Fritchman
>Release:        FreeBSD 4.3-RC i386
>Organization:

  Databits Network Services, Inc.

>Environment:
System: FreeBSD electron.databits.net 4.3-RC FreeBSD 4.3-RC #0: Thu Apr 12 17:02:53 EDT 2001 root@electron.databits.net:/usr/obj/usr/src/sys/ELECTRON i386


>Description:

- update a few miswordings
- add descriptions for the 'search' and 'index' bsd.port.mk targets

>How-To-Repeat:

  N/A

>Fix:

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/19 01:34:28
@@ -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,7 @@
 .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 +188,20 @@
 This can be used from
 .Pa /usr/ports
 to create a browsable web of all ports on your system!
+.It Ar search
+Search the INDEX file for the keyword specified by the 
+.Ev KEY
+value.  Results include the path to the port, a short comment, and the
+build and run depends required.
+.It Ar index
+Create /usr/ports/INDEX, used by the
+.Pa pretty-print-*
+and
+.Pa 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.
>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?200104190139.f3J1d5O47518>