From a10b17b5030f45bcf698ebc1f34b6b877069bdfa Mon Sep 17 00:00:00 2001
From: rudolfkoenig <>
Date: Fri, 9 Mar 2018 07:45:43 +0000
Subject: [PATCH] commandref_frame.html: add OldReadings documentation (from
 justme1968, Forum #85406)

git-svn-id: https://svn.fhem.de/fhem/trunk@16355 2b470e98-0d58-463d-a4d8-8e2adae1ed80
---
 fhem/docs/commandref_frame.html    | 22 +++++++++++++++++++++-
 fhem/docs/commandref_frame_DE.html | 22 ++++++++++++++++++++++
 2 files changed, 43 insertions(+), 1 deletion(-)

diff --git a/fhem/docs/commandref_frame.html b/fhem/docs/commandref_frame.html
index 9f384981a..92d478282 100644
--- a/fhem/docs/commandref_frame.html
+++ b/fhem/docs/commandref_frame.html
@@ -581,7 +581,13 @@ attribute list if you want to know if a device supports these attributes.  <br>
     of the matched type. If event-on-change-reading is also specified, they are
     combined with OR: if one of them is true, the event is generated.
     </li>
-    <p>
+
+    <a name="oldreadings"></a>
+    <li>oldreadings<br>
+    This attribute takes a comma-separated list of readings. You may use
+    regular expressions in that list. For each reading in the list FHEM will
+    internaly store the previous value if the readings value changes. To access
+    the storead value use the OldReadings.* functions.</li>
 
     <a name="userReadings"></a>
     <li>userReadings<br>
@@ -1774,6 +1780,20 @@ The following local attributes are used by a wider range of devices:
         <br>
         returns the age of the reading in seconds.
         </li><br>
+
+      <li>
+        OldReadingsVal(&lt;devicename&gt;,&lt;reading&gt;,
+                        &lt;defaultvalue&gt;)<br>
+        OldReadingsNum(&lt;devicename&gt;,&lt;reading&gt;,
+                        &lt;defaultvalue&gt;,&lt;round&gt;)<br>
+        OldReadingsTimestamp(&lt;devicename&gt;,&lt;
+                        reading&gt;,&lt;defaultvalue&gt;)<br>
+        OldReadingsAge(&lt;devicename&gt;,&lt;reading&gt;,
+                        &lt;defaultvalue&gt;)<br>
+        similar to the above functions, but used to access the previous values.
+        see: <a href="#oldreadings">oldreadings</a>
+        </li><br>
+
       <li>
         AttrVal(&lt;devicename&gt;,&lt;attribute&gt;,&lt;defaultvalue&gt;)<br>
         Return the attribute of the device
diff --git a/fhem/docs/commandref_frame_DE.html b/fhem/docs/commandref_frame_DE.html
index 223546e55..8a79aa43b 100644
--- a/fhem/docs/commandref_frame_DE.html
+++ b/fhem/docs/commandref_frame_DE.html
@@ -593,6 +593,14 @@ Ger&auml;t dokumentiert.
     event-on-change-reading auch spezifiziert ist, dann werden sie mit ODER
     kombiniert, d.h. wenn einer der beiden Bedingungen wahr ist.
     </li>
+          
+    <a name="oldreadings"></a>
+    <li>oldreadings<br>
+    Dieses Attribut enth&auml;lt eine durch Kommata getrennte Liste von
+    Readings.  regex sind erlaubt. F&uuml;r jedes Reading aus der Liste
+    speichert FHEM intern den vorherigen Wert wenn sich das Reading
+    &auml;ndert. Zum Zugriff auf die Werte gibt es die OldReadings.* Routinen.
+    </li>     
 
     <a name="userReadings"></a>
     <li>userReadings<br>
@@ -1919,6 +1927,20 @@ Die folgenden lokalen Attribute werden von mehreren Ger&auml;ten verwendet:
         <br>
         gibt das Alter des Readings in Sekunden zur&uuml;ck.
         </li><br>
+
+      <li>
+        OldReadingsVal(&lt;devicename&gt;,&lt;reading&gt;
+                        ,&lt;defaultvalue&gt;)<br>
+        OldReadingsNum(&lt;devicename&gt;,&lt;reading&gt;,
+                        &lt;defaultvalue&gt;,&lt;round&gt;)<br>
+        OldReadingsTimestamp(&lt;devicename&gt;,&lt;reading&gt;
+                        ,&lt;defaultvalue&gt;)<br>         
+        OldReadingsAge(&lt;devicename&gt;,&lt;reading&gt;,&lt;
+                        defaultvalue&gt;)<br>
+        analog zu den Routinen oben, aber zum Zugriff auf die vorherigen Werte.
+        siehe: <a href="#oldreadings">oldreadings</a><br>
+        </li><br>
+
       <li>
         AttrVal(&lt;devicename&gt;,&lt;attribute&gt;,&lt;defaultvalue&gt;)<br>
         Gibt das entsprechende Attribut des Ger&auml;tes zur&uuml;ck