BUG DESCRIPTION:
----------------
The documentation page of set() is a bag of inconsistencies, abstruse things, or things that do not actually work.
Examples:
1) Nowhere in the page the first instruction of the example
clf, set("auto_resize", "off")
is documented. The case set(prop, value) is not described. The fact that the default h is gce() (is it?) is not documented.
2) The special syntaxes with "current_entity", "current_figure", "current_axes", "default_values" are not in the syntax list.
They should be so. Indeed, they are puzzling, since the "pseudo property" is in arg #1 while the handle is in arg #2.
This is just the opposite of all the regular set(h,prop) and set(h,prop,val) documented syntaxes
3) The documented syntax set("default_values",gdf()) fails. Editing sdf() shows that the working syntax is
set(gdf(), "default_values", anyValueThatISActuallyIgnored)
If we try only set(gdf(), "default_values"), we get a puzzling error message:
set: Wrong size for input argument #1: A single string expected.
And then when we try to put the "pseudo-property" in argin #1, we get
--> set("default_values", gdf())
Wrong type for 'default_values' property: Real expected.
Then, if we are not yet completely lost...
4) the page fails emphasizing cases that can be managed more simply with the direct h.prop=val syntax:
- the list of syntaxes misses set(h, prop1,val1, prop2,val2, ..)
- there is no example with this syntax
...
HOW TO REPRODUCE THE BUG:
-------------------------
https://help.scilab.org/docs/6.0.1/en_US/set.html
OTHER INFORMATION:
------------------
I am aiming to overhaul this page.