aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorFabian Groffen <grobian@gentoo.org>2018-04-12 21:14:19 +0200
committerFabian Groffen <grobian@gentoo.org>2018-04-12 21:14:19 +0200
commit33d4e18b26cd37691a81584da0efd929097a22b3 (patch)
tree5ec36b451373d2916dff55354e2e8dd9c2138901 /man/qlop.1
parentatom_explode: try harder to find correct PV (diff)
downloadportage-utils-33d4e18b26cd37691a81584da0efd929097a22b3.tar.gz
portage-utils-33d4e18b26cd37691a81584da0efd929097a22b3.tar.bz2
portage-utils-33d4e18b26cd37691a81584da0efd929097a22b3.zip
qlop: don't rely on %F for data parsing for portability
While at it document the date formats in the man-page.
Diffstat (limited to 'man/qlop.1')
-rw-r--r--man/qlop.116
1 files changed, 15 insertions, 1 deletions
diff --git a/man/qlop.1 b/man/qlop.1
index c138054..9c449a9 100644
--- a/man/qlop.1
+++ b/man/qlop.1
@@ -39,7 +39,21 @@ Show current emerging packages. This relies on
in order to detect running merges.
.TP
\fB\-d\fR \fI<arg>\fR, \fB\-\-date\fR \fI<arg>\fR
-Limit selection to this time (1st -d is start, 2nd -d is end).
+Limit the selection of packages to the date given, or to the range
+of dates if this argument is given twice. The \fB--date\fR option
+can take a few forms.
+.RS
+.IP "NUMBER <day|week|month|year>[s] [ago]"
+Relative time, specifying \fINUMBER\fR \fIdays\fR, \fIweeks\fR,
+\fImonths\fR or \fIyears\fR, for example \fI3 days ago\fR.
+.IP YYYY-MM-DD
+Big-endian date, with components separated by hyphens, starting with
+year, followed by month and day of month.
+.IP SSSSSSSSS
+Seconds since 1970-01-01 00:00:00 +0000 (UTC), the UNIX epoch.
+.IP FORMAT|DATE
+Use \fIFORMAT\fR as input for \fBstrptime\fR(3) to parse \fIDATE\fR.
+.RE
.TP
\fB\-f\fR \fI<arg>\fR, \fB\-\-logfile\fR \fI<arg>\fR
Read emerge logfile instead of $EMERGE_LOG_DIR/emerge.log.