source: trunk/base/doc/port-list.1.txt @ 134980

Last change on this file since 134980 was 123962, checked in by cal@…, 5 years ago

base: document port list, #44530

  • Property svn:eol-style set to native
  • Property svn:keywords set to Id
File size: 1.6 KB
Line 
1// vim: set et sw=4 ts=8 ft=asciidoc tw=80:
2port-echo(1)
3============
4$Id: port-list.1.txt 123962 2014-08-16 16:54:15Z cal@macports.org $
5
6NAME
7----
8port-list - List the latest available version for the given ports
9
10SYNOPSIS
11--------
12[cmdsynopsis]
13*port* *list*
14     [['portname' | 'pseudo-portname' | 'port-expressions' | 'port-url']]
15
16DESCRIPTION
17-----------
18*port list* prints the latest version of the given port(s) that is available
19through MacPorts. It prints name, version number and the relative path of the
20port in the port tree, i.e. the name of the primary category followed by the
21port name.
22
23[NOTE]
24====
25*port list* will always print the latest *available* version, which is not
26necessarily the version you have installed.
27
28This leads to the common mistake that *port list installed* lists the same port
29multiple times in the same version. This happens because *installed* expands to
30a list of installed ports and their versions, but *port list* ignores the
31version and prints the latest available version for each occurrence of a port in
32*installed*. In these cases, you should use man:port-installed[1] or
33man:port-echo[1] instead. *port installed* and *port echo* also have the
34advantage of being much faster.
35====
36
37Pretty much the only use case for *port list* is checking which version of
38a specific port is current in MacPorts, or if a port exists at all. Do *not* use
39*port list* to print *outdated*, *inactive*, *installed*, *requested*, *leaves*,
40or other pseudo-ports. Use man:port-outdated[1], man:port-installed[1], or
41man:port-echo[1] instead.
42
43SEE ALSO
44--------
45man:port[1], man:port-installed[1], man:port-echo[1], man:port-outdated[1]
46
47AUTHORS
48-------
49 (C) 2014 The MacPorts Project
50 Clemens Lang <cal@macports.org>
Note: See TracBrowser for help on using the repository browser.