check/pipelines/simple_launch_lines.c: test for pipe!=NULL
authorStefan Kost <ensonic@users.sourceforge.net>
Tue, 6 Sep 2005 22:03:01 +0000 (22:03 +0000)
committerStefan Kost <ensonic@users.sourceforge.net>
Tue, 6 Sep 2005 22:03:01 +0000 (22:03 +0000)
Original commit message from CVS:
* check/pipelines/simple_launch_lines.c: (run_pipeline):
test for pipe!=NULL
* docs/gst/tmpl/.cvsignore:
* docs/gst/tmpl/gstmemchunk.sgml:
* docs/gst/tmpl/gstparse.sgml:
* docs/gst/tmpl/gsttaglist.sgml:
* docs/gst/tmpl/gsttagsetter.sgml:
* docs/gst/tmpl/gsttypefind.sgml:
* docs/gst/tmpl/gsttypefindfactory.sgml:
* gst/gstmemchunk.c:
* gst/gstparse.c:
* gst/gsttag.c:
* gst/gsttaginterface.c:
* gst/gsttypefind.c:
* gst/gsttypefind.h:
inlined more docs

18 files changed:
ChangeLog
check/pipelines/simple_launch_lines.c
docs/gst/tmpl/.gitignore
docs/gst/tmpl/gstmemchunk.sgml [deleted file]
docs/gst/tmpl/gstparse.sgml [deleted file]
docs/gst/tmpl/gsttaglist.sgml [deleted file]
docs/gst/tmpl/gsttagsetter.sgml [deleted file]
docs/gst/tmpl/gsttypefind.sgml [deleted file]
docs/gst/tmpl/gsttypefindfactory.sgml [deleted file]
gst/gstmemchunk.c
gst/gstparse.c
gst/gsttag.c
gst/gsttaginterface.c
gst/gsttaglist.c
gst/gsttagsetter.c
gst/gsttypefind.c
gst/gsttypefind.h
tests/check/pipelines/simple-launch-lines.c

index af05e9b..bbfc720 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,22 @@
+2005-09-07  Stefan Kost  <ensonic@users.sf.net>
+
+       * check/pipelines/simple_launch_lines.c: (run_pipeline):
+          test for pipe!=NULL
+       * docs/gst/tmpl/.cvsignore:
+       * docs/gst/tmpl/gstmemchunk.sgml:
+       * docs/gst/tmpl/gstparse.sgml:
+       * docs/gst/tmpl/gsttaglist.sgml:
+       * docs/gst/tmpl/gsttagsetter.sgml:
+       * docs/gst/tmpl/gsttypefind.sgml:
+       * docs/gst/tmpl/gsttypefindfactory.sgml:
+       * gst/gstmemchunk.c:
+       * gst/gstparse.c:
+       * gst/gsttag.c:
+       * gst/gsttaginterface.c:
+       * gst/gsttypefind.c:
+       * gst/gsttypefind.h:
+          inlined more docs
+
 === release 0.9.2 ===
 
 2005-09-06  Thomas Vander Stichele  <thomas at apestaart dot org>
@@ -80,7 +99,7 @@
        * po/vi.po:
          translation updates
 
-2005-09-03  Tim-Philipp Müller  <tim at centricular dot net>
+2005-09-03  Tim-Philipp M??ller  <tim at centricular dot net>
 
        * gst/base/gstbasesink.c: (gst_base_sink_pad_buffer_alloc):
          Add comment.
        * gst/gstevent.c: (gst_event_new_newsegment):
        A newsegment cannot have a start_time of -1
 
-2005-09-01  Tim-Philipp Müller  <tim at centricular dot net>
+2005-09-01  Tim-Philipp M??ller  <tim at centricular dot net>
 
        * win32/gstenumtypes.c:
        * win32/gstenumtypes.h:
        * gst/base/gstbasetransform.h:
        Handle the case where we are not negotiated more gracefully.
 
-2005-08-31  Tim-Philipp Müller  <tim at centricular dot net>
+2005-08-31  Tim-Philipp M??ller  <tim at centricular dot net>
 
        * gst/elements/gstfilesrc.c: (gst_mmap_buffer_init),
        (gst_file_src_map_region):
        * check/gstcheck.h:
          add ASSERT_BUFFER_REFCOUNT
 
-2005-08-13  Tim-Philipp Müller  <tim at centricular dot net>
+2005-08-13  Tim-Philipp M??ller  <tim at centricular dot net>
 
        * docs/gst/gstreamer-sections.txt:
        * gst/gsttag.c: (_gst_tag_initialize), (gst_tag_register):
          is re-registered, unless it is re-registered with a 
          different type (#308438).
 
-2005-08-12  Tim-Philipp Müller  <tim at centricular dot net>
+2005-08-12  Tim-Philipp M??ller  <tim at centricular dot net>
 
        * docs/pwg/appendix-porting.xml:
        * docs/pwg/building-state.xml:
        Actually implement (re)setting the target on a ghostpad
        as described in the docs.
 
-2005-08-10  Tim-Philipp Müller  <tim at centricular dot net>
+2005-08-10  Tim-Philipp M??ller  <tim at centricular dot net>
 
        * gst/gst.c: (gst_init_check_with_popt_table), (init_pre):
          Check whether GST_DEBUG_NO_COLOR environment variable is
          set and disable coloured debug output if that is the case.
 
-2005-08-10  Tim-Philipp Müller  <tim at centricular dot net>
+2005-08-10  Tim-Philipp M??ller  <tim at centricular dot net>
 
        * gst/base/gsttypefindhelper.c: (helper_find_peek),
        (gst_type_find_helper):
          returned by _peek() until typefinding is done and only
          free them then.
 
-2005-08-09  Tim-Philipp Müller  <tim at centricular dot net>
+2005-08-09  Tim-Philipp M??ller  <tim at centricular dot net>
 
        * docs/gst/gstreamer-sections.txt:
        * gst/gstutils.h:
        * gst/base/gstbasetransform.c: (gst_base_transform_buffer_alloc):
          Fix a pretty good memleak.
 
-2005-08-08  Tim-Philipp Müller  <tim at centricular dot net>
+2005-08-08  Tim-Philipp M??ller  <tim at centricular dot net>
 
        * gst/gstiterator.h:
          Fix wrong include and 'make distcheck'.
        * gst/gstbin.c: (bin_bus_handler):
          Use gst_element_post_message() instead.
 
-2005-08-08  Tim-Philipp Müller  <tim at centricular dot net>
+2005-08-08  Tim-Philipp M??ller  <tim at centricular dot net>
 
        * gst/base/gstadapter.h:
        * gst/base/gstbasesink.h:
        * tools/gst-xmlinspect.c: (print_element_info), (main):
          deactivate and remove dparams (libgstcontrol)
 
-2005-08-01  Tim-Philipp Müller  <tim at centricular dot net>
+2005-08-01  Tim-Philipp M??ller  <tim at centricular dot net>
 
        * gst/elements/gsttypefindelement.c:
        (gst_type_find_element_have_type), (gst_type_find_element_init),
        * gst/elements/gsttypefindelement.h:
          Set caps on all outgoing buffers, not just the first one.
 
-2005-08-01  Tim-Philipp Müller  <tim at centricular dot net>
+2005-08-01  Tim-Philipp M??ller  <tim at centricular dot net>
 
        * gst/elements/gsttypefindelement.c:
        (gst_type_find_element_have_type),
        * gst/elements/gsttypefindelement.h:
          Set caps on first outgoing buffer when we've found the type.
 
-2005-08-01  Tim-Philipp Müller  <tim at centricular dot net>
+2005-08-01  Tim-Philipp M??ller  <tim at centricular dot net>
 
        * docs/gst/gstreamer-docs.sgml:
        * docs/gst/gstreamer-sections.txt:
        * docs/gst/tmpl/gstschedulerfactory.sgml:
          Remove some old cruft from docs.
 
-2005-07-31  Tim-Philipp Müller  <tim at centricular dot net>
+2005-07-31  Tim-Philipp M??ller  <tim at centricular dot net>
 
        * gst/gstpad.h:
          Fix inline docs for GstPadLinkReturn.
        * docs/gst/gstreamer-sections.txt:
          New API: gst_structure_has_name().
 
-2005-07-30  Tim-Philipp Müller  <tim at centricular dot net>
+2005-07-30  Tim-Philipp M??ller  <tim at centricular dot net>
 
        * configure.ac:
          Use AC_SYS_LARGEFILE, which will set _FILE_OFFSET_BITS=64
        * gst/gstghostpad.c: (gst_ghost_pad_do_activate_push):
        Don't hold the lock for too long.
 
-2005-07-16  Tim-Philipp Müller  <tim at centricular dot net>
+2005-07-16  Tim-Philipp M??ller  <tim at centricular dot net>
 
        * gst/base/gstbasesrc.c: (gst_base_src_default_negotiate):
          Don't unref the caps we passed to gst_caps_make_writable() after
        * docs/design/part-gstpipeline.txt:
        Updated docs, mostly DISCONT related.
 
-2005-07-15  Tim-Philipp Müller  <tim at centricular dot net>
+2005-07-15  Tim-Philipp M??ller  <tim at centricular dot net>
 
        * docs/pwg/building-pads.xml:
          s/GST_PAD_LINK_REFUSED/FALSE/ in gst_my_filter_setcaps()
        * gst/gstpad.c: (_gst_do_pass_data_accumulator):
          Make work (??).
 
-2005-06-29  Tim-Philipp Müller  <tim at centricular dot net>
+2005-06-29  Tim-Philipp M??ller  <tim at centricular dot net>
 
        * gst/elements/gstfilesink.c: (gst_filesink_render):
          Simplify code so that we don't have to handle short
        (gst_system_clock_obtain): Set the name on object construction.
        Avoid double-checked locking.
 
-2005-06-20  Tim-Philipp Müller  <tim at centricular dot net>
+2005-06-20  Tim-Philipp M??ller  <tim at centricular dot net>
 
        * gst/gsturi.c: (gst_element_make_from_uri):
          Fix potential endless loop.
        Clear queue when going to READY.
        Remove IN_SETCAPS flag too.
 
-2005-05-17  Tim-Philipp Müller  <tim at centricular dot net>
+2005-05-17  Tim-Philipp M??ller  <tim at centricular dot net>
 
        * gst/base/gstbasesrc.c: (gst_basesrc_change_state):
          Remove implicit cast from gboolean to GstElementStateReturn;
        (find_common_root, object_has_ancestor, ghost_up, remove_pad):
        Helpers for pad_link_maybe_ghosting.
 
-2005-05-13  Tim-Philipp Müller  <tim at centricular dot net>
+2005-05-13  Tim-Philipp M??ller  <tim at centricular dot net>
 
        * configure.ac:
          Require GLib >= 2.4.0 (for the g_atomic_* funcs)
 
-2005-05-13  Tim-Philipp Müller  <tim at centricular dot net>
+2005-05-13  Tim-Philipp M??ller  <tim at centricular dot net>
 
        * docs/design/part-element-source.txt:
          Mention GstPushSrc
        * gst/gstbin.c: (gst_bin_class_init), (gst_bin_query):
          Implement _query on a bin, similar to _send_event.
 
-2005-05-12  Tim-Philipp Müller  <tim at centricular dot net>
+2005-05-12  Tim-Philipp M??ller  <tim at centricular dot net>
 
        * gst/base/gstbasesrc.c: (gst_basesrc_do_seek):
          Discont event offset format should be GST_FORMAT_BYTES,
        * gst/gstpad.c: (gst_pad_alloc_buffer), (gst_pad_push):
        Also set caps if we use the fallback buffer alloc.
 
-2005-05-06  Tim-Philipp Müller  <tim at centricular dot net>
+2005-05-06  Tim-Philipp M??ller  <tim at centricular dot net>
 
        * docs/gst/Makefile.am:
        * docs/gst/gstreamer-docs.sgml:
index 11c6ed8..293e887 100644 (file)
@@ -33,8 +33,14 @@ setup_pipeline (gchar * pipe_descr)
   return pipeline;
 }
 
-/* events is a mask of expected events. tevent is the expected terminal event.
-   the poll call will time out after half a second.
+/* 
+ * run_pipeline:
+ * @pipe: the pipeline to run
+ * @desc: the description for use in messages
+ * @events: is a mask of expected events
+ * @tevent: is the expected terminal event.
+ *
+ * the poll call will time out after half a second.
  */
 static void
 run_pipeline (GstElement * pipe, gchar * descr,
@@ -43,6 +49,7 @@ run_pipeline (GstElement * pipe, gchar * descr,
   GstBus *bus;
   GstMessageType revent;
 
+  g_assert (pipe);
   bus = gst_element_get_bus (pipe);
   g_assert (bus);
   if (gst_element_set_state (pipe,
@@ -162,8 +169,7 @@ GST_START_TEST (test_stop_from_app)
 
   assert_live_count (GST_TYPE_BUFFER, 0);
 }
-GST_END_TEST Suite *
-simple_launch_lines_suite (void)
+GST_END_TEST Suite * simple_launch_lines_suite (void)
 {
   Suite *s = suite_create ("Pipelines");
   TCase *tc_chain = tcase_create ("linear");
index d307f90..500d16b 100644 (file)
@@ -28,9 +28,10 @@ gstformat.sgml
 gstghostpad.sgml
 gstiterator.sgml
 gstmacros.sgml
-gstmemchunck.sgml
+gstmemchunk.sgml
 gstmessage.sgml
 gstminiobject.sgml
+gstparse.sgml
 gstprobe.sgml
 gstpushsrc.sgml
 gstqueue.sgml
@@ -40,7 +41,11 @@ gstregistry.sgml
 gstregistrypool.sgml
 gststructure.sgml
 gstsystemclock.sgml
+gsttaglist.sgml
+gsttagsetter.sgml
 gsttask.sgml
+gsttypefind.sgml
+gsttypefindfactory.sgml
 gsturihandler.sgml
 gsturitype.sgml
 gstutils.sgml
diff --git a/docs/gst/tmpl/gstmemchunk.sgml b/docs/gst/tmpl/gstmemchunk.sgml
deleted file mode 100644 (file)
index 8ce3af2..0000000
+++ /dev/null
@@ -1,79 +0,0 @@
-<!-- ##### SECTION Title ##### -->
-GstMemChunk
-
-<!-- ##### SECTION Short_Description ##### -->
-Atomic chunk allocator
-
-<!-- ##### SECTION Long_Description ##### -->
-<para>
-GstMemChunk is an atomic chunk allocator. It uses atomic operations
-to allocate fixed size memory regions and is therefore thread safe
-without the overhead of mutexes or other heavyweight locking mechanisms.
-</para>
-
-<para>
-The GstMemChunk is used to allocate critical resources for #GstBuffer and
-#GstEvent.
-</para>
-
-<!-- ##### SECTION See_Also ##### -->
-<para>
-#GstBuffer, #GstEvent, #GstData
-</para>
-
-<!-- ##### SECTION Stability_Level ##### -->
-
-
-<!-- ##### STRUCT GstMemChunk ##### -->
-<para>
-The memchunk structure
-</para>
-
-
-<!-- ##### FUNCTION gst_mem_chunk_new ##### -->
-<para>
-
-</para>
-
-@name: 
-@atom_size: 
-@area_size: 
-@type: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gst_mem_chunk_destroy ##### -->
-<para>
-
-</para>
-
-@mem_chunk: 
-
-
-<!-- ##### FUNCTION gst_mem_chunk_alloc ##### -->
-<para>
-
-</para>
-
-@mem_chunk: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gst_mem_chunk_alloc0 ##### -->
-<para>
-
-</para>
-
-@mem_chunk: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gst_mem_chunk_free ##### -->
-<para>
-
-</para>
-
-@mem_chunk: 
-@mem: 
-
-
diff --git a/docs/gst/tmpl/gstparse.sgml b/docs/gst/tmpl/gstparse.sgml
deleted file mode 100644 (file)
index e43a2da..0000000
+++ /dev/null
@@ -1,67 +0,0 @@
-<!-- ##### SECTION Title ##### -->
-GstParse
-
-<!-- ##### SECTION Short_Description ##### -->
-get a pipeline from a text pipeline description
-
-<!-- ##### SECTION Long_Description ##### -->
-<para>
-
-</para>
-
-<!-- ##### SECTION See_Also ##### -->
-<para>
-
-</para>
-
-<!-- ##### SECTION Stability_Level ##### -->
-
-
-<!-- ##### FUNCTION gst_parse_error_quark ##### -->
-<para>
-
-</para>
-
-@Returns: 
-
-
-<!-- ##### MACRO GST_PARSE_ERROR ##### -->
-<para>
-
-</para>
-
-
-
-<!-- ##### ENUM GstParseError ##### -->
-<para>
-
-</para>
-
-@GST_PARSE_ERROR_SYNTAX: 
-@GST_PARSE_ERROR_NO_SUCH_ELEMENT: 
-@GST_PARSE_ERROR_NO_SUCH_PROPERTY: 
-@GST_PARSE_ERROR_LINK: 
-@GST_PARSE_ERROR_COULD_NOT_SET_PROPERTY: 
-@GST_PARSE_ERROR_EMPTY_BIN: 
-@GST_PARSE_ERROR_EMPTY: 
-
-<!-- ##### FUNCTION gst_parse_launch ##### -->
-<para>
-
-</para>
-
-@pipeline_description: 
-@error: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gst_parse_launchv ##### -->
-<para>
-
-</para>
-
-@argv: 
-@error: 
-@Returns: 
-
-
diff --git a/docs/gst/tmpl/gsttaglist.sgml b/docs/gst/tmpl/gsttaglist.sgml
deleted file mode 100644 (file)
index 50c6f9a..0000000
+++ /dev/null
@@ -1,848 +0,0 @@
-<!-- ##### SECTION Title ##### -->
-GstTagList
-
-<!-- ##### SECTION Short_Description ##### -->
-List of tags and values used to describe media metadata
-
-<!-- ##### SECTION Long_Description ##### -->
-<para>
-
-</para>
-
-<!-- ##### SECTION See_Also ##### -->
-<para>
-
-</para>
-
-<!-- ##### SECTION Stability_Level ##### -->
-
-
-<!-- ##### TYPEDEF GstTagList ##### -->
-<para>
-
-</para>
-
-
-<!-- ##### ENUM GstTagMergeMode ##### -->
-<para>
-
-</para>
-
-@GST_TAG_MERGE_UNDEFINED: 
-@GST_TAG_MERGE_REPLACE_ALL: 
-@GST_TAG_MERGE_REPLACE: 
-@GST_TAG_MERGE_APPEND: 
-@GST_TAG_MERGE_PREPEND: 
-@GST_TAG_MERGE_KEEP: 
-@GST_TAG_MERGE_KEEP_ALL: 
-@GST_TAG_MERGE_COUNT: 
-
-<!-- ##### ENUM GstTagFlag ##### -->
-<para>
-
-</para>
-
-@GST_TAG_FLAG_UNDEFINED: 
-@GST_TAG_FLAG_META: 
-@GST_TAG_FLAG_ENCODED: 
-@GST_TAG_FLAG_DECODED: 
-@GST_TAG_FLAG_COUNT: 
-
-<!-- ##### USER_FUNCTION GstTagForeachFunc ##### -->
-<para>
-
-</para>
-
-@list: 
-@tag: 
-@user_data: 
-
-
-<!-- ##### USER_FUNCTION GstTagMergeFunc ##### -->
-<para>
-
-</para>
-
-@dest: 
-@src: 
-
-
-<!-- ##### MACRO GST_TAG_TITLE ##### -->
-<para>
-
-</para>
-
-
-
-<!-- ##### MACRO GST_TAG_ARTIST ##### -->
-<para>
-
-</para>
-
-
-
-<!-- ##### MACRO GST_TAG_ALBUM ##### -->
-<para>
-
-</para>
-
-
-
-<!-- ##### MACRO GST_TAG_DATE ##### -->
-<para>
-
-</para>
-
-
-
-<!-- ##### MACRO GST_TAG_GENRE ##### -->
-<para>
-
-</para>
-
-
-
-<!-- ##### MACRO GST_TAG_COMMENT ##### -->
-<para>
-
-</para>
-
-
-
-<!-- ##### MACRO GST_TAG_TRACK_NUMBER ##### -->
-<para>
-
-</para>
-
-
-
-<!-- ##### MACRO GST_TAG_TRACK_COUNT ##### -->
-<para>
-
-</para>
-
-
-
-<!-- ##### MACRO GST_TAG_ALBUM_VOLUME_NUMBER ##### -->
-<para>
-
-</para>
-
-
-
-<!-- ##### MACRO GST_TAG_ALBUM_VOLUME_COUNT ##### -->
-<para>
-
-</para>
-
-
-
-<!-- ##### MACRO GST_TAG_LOCATION ##### -->
-<para>
-
-</para>
-
-
-
-<!-- ##### MACRO GST_TAG_DESCRIPTION ##### -->
-<para>
-
-</para>
-
-
-
-<!-- ##### MACRO GST_TAG_VERSION ##### -->
-<para>
-
-</para>
-
-
-
-<!-- ##### MACRO GST_TAG_ISRC ##### -->
-<para>
-
-</para>
-
-
-
-<!-- ##### MACRO GST_TAG_ORGANIZATION ##### -->
-<para>
-
-</para>
-
-
-
-<!-- ##### MACRO GST_TAG_COPYRIGHT ##### -->
-<para>
-
-</para>
-
-
-
-<!-- ##### MACRO GST_TAG_CONTACT ##### -->
-<para>
-
-</para>
-
-
-
-<!-- ##### MACRO GST_TAG_LICENSE ##### -->
-<para>
-
-</para>
-
-
-
-<!-- ##### MACRO GST_TAG_PERFORMER ##### -->
-<para>
-
-</para>
-
-
-
-<!-- ##### MACRO GST_TAG_DURATION ##### -->
-<para>
-
-</para>
-
-
-
-<!-- ##### MACRO GST_TAG_CODEC ##### -->
-<para>
-
-</para>
-
-
-
-<!-- ##### MACRO GST_TAG_VIDEO_CODEC ##### -->
-<para>
-
-</para>
-
-
-
-<!-- ##### MACRO GST_TAG_AUDIO_CODEC ##### -->
-<para>
-
-</para>
-
-
-
-<!-- ##### MACRO GST_TAG_BITRATE ##### -->
-<para>
-
-</para>
-
-
-
-<!-- ##### MACRO GST_TAG_NOMINAL_BITRATE ##### -->
-<para>
-
-</para>
-
-
-
-<!-- ##### MACRO GST_TAG_MINIMUM_BITRATE ##### -->
-<para>
-
-</para>
-
-
-
-<!-- ##### MACRO GST_TAG_MAXIMUM_BITRATE ##### -->
-<para>
-
-</para>
-
-
-
-<!-- ##### MACRO GST_TAG_SERIAL ##### -->
-<para>
-
-</para>
-
-
-
-<!-- ##### MACRO GST_TAG_ENCODER ##### -->
-<para>
-
-</para>
-
-
-
-<!-- ##### MACRO GST_TAG_ENCODER_VERSION ##### -->
-<para>
-
-</para>
-
-
-
-<!-- ##### MACRO GST_TAG_TRACK_GAIN ##### -->
-<para>
-
-</para>
-
-
-
-<!-- ##### MACRO GST_TAG_TRACK_PEAK ##### -->
-<para>
-
-</para>
-
-
-
-<!-- ##### MACRO GST_TAG_ALBUM_GAIN ##### -->
-<para>
-
-</para>
-
-
-
-<!-- ##### MACRO GST_TAG_ALBUM_PEAK ##### -->
-<para>
-
-</para>
-
-
-
-<!-- ##### MACRO GST_TAG_LANGUAGE_CODE ##### -->
-<para>
-
-</para>
-
-
-
-<!-- ##### FUNCTION gst_tag_register ##### -->
-<para>
-
-</para>
-
-@name: 
-@flag: 
-@type: 
-@nick: 
-@blurb: 
-@func: 
-
-
-<!-- ##### FUNCTION gst_tag_merge_use_first ##### -->
-<para>
-
-</para>
-
-@dest: 
-@src: 
-
-
-<!-- ##### FUNCTION gst_tag_merge_strings_with_comma ##### -->
-<para>
-
-</para>
-
-@dest: 
-@src: 
-
-
-<!-- ##### FUNCTION gst_tag_exists ##### -->
-<para>
-
-</para>
-
-@tag: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gst_tag_get_type ##### -->
-<para>
-
-</para>
-
-@tag: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gst_tag_get_nick ##### -->
-<para>
-
-</para>
-
-@tag: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gst_tag_get_description ##### -->
-<para>
-
-</para>
-
-@tag: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gst_tag_get_flag ##### -->
-<para>
-
-</para>
-
-@tag: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gst_tag_is_fixed ##### -->
-<para>
-
-</para>
-
-@tag: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gst_tag_list_new ##### -->
-<para>
-
-</para>
-
-@Returns: 
-
-
-<!-- ##### FUNCTION gst_is_tag_list ##### -->
-<para>
-
-</para>
-
-@p: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gst_tag_list_copy ##### -->
-<para>
-
-</para>
-
-@list: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gst_tag_list_insert ##### -->
-<para>
-
-</para>
-
-@into: 
-@from: 
-@mode: 
-
-
-<!-- ##### FUNCTION gst_tag_list_merge ##### -->
-<para>
-
-</para>
-
-@list1: 
-@list2: 
-@mode: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gst_tag_list_free ##### -->
-<para>
-
-</para>
-
-@list: 
-
-
-<!-- ##### FUNCTION gst_tag_list_get_tag_size ##### -->
-<para>
-
-</para>
-
-@list: 
-@tag: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gst_tag_list_add ##### -->
-<para>
-
-</para>
-
-@list: 
-@mode: 
-@tag: 
-@Varargs: 
-
-
-<!-- ##### FUNCTION gst_tag_list_add_values ##### -->
-<para>
-
-</para>
-
-@list: 
-@mode: 
-@tag: 
-@Varargs: 
-
-
-<!-- ##### FUNCTION gst_tag_list_add_valist ##### -->
-<para>
-
-</para>
-
-@list: 
-@mode: 
-@tag: 
-@var_args: 
-
-
-<!-- ##### FUNCTION gst_tag_list_add_valist_values ##### -->
-<para>
-
-</para>
-
-@list: 
-@mode: 
-@tag: 
-@var_args: 
-
-
-<!-- ##### FUNCTION gst_tag_list_remove_tag ##### -->
-<para>
-
-</para>
-
-@list: 
-@tag: 
-
-
-<!-- ##### FUNCTION gst_tag_list_foreach ##### -->
-<para>
-
-</para>
-
-@list: 
-@func: 
-@user_data: 
-
-
-<!-- ##### FUNCTION gst_tag_list_get_value_index ##### -->
-<para>
-
-</para>
-
-@list: 
-@tag: 
-@index: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gst_tag_list_copy_value ##### -->
-<para>
-
-</para>
-
-@dest: 
-@list: 
-@tag: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gst_tag_list_get_char ##### -->
-<para>
-
-</para>
-
-@list: 
-@tag: 
-@value: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gst_tag_list_get_char_index ##### -->
-<para>
-
-</para>
-
-@list: 
-@tag: 
-@index: 
-@value: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gst_tag_list_get_uchar ##### -->
-<para>
-
-</para>
-
-@list: 
-@tag: 
-@value: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gst_tag_list_get_uchar_index ##### -->
-<para>
-
-</para>
-
-@list: 
-@tag: 
-@index: 
-@value: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gst_tag_list_get_boolean ##### -->
-<para>
-
-</para>
-
-@list: 
-@tag: 
-@value: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gst_tag_list_get_boolean_index ##### -->
-<para>
-
-</para>
-
-@list: 
-@tag: 
-@index: 
-@value: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gst_tag_list_get_int ##### -->
-<para>
-
-</para>
-
-@list: 
-@tag: 
-@value: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gst_tag_list_get_int_index ##### -->
-<para>
-
-</para>
-
-@list: 
-@tag: 
-@index: 
-@value: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gst_tag_list_get_uint ##### -->
-<para>
-
-</para>
-
-@list: 
-@tag: 
-@value: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gst_tag_list_get_uint_index ##### -->
-<para>
-
-</para>
-
-@list: 
-@tag: 
-@index: 
-@value: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gst_tag_list_get_long ##### -->
-<para>
-
-</para>
-
-@list: 
-@tag: 
-@value: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gst_tag_list_get_long_index ##### -->
-<para>
-
-</para>
-
-@list: 
-@tag: 
-@index: 
-@value: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gst_tag_list_get_ulong ##### -->
-<para>
-
-</para>
-
-@list: 
-@tag: 
-@value: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gst_tag_list_get_ulong_index ##### -->
-<para>
-
-</para>
-
-@list: 
-@tag: 
-@index: 
-@value: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gst_tag_list_get_int64 ##### -->
-<para>
-
-</para>
-
-@list: 
-@tag: 
-@value: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gst_tag_list_get_int64_index ##### -->
-<para>
-
-</para>
-
-@list: 
-@tag: 
-@index: 
-@value: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gst_tag_list_get_uint64 ##### -->
-<para>
-
-</para>
-
-@list: 
-@tag: 
-@value: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gst_tag_list_get_uint64_index ##### -->
-<para>
-
-</para>
-
-@list: 
-@tag: 
-@index: 
-@value: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gst_tag_list_get_float ##### -->
-<para>
-
-</para>
-
-@list: 
-@tag: 
-@value: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gst_tag_list_get_float_index ##### -->
-<para>
-
-</para>
-
-@list: 
-@tag: 
-@index: 
-@value: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gst_tag_list_get_double ##### -->
-<para>
-
-</para>
-
-@list: 
-@tag: 
-@value: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gst_tag_list_get_double_index ##### -->
-<para>
-
-</para>
-
-@list: 
-@tag: 
-@index: 
-@value: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gst_tag_list_get_string ##### -->
-<para>
-
-</para>
-
-@list: 
-@tag: 
-@value: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gst_tag_list_get_string_index ##### -->
-<para>
-
-</para>
-
-@list: 
-@tag: 
-@index: 
-@value: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gst_tag_list_get_pointer ##### -->
-<para>
-
-</para>
-
-@list: 
-@tag: 
-@value: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gst_tag_list_get_pointer_index ##### -->
-<para>
-
-</para>
-
-@list: 
-@tag: 
-@index: 
-@value: 
-@Returns: 
-
-
diff --git a/docs/gst/tmpl/gsttagsetter.sgml b/docs/gst/tmpl/gsttagsetter.sgml
deleted file mode 100644 (file)
index d80b667..0000000
+++ /dev/null
@@ -1,113 +0,0 @@
-<!-- ##### SECTION Title ##### -->
-GstTagSetter
-
-<!-- ##### SECTION Short_Description ##### -->
-Element interface that allows setting and retrieval of media metadata
-
-<!-- ##### SECTION Long_Description ##### -->
-<para>
-
-</para>
-
-<!-- ##### SECTION See_Also ##### -->
-<para>
-
-</para>
-
-<!-- ##### SECTION Stability_Level ##### -->
-
-
-<!-- ##### STRUCT GstTagSetter ##### -->
-<para>
-
-</para>
-
-
-<!-- ##### STRUCT GstTagSetterIFace ##### -->
-<para>
-
-</para>
-
-@g_iface: 
-
-<!-- ##### FUNCTION gst_tag_setter_merge ##### -->
-<para>
-
-</para>
-
-@setter: 
-@list: 
-@mode: 
-
-
-<!-- ##### FUNCTION gst_tag_setter_add ##### -->
-<para>
-
-</para>
-
-@setter: 
-@mode: 
-@tag: 
-@Varargs: 
-
-
-<!-- ##### FUNCTION gst_tag_setter_add_values ##### -->
-<para>
-
-</para>
-
-@setter: 
-@mode: 
-@tag: 
-@Varargs: 
-
-
-<!-- ##### FUNCTION gst_tag_setter_add_valist ##### -->
-<para>
-
-</para>
-
-@setter: 
-@mode: 
-@tag: 
-@var_args: 
-
-
-<!-- ##### FUNCTION gst_tag_setter_add_valist_values ##### -->
-<para>
-
-</para>
-
-@setter: 
-@mode: 
-@tag: 
-@var_args: 
-
-
-<!-- ##### FUNCTION gst_tag_setter_get_list ##### -->
-<para>
-
-</para>
-
-@setter: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gst_tag_setter_set_merge_mode ##### -->
-<para>
-
-</para>
-
-@setter: 
-@mode: 
-
-
-<!-- ##### FUNCTION gst_tag_setter_get_merge_mode ##### -->
-<para>
-
-</para>
-
-@setter: 
-@Returns: 
-
-
diff --git a/docs/gst/tmpl/gsttypefind.sgml b/docs/gst/tmpl/gsttypefind.sgml
deleted file mode 100644 (file)
index eb4ab7e..0000000
+++ /dev/null
@@ -1,94 +0,0 @@
-<!-- ##### SECTION Title ##### -->
-GstTypeFindElement
-
-<!-- ##### SECTION Short_Description ##### -->
-typefinding subsystem
-
-<!-- ##### SECTION Long_Description ##### -->
-<para>
-
-</para>
-
-<!-- ##### SECTION See_Also ##### -->
-<para>
-
-</para>
-
-<!-- ##### SECTION Stability_Level ##### -->
-
-
-<!-- ##### STRUCT GstTypeFind ##### -->
-<para>
-
-</para>
-
-@peek: 
-@suggest: 
-@data: 
-@get_length: 
-
-<!-- ##### USER_FUNCTION GstTypeFindFunction ##### -->
-<para>
-
-</para>
-
-@find: 
-@data: 
-
-
-<!-- ##### ENUM GstTypeFindProbability ##### -->
-<para>
-
-</para>
-
-@GST_TYPE_FIND_MINIMUM: 
-@GST_TYPE_FIND_POSSIBLE: 
-@GST_TYPE_FIND_LIKELY: 
-@GST_TYPE_FIND_NEARLY_CERTAIN: 
-@GST_TYPE_FIND_MAXIMUM: 
-
-<!-- ##### FUNCTION gst_type_find_peek ##### -->
-<para>
-
-</para>
-
-@find: 
-@offset: 
-@size: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gst_type_find_suggest ##### -->
-<para>
-
-</para>
-
-@find: 
-@probability: 
-@caps: 
-
-
-<!-- ##### FUNCTION gst_type_find_get_length ##### -->
-<para>
-
-</para>
-
-@find: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gst_type_find_register ##### -->
-<para>
-
-</para>
-
-@plugin: 
-@name: 
-@rank: 
-@func: 
-@extensions: 
-@possible_caps: 
-@data: 
-@Returns: 
-
-
diff --git a/docs/gst/tmpl/gsttypefindfactory.sgml b/docs/gst/tmpl/gsttypefindfactory.sgml
deleted file mode 100644 (file)
index 0ec2797..0000000
+++ /dev/null
@@ -1,113 +0,0 @@
-<!-- ##### SECTION Title ##### -->
-GstTypeFindFactory
-
-<!-- ##### SECTION Short_Description ##### -->
-information about registered typefind functions
-
-<!-- ##### SECTION Long_Description ##### -->
-<para>
-These functions allow querying informations about registered typefind 
-functions. How to create and register these functions is described in
-the section <link linkend="gstreamer-Writing-typefind-functions">
-"Writing typefind functions"</link>.
-</para>
-<example>
-  <title>how to write a simple typefinder</title>
-  <programlisting>
-  /* FIXME: compile this? ;) */
-  typedef struct {
-    guint8 *data;
-    guint size;
-    guint probability;
-    GstCaps *data;
-  } MyTypeFind;
-  static void
-  my_peek (gpointer data, gint64 offset, guint size)
-  {
-    MyTypeFind *find = (MyTypeFind *) data;
-    if (offset &gt;= 0 &amp;&amp; offset + size &lt;= find->size) {
-      return find->data + offset;
-    }
-    return NULL;
-  }
-  static void
-  my_suggest (gpointer data, guint probability, GstCaps *caps)
-  {
-    MyTypeFind *find = (MyTypeFind *) data;
-    if (probability &gt; find->probability) {
-      find->probability = probability;
-      gst_caps_replace (&amp;find->caps, caps);
-    }
-  }
-  static GstCaps *
-  find_type (guint8 *data, guint size)
-  {
-    GList *walk, *type_list;
-    MyTypeFind find = {data, size, 0, NULL};
-    GstTypeFind gst_find = {my_peek, my_suggest, &amp;find, };
-    
-    walk = type_list = gst_type_find_factory_get_list ();
-    while (walk) {
-      GstTypeFindFactory *factory = GST_TYPE_FIND_FACTORY (walk->data);
-      walk = g_list_next (walk)
-      gst_type_find_factory_call_function (factory, &amp;gst_find);
-    }
-    g_list_free (type_list);
-    return find.caps;
-  };
-  </programlisting>
-</example>
-<para>
-The above example shows how to write a very simple typefinder that identifies
-the given data. You can get quite a bit more complicated than that though.
-</para>
-
-<!-- ##### SECTION See_Also ##### -->
-<para>
-<link linkend="gstreamer-Writing-typefind-functions">Writing typefind functions</link>
-</para>
-
-<!-- ##### SECTION Stability_Level ##### -->
-
-
-<!-- ##### STRUCT GstTypeFindFactory ##### -->
-<para>
-Object that stores information about a typefind function
-</para>
-
-
-<!-- ##### FUNCTION gst_type_find_factory_get_list ##### -->
-<para>
-
-</para>
-
-@Returns: 
-
-
-<!-- ##### FUNCTION gst_type_find_factory_get_extensions ##### -->
-<para>
-
-</para>
-
-@factory: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gst_type_find_factory_get_caps ##### -->
-<para>
-
-</para>
-
-@factory: 
-@Returns: 
-
-
-<!-- ##### FUNCTION gst_type_find_factory_call_function ##### -->
-<para>
-
-</para>
-
-@factory: 
-@find: 
-
-
index 7754c2d..cbe470b 100644 (file)
@@ -21,7 +21,7 @@
  * Boston, MA 02111-1307, USA.
  */
 /**
- * SECTION:gstmacros
+ * SECTION:gstmemchunk
  * @short_description: Atomic chunk allocator
  * @see_also: #GstBuffer, #GstEvent, #GstData
  *
index 43b3534..24ed0ca 100644 (file)
  * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
  * Boston, MA 02111-1307, USA.
  */
+/**
+ * SECTION:gstparse
+ * @short_description: Get a pipeline from a text pipeline description
+ *
+ * These function allow to create a pipeline based on the syntax used in the
+ * gst-launch utillity.
+ */
 
 #include <string.h>
 
@@ -69,10 +76,10 @@ _gst_parse_escape (const gchar * str)
  * @error: pointer to a #GError
  *
  * Create a new element based on command line syntax.
- * #error will contain an error message if an erroneuos pipeline is specified.
+ * @error will contain an error message if an erroneuos pipeline is specified.
  * An error does not mean that the pipeline could not be constructed.
  *
- * Returns: a new element on success and NULL on failure.
+ * Returns: a new element on success and %NULL on failure.
  */
 GstElement *
 gst_parse_launchv (const gchar ** argv, GError ** error)
@@ -110,13 +117,13 @@ gst_parse_launchv (const gchar ** argv, GError ** error)
  * @error: the error message in case of an erroneous pipeline.
  *
  * Create a new pipeline based on command line syntax.
- * Please note that you might get a return value that is not NULL even though
- * the error is set. In this case there was a recoverable parsing error and you
+ * Please note that you might get a return value that is not %NULL even though
+ * the @error is set. In this case there was a recoverable parsing error and you
  * can try to play the pipeline.
  *
- * Returns: a new element on success, NULL on failure. If more than one toplevel
- * element is specified by the pipeline_description, all elements are put into
- * a #GstPipeline ant that is returned.
+ * Returns: a new element on success, %NULL on failure. If more than one toplevel
+ * element is specified by the @pipeline_description, all elements are put into
+ * a #GstPipeline, which than is returned.
  */
 GstElement *
 gst_parse_launch (const gchar * pipeline_description, GError ** error)
index b040098..3e54176 100644 (file)
  * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
  * Boston, MA 02111-1307, USA.
  */
+/**
+ * SECTION:gsttaglist
+ * @short_description: List of tags and values used to describe media metadata
+ *
+ */
 
 #ifdef HAVE_CONFIG_H
 #  include "config.h"
index b73108f..2fae2b8 100644 (file)
  * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
  * Boston, MA 02111-1307, USA.
  */
+/**
+ * SECTION:gsttagsetter
+ * @short_description: Element interface that allows setting and retrieval of media metadata
+ *
+ */
 
 
 #ifdef HAVE_CONFIG_H
index b040098..3e54176 100644 (file)
  * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
  * Boston, MA 02111-1307, USA.
  */
+/**
+ * SECTION:gsttaglist
+ * @short_description: List of tags and values used to describe media metadata
+ *
+ */
 
 #ifdef HAVE_CONFIG_H
 #  include "config.h"
index b73108f..2fae2b8 100644 (file)
  * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
  * Boston, MA 02111-1307, USA.
  */
+/**
+ * SECTION:gsttagsetter
+ * @short_description: Element interface that allows setting and retrieval of media metadata
+ *
+ */
 
 
 #ifdef HAVE_CONFIG_H
index 1ba77e8..d579e70 100644 (file)
  * Free Software Foundation, Inc., 59 Temple Place - Suite 330,
  * Boston, MA 02111-1307, USA.
  */
+/**
+ * SECTION:gsttypefind
+ * @short_description: Stream type detection
+ *
+ */
+ /**
+ * SECTION:gsttypefindfactory
+ * @short_description: Information about registered typefind functions
+ *
+ * These functions allow querying informations about registered typefind 
+ * functions. How to create and register these functions is described in
+ * the section <link linkend="gstreamer-Writing-typefind-functions">
+ * "Writing typefind functions"</link>.
+ *
+ * <example>
+ *   <title>how to write a simple typefinder</title>
+ *   <programlisting>
+ *   typedef struct {
+ *     guint8 *data;
+ *     guint size;
+ *     guint probability;
+ *     GstCaps *data;
+ *   } MyTypeFind;
+ *   static void
+ *   my_peek (gpointer data, gint64 offset, guint size)
+ *   {
+ *     MyTypeFind *find = (MyTypeFind *) data;
+ *     if (offset &gt;= 0 &amp;&amp; offset + size &lt;= find->size) {
+ *       return find->data + offset;
+ *     }
+ *     return NULL;
+ *   }
+ *   static void
+ *   my_suggest (gpointer data, guint probability, GstCaps *caps)
+ *   {
+ *     MyTypeFind *find = (MyTypeFind *) data;
+ *     if (probability &gt; find->probability) {
+ *       find->probability = probability;
+ *       gst_caps_replace (&amp;find->caps, caps);
+ *     }
+ *   }
+ *   static GstCaps *
+ *   find_type (guint8 *data, guint size)
+ *   {
+ *     GList *walk, *type_list;
+ *     MyTypeFind find = {data, size, 0, NULL};
+ *     GstTypeFind gst_find = {my_peek, my_suggest, &amp;find, };
+ *     
+ *     walk = type_list = gst_type_find_factory_get_list ();
+ *     while (walk) {
+ *       GstTypeFindFactory *factory = GST_TYPE_FIND_FACTORY (walk->data);
+ *       walk = g_list_next (walk)
+ *       gst_type_find_factory_call_function (factory, &amp;gst_find);
+ *     }
+ *     g_list_free (type_list);
+ *     return find.caps;
+ *   };
+ *   </programlisting>
+ * </example>
+ *
+ * The above example shows how to write a very simple typefinder that identifies
+ * the given data. You can get quite a bit more complicated than that though.
+ */
 
 #include "gst_private.h"
 #include "gstinfo.h"
index 7f34717..8e32189 100644 (file)
@@ -68,6 +68,11 @@ struct _GstTypeFind {
   gpointer _gst_reserved[GST_PADDING];
 };
 
+/**
+ * GstTypeFindFactory:
+ *
+ * Object that stores information about a typefind function.
+ */
 struct _GstTypeFindFactory {
   GstPluginFeature             feature;
   /* <private> */
index 11c6ed8..293e887 100644 (file)
@@ -33,8 +33,14 @@ setup_pipeline (gchar * pipe_descr)
   return pipeline;
 }
 
-/* events is a mask of expected events. tevent is the expected terminal event.
-   the poll call will time out after half a second.
+/* 
+ * run_pipeline:
+ * @pipe: the pipeline to run
+ * @desc: the description for use in messages
+ * @events: is a mask of expected events
+ * @tevent: is the expected terminal event.
+ *
+ * the poll call will time out after half a second.
  */
 static void
 run_pipeline (GstElement * pipe, gchar * descr,
@@ -43,6 +49,7 @@ run_pipeline (GstElement * pipe, gchar * descr,
   GstBus *bus;
   GstMessageType revent;
 
+  g_assert (pipe);
   bus = gst_element_get_bus (pipe);
   g_assert (bus);
   if (gst_element_set_state (pipe,
@@ -162,8 +169,7 @@ GST_START_TEST (test_stop_from_app)
 
   assert_live_count (GST_TYPE_BUFFER, 0);
 }
-GST_END_TEST Suite *
-simple_launch_lines_suite (void)
+GST_END_TEST Suite * simple_launch_lines_suite (void)
 {
   Suite *s = suite_create ("Pipelines");
   TCase *tc_chain = tcase_create ("linear");