Add description to each port target

Also, remove targets used only in interactive mode, like 'exit' or 'cd'

src/_port

@@ -25,15 +25,74 @@ _port() {
 
   port_prefix=$(which port | sed 's|/bin/port||')
 
-  actions=( activate archive archivefetch build cat cd
+  actions=(
-  checksum clean configure contents deactivate dependents deps
+    'activate\:Activate\ the\ given\ ports'
-  destroot dir distcheck distfiles dmg dpkg echo edit exit
+    'archive\:Archive\ the\ given\ ports,\ i.e.\ install\ the\ port\ image\ but\ do\ not\ activate'
-  extract fetch file gohome help info install installed lint list
+    'archivefetch\:Fetch\ archive\ for\ the\ given\ ports'
-  livecheck load location log logfile mdmg mirror mpkg notes
+    'build\:Build\ the\ given\ ports'
-  outdated patch pkg platform portpkg provides quit rdependents
+    'cat\:Writes\ the\ Portfiles\ of\ the\ given\ ports\ to\ stdout'
-  rdeps rev-upgrade rpm search select selfupdate setrequested space
+    'checksum\:Compares\ the\ checksums\ for\ the\ downloaded\ files\ of\ the\ given\ ports'
-  srpm submit sync test unarchive uninstall unload unsetrequested
+    'clean\:Removes\ files\ associated\ with\ the\ given\ ports'
-  upgrade url usage variants version work )
+    'configure\:Configure\ the\ given\ ports'
+    'contents\:\Returns\ a\ list\ of\ files\ installed\ by\ given\ ports'
+    'deactivate\:Deactivates\ the\ given\ ports'
+    'dependents\:Returns\ a\ list\ of\ installed\ dependents\ for\ each\ of\ the\ given\ ports'
+    'deps\:Display\ a\ dependency\ listing\ for\ the\ given\ ports'
+    'destroot\:Destroot\ the\ given\ ports'
+    'dir\:Returns\ the\ directories\ of\ the\ given\ ports'
+    'distcheck\:Checks\ if\ the\ given\ ports\ can\ be\ fetched\ from\ all\ of\ its\ master_sites'
+    'distfiles\:Returns\ a\ list\ of\ distfiles\ for\ the\ given\ port'
+    'dmg\:Creates\ a\ dmg\ for\ each\ of\ the\ given\ ports'
+    'dpkg\:Creates\ a\ dpkg\ for\ each\ of\ the\ given\ ports'
+    'echo\:Returns\ the\ list\ of\ ports\ the\ argument\ expands\ to'
+    'edit\:Edit\ given\ ports'
+    'extract\:Extract\ the\ downloaded\ files\ of\ the\ given\ ports'
+    'fetch\:Downloaded\ distfiles\ for\ the\ given\ ports'
+    'file\:Returns\ the\ path\ to\ the\ Portfile\ for\ each\ of\ the\ given\ ports'
+    'gohome\:Opens\ the\ homepages\ of\ the\ given\ ports\ in\ your\ browser'
+    'help\:Displays\ short\ help\ texts\ for\ the\ given\ actions'
+    'info\:Returns\ information\ about\ the\ given\ ports '
+    'install\:Installs\ the\ given\ ports'
+    'installed\:List\ installed\ versions\ of\ the\ given\ port,\ or\ all\ installed\ ports\ if\ no\ port\ is\ given'
+    'lint\:Checks\ if\ the\ Portfile\ is\ lint-free\ for\ each\ of\ the\ given\ ports'
+    'list\:List\ the\ available\ version\ for\ each\ of\ the\ given\ ports'
+    'livecheck\:Checks\ if\ a\ new\ version\ of\ the\ software\ is\ available'
+    'load\:Interface\ to\ launchctl(1)\ for\ ports\ providing\ startup\ items'
+    'location\:Returns\ the\ install\ location\ for\ each\ of\ the\ given\ ports'
+    'log\:Shows\ main\ log\ for\ given\ ports'
+    'logfile\:Returns\ the\ log\ file\ path\ for\ each\ of\ the\ given\ ports'
+    'mdmg\:Creates\ a\ dmg\ containing\ an\ mpkg\ for\ each\ of\ the\ given\ ports\ and\ their\ dependencies'
+    'mirror\:Fetches\ distfiles\ for\ the\ given\ ports'
+    'mpkg\:Creates\ an\ mpkg\ for\ each\ of\ the\ given\ ports\ and\ their\ dependencies'
+    'notes\:Displays\ informational\ notes\ for\ each\ of\ the\ given\ ports'
+    'outdated\:Returns\ a\ list\ of\ outdated\ ports'
+    'patch\:Applies\ patches\ to\ each\ of\ the\ given\ ports'
+    'pkg\:Creates\ a\ pkg\ for\ each\ of\ the\ given\ ports'
+    'platform\:Returns\ the\ current\ platform\ that\ port\ is\ running\ on'
+    'provides\:Return\ which\ port\ provides\ each\ of\ the\ files\ given'
+    'rdependents\:Recursive\ version\ of\ dependents'
+    'rdeps\:Display\ a\ recursive\ dependency\ listing\ for\ the\ given\ ports'
+    'rev-upgrade\:Scan\ for\ broken\ binaries\ in\ the\ installed\ ports\ and\ rebuild\ them\ as\ needed'
+    'rpm\:Creates\ a\ rpm\ for\ each\ of\ the\ given\ ports'
+    'search\:Search\ for\ a\ port'
+    'select\:Select\ between\ multiple\ versions\ of\ a\ versioned\ port'
+    'selfupdate\:Upgrade\ MacPorts\ itself\ and\ run\ the\ sync\ target'
+    'setrequested\:Marks\ each\ of\ the\ given\ ports\ as\ requested'
+    'space\:Show\ the\ disk\ space\ used\ by\ the\ given\ ports'
+    'srpm\:Creates\ a\ srpm\ for\ each\ of\ the\ given\ ports'
+    'sync\:Synchronize\ the\ set\ of\ Portfiles'
+    'test\:Run\ tests\ on\ each\ of\ the\ given\ ports'
+    'unarchive\:Unarchive\ the\ destroot\ of\ the\ given\ ports\ from\ installed\ images'
+    'uninstall\:Uninstall\ the\ given\ ports'
+    'unload\:Interface\ to\ launchctl(1)\ for\ ports\ providing\ startup\ items'
+    'unsetrequested\:Marks\ each\ of\ the\ given\ ports\ as\ unrequested'
+    'upgrade\:Upgrades\ the\ given\ ports\ to\ the\ latest\ version'
+    'url\:Returns\ the\ URL\ for\ each\ of\ the\ given\ ports'
+    'usage\:Returns\ basic\ usage\ of\ the\ port\ command'
+    'variants\:Returns\ a\ list\ of\ variants\ provided\ by\ the\ given\ ports,\ with\ descriptions\ if\ present'
+    'version\:Returns\ the\ version\ of\ MacPorts'
+    'work\:Returns\ the\ path\ to\ the\ work\ directory\ for\ each\ of\ the\ given\ ports'
+  )
 
   pseudo_common=(all current active inactive actinact installed uninstalled outdated
   obsolete requested unrequested leaves)
@@ -81,7 +140,7 @@ _port() {
     '-p[Despite any errors encountered, proceed to process multiple ports and commands.]' \
     '-y[Perform a dry run.]' \
     '-t[Enable trace mode debug facilities on platforms that support it (Mac OS X).]' \
-    "1:Port actions:($actions)" \
+    "1:Port actions:(($actions))" \
     '*:extra:->extra' \
     && return 0