All property types have a 'nick' and a 'blurb' attribute and you should
set those accordingly. This will make runtime querying the object
nicer as things such as gui editors and class browsers can be more
-verbose about the class itself. Almost all types also have a
-'default_value'
-attribute which sets the initial value of this property (on object
-initialization, the set handler will be run automatically with this
-value).
+verbose about the class itself. You can use the '_("string")' notation
+instead of just "string", and that will mark the string for translation.
+.PP
+Almost all types also have a 'default_value' attribute which sets the initial
+value of this property (on object initialization, the set handler will be run
+automatically with this value). This value will be overriden if the user
+sets a value of this property on the call to g_object_new.
.PP
All the numeric types (including CHAR) have 'minimum' and 'maximum'
attributes which can restrict the range. If you do not specify these
you will need to specify the 'boxed_type' attribute with the specific
type of the boxed pointer.
.PP
-There is also a POINTER type, which has only the nick and blurb
+There is also a POINTER type, which has only the 'nick' and 'blurb'
attributes. This is for storing arbitrary pointers. You should be
careful with this one, as GObject knows nothing about the data
stored at this pointer. It is somewhat like a 'void *' type.