Open ypiguet-epfl opened 6 years ago
The description in the vm are small reminder to have them dynamically listed. A more detail description is in the help of the asebastudio. It is also now in https://github.com/aseba-community/aseba/blob/master/docs/en/aseba-std-natives.rst that could be included in helps of different programms. I agree that the vm description is perhaps ambiguous but it has to be short.
I just read the function description display in studio. I just found math.add that is not crystal clear: "adds src1 and src2 to dest, element by element" -> probably the function should been have called math.sum. There is two possibilities:
Sum is a bad name here because it is commonly assumed to mean "sum all elements together". What about: "adds src1 and src2, write to dest, element by element"
for me it's ok
In the function descriptions in aseba/native.c, the role of arguments isn't always stated clearly. For instance for
math.add
, the description reads adds src1 and src2 to dest, element by element while the element-wise sum ofsrc1
andsrc2
is stored intodest
, not added todest
.Suggestion: revise all native function descriptions, and store them in programming documentation, neither in the vm nor elsewhere in the robot firmware.