I could see how that can be confusing. That statement is made with respect to the overview of the Element, not the scripting language. But we'll edit that to remove the overlap.
The best resource for scritping is the Element Properties section. You can see there that Digital Inputs can only have properties ActiveLow or Value (along with the properties common to all Elements and Device Elements). There is no State there, therefore it cannot be used in a script as a property of a Digital Input.
I see that now. It would be nice if you could also list the scripting properties for each element with it properties in it description in the User Manual.
I know that writing Users Manuals is a chore and pain (and normally an afterthought). Having all the information with its Main Entry is what I found best when I was doing it. I would suggest that you keep the Scripting Section but add the following after each Device Element:
Device Input Scripting:
•
All Elements
Visibility (Enumerated Read/Write: default/visible/hidden/hiddenlocked)
DisplayName (Read/Write: string)
DisplayText (Read Only: string)
Background (Enumerated Read/Write: 1/2/3)
ID (Read Only: string)
Element ID (Read Only: string)
Port ID (Read Only: string)
All Device Elements
Enabled (Enumerated Read/Write: true/false)
Connected (Read Only: true/false)
RefreshMultiple (Read/Write: number)
Digital Input
ActiveLow (Read/Write: true/false)
Value (Read/Write: true/false)
Example:
A Float that is wired as a Digital Input and a Valve that will shut when Float is "made".
// Brewery Float is wired as a Digital Input
// Fill Valve is a 24 vdc ball valve
[LoopBF]
if "Brewery Float" value == True
"Fill Valve" state = False
endif
goto LoopBF
or
// Brewery Float is wired as a Digital Input
// Fill Valve is a 24 vdc ball valve
wait "Brewery Float" value == True
"Fill Valve" state = False
While this is something of a repeat within the manual, since the manual is digital it would be easy to cut and paste and add the extra. When it is with the Main Section as well, your end user may better see it rather than trying to find it elsewhere.
That being said, I think having all the scripting stuff together is good as well and the above only a repeat.
BTW, the value of a Digital Input is read/write which is fine because you can control the flow (like overriding a Float with a button) with scripting as well as the Physical Element Interface:
In your manual. Somewhat True except you can control via scripting:
Digital Inputs have no User Control, as they are read-only Elements