[66670] trunk/base/doc/port.1

[jmr at macports.org]

Revision: 66670
          http://trac.macports.org/changeset/66670
Author:   jmr at macports.org
Date:     2010-04-19 09:13:56 -0700 (Mon, 19 Apr 2010)
Log Message:
-----------
port.1: update description of search action

Modified Paths:
--------------
    trunk/base/doc/port.1

Modified: trunk/base/doc/port.1
===================================================================
--- trunk/base/doc/port.1	2010-04-19 15:57:33 UTC (rev 66669)
+++ trunk/base/doc/port.1	2010-04-19 16:13:56 UTC (rev 66670)
@@ -273,9 +273,21 @@
 .Sh USER TARGETS
 Targets most commonly used by regular MacPorts users are:
 .Ss search
-Search for an available port whose name matches a regular expression. For example:
+Search for an available port. By default, the search string is treated as a case-insensitive glob,
+and is matched against the name and description fields. To have the search string treated as
+a regular expression, as a literal, or in a case-sensitive manner, use
+.Fl -regex,
+.Fl -exact,
+or
+.Fl -case-sensitive,
+respectively. To match against a different set of fields, use one or more
+.Fl -<field-name>
+options. To display each result on a single line, use
+.Fl -line.
+For example:
 .Pp
 .Dl "port search vim"
+.Dl "port search --regex --depends_build 'docbook.*[0-9]+'"
 .Pp
 .Ss info
 Displays meta-information available for
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.macosforge.org/pipermail/macports-changes/attachments/20100419/99c96134/attachment.html>