Code

changelog: Fixed last changelog regarding the versioned build-dep on tcl-dev.
[pkg-rrdtool.git] / doc / rrdfetch.txt
index b6f3f2c51c9ff7102faf3660d7ff4d20560bd659..eb6dd0b95c9353926b36574637d9a35036f1337c 100644 (file)
@@ -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.3.999                           2009-06-09                       RRDFETCH(1)
+1.4.7                             2010-11-11                       RRDFETCH(1)