Imported upstream version 1.3rc4.

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

diff --git a/doc/rrdgraph_rpn.txt b/doc/rrdgraph_rpn.txt
index 5f022a444a91bd80ecd83d1e478471a3a1fa6625..8be61de7ca0d739256e2c19bc5bcefa3ecde40ae 100644 (file)
--- a/doc/rrdgraph_rpn.txt
+++ b/doc/rrdgraph_rpn.txt
@@ -63,6 +63,8 @@ O\bOP\bPE\bER\bRA\bAT\bTO\bOR\bRS\bS
 
            Example: "A,B,C,IF" should be read as "if (A) then (B) else (C)"
 
+
+
        Comparing values
            M\bMI\bIN\bN,\b, M\bMA\bAX\bX
 
@@ -85,11 +87,19 @@ O\bOP\bPE\bER\bRA\bAT\bTO\bOR\bRS\bS
            Example: "CDEF:a=alpha,0,100,LIMIT" will return _\bu_\bn_\bk_\bn_\bo_\bw_\bn if alpha is
            lower than 0 or if it is higher than 100.
 
+
+
        Arithmetics
            +\b+,\b, -\b-,\b, *\b*,\b, /\b/,\b, %\b%
 
            Add, subtract, multiply, divide, modulo
 
+           A\bAD\bDD\bDN\bNA\bAN\bN
+
+           NAN-safe addition. If one parameter is NAN/UNKNOWN it'll be treated
+           as zero. If both parameters are NAN/UNKNOWN, NAN/UNKNOWN will be
+           returned.
+
            S\bSI\bIN\bN,\b, C\bCO\bOS\bS,\b, L\bLO\bOG\bG,\b, E\bEX\bXP\bP,\b, S\bSQ\bQR\bRT\bT
 
            Sine and cosine (input in radians), log and exp (natural loga-
@@ -139,7 +149,7 @@ O\bOP\bPE\bER\bRA\bAT\bTO\bOR\bRS\bS
 
            Example: "CDEF:x=a,b,c,d,4,AVG"
 
-           T\bTR\bRE\bEN\bND\bD
+           T\bTR\bRE\bEN\bND\bD,\b, T\bTR\bRE\bEN\bND\bDN\bNA\bAN\bN
 
            Create a "sliding window" average of another data series.
 
@@ -161,6 +171,11 @@ O\bOP\bPE\bER\bRA\bAT\bTO\bOR\bRS\bS
                 Value at sample (t1) will be the average between (t1-delay) and (t1)
                 Value at sample (t2) will be the average between (t2-delay) and (t2)
 
+           TRENDNAN is - in contrast to TREND - NAN-safe. If you use TREND and
+           one source value is NAN the complete sliding window is affected.
+           The TRENDNAN operation ignores all NAN-values in a sliding window
+           and computes the average of the remaining values.
+
        Special values
            U\bUN\bNK\bKN\bN
 
@@ -219,6 +234,8 @@ O\bOP\bPE\bER\bRA\bAT\bTO\bOR\bRS\bS
            Duplicate the top element, remove the top element, exchange the two
            top elements.
 
+
+
 V\bVA\bAR\bRI\bIA\bAB\bBL\bLE\bES\bS
        These operators work only on V\bVD\bDE\bEF\bF statements. Note that currently ONLY
        these work for V\bVD\bDE\bEF\bF.
@@ -229,6 +246,11 @@ V\bVA\bAR\bRI\bIA\bAB\bBL\bLE\bES\bS
 
            Example: "VDEF:avg=mydata,AVERAGE"
 
+       STDEV
+           Returns the standard deviation of the values.
+
+           Example: "VDEF:stdev=mydata,STDEV"
+
        LAST, FIRST
            Return the last/first value including its time.  The time for FIRST
            is actually the start of the corresponding interval, whereas LAST
@@ -284,4 +306,4 @@ A\bAU\bUT\bTH\bHO\bOR\bR
 
 
 
-1.2.27                            2008-02-17                   RRDGRAPH_RPN(1)
+1.3rc4                            2008-03-15                   RRDGRAPH_RPN(1)