[49752] trunk/base/src/port/port-help.tcl

[jmr at macports.org]

Revision: 49752
          http://trac.macports.org/changeset/49752
Author:   jmr at macports.org
Date:     2009-04-17 03:10:58 -0700 (Fri, 17 Apr 2009)
Log Message:
-----------
various improvements to port help

Modified Paths:
--------------
    trunk/base/src/port/port-help.tcl

Modified: trunk/base/src/port/port-help.tcl
===================================================================
--- trunk/base/src/port/port-help.tcl	2009-04-17 07:53:14 UTC (rev 49751)
+++ trunk/base/src/port/port-help.tcl	2009-04-17 10:10:58 UTC (rev 49752)
@@ -43,7 +43,7 @@
 }
 
 set porthelp(compact) {
-Compact the given ports
+Compact the given ports (unimplemented)
 }
 
 set porthelp(configure) {
@@ -99,7 +99,7 @@
 set porthelp(echo) {
 Returns the list of ports the argument expands to
 
-This can be useful to what a pseudo-port expands.
+This can be useful to see what a pseudo-port expression expands to.
 }
 
 set porthelp(edit) {
@@ -131,7 +131,7 @@
 }
 
 set porthelp(help) {
-Displays short help texts for the given ports
+Displays short help texts for the given commands
 }
 
 set porthelp(info) {
@@ -156,7 +156,7 @@
 }
 
 set porthelp(installed) {
-List installed versions of the given port
+List installed versions of the given port, or all installed ports if no port is given
 }
 
 set porthelp(lint) {
@@ -180,7 +180,7 @@
 }
 
 set porthelp(mdmg) {
-Creates a dmg for each of the given ports
+Creates a dmg containing an mpkg for each of the given ports and their dependencies
 }
 
 set porthelp(mirror) {
@@ -188,7 +188,7 @@
 }
 
 set porthelp(mpkg) {
-Creates a mpkg for each of the given ports
+Creates an mpkg for each of the given ports and their dependencies
 }
 
 set porthelp(outdated) {
@@ -196,7 +196,7 @@
 }
 
 set porthelp(patch) {
-Applies patches on each of the given port
+Applies patches to each of the given ports
 }
 
 set porthelp(pkg) {
@@ -204,11 +204,11 @@
 }
 
 set porthelp(platform) {
-Returns the current platform you are on
+Returns the current platform that port is running on
 }
 
 set porthelp(provides) {
-Return which port (or ports) provide the file (or files) given
+Return which port provides each of the files given
 }
 
 set porthelp(quit) $porthelp(exit)
@@ -220,11 +220,16 @@
 set porthelp(search) {
 Search for a port
 
-This looks in name, desription and long_description of each port for the given search string.
+--case-sensitive   match the search string in a case-sensitive manner
+--exact   match the literal search string exactly
+--glob    treat the given search string as a glob (default)
+--line    print each result on a single line
+--regex   treat the given search string as a regular expression
+--<field> match against <field>, default is '--name --description'
 }
 
 set porthelp(select) {
-Select between mulitple versions of a versioned port
+Select between multiple versions of a versioned port
 
 This allows you to choose which version, among several installed versions
 of a port, is to be considered primary.  What this means is which version
@@ -245,7 +250,7 @@
 }
 
 set porthelp(selfupdate) {
-Upgrade MacPorts itself
+Upgrade MacPorts itself and run the sync target
 }
 
 set porthelp(srpm) {
@@ -253,7 +258,7 @@
 }
 
 set porthelp(submit) {
-Submit a port to the MacPorts Web Application
+Submit a port to the MacPorts Web Application (unimplemented)
 }
 
 set porthelp(sync) {
@@ -264,16 +269,12 @@
 Run tests on each of the given ports
 }
 
-set porthelp(trace) {
-Trace a port
-}
-
 set porthelp(unarchive) {
-Unarchive a port
+Unarchive the given ports
 }
 
 set porthelp(uncompact) {
-Uncompact a port
+Uncompact a port (unimplemented)
 }
 
 set porthelp(uninstall) {
@@ -299,7 +300,7 @@
 }
 
 set porthelp(variants) {
-Returns a list of variants with descriptions available for the given ports
+Returns a list of variants provided by the given ports, with descriptions if present
 }
 
 set porthelp(version) {
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.macosforge.org/pipermail/macports-changes/attachments/20090417/fb9563cb/attachment.html>