aboutsummaryrefslogtreecommitdiff
path: root/man
diff options
context:
space:
mode:
Diffstat (limited to 'man')
-rw-r--r--man/include/qlop.optdesc.yaml16
-rw-r--r--man/qlop.116
2 files changed, 31 insertions, 1 deletions
diff --git a/man/include/qlop.optdesc.yaml b/man/include/qlop.optdesc.yaml
index 7864d6e..fad1670 100644
--- a/man/include/qlop.optdesc.yaml
+++ b/man/include/qlop.optdesc.yaml
@@ -1,3 +1,19 @@
+date: |
+ 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
gauge: |
Gauge number of times a package has been merged. This shows the
merge time for each individual merge of package.
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.