[124485] trunk/base/doc
cal at macports.org
cal at macports.org
Sun Aug 24 15:12:53 PDT 2014
Revision: 124485
https://trac.macports.org/changeset/124485
Author: cal at macports.org
Date: 2014-08-24 15:12:53 -0700 (Sun, 24 Aug 2014)
Log Message:
-----------
base: (re-)generate roff from asciidoc, enable port-log{,file}.1
Modified Paths:
--------------
trunk/base/doc/Makefile.in
trunk/base/doc/port-doctor.1
trunk/base/doc/port-fetch.1
trunk/base/doc/port-reclaim.1
Added Paths:
-----------
trunk/base/doc/port-log.1
trunk/base/doc/port-logfile.1
Modified: trunk/base/doc/Makefile.in
===================================================================
--- trunk/base/doc/Makefile.in 2014-08-24 22:12:02 UTC (rev 124484)
+++ trunk/base/doc/Makefile.in 2014-08-24 22:12:53 UTC (rev 124485)
@@ -52,6 +52,8 @@
port-livecheck.1 \
port-load.1 \
port-location.1 \
+ port-log.1 \
+ port-logfile.1 \
port-mdmg.1 \
port-mpkg.1 \
port-patch.1 \
Modified: trunk/base/doc/port-doctor.1
===================================================================
--- trunk/base/doc/port-doctor.1 2014-08-24 22:12:02 UTC (rev 124484)
+++ trunk/base/doc/port-doctor.1 2014-08-24 22:12:53 UTC (rev 124485)
@@ -1,5 +1,5 @@
'\" t
-.TH "PORT\-DOCTOR" "1" "08/20/2014" "MacPorts 2\&.3\&.99" "MacPorts Manual"
+.TH "PORT\-DOCTOR" "1" "08/24/2014" "MacPorts 2\&.3\&.99" "MacPorts Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
Modified: trunk/base/doc/port-fetch.1
===================================================================
--- trunk/base/doc/port-fetch.1 2014-08-24 22:12:02 UTC (rev 124484)
+++ trunk/base/doc/port-fetch.1 2014-08-24 22:12:53 UTC (rev 124485)
@@ -1,5 +1,5 @@
'\" t
-.TH "PORT\-FETCH" "1" "2014\-08\-03" "MacPorts 2\&.3\&.99" "MacPorts Manual"
+.TH "PORT\-FETCH" "1" "2014\-08\-24" "MacPorts 2\&.3\&.99" "MacPorts Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
@@ -24,7 +24,7 @@
.SH "SYNOPSIS"
.sp
.nf
-\fBport\fR [\fB\-vdoy\fR] [\fB\-D\fR \fIportdir\fR] \fBfetch\fR | \fBchecksum\fR | \fBextract\fR | \fBpatch\fR | \fBconfigure\fR | \fBbuild\fR | \fBdestroot\fR
+\fBport\fR [\fB\-vdoy\fR] [\fB\-D\fR \fIportdir\fR] [\fBfetch\fR | \fBchecksum\fR | \fBextract\fR | \fBpatch\fR | \fBconfigure\fR | \fBbuild\fR | \fBdestroot\fR]
[[\fIportname\fR | \fIpseudo\-portname\fR | \fIport\-expressions\fR | \fIport\-url\fR]]
.fi
.SH "DESCRIPTION"
Added: trunk/base/doc/port-log.1
===================================================================
--- trunk/base/doc/port-log.1 (rev 0)
+++ trunk/base/doc/port-log.1 2014-08-24 22:12:53 UTC (rev 124485)
@@ -0,0 +1,103 @@
+'\" t
+.TH "PORT\-CAT" "1" "2014\-08\-24" "MacPorts 2\&.3\&.99" "MacPorts Manual"
+.\" -----------------------------------------------------------------
+.\" * Define some portability stuff
+.\" -----------------------------------------------------------------
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.\" http://bugs.debian.org/507673
+.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
+.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+.ie \n(.g .ds Aq \(aq
+.el .ds Aq '
+.\" -----------------------------------------------------------------
+.\" * set default formatting
+.\" -----------------------------------------------------------------
+.\" disable hyphenation
+.nh
+.\" disable justification (adjust text to left margin only)
+.ad l
+.\" -----------------------------------------------------------------
+.\" * MAIN CONTENT STARTS HERE *
+.\" -----------------------------------------------------------------
+.SH "NAME"
+port-log, port-logfile \- Print contents or path of a port\*(Aqs log file
+.SH "SYNOPSIS"
+.sp
+.nf
+\fBport\fR [\fB\-D\fR \fIportdir\fR] \fBlog\fR
+ [\-\-level [error | warn | msg | info | debug]]
+ [\-\-phase [fetch | checksum | extract | patch | configure | build | destroot]]
+ [[\fIportname\fR | \fIpseudo\-portname\fR | \fIport\-expressions\fR | \fIport\-url\fR]]
+.fi
+.sp
+.nf
+\fBport\fR [\fB\-D\fR \fIportdir\fR] \fBlogfile\fR
+ [[\fIportname\fR | \fIpseudo\-portname\fR | \fIport\-expressions\fR | \fIport\-url\fR]]
+.fi
+.SH "DESCRIPTION"
+.sp
+\fBport log\fR prints and optionally filters the contents of the log file for the installation of the given port\&. The file can be filtered by log message level and installation phase\&.
+.sp
+\fBport logfile\fR prints the path to the log file for the last installation of the given port\&. This is helpful to locate the file to attach when reporting bugs against ports in MacPorts\*(Aq issue tracker\&.
+.SH "OPTIONS"
+.sp
+\fBport logfile\fR has no options\&. \fBport log\fR has the following options:
+.PP
+\fB\-\-level SEVERITY\fR
+.RS 4
+Hide all messages below the given severity, which is one of
+.PP
+error
+.RS 4
+for error messages
+.RE
+.PP
+warn
+.RS 4
+for warnings
+.RE
+.PP
+msg
+.RS 4
+for standard MacPorts output
+.RE
+.PP
+info
+.RS 4
+for output shown in verbose mode
+.RE
+.PP
+debug
+.RS 4
+for all output including debugging messages
+.RE
+.RE
+.PP
+\fB\-\-phase PHASE\fR
+.RS 4
+Only print messages that were generated in the given installation phase, where possible values for
+\fBPHASE\fR
+include
+\fIfetch\fR,
+\fIchecksum\fR,
+\fIextract\fR,
+\fIpatch\fR,
+\fIconfigure\fR,
+\fIbuild\fR, and
+\fIdestroot\fR\&. Note that you can specify an arbitrary value which will be used in a regular expression to filter the log file\&.
+.RE
+.SH "SEE ALSO"
+.sp
+\fBport\fR(1), \fBport-install\fR(1), \fBport-clean\fR(1)
+.SH "AUTHORS"
+.sp
+.if n \{\
+.RS 4
+.\}
+.nf
+(C) 2014 The MacPorts Project
+Clemens Lang <cal at macports\&.org>
+.fi
+.if n \{\
+.RE
+.\}
Added: trunk/base/doc/port-logfile.1
===================================================================
--- trunk/base/doc/port-logfile.1 (rev 0)
+++ trunk/base/doc/port-logfile.1 2014-08-24 22:12:53 UTC (rev 124485)
@@ -0,0 +1 @@
+.so man1/port-log.1
Modified: trunk/base/doc/port-reclaim.1
===================================================================
--- trunk/base/doc/port-reclaim.1 2014-08-24 22:12:02 UTC (rev 124484)
+++ trunk/base/doc/port-reclaim.1 2014-08-24 22:12:53 UTC (rev 124485)
@@ -1,5 +1,5 @@
'\" t
-.TH "PORT\-RECLAIM" "1" "08/20/2014" "MacPorts 2\&.3\&.99" "MacPorts Manual"
+.TH "PORT\-RECLAIM" "1" "08/24/2014" "MacPorts 2\&.3\&.99" "MacPorts Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.macosforge.org/pipermail/macports-changes/attachments/20140824/4e6adfb0/attachment.html>
More information about the macports-changes
mailing list