Cosmetic rearrangement

gobject/gboxed.h

@@ -33,7 +33,8 @@ G_BEGIN_DECLS
  * G_VALUE_HOLDS_BOXED:
  * @value: a valid #GValue structure
  *
- * Checks whether the given #GValue can hold values derived from type %G_TYPE_BOXED.
+ * Checks whether the given #GValue can hold values derived
+ * from type %G_TYPE_BOXED.
  *
  * Returns: %TRUE on success.
  */
@@ -45,8 +46,8 @@ G_BEGIN_DECLS
  * GBoxedCopyFunc:
  * @boxed: The boxed structure to be copied.
  *
- * This function is provided by the user and should produce a copy of the passed
+ * This function is provided by the user and should produce a copy
- * in boxed structure.
+ * of the passed in boxed structure.
  *
  * Returns: The newly created copy of the boxed structure.
  */
@@ -71,6 +72,12 @@ void		g_value_set_boxed		(GValue		*value,
                                            gconstpointer  v_boxed);
 void     g_value_set_static_boxed         (GValue        *value,
                                            gconstpointer  v_boxed);
+void     g_value_take_boxed               (GValue        *value,
+                                           gconstpointer  v_boxed);
+#ifndef G_DISABLE_DEPRECATED
+void     g_value_set_boxed_take_ownership (GValue        *value,
+                                           gconstpointer  v_boxed);
+#endif
 gpointer g_value_get_boxed                (const GValue  *value);
 gpointer g_value_dup_boxed                (const GValue  *value);
 
@@ -88,6 +95,7 @@ GType	g_boxed_type_register_static		(const gchar	*name,
  * The #GType for #GClosure.
  */
 #define G_TYPE_CLOSURE (g_closure_get_type ())
+
 /**
  * G_TYPE_VALUE:
  *
@@ -95,6 +103,7 @@ GType	g_boxed_type_register_static		(const gchar	*name,
  * used to pass around pointers to GValues.
  */
 #define G_TYPE_VALUE (g_value_get_type ())
+
 /**
  * G_TYPE_VALUE_ARRAY:
  *
@@ -102,12 +111,14 @@ GType	g_boxed_type_register_static		(const gchar	*name,
  * used to pass around pointers to GValueArrays.
  */
 #define G_TYPE_VALUE_ARRAY (g_value_array_get_type ())
+
 /**
  * G_TYPE_DATE:
  *
  * The #GType for #GDate.
  */
 #define G_TYPE_DATE (g_date_get_type ())
+
 /**
  * G_TYPE_STRV:
  *
@@ -126,26 +137,26 @@ GType	g_boxed_type_register_static		(const gchar	*name,
  *                                                      G_TYPE_STRV,
  *                                                      G_PARAM_READWRITE));
  *
- * 
  * gchar *authors[] = { "Owen", "Tim", NULL };
  * g_object_set (obj, "authors", authors, NULL);
  *
- * 
  * gchar *writers[];
  * g_object_get (obj, "authors", &writers, NULL);
- * // do something with writers
+ * /* do something with writers */
  * g_strfreev (writers);
  * ]|
  *
  * Since: 2.4
  */
 #define G_TYPE_STRV (g_strv_get_type ())
+
 /**
  * G_TYPE_GSTRING:
  *
  * The #GType for #GString.
  */
 #define G_TYPE_GSTRING (g_gstring_get_type ())
+
 /**
  * G_TYPE_HASH_TABLE:
  *
@@ -154,6 +165,7 @@ GType	g_boxed_type_register_static		(const gchar	*name,
  * Since: 2.10
  */
 #define G_TYPE_HASH_TABLE (g_hash_table_get_type ())
+
 /**
  * G_TYPE_REGEX:
  *
@@ -162,6 +174,7 @@ GType	g_boxed_type_register_static		(const gchar	*name,
  * Since: 2.14
  */
 #define G_TYPE_REGEX (g_regex_get_type ())
+
 /**
  * G_TYPE_ARRAY:
  *
@@ -170,6 +183,7 @@ GType	g_boxed_type_register_static		(const gchar	*name,
  * Since: 2.22
  */
 #define G_TYPE_ARRAY (g_array_get_type ())
+
 /**
  * G_TYPE_BYTE_ARRAY:
  *
@@ -178,6 +192,7 @@ GType	g_boxed_type_register_static		(const gchar	*name,
  * Since: 2.22
  */
 #define G_TYPE_BYTE_ARRAY (g_byte_array_get_type ())
+
 /**
  * G_TYPE_PTR_ARRAY:
  *
@@ -186,6 +201,7 @@ GType	g_boxed_type_register_static		(const gchar	*name,
  * Since: 2.22
  */
 #define G_TYPE_PTR_ARRAY (g_ptr_array_get_type ())
+
 /**
  * G_TYPE_VARIANT_TYPE:
  *
@@ -194,6 +210,7 @@ GType	g_boxed_type_register_static		(const gchar	*name,
  * Since: 2.24
  */
 #define G_TYPE_VARIANT_TYPE (g_variant_type_get_gtype ())
+
 /**
  * G_TYPE_ERROR:
  *
@@ -202,6 +219,7 @@ GType	g_boxed_type_register_static		(const gchar	*name,
  * Since: 2.26
  */
 #define G_TYPE_ERROR (g_error_get_type ())
+
 /**
  * G_TYPE_DATE_TIME:
  *
@@ -211,12 +229,6 @@ GType	g_boxed_type_register_static		(const gchar	*name,
  */
 #define G_TYPE_DATE_TIME (g_date_time_get_type ())
 
-void    g_value_take_boxed      (GValue		*value,
-				 gconstpointer	 v_boxed);
-#ifndef G_DISABLE_DEPRECATED
-void	g_value_set_boxed_take_ownership	(GValue		*value,
-						 gconstpointer	 v_boxed);
-#endif
 GType   g_closure_get_type       (void) G_GNUC_CONST;
 GType   g_value_get_type         (void) G_GNUC_CONST;
 GType   g_value_array_get_type   (void) G_GNUC_CONST;