+2004-03-30 Thomas Vander Stichele <thomas at apestaart dot org>
+
+ * gst/gstcaps.c:
+ * gst/gstelement.c:
+ * gst/gstelementfactory.c: (gst_element_factory_get_type):
+ * gst/gstindex.c: (gst_index_resolver_get_type),
+ (gst_index_get_type), (gst_index_factory_get_type):
+ * gst/gstinfo.c:
+ * gst/gstpad.c:
+ * gst/gstplugin.c:
+ * gst/gsturi.c: (gst_uri_handler_get_type):
+ * gst/gstvalue.c:
+ first batch of documentation fixes
+
2004-03-29 David Schleef <ds@schleef.org>
* docs/gst/Makefile.am: Disable a bunch of headers from being scanned
<!-- ##### SECTION Title ##### -->
-GstUtils
+gstutils
<!-- ##### SECTION Short_Description ##### -->
-Utility functions
+
<!-- ##### SECTION Long_Description ##### -->
<para>
-Some convenience functions
+
</para>
+
<!-- ##### SECTION See_Also ##### -->
<para>
</para>
+
<!-- ##### FUNCTION gst_util_set_value_from_string ##### -->
<para>
@type_as_function:
@parent_type:
@\
- parent_type_macro:
-@\
- parent_type_macro:
-@\
- parent_type_macro:
-@\
- parent_type_macro:
-@\
- parent_type_macro:
-@\
- parent_type_macro:
-@\
- parent_type_macro:
-@\
- parent_type_macro:
-@\
- parent_type_macro:
-@\
- parent_type_macro:
-@\
- parent_type_macro:
-@\
- parent_type_macro:
-@\
- parent_type_macro:
-@\
- parent_type_macro:
-@\
- parent_type_macro:
-@\
- parent_type_macro:
-@\
- parent_type_macro:
-@\
- parent_type_macro:
-@\
- parent_type_macro:
-@\
- parent_type_macro:
-@\
- parent_type_macro:
-@\
- parent_type_macro:
-@\
- parent_type_macro:
-@\
- parent_type_macro:
-@\
- parent_type_macro:
-@\
- parent_type_macro:
-@\
- parent_type_macro:
-@\
- parent_type_macro:
-@\
- parent_type_macro:
-@\
- parent_type_macro:
-@\
- parent_type_macro:
-@\
- parent_type_macro:
-@\
- parent_type_macro:
-@\
- parent_type_macro:
-@\
- parent_type_macro:
-@\
- parent_type_macro:
-@\
- parent_type_macro:
-@\
- parent_type_macro:
-@\
- parent_type_macro:
-@\
- parent_type_macro:
-@\
- parent_type_macro:
-@\
- parent_type_macro:
-@\
- parent_type_macro:
-@\
- parent_type_macro:
-@\
- parent_type_macro:
-@\
parent_type_macro:
@additional_initializations:
</para>
-@:
-@:
-@:
-
@gstxml: the object which received the signal.
@arg1:
@arg2:
</para>
-@gstxml: the object which received the signal.
-@arg1:
-@arg2:
+@:
+@:
+@:
* @message: an allocated message to be used as a replacement for the default
* message connected to code, or NULL
* @debug: an allocated debug message to be used as a replacement for the
- * default debugging information, or NULL
- * @file: source filename
- * @function: source function
- * @line: source line
+ * default debugging information, or NULL
+ * @file: the source code file where the error was generated
+ * @function: the source code function where the error was generated
+ * @line: the source code line where the error was generated
*
* Signals an error condition on an element.
* This function is used internally by elements.
/**
* gst_element_register:
- * @plugin:
+ * @plugin: #GstPlugin to register the element with
* @name: name of elements of this type
* @rank: rank of element (higher rank means more importance when autoplugging)
* @type: GType of element to register
*
- * Create a new elementfactory capable of insantiating objects of the
+ * Create a new elementfactory capable of instantiating objects of the
* given type.
*
* Returns: TRUE, if the registering succeeded, FALSE on error
*
* Copies an entry and returns the result.
*
- * Returns:
+ * Returns: a newly allocated #GstIndexEntry.
*/
GstIndexEntry *
gst_index_entry_copy (GstIndexEntry * entry)
* gst_debug_message_get:
* @message: a debug message
*
- * Gets the string representation of a GstDebugMessage. This function is used
+ * Gets the string representation of a #GstDebugMessage. This function is used
* in debug handlers to extract the message.
*
- * Returns: the string representation
+ * Returns: the string representation of a #GstDebugMessage.
*/
const gchar *
gst_debug_message_get (GstDebugMessage * message)
/**
* gst_pad_proxy_pad_link:
- * @pad: a #GstPad to proxy.
+ * @pad: a #GstPad to proxy from
* @caps: the #GstCaps to link with
*
* Calls gst_pad_try_set_caps() for every other pad belonging to the
/**
* gst_pad_alloc_buffer:
- * @pad: a source #GstPad.
+ * @pad: a source #GstPad
* @offset: the offset of the new buffer in the stream
* @size: the size of the new buffer
*
/**
* gst_plugin_load_file:
- * @filename: The file to load
- * @error: Pointer to a NULL-valued GError.
+ * @filename: the plugin filename to load
+ * @error: pointer to a NULL-valued GError
*
- * Load the given plugin.
+ * Loads the given plugin.
*
* Returns: a new GstPlugin or NULL, if an error occurred.
*/
/**
* gst_value_list_get_value:
* @value: a GstValueList
- * @index: the index
+ * @index: index of value to get from the list
*
* Gets the value that is a member of the list contained in @value and
* has the index @index.
/* intersection */
-/**
+/*
* gst_value_can_intersect:
* @value1:
* @value2:
g_array_append_val (gst_value_intersect_funcs, intersect_info);
}
-/**
+/*
* gst_value_register:
* @table:
*
g_array_append_val (gst_value_table, *table);
}
-/**
+/*
* gst_value_init_and_copy:
* @dest:
* @src:
g_value_copy (src, dest);
}
-/**
+/*
* gst_value_serialize:
* @value:
*
return s;
}
-/**
+/*
* gst_value_deserialize:
* @dest:
* @src: