2.17.1
[platform/upstream/glib.git] / docs / reference / gobject / tmpl / gparamspec.sgml
index eb90ffd..cebf58e 100644 (file)
@@ -149,9 +149,10 @@ can be configured.
                          parameter is guaranteed to remain valid and
                          unmodified for the lifetime of the parameter. 
                          Since 2.8
+@G_PARAM_PRIVATE: 
 @G_PARAM_STATIC_NICK:    the string used as nick when constructing the
                          parameter is guaranteed to remain valid and
-                         unmodified for the lifetime of the parameter.
+                         unmmodified for the lifetime of the parameter.
                          Since 2.8
 @G_PARAM_STATIC_BLURB:   the string used as blurb when constructing the 
                          parameter is guaranteed to remain valid and 
@@ -165,6 +166,15 @@ can be configured.
 
 
 
+<!-- ##### MACRO G_PARAM_STATIC_STRINGS ##### -->
+<para>
+#GParamFlags value alias for %G_PARAM_STATIC_NAME | %G_PARAM_STATIC_NICK | %G_PARAM_STATIC_BLURB.
+
+Since 2.13.0
+</para>
+
+
+
 <!-- ##### MACRO G_PARAM_MASK ##### -->
 <para>
 Mask containing the bits of #GParamSpec.flags which are reserved for GLib.
@@ -376,7 +386,7 @@ returns that paramspec. Redirect is used typically for
 providing a new implementation of a property in a derived
 type while preserving all the properties from the parent
 type. Redirection is established by creating a property
-of type #GParamSpecOverride. See g_object_override_property()
+of type #GParamSpecOverride. See g_object_class_override_property()
 for an example of the use of this capability.
 </para>
 
@@ -401,6 +411,13 @@ When creating and looking up a #GParamSpec, either separator can be used,
 but they cannot be mixed. Using '-' is considerably more efficient and in 
 fact required when using property names as detail strings for signals.
 </para>
+<para>
+Beyond the name, #GParamSpec<!-- -->s have two more descriptive strings 
+associated with them, the @nick, which should be suitable for use as 
+a label for the property in a property editor, and the @blurb, which should
+be a somewhat longer description, suitable for e.g. a tooltip. The @nick
+and @blurb should ideally be localized.
+</para>
 
 @param_type: the #GType for the property; must be derived from #G_TYPE_PARAM
 @name: the canonical name of the property