Imported upstream version 1.4.8

[pkg-rrdtool.git] / doc / rrdfetch.1

diff --git a/doc/rrdfetch.1 b/doc/rrdfetch.1
index c555c132d9c173db373fe1b9a3042d2a6341cc47..4a441d9dc38de21eca7dcb6a08c4fc0e0c3b5967 100644 (file)
--- a/doc/rrdfetch.1
+++ b/doc/rrdfetch.1
@@ -1,4 +1,4 @@
-.\" Automatically generated by Pod::Man 2.1801 (Pod::Simple 3.08)
+.\" Automatically generated by Pod::Man 2.25 (Pod::Simple 3.16)
 .\"
 .\" Standard preamble:
 .\" ========================================================================
@@ -124,7 +124,7 @@
 .\" ========================================================================
 .\"
 .IX Title "RRDFETCH 1"
-.TH RRDFETCH 1 "2009-06-09" "1.3.999" "rrdtool"
+.TH RRDFETCH 1 "2013-05-23" "1.4.8" "rrdtool"
 .\" For nroff, turn off justification.  Always turn off hyphenation; it makes
 .\" way too many mistakes in technical documents.
 .if n .ad l
@@ -276,11 +276,16 @@ single-number date is interpreted as MMDD[\s-1YY\s0]YY.
 \&\fI\s-1NOTE2\s0\fR: if you specify the \fIday\fR in this way, the \fItime-of-day\fR is
 \&\s-1REQUIRED\s0 as well.
 .PP
-Finally, you can use the words \fBnow\fR, \fBstart\fR, or \fBend\fR as your time
+Finally, you can use the words \fBnow\fR, \fBstart\fR, \fBend\fR or \fBepoch\fR as your time
 reference. \fBNow\fR refers to the current moment (and is also the default
 time reference). \fBStart\fR (\fBend\fR) can be used to specify a time
 relative to the start (end) time for those tools that use these
-categories (\fBrrdfetch\fR, rrdgraph).
+categories (\fBrrdfetch\fR, rrdgraph) and \fBepoch\fR indicates the 
+*IX epoch (*IX timestamp 0 = 1970\-01\-01 00:00:00 \s-1UTC\s0). \fBepoch\fR is
+useful to disambiguate between a timestamp value and some forms
+of abbreviated date/time specifications, because it allows to use 
+time offset specifications using units, eg. \fBepoch\fR+19711205s unambiguously
+denotes timestamp 19711205 and not 1971\-12\-05 00:00:00 \s-1UTC\s0.
 .PP
 Month and day of the week names can be used in their naturally
 abbreviated form (e.g., Dec for December, Sun for Sunday, etc.). The