Browse files

- Refresh README a little

Submitted by:	Tim Welch
  • Loading branch information...
pav pav
pav authored and pav committed May 22, 2006
1 parent 6b28ed6 commit cc2e78b475ef2938b59b924fe584b9a05f5d3890
Showing with 21 additions and 20 deletions.
  1. +21 −20 README
@@ -1,39 +1,40 @@
This is the FreeBSD Ports Collection. For an easy to use
WEB-based interface to it, please see:
-For general information on the ports collection, please see the
-FreeBSD Handbook which is available from:
+For general information on the Ports Collection, please see the
+FreeBSD Handbook ports section which is available from:
- file://localhost/usr/share/doc/handbook/handbook.html
+ for the latest official version
+ or:
+ The ports(7) manual page (man ports).
-(if you installed the doc distribution on your machine)
+These will explain how to use ports and packages.
+If you would like to search for a port, you can do so easily by
+saying (in /usr/ports):
-for the latest official version from FreeBSD-current.
+ make search name="<name>"
+ or:
+ make search key="<keyword>"
-The section "The Ports Collection" will tell you how to use the
-ports and packages and the "Porting Applications" section
-describes how one can contribute to the ports collection.
+which will generate a list of all ports matching <name> or <keyword>.
+make search also supports wildcards, such as:
-If you would like to search for a given port, you can do so easily
-by saying:
+ make search name="gtk*"
- make search key="<keyword>"
+For information about contributing to FreeBSD ports, please see the Porter's
+Handbook, available at:
-Which will generate a list of all ports matching <keyword>.
-NOTE: This tree can GROW significantly in size during normal usage!
+NOTE: This tree will GROW significantly in size during normal usage!
The distribution tar files can and do accumulate in /usr/ports/distfiles,
and the individual ports will also use up lots of space in their work
subdirectories unless you remember to "make clean" after you're done
building a given port. /usr/ports/distfiles can also be periodically
-cleaned without ill-effect, though if you don't have the original
-distribution tarball(s) for something on CDROM then you will need to pull
-it all over your network connection again if you ever try to build the
-associated port.
+cleaned without ill-effect.

0 comments on commit cc2e78b

Please sign in to comment.