P: SDK: Documentation for "bind_to_object" and "key" properties incorrect

[johnrellis]

Most of the documentation for the LrView "bind_to_object" and "key" properties is incorrect and omits important information.  From the LR 14.3 SDK:

API Reference

LrView.bind() says in multiple places "bind_to_object" is a string. But in fact it is an observable table returned by LrBinding.makePropertyTable().

LrView.bind() omits the following about "key":  A key name for the observed property. If "key" is of the form "x.y", then it refers to the key "y" in the table bound to key "y" in the current bound table.  Are multiple dots allowed, e.g. "x.y.z"?

LrBinding.andAllKeys() and LrBinding.orAllKeys() say "bind_to_object" is a string, but it is in fact a table as specified in LrView.bind().

LrBinding: Can the various instances of "key" be in in hierarchical form, as in LrView.bind()?  

Lightroom Classic SDK Guide

Page 105: Says "bind_to_object:  Optional. The name of an observable table which overrides the value of the property." This is incorrect -- it is an observable table returned by LrBinding.makePropertyTable().

Page 107: Says "bind_to_object or object: Optional. The name of an observable table..." This is incorrect -- it is an observable table returned by LrBinding.makePropertyTable().

* * *

See also this previous bug report, which fixed one instance of missing information but not everything listed above:

https://community.adobe.com/t5/lightroom-classic-bugs/p-sdk-lrview-bind-key-fails-when-quot-key-quot...

[Rikk Flohr: Photography]

Thanks, @johnrellis  I will get it logged for a future SDK documentation update.