Changeset 124484


Ignore:
Timestamp:
Aug 24, 2014, 10:12:02 PM (5 years ago)
Author:
cal@…
Message:

base: document port log{,file}

Location:
trunk/base/doc
Files:
1 added
1 copied

Legend:

Unmodified
Added
Removed
  • trunk/base/doc/port-log.1.txt

    r124479 r124484  
    66NAME
    77----
    8 port-cat - Print the contents of a Portfile
     8port-log, port-logfile - Print contents or path of a port's log file
    99
    1010SYNOPSIS
    1111--------
    1212[cmdsynopsis]
    13 *port* [*-D* 'portdir'] *cat*
     13*port* [*-D* 'portdir'] *log*
     14     [--level [error | warn | msg | info | debug]]
     15     [--phase [fetch | checksum | extract | patch | configure | build | destroot]]
     16     [['portname' | 'pseudo-portname' | 'port-expressions' | 'port-url']]
     17
     18[cmdsynopsis]
     19*port* [*-D* 'portdir'] *logfile*
    1420     [['portname' | 'pseudo-portname' | 'port-expressions' | 'port-url']]
    1521
    1622DESCRIPTION
    1723-----------
    18 Print the 'Portfile' of the given port(s). Note that always the latest version
    19 in your local ports tree is printed.
     24*port log* prints and optionally filters the contents of the log file for the
     25installation of the given port. The file can be filtered by log message level
     26and installation phase.
     27
     28*port logfile* prints the path to the log file for the last installation of the
     29given port. This is helpful to locate the file to attach when reporting bugs
     30against ports in MacPorts' issue tracker.
     31
     32OPTIONS
     33-------
     34*port logfile* has no options. *port log* has the following options:
     35
     36*--level SEVERITY*::
     37    Hide all messages below the given severity, which is one of
     38
     39    error:::
     40        for error messages
     41
     42    warn:::
     43        for warnings
     44
     45    msg:::
     46        for standard MacPorts output
     47
     48    info:::
     49        for output shown in verbose mode
     50
     51    debug:::
     52        for all output including debugging messages
     53
     54*--phase PHASE*::
     55    Only print messages that were generated in the given installation phase,
     56    where possible values for *PHASE* include 'fetch', 'checksum', 'extract',
     57    'patch', 'configure', 'build', and 'destroot'. Note that you can specify an
     58    arbitrary value which will be used in a regular expression to filter the log
     59    file.
    2060
    2161SEE ALSO
    2262--------
    23 man:port[1], man:port-selfupdate[1]
     63man:port[1], man:port-install[1], man:port-clean[1]
    2464
    2565AUTHORS
Note: See TracChangeset for help on using the changeset viewer.