source: trunk/base/doc/port-log.1.txt @ 124484

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

base: document port log{,file}

  • Property svn:eol-style set to native
  • Property svn:keywords set to Id
File size: 1.8 KB
Line 
1// vim: set et sw=4 ts=8 ft=asciidoc tw=80:
2port-cat(1)
3===========
4$Id: port-log.1.txt 124484 2014-08-24 22:12:02Z cal@macports.org $
5
6NAME
7----
8port-log, port-logfile - Print contents or path of a port's log file
9
10SYNOPSIS
11--------
12[cmdsynopsis]
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*
20     [['portname' | 'pseudo-portname' | 'port-expressions' | 'port-url']]
21
22DESCRIPTION
23-----------
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.
60
61SEE ALSO
62--------
63man:port[1], man:port-install[1], man:port-clean[1]
64
65AUTHORS
66-------
67 (C) 2014 The MacPorts Project
68 Clemens Lang <cal@macports.org>
Note: See TracBrowser for help on using the repository browser.