// vim: set et sw=4 ts=8 ft=asciidoc tw=80: port-info(1) ============ $Id: port-info.1.txt 123889 2014-08-15 20:06:28Z cal@macports.org $ NAME ---- port-info - Return information about the given ports. SYNOPSIS -------- [cmdsynopsis] *port* [*-q*] [*-D* 'portdir'] *info* [--categories|--category] [--depends] [--depends_fetch] [--depends_extract] [--depends_build] [--depends_lib] [--depends_run] [--description] [--epoch] [--fullname] [--heading] [--homepage] [--index] [--license] [--line] [--long_description] [--maintainer|--maintainers] [--name] [--platform|--platforms] [--portdir] [--pretty] [--replaced_by] [--revision] [--subports] [--variant|--variants] [--version] [['portname' | 'pseudo-portname' | 'port-expressions' | 'port-url']] DESCRIPTION ----------- *port info* prints information about the given ports. Specifying at least one of the options limits the output to the corresponding field. If no fields are specified, a useful default set consisting of name, epoch, version, revision, categories, replaced_by, variants, description, homepage, dependencies, platforms, license, and maintainers is shown. OPTIONS ------- The following options do not select fields for the output but change how the information is obtained or formatted: --index:: Do not read the Portfile, but rely solely on the port index information. Note that this option will prevent the information reported from reflecting the effects of any variants specified. --line:: Print a single line for each port. Fields are separated by spaces. --pretty:: Format the output in a convenient, human-readable fashion. This is the default when no options are specified. The rest of the options affect which fields will be given in the output: --category, or --categories:: List the categories of a port. --depends, --depends_fetch, --depends_extract, --depends_build, --depends_lib, and --depends_run:: List the specified dependencies of a port. *--depends* is a shorthand option for all other *--depends_** options. --description, and --long_description:: Print the short, and long description of a port, respectively. --epoch, --version, --revision:: List the components of a MacPorts version tuple, epoch, version and revision, respectively. --fullname:: Print name and the full MacPorts version tuple, e.g., "yubico-pam @2.16". --heading:: Like *--fullname* but including the categories. --homepage:: List the homepage of a port. --license:: Print the license that applies to the source code of a port. --maintainer, or --maintainers:: List the email address(es) of a port's maintainer(s). --name:: Print the name of a port. --platform, or --platforms:: List the platforms supported by a port. This field exists for historical reasons only. In modern MacPorts, this is always 'darwin', i.e., OS X. --portdir:: Print the path to a port's directory relative to the port tree root. --replaced_by:: List the name of the port that replaces a port, if any. --subports:: Print a list of subports defined by this port's Portfile, i.e., ports that are defined in the same Portfile because they share common parts. --variant, or --variants:: List the variants defined by a port by name. include::global-flags.txt[] -q:: Do not print the field description when using *--pretty* output. SEE ALSO -------- man:port[1] AUTHORS ------- (C) 2014 The MacPorts Project Clemens Lang