Re: (allow-none) for properties



15/05/13 21:24, Nikita Churaev wrote:
Do I have to mark properties that allow NULL strings or objects with
(allow-none)?

Not according to the official description of introspection annotations:
https://live.gnome.org/GObjectIntrospection/Annotations

However, if the gtk-doc parser doesn't trip over such annotations, it seems a good idea to include them for documentation purposes. In future they may even be supported. Others have clearly wanted to support this:
https://bugzilla.gnome.org/show_bug.cgi?id=669640
https://bugzilla.gnome.org/show_bug.cgi?id=672612
Generally the discussion on allow-none has extended to out/inout parameters and return values too:
https://bugzilla.gnome.org/show_bug.cgi?id=626395
https://bugzilla.gnome.org/show_bug.cgi?id=660879



[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]