Documentation Errors

[tgochenour]

1) The function DataSource.xmlSerialize() claims to return type void. It appears to return a string.

2) The function Canvas.dynamicContentsVars() has an example where the contents is "Hello " and I think it should be "Hello ${this.name}"

[Isomorphic]

Thanks - both fixed now. For #2, it's actually "Hello ${name}".

By the way, notice that our template syntax (unfortunately) matches the JSP EL variable reference. This is actually one of the reasons behind the global disabling of EL in our runtime war.xml (which has now been fixed, by the way).

So be careful when you use this syntax in EL-enabled JSPs as you might get conflicts with the JSP's interpretation...

[tgochenour]

3) DataSourceField.valueXPath

"For JSON data (dataFormat:"xml"), this means a call to XMLTools.selectObjects() passing the selected JSON object."

Shouldn't this be (dataFormat:"json")

???

[Isomorphic]

Quite right, thank you, that's been fixed now.

[tgochenour]

4) class LayoutSpacerextends Canvas

Add a LayoutSpacer to a Layout to take up space just like a normal member, without actually drawing anything. Semantically equivalent to using an empty canvas, but higher performance for this particular use case.

DEPRECATED: As of Isomorphic SmartClient version 5.5, autoFit behavior can be achieved using the Button class instead by setting the property Button.autoFit to true.


-----

The deprecation regarding Button.autoFit seems misplaced.

-----

Found the same deprecation on Window.

[Isomorphic]

Thanks for pointing this out.
This is actually a bug in the document viewer - having viewed a deprecated property (like the auto-fit button), we're not clearing the deprecated warning message when showing another class.

This will be fixed for our next release.