From: oetiker <oetiker@a5681a0c-68f1-0310-ab6d-d61299d08faa>
Date: Tue, 2 Jun 2009 13:55:40 +0000 (+0000)
Subject: Mention that negative time values should be separated by '--' in rrdupdate.pod -... 
X-Git-Url: https://git.tokkee.org/?a=commitdiff_plain;h=5bd8162477db761296181c98a4c31f5f62edcfc6;p=rrdtool-all.git

Mention that negative time values should be separated by '--' in rrdupdate.pod -- Sebastian Harl


git-svn-id: svn://svn.oetiker.ch/rrdtool/branches/1.3@1839 a5681a0c-68f1-0310-ab6d-d61299d08faa
---

diff --git a/program/doc/rrdupdate.pod b/program/doc/rrdupdate.pod
index cc0b452f..49eb8fe4 100644
--- a/program/doc/rrdupdate.pod
+++ b/program/doc/rrdupdate.pod
@@ -5,7 +5,7 @@ rrdupdate - Store a new set of values into the RRD
 =head1 SYNOPSIS
 
 B<rrdtool> {B<update> | B<updatev>} I<filename>
-S<[B<--template>|B<-t> I<ds-name>[B<:>I<ds-name>]...]>
+S<[B<--template>|B<-t> I<ds-name>[B<:>I<ds-name>]...]> [B<-->]
 S<B<N>|I<timestamp>B<:>I<value>[B<:>I<value>...]>
 S<I<at-timestamp>B<@>I<value>[B<:>I<value>...]>
 S<[I<timestamp>B<:>I<value>[B<:>I<value>...] ...]>
@@ -69,6 +69,10 @@ timing right to the second is especially important when you are
 working with data-sources of type B<COUNTER>, B<DERIVE> or
 B<ABSOLUTE>.
 
+When using negative time values, options and data have to be separated
+by two dashes (B<-->), else the time value would be parsed as an option.
+See below for an example.
+
 The remaining elements of the argument are DS updates. The order of
 this list is the same as the order the data sources were defined in
 the RRA. If there is no data for a certain data-source, the letter
@@ -95,6 +99,11 @@ Update the database file demo2.rrd which expects data from a single
 data-source, three times. First with an I<*UNKNOWN*> value then with two
 regular readings. The update interval seems to be around 300 seconds.
 
+C<rrdtool update demo3.rrd -- -5:21 N:42>
+
+Update the database file demo3.rrd two times, using five seconds in the
+past and the current time as the update times.
+
 =head1 AUTHOR
 
 Tobias Oetiker <tobi@oetiker.ch>