[MacPorts] #18133: /opt/local/bin/port documentation problems

[MacPorts]

#18133: /opt/local/bin/port documentation problems
-------------------------------------+--------------------------------------
 Reporter:  macosforge.org@…         |       Owner:  macports-tickets@…                   
     Type:  defect                   |      Status:  new                                  
 Priority:  Normal                   |   Milestone:  Port Bugs                            
Component:  base                     |     Version:  1.7.0                                
 Keywords:                           |        Port:                                       
-------------------------------------+--------------------------------------
 there are a number of minor problems with the port command's
 documentation.

 1) the usage text differs between "port help" and the man page.
 help:
 {{{
 port
         [-bcdfiknopqRstuvx] [-D portdir] [-F cmdfile] action [privopts]
 [actionflags]
         [[portname|pseudo-portname|port-url] [@version] [+-variant]...
 [option=value]...]...
 }}}
 man page:
 {{{
      port [-vdqfonRusbckixpt] [-D portdir] [-F cmdfile] [action]
 [actionflags]
           [[portname | pseudo-portname | port-url]]
           [[@version] [+/-variant ...] ... [option=value ...]]
 }}}

 2) "actions" aren't consistently referred to as "actions".  the help text
 refers to "commands".  the man page talks about "USER TARGETS".

 3) the pseudo-portname "outdated" is listed as a command in the help text.

 4) the help text lists "work" as a command.

 there are likely other inconsistencies, too.

-- 
Ticket URL: <http://trac.macports.org/ticket/18133>
MacPorts <http://www.macports.org/>
Ports system for Mac OS