From 0393a4becb8668b4fa666e09887b4dad5e630240 Mon Sep 17 00:00:00 2001
From: rudolfkoenig <>
Date: Mon, 14 Nov 2022 09:50:00 +0000
Subject: [PATCH] commandref_frame.html: better Value doc (Forum #130244)

git-svn-id: https://svn.fhem.de/fhem/trunk@26700 2b470e98-0d58-463d-a4d8-8e2adae1ed80
---
 fhem/docs/commandref_frame.html    | 7 +++++--
 fhem/docs/commandref_frame_DE.html | 7 +++++--
 2 files changed, 10 insertions(+), 4 deletions(-)

diff --git a/fhem/docs/commandref_frame.html b/fhem/docs/commandref_frame.html
index 369ad4837..b6ba64198 100644
--- a/fhem/docs/commandref_frame.html
+++ b/fhem/docs/commandref_frame.html
@@ -1947,8 +1947,11 @@ The following local attributes are used by a wider range of devices:
     <br>
     <ul>
       <li>Value(&lt;devicename&gt;)<br>
-        Returns the state of the device (the string you see in parenthesis in
-        the output of the list command).
+        Returns the STATE of the device (the string you see in parenthesis in
+        the output of the list command). Note: STATE is meant for display
+        purposes, and can be customized by the user via the stateFormat
+        attribute. Use ReadingsVal(&lt;devicename&gt;, 'state', '') instead for
+        computational purposes.
         </li><br>
       <li>OldValue(&lt;devicename&gt;)
       <li>OldTimestamp(&lt;devicename&gt;)<br>
diff --git a/fhem/docs/commandref_frame_DE.html b/fhem/docs/commandref_frame_DE.html
index 7dff88a89..758bb8b5f 100644
--- a/fhem/docs/commandref_frame_DE.html
+++ b/fhem/docs/commandref_frame_DE.html
@@ -2092,8 +2092,11 @@ Die folgenden lokalen Attribute werden von mehreren Ger&auml;ten verwendet:
     <br>
     <ul>
       <li>Value(&lt;devicename&gt;)<br>
-        liefert das Internal STATE zur&uuml;ck.
-        </li><br>
+        liefert das Internal STATE zur&uuml;ck. Achtung: STATE wird in erster
+        Linie f&uuml;r die Anzeige verwendet, und kann vom Benutzer mit dem
+        stateFormat Attribut ge&auml;ndert werden. F&uuml;r Berechnungen sollte
+        man stattdessen ReadingsVal(&lt;devicename&gt;, 'state', '') verwenden
+        (s.u.).  </li><br>
 
       <li>OldValue(&lt;devicename&gt;)</li>
       <li>OldTimestamp(&lt;devicename&gt;)<br>