gparamspecs: Recommend use of most specific GParamSpec types
authorPhilip Withnall <philip.withnall@collabora.co.uk>
Thu, 18 Dec 2014 11:23:05 +0000 (11:23 +0000)
committerPhilip Withnall <philip.withnall@collabora.co.uk>
Tue, 3 Mar 2015 18:40:33 +0000 (18:40 +0000)
commitc639b628ec425ac28b79bd48c703fc7115b1fc97
treec164896d2bb528f21c706c56215d6d6b3fe252fc
parent430814992ddefae2588ae12e4d6aa4d66ed23461
gparamspecs: Recommend use of most specific GParamSpec types

It’s quite common to see a g_param_spec_pointer() used for GObject or
boxed types which, while not incorrect, does make memory management
unsafe, since no copying or reference counting can be performed
automatically.

Similarly, people often use g_param_spec_boolean() when an enum would be
more appropriate, cf.
    http://blog.ometer.com/2011/01/20/boolean-parameters-are-wrong/
Using enums also means that the set of allowable values can be extended
in future if needed.

In the hope that people who write code like that read the documentation,
mention the more specific types in the documentation.

https://bugzilla.gnome.org/show_bug.cgi?id=741779
gobject/gparamspecs.c