Imported Upstream version 1.4.7

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

diff --git a/doc/rrdfetch.txt b/doc/rrdfetch.txt
index 88e5ca71d638414737f823b472d90ec5ca182744..eb6dd0b95c9353926b36574637d9a35036f1337c 100644 (file)
--- a/doc/rrdfetch.txt
+++ b/doc/rrdfetch.txt
@@ -132,11 +132,16 @@ D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN
        _\bN_\bO_\bT_\bE_\b2: if you specify the _\bd_\ba_\by in this way, the _\bt_\bi_\bm_\be_\b-_\bo_\bf_\b-_\bd_\ba_\by is REQUIRED
        as well.
 
-       Finally, you can use the words n\bno\bow\bw, s\bst\bta\bar\brt\bt, or e\ben\bnd\bd as your time
+       Finally, you can use the words n\bno\bow\bw, s\bst\bta\bar\brt\bt, e\ben\bnd\bd or e\bep\bpo\boc\bch\bh as your time
        reference. N\bNo\bow\bw refers to the current moment (and is also the default
        time reference). S\bSt\bta\bar\brt\bt (e\ben\bnd\bd) can be used to specify a time relative to
        the start (end) time for those tools that use these categories
-       (r\brr\brd\bdf\bfe\bet\btc\bch\bh, rrdgraph).
+       (r\brr\brd\bdf\bfe\bet\btc\bch\bh, rrdgraph) and e\bep\bpo\boc\bch\bh indicates the *IX epoch (*IX timestamp 0
+       = 1970-01-01 00:00:00 UTC). e\bep\bpo\boc\bch\bh 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.
+       e\bep\bpo\boc\bch\bh+19711205s unambiguously denotes timestamp 19711205 and not
+       1971-12-05 00:00:00 UTC.
 
        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
@@ -241,4 +246,4 @@ A\bAU\bUT\bTH\bHO\bOR\bR
 
 
 
-1.4.3                             2008-09-25                       RRDFETCH(1)
+1.4.7                             2010-11-11                       RRDFETCH(1)