remove deprecated functions add two tag prototypes to docs add accessor function

Original commit message from CVS:
remove deprecated functions
add two tag prototypes to docs
add accessor function

diff --git a/ChangeLog b/ChangeLog
index dc1e785..834b06e 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,22 @@
+2004-03-06  Thomas Vander Stichele  <thomas at apestaart dot org>
+
+       * docs/gst/gstreamer-sections.txt:
+       * docs/gst/tmpl/gsttag.sgml:
+          remove some deprecated functions, document some existing ones
+       * gst/gsttag.c: (gst_tag_get_flag):
+       * gst/gsttag.h:
+          add accessor function
+
+2004-03-06  Thomas Vander Stichele  <thomas at apestaart dot org>
+
+       reviewed by: <delete if not using a buddy>
+
+       * docs/gst/gstreamer-sections.txt:
+       * docs/gst/tmpl/gsttag.sgml:
+       * docs/gst/tmpl/gstxml.sgml:
+       * gst/gsttag.c: (gst_tag_get_flag):
+       * gst/gsttag.h:
+
 2004-03-06  Christophe Fergeau  <teuf@gnome.org>
 
        * gst/autoplug/gstspider.c: (gst_spider_identity_plug): fixed caps

diff --git a/docs/gst/gstreamer-sections.txt b/docs/gst/gstreamer-sections.txt
index 5f6d775..08374ca 100644 (file)
--- a/docs/gst/gstreamer-sections.txt
+++ b/docs/gst/gstreamer-sections.txt
@@ -280,7 +280,6 @@ gst_data_dispose
 gst_data_copy_into
 gst_data_copy
 gst_data_copy_on_write
-gst_data_free
 gst_data_ref
 gst_data_ref_by_count
 gst_data_unref
@@ -324,7 +323,6 @@ gst_buffer_ref_by_count
 gst_buffer_unref
 gst_buffer_copy
 gst_buffer_copy_on_write
-gst_buffer_free
 gst_buffer_create_sub
 gst_buffer_merge
 gst_buffer_is_span_fast
@@ -568,10 +566,10 @@ gst_structure_new
 gst_structure_new_valist
 gst_structure_copy
 gst_structure_free
-                                                                                
+
 gst_structure_get_name
 gst_structure_set_name
-                                                                                
+
 gst_structure_id_set_value
 gst_structure_set_value
 
@@ -583,20 +581,20 @@ gst_structure_remove_field
 gst_structure_remove_fields
 gst_structure_remove_fields_valist
 gst_structure_remove_all_fields
-                                                                                
+
 gst_structure_get_field_type
-gst_structure_foreach 
+gst_structure_foreach
 gst_structure_n_fields
 gst_structure_has_field
 gst_structure_has_field_typed
-                                                                                
+
 gst_structure_get_boolean
 gst_structure_get_int
 gst_structure_get_fourcc
 gst_structure_get_double
 gst_structure_get_string
 gst_structure_to_string
-gst_structure_from_string 
+gst_structure_from_string
 
 </SECTION>
 
@@ -605,69 +603,72 @@ gst_structure_from_string
 <TITLE>GstTag</TITLE>
 GstTagMergeMode
 GstTagFlag
+GstTagForeachFunc
+GstTagMergeFunc
 gst_tag_register
 gst_tag_merge_use_first
 gst_tag_merge_strings_with_comma
-gst_tag_exists                 
-gst_tag_get_type               
-gst_tag_get_nick               
-gst_tag_get_description                
-gst_tag_is_fixed               
-gst_tag_list_new               
-gst_tag_list_copy              
-gst_tag_list_insert            
-gst_tag_list_merge             
-gst_tag_list_free              
-gst_tag_list_get_tag_size      
-gst_tag_list_add               
-gst_tag_list_add_values                
-gst_tag_list_add_valist                
-gst_tag_list_add_valist_values 
-gst_tag_list_remove_tag                
-gst_tag_list_foreach           
-gst_tag_list_get_value_index   
-gst_tag_list_copy_value                
-gst_tag_list_get_char          
-gst_tag_list_get_char_index    
-gst_tag_list_get_uchar         
-gst_tag_list_get_uchar_index   
-gst_tag_list_get_boolean       
-gst_tag_list_get_boolean_index 
-gst_tag_list_get_int           
-gst_tag_list_get_int_index     
-gst_tag_list_get_uint          
-gst_tag_list_get_uint_index    
-gst_tag_list_get_long          
-gst_tag_list_get_long_index    
-gst_tag_list_get_ulong         
-gst_tag_list_get_ulong_index   
-gst_tag_list_get_int64         
-gst_tag_list_get_int64_index   
-gst_tag_list_get_uint64                
-gst_tag_list_get_uint64_index  
-gst_tag_list_get_float         
-gst_tag_list_get_float_index   
-gst_tag_list_get_double                
-gst_tag_list_get_double_index  
-gst_tag_list_get_string                
-gst_tag_list_get_string_index  
-gst_tag_list_get_pointer       
-gst_tag_list_get_pointer_index 
+gst_tag_exists
+gst_tag_get_type
+gst_tag_get_nick
+gst_tag_get_description
+gst_tag_get_flag
+gst_tag_is_fixed
+gst_tag_list_new
+gst_tag_list_copy
+gst_tag_list_insert
+gst_tag_list_merge
+gst_tag_list_free
+gst_tag_list_get_tag_size
+gst_tag_list_add
+gst_tag_list_add_values
+gst_tag_list_add_valist
+gst_tag_list_add_valist_values
+gst_tag_list_remove_tag
+gst_tag_list_foreach
+gst_tag_list_get_value_index
+gst_tag_list_copy_value
+gst_tag_list_get_char
+gst_tag_list_get_char_index
+gst_tag_list_get_uchar
+gst_tag_list_get_uchar_index
+gst_tag_list_get_boolean
+gst_tag_list_get_boolean_index
+gst_tag_list_get_int
+gst_tag_list_get_int_index
+gst_tag_list_get_uint
+gst_tag_list_get_uint_index
+gst_tag_list_get_long
+gst_tag_list_get_long_index
+gst_tag_list_get_ulong
+gst_tag_list_get_ulong_index
+gst_tag_list_get_int64
+gst_tag_list_get_int64_index
+gst_tag_list_get_uint64
+gst_tag_list_get_uint64_index
+gst_tag_list_get_float
+gst_tag_list_get_float_index
+gst_tag_list_get_double
+gst_tag_list_get_double_index
+gst_tag_list_get_string
+gst_tag_list_get_string_index
+gst_tag_list_get_pointer      
+gst_tag_list_get_pointer_index
 </SECTION>
 
 <SECTION>
 <FILE>gsttaginterface</FILE>
 <TITLE>GstTagInterface</TITLE>
 
-gst_tag_setter_get_type                
-gst_tag_setter_merge           
-gst_tag_setter_add             
-gst_tag_setter_add_values      
-gst_tag_setter_add_valist      
+gst_tag_setter_get_type
+gst_tag_setter_merge
+gst_tag_setter_add
+gst_tag_setter_add_values
+gst_tag_setter_add_valist     
 gst_tag_setter_add_valist_values
-gst_tag_setter_get_list        
-gst_tag_setter_set_merge_mode  
-gst_tag_setter_get_merge_mode  
+gst_tag_setter_get_list
+gst_tag_setter_set_merge_mode
+gst_tag_setter_get_merge_mode
 </SECTION>
 
 <SECTION>

diff --git a/docs/gst/tmpl/gsttag.sgml b/docs/gst/tmpl/gsttag.sgml
index 955cce6..568ed82 100644 (file)
--- a/docs/gst/tmpl/gsttag.sgml
+++ b/docs/gst/tmpl/gsttag.sgml
@@ -39,6 +39,25 @@ GstTag
 @GST_TAG_FLAG_DECODED: 
 @GST_TAG_FLAG_COUNT: 
 
+<!-- ##### USER_FUNCTION GstTagForeachFunc ##### -->
+<para>
+
+</para>
+
+@list: 
+@tag: 
+@user_data: 
+
+
+<!-- ##### USER_FUNCTION GstTagMergeFunc ##### -->
+<para>
+
+</para>
+
+@dest: 
+@src: 
+
+
 <!-- ##### FUNCTION gst_tag_register ##### -->
 <para>
 
@@ -106,6 +125,15 @@ GstTag
 @Returns: 
 
 
+<!-- ##### FUNCTION gst_tag_get_flag ##### -->
+<para>
+
+</para>
+
+@tag: 
+@Returns: 
+
+
 <!-- ##### FUNCTION gst_tag_is_fixed ##### -->
 <para>
 

diff --git a/gst/gsttag.c b/gst/gsttag.c
index afdb2bc..439da97 100644 (file)
--- a/gst/gsttag.c
+++ b/gst/gsttag.c
@@ -417,6 +417,25 @@ gst_tag_get_description (const gchar *tag)
   
   return info->blurb;
 }
+
+/**
+ * gst_tag_get_flag:
+ * @tag: the tag
+ *
+ * Returns the flag of this tag.
+ */
+GstTagFlag
+gst_tag_get_flag (const gchar *tag)
+{
+  GstTagInfo *info;
+
+  g_return_val_if_fail (tag != NULL, GST_TAG_FLAG_UNDEFINED);
+  info = gst_tag_lookup (g_quark_from_string (tag));
+  g_return_val_if_fail (info != NULL, GST_TAG_FLAG_UNDEFINED);
+
+  return info->flag;
+}
+
 /**
  * gst_tag_list_is_fixed:
  * @tag: tag to check

diff --git a/gst/gsttag.h b/gst/gsttag.h
index 4f11fc5..a91ab8f 100644 (file)
--- a/gst/gsttag.h
+++ b/gst/gsttag.h
@@ -81,6 +81,7 @@ G_CONST_RETURN gchar *
                gst_tag_get_nick                (const gchar *          tag);
 G_CONST_RETURN gchar *
                gst_tag_get_description         (const gchar *          tag);
+GstTagFlag     gst_tag_get_flag                (const gchar *          tag);
 gboolean       gst_tag_is_fixed                (const gchar *          tag);
 
 /* tag lists */

diff --git a/gst/gsttaglist.c b/gst/gsttaglist.c
index afdb2bc..439da97 100644 (file)
--- a/gst/gsttaglist.c
+++ b/gst/gsttaglist.c
@@ -417,6 +417,25 @@ gst_tag_get_description (const gchar *tag)
   
   return info->blurb;
 }
+
+/**
+ * gst_tag_get_flag:
+ * @tag: the tag
+ *
+ * Returns the flag of this tag.
+ */
+GstTagFlag
+gst_tag_get_flag (const gchar *tag)
+{
+  GstTagInfo *info;
+
+  g_return_val_if_fail (tag != NULL, GST_TAG_FLAG_UNDEFINED);
+  info = gst_tag_lookup (g_quark_from_string (tag));
+  g_return_val_if_fail (info != NULL, GST_TAG_FLAG_UNDEFINED);
+
+  return info->flag;
+}
+
 /**
  * gst_tag_list_is_fixed:
  * @tag: tag to check

diff --git a/gst/gsttaglist.h b/gst/gsttaglist.h
index 4f11fc5..a91ab8f 100644 (file)
--- a/gst/gsttaglist.h
+++ b/gst/gsttaglist.h
@@ -81,6 +81,7 @@ G_CONST_RETURN gchar *
                gst_tag_get_nick                (const gchar *          tag);
 G_CONST_RETURN gchar *
                gst_tag_get_description         (const gchar *          tag);
+GstTagFlag     gst_tag_get_flag                (const gchar *          tag);
 gboolean       gst_tag_is_fixed                (const gchar *          tag);
 
 /* tag lists */