Please document that primitive types can/should be used directly (unlike GLib.List etc.)
I just got caught out by the fact that this is different from GLib containers, where you specifically need to box primitive types in GLib.List
, for example. It would be good to have a note on Gee.List
, Gee.Entry
and perhaps most of all add a note to https://wiki.gnome.org/Projects/Vala/GeeSamples where it says:
You can use any type fitting into the size of a pointer (e.g. int, bool, reference types) directly as generic type argument: <bool>, <int>, <string>, <MyObject>. Other types must be "boxed" by appending a question mark: <float?>, <double?>, <MyStruct?>. The compiler will tell you this if necessary.
It would be good to add "N.B. This is different from GLib.List
and similar!"
This is not really a problem with libgee, of course, but I think other programmers who have previously used GLib might be confused by this difference.