gama-platform / gama-platform.github.io

Repository for the website of GAMA
https://gama-platform.github.io/
GNU General Public License v3.0
4 stars 2 forks source link

Some operator definitions are missing #129

Open lesquoyb opened 1 year ago

lesquoyb commented 1 year ago

Describe the bug Some operators/statements with multiple definitions are missing one (or more?) of those definitions. One example was given in this discussion, but I'm sure I already encountered other cases though didn't take the time to write them down.

To reproduce

  1. got to to_rectangles documentation
  2. see that the definition of to_rectangles (geometry, point) ---> list<geometry> is not present though it is available in gama

Additional context Looking at the code of the operator, my guess would be that at the generation of the documentation only the first element of the value array is taken into account.

benoitgaudou commented 1 year ago

In fact, when we have a case where the same method can be called from 2 different operators, the documentation is generated only for the first one, and in the second one there is only a reference to the first one (see any and one_of).

In the case of to_rectangles, we have an unexpected mix between common definition with split_geometry and independent definition...

lesquoyb commented 1 year ago

Is there a way to fix it so we have the definitions for both split_geometry and to_rectangles ? I also see in the examples of split_geometry that there's a third one: to_squares that is not even referenced. Makes me think that for gama 2 we may need to find a better way to define alternative names for operators