remove trailing whitespace from newly added gtk-doc comments and

2008-06-22  Michael Natterer  <mitch@imendio.com>

	* *.c: remove trailing whitespace from newly added gtk-doc
	comments and reformatted some where they contained overly long or
	ill-formatted lines.


svn path=/trunk/; revision=7090
This commit is contained in:
Michael Natterer
2008-06-22 14:53:09 +00:00
committed by Michael Natterer
parent 5602b7e275
commit 6347be5fb6
16 changed files with 1225 additions and 1098 deletions

View File

@@ -32,8 +32,9 @@
/**
* SECTION:gboxed
*
* @Short_description: A mechanism to wrap opaque C structures registered
* by the type system
* by the type system
*
* @See_also: #GParamSpecBoxed, g_param_spec_boxed()
*
@@ -114,7 +115,7 @@ value_free (gpointer boxed)
}
void
g_boxed_type_init (void)
g_boxed_type_init (void)
{
static const GTypeInfo info = {
0, /* class_size */
@@ -372,11 +373,11 @@ boxed_proxy_lcopy_value (const GValue *value,
* @name: Name of the new boxed type.
* @boxed_copy: Boxed structure copy function.
* @boxed_free: Boxed structure free function.
*
*
* This function creates a new %G_TYPE_BOXED derived type id for a new
* boxed type with name @name. Boxed type handling functions have to be
* provided to copy and free opaque boxed structures of this type.
*
*
* Returns: New %G_TYPE_BOXED derived type id for @name.
*/
GType
@@ -465,7 +466,7 @@ g_boxed_copy (GType boxed_type,
else
{
GValue src_value, dest_value;
/* we heavily rely on third-party boxed type value vtable
* implementations to follow normal boxed value storage
* (data[0].v_pointer is the boxed struct, and
@@ -500,7 +501,7 @@ g_boxed_copy (GType boxed_type,
* g_boxed_free:
* @boxed_type: The type of @boxed.
* @boxed: The boxed structure to be freed.
*
*
* Free the boxed structure @boxed which is of type @boxed_type.
*/
void
@@ -540,9 +541,9 @@ g_boxed_free (GType boxed_type,
/**
* g_value_get_boxed:
* @value: a valid #GValue of %G_TYPE_BOXED derived type
*
*
* Get the contents of a %G_TYPE_BOXED derived #GValue.
*
*
* Returns: boxed contents of @value
*/
gpointer
@@ -557,11 +558,12 @@ g_value_get_boxed (const GValue *value)
/**
* g_value_dup_boxed:
* @value: a valid #GValue of %G_TYPE_BOXED derived type
*
* Get the contents of a %G_TYPE_BOXED derived #GValue.
* Upon getting, the boxed value is duplicated and needs to be
* later freed with g_boxed_free(), e.g. like: g_boxed_free (G_VALUE_TYPE (@value), return_value);
*
*
* Get the contents of a %G_TYPE_BOXED derived #GValue. Upon getting,
* the boxed value is duplicated and needs to be later freed with
* g_boxed_free(), e.g. like: g_boxed_free (G_VALUE_TYPE (@value),
* return_value);
*
* Returns: boxed contents of @value
*/
gpointer
@@ -620,7 +622,7 @@ value_set_boxed_internal (GValue *value,
* g_value_set_boxed:
* @value: a valid #GValue of %G_TYPE_BOXED derived type
* @v_boxed: boxed value to be set
*
*
* Set the contents of a %G_TYPE_BOXED derived #GValue to @v_boxed.
*/
void
@@ -637,7 +639,7 @@ g_value_set_boxed (GValue *value,
* g_value_set_static_boxed:
* @value: a valid #GValue of %G_TYPE_BOXED derived type
* @v_boxed: static boxed value to be set
*
*
* Set the contents of a %G_TYPE_BOXED derived #GValue to @v_boxed.
* The boxed value is assumed to be static, and is thus not duplicated
* when setting the #GValue.
@@ -656,9 +658,9 @@ g_value_set_static_boxed (GValue *value,
* g_value_set_boxed_take_ownership:
* @value: a valid #GValue of %G_TYPE_BOXED derived type
* @v_boxed: duplicated unowned boxed value to be set
*
*
* This is an internal function introduced mainly for C marshallers.
*
*
* Deprecated: 2.4: Use g_value_take_boxed() instead.
*/
void
@@ -672,11 +674,11 @@ g_value_set_boxed_take_ownership (GValue *value,
* g_value_take_boxed:
* @value: a valid #GValue of %G_TYPE_BOXED derived type
* @v_boxed: duplicated unowned boxed value to be set
*
* Sets the contents of a %G_TYPE_BOXED derived #GValue to @v_boxed and
* takes over the ownership of the callers reference to @v_boxed;
*
* Sets the contents of a %G_TYPE_BOXED derived #GValue to @v_boxed
* and takes over the ownership of the callers reference to @v_boxed;
* the caller doesn't have to unref it any more.
*
*
* Since: 2.4
*/
void