docs: Fix documentation typos and inconsistencies
authorSebastian Rasmussen <sebras@hotmail.com>
Sat, 5 Jul 2014 16:29:29 +0000 (18:29 +0200)
committerSebastian Dröge <sebastian@centricular.com>
Wed, 9 Jul 2014 07:22:11 +0000 (09:22 +0200)
 * GstGlobalDeviceMonitor was renamed to GstDeviceMonitor
 * Expand GST_MESSAGE_DEVICE to the full enum value names
 * Correct the incorrect references to the GstDeviceProvider interfaces
 * Describe caps arguments for gstcheck interface
 * Add missing docs for GstNetAddressMeta and its add function
 * Add docs for toc helper macros
 * Avoid refering to GstValueList type as done elsewhere

Fixes https://bugzilla.gnome.org/show_bug.cgi?id=732786

docs/libs/gstreamer-libs-docs.sgml
docs/libs/gstreamer-libs-sections.txt
gst/gstcaps.h
gst/gstdevice.c
gst/gstdeviceprovider.c
gst/gstdeviceproviderfactory.c
gst/gsttoc.h
gst/gstvalue.c
libs/gst/check/gstcheck.c
libs/gst/net/gstnetaddressmeta.c
libs/gst/net/gstnetaddressmeta.h

index ce876958124f31f7428acf45ae974e01f3a834e6..0070771da64f7c4656fe6aaec6195d6b51100fc5 100644 (file)
@@ -72,6 +72,7 @@
         libgstnet-&GST_API_VERSION;.so provides network elements and objects.
       </para>
 
+      <xi:include href="xml/gstnetaddressmeta.xml" />
       <xi:include href="xml/gstnetclientclock.xml" />
       <xi:include href="xml/gstnettimepacket.xml" />
       <xi:include href="xml/gstnettimeprovider.xml" />
index 2fb070186ea2a84295186e605c9ac89507bc8efc..83b19db701a1cebeb73e2129cf9f024530af7419 100644 (file)
@@ -978,6 +978,10 @@ gst_check_element_push_buffer
 gst_check_run_suite
 gst_check_setup_events
 gst_check_setup_events_with_stream_id
+gst_check_setup_sink_pad_by_name_from_template
+gst_check_setup_sink_pad_from_template
+gst_check_setup_src_pad_by_name_from_template
+gst_check_setup_src_pad_from_template
 
 <SUBSECTION Private>
 MAIN_INIT
index 2acf84cb444dd156f7c9f7b35de16be8ea19d6ae..4b09b8eb74ced918db6a002a4f144c680b482eee 100644 (file)
@@ -291,14 +291,14 @@ gst_caps_copy (const GstCaps * caps)
  * @old_caps: (inout) (transfer full) (nullable): pointer to a pointer
  *     to a #GstCaps to be replaced.
  * @new_caps: (transfer none) (allow-none): pointer to a #GstCaps that will
- *     replace the caps pointed to by @ocaps.
+ *     replace the caps pointed to by @old_caps.
  *
  * Modifies a pointer to a #GstCaps to point to a different #GstCaps. The
  * modification is done atomically (so this is useful for ensuring thread safety
  * in some cases), and the reference counts are updated appropriately (the old
  * caps is unreffed, the new is reffed).
  *
- * Either @ncaps or the #GstCaps pointed to by @ocaps may be %NULL.
+ * Either @new_caps or the #GstCaps pointed to by @old_caps may be %NULL.
  *
  * Returns: %TRUE if @new_caps was different from @old_caps
  */
@@ -317,7 +317,7 @@ gst_caps_replace (GstCaps **old_caps, GstCaps *new_caps)
  * @old_caps: (inout) (transfer full): pointer to a pointer to a #GstCaps to be
  *     replaced.
  * @new_caps: (transfer full) (allow-none): pointer to a #GstCaps that will
- *     replace the caps pointed to by @ocaps.
+ *     replace the caps pointed to by @old_caps.
  *
  * Modifies a pointer to a #GstCaps to point to a different #GstCaps. This
  * function is similar to gst_caps_replace() except that it takes ownership
index 1237dcac6d83aca7747445c671338406e1b7d1e1..6274c93af6b7814249ff0bd5b4aad6ec5187d1eb 100644 (file)
@@ -29,7 +29,7 @@
  * representing the media types it can produce or handle.
  *
  * #GstDevice are created by #GstDeviceProvider objects which can be
- * aggregated by #GstGlobalDeviceMonitor objects.
+ * aggregated by #GstDeviceMonitor objects.
  *
  * Since: 1.4
  */
index 963a68377cc486326a37bf0e9834cde650e9e011..8ad737cd415649178fc3d7e5798ec8b2dff0980f 100644 (file)
@@ -380,9 +380,9 @@ gst_device_provider_get_devices (GstDeviceProvider * provider)
  * gst_device_provider_start:
  * @provider: A #GstDeviceProvider
  *
- * Starts providering the devices. This will cause #GST_MESSAGE_DEVICE messages
- * to be posted on the provider's bus when devices are added or removed from
- * the system.
+ * Starts providering the devices. This will cause #GST_MESSAGE_DEVICE_ADDED
+ * and #GST_MESSAGE_DEVICE_REMOVED messages to be posted on the provider's bus
+ * when devices are added or removed from the system.
  *
  * Since the #GstDeviceProvider is a singleton,
  * gst_device_provider_start() may already have been called by another
index 3f38f064450e9c45a61c5dddeb106a273cb95d08..a28a0bd53ac37c4f045bd59de5140266a80bcd79 100644 (file)
@@ -31,8 +31,8 @@
  * #GstPluginFeature.
  *
  * Use the gst_device_provider_factory_find() and
- * gst_device_provider_factory_create() functions to create device
- * provider instances or use gst_device_provider_factory_make() as a
+ * gst_device_provider_factory_get() functions to create device
+ * provider instances or use gst_device_provider_factory_get_by_name() as a
  * convenient shortcut.
  *
  * Since: 1.4
index 39469c188508d71f70fb8315ff65e65f27426e6f..cb778629824a5e487e8bd8a5eb30c0630114ad7c 100644 (file)
@@ -81,7 +81,20 @@ typedef enum {
   GST_TOC_ENTRY_TYPE_CHAPTER     = 3,
 } GstTocEntryType;
 
+/**
+ * GST_TOC_ENTRY_TYPE_IS_ALTERNATIVE:
+ * @entry_type: The #GstTocEntryType from a #GstTocEntry
+ *
+ * Checks if @entry_type indicates that its #GstTocEntry is an alternative.
+ */
 #define GST_TOC_ENTRY_TYPE_IS_ALTERNATIVE(entry_type)  (entry_type < 0)
+
+/**
+ * GST_TOC_ENTRY_TYPE_IS_SEQUENCE:
+ * @entry_type: The #GstTocEntryType from a #GstTocEntry
+ *
+ * Checks if @entry_type indicates that its #GstTocEntry is a sequence.
+ */
 #define GST_TOC_ENTRY_TYPE_IS_SEQUENCE(entry_type)     (entry_type > 0)
 
 /**
index 77e6fa10b2a6fb30fd77f901844c8f2ee15dbbf5..964431c82a7bc12cf252fa6672a7dd04b3be5b68 100644 (file)
@@ -4637,7 +4637,7 @@ gst_value_compare_with_func (const GValue * value1, const GValue * value2,
  *
  * Determines if @value1 and @value2 can be non-trivially unioned.
  * Any two values can be trivially unioned by adding both of them
- * to a #GstValueList.  However, certain types have the possibility
+ * to a GstValueList.  However, certain types have the possibility
  * to be unioned in a simpler way.  For example, an integer range
  * and an integer can be unioned if the integer is a subset of the
  * integer range.  If there is the possibility that two values can
index 7589ce152b3ca4a09f8d240fca37d0680c667c60..e92f4c89bc4903db8c36aaa5878918446618975a 100644 (file)
@@ -547,14 +547,16 @@ buffer_event_function (GstPad * pad, GstObject * noparent, GstEvent * event)
  * @element_name: name of the element that needs to be created
  * @buffer_in: (element-type GstBuffer) (transfer full): a list of buffers that needs to be
  *  pushed to the element
+ * @caps_in: the #GstCaps expected of the sinkpad of the element
  * @buffer_out: (element-type GstBuffer) (transfer full): a list of buffers that we expect from
  * the element
+ * @caps_out: the #GstCaps expected of the srcpad of the element
  * @last_flow_return: the last buffer push needs to give this GstFlowReturn
  *
- * Create an @element with the factory with the name and push the buffers in
- * @buffer_in to this element. The element should create the buffers equal to
- * the buffers in @buffer_out. We only check the caps, size and the data of the
- * buffers. This function unrefs the buffers in the two lists.
+ * Create an element using the factory providing the @element_name and push the
+ * buffers in @buffer_in to this element. The element should create the buffers
+ * equal to the buffers in @buffer_out. We only check the size and the data of
+ * the buffers. This function unrefs the buffers in the two lists.
  * The last_flow_return parameter indicates the expected flow return value from
  * pushing the final buffer in the list.
  * This can be used to set up a test which pushes some buffers and then an
@@ -694,10 +696,12 @@ gst_check_element_push_buffer_list (const gchar * element_name,
  * gst_check_element_push_buffer:
  * @element_name: name of the element that needs to be created
  * @buffer_in: push this buffer to the element
+ * @caps_in: the #GstCaps expected of the sinkpad of the element
  * @buffer_out: compare the result with this buffer
+ * @caps_out: the #GstCaps expected of the srcpad of the element
  *
- * Create an @element with the factory with the name and push the
- * @buffer_in to this element. The element should create one buffer
+ * Create an element using the factory providing the @element_name and
+ * push the @buffer_in to this element. The element should create one buffer
  * and this will be compared with @buffer_out. We only check the caps
  * and the data of the buffers. This function unrefs the buffers.
  */
index 164ce4fa6c41c756089a2e8b9172d954fedff9e9..2c413e272b0ae54f772ffd60ece5dc530bea7cdb 100644 (file)
@@ -91,6 +91,15 @@ gst_net_address_meta_get_info (void)
   return meta_info;
 }
 
+/**
+ * gst_buffer_add_net_address_meta:
+ * @buffer: a #GstBuffer
+ * @addr: a @GSocketAddress to connect to @buffer
+ *
+ * Attaches @addr as metadata in a #GstNetAddressMeta to @buffer.
+ *
+ * Returns: (transfer none): a #GstNetAddressMeta connected to @buffer
+ */
 GstNetAddressMeta *
 gst_buffer_add_net_address_meta (GstBuffer * buffer, GSocketAddress * addr)
 {
index feb64d83b8adabba0654dfdd2140e82f89164468..ff8b52371e4f5f371df25235a7c1f3408f2a1d6c 100644 (file)
@@ -29,6 +29,8 @@ typedef struct _GstNetAddressMeta GstNetAddressMeta;
 
 /**
  * GstNetAddressMeta:
+ * @meta: the parent type
+ * @addr: a #GSocketAddress stored as metadata
  *
  * Buffer metadata for network addresses.
  */