Imported upstream version 1.4.8

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

diff --git a/doc/rrdtutorial.1 b/doc/rrdtutorial.1
index d0bad20183467f0f413d8fa6e36f44be1270ccfd..db57748d29e9993fddafab501cdcb6a73f7d5c90 100644 (file)
--- a/doc/rrdtutorial.1
+++ b/doc/rrdtutorial.1
@@ -1,4 +1,4 @@
-.\" Automatically generated by Pod::Man 2.1801 (Pod::Simple 3.05)
+.\" Automatically generated by Pod::Man 2.25 (Pod::Simple 3.16)
 .\"
 .\" Standard preamble:
 .\" ========================================================================
@@ -124,7 +124,7 @@
 .\" ========================================================================
 .\"
 .IX Title "RRDTUTORIAL 1"
-.TH RRDTUTORIAL 1 "2009-10-15" "1.4.3" "rrdtool"
+.TH RRDTUTORIAL 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
@@ -181,7 +181,7 @@ element. As we are on a circle there is neither a beginning nor an end, you can
 go on and on and on. After a while, all the available places will be used and
 the process automatically reuses old locations. This way, the dataset
 will not grow in size and therefore requires no maintenance.
-RRDtool works with with Round Robin Databases (RRDs). It stores and retrieves
+RRDtool works with Round Robin Databases (RRDs). It stores and retrieves
 data from them.
 .SS "What data can be put into an \s-1RRD\s0?"
 .IX Subsection "What data can be put into an RRD?"
@@ -447,14 +447,19 @@ It should return the following output:
 \& 920808600: 6.6666666667e\-03
 \& 920808900: 3.3333333333e\-03
 \& 920809200: nan
+\& 920809500: nan
 .Ve
 .PP
-If it doesn't, something may be wrong.  Perhaps your \s-1OS\s0 will print
-\&\*(L"NaN\*(R" in a different form. \*(L"NaN\*(R" stands for \*(L"Not A Number\*(R".  If your \s-1OS\s0
-writes \*(L"U\*(R" or \*(L"\s-1UNKN\s0\*(R" or something similar that's okay.  If something
-else is wrong, it will probably be due to an error you made (assuming
-that my tutorial is correct of course :\-). In that case: delete the
-database and try again.
+Note that you might get more rows than you expect. The reason for this is
+that you ask for a time range that ends on 920809200. The number that is
+written behind 920809200: in the list above covers the time range from
+920808900 to 920809200, \s-1EXCLUDING\s0 920809200. Hence to be on the sure side,
+you receive the entry from 920809200 to 920809500 as well since it \s-1INCLUDES\s0
+920809200. You may also see \*(L"NaN\*(R" instead of \*(L"nan\*(R" this is \s-1OS\s0 dependent.
+\&\*(L"NaN\*(R" stands for \*(L"Not A Number\*(R".  If your \s-1OS\s0 writes \*(L"U\*(R" or \*(L"\s-1UNKN\s0\*(R" or
+something similar that's okay.  If something else is wrong, it will probably
+be due to an error you made (assuming that my tutorial is correct of course
+:\-). In that case: delete the database and try again.
 .PP
 The meaning of the above output will become clear below.
 .SS "Time to create some graphics"