Imported upstream version 1.4.8

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

diff --git a/doc/rrdfetch.txt b/doc/rrdfetch.txt
index 88e5ca71d638414737f823b472d90ec5ca182744..c6717d6198e42d0191fc7ece6ca9e6067d5d5431 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.8                             2013-05-23                       RRDFETCH(1)