docs/faq/: Faq review and update.
[platform/upstream/gstreamer.git] / ChangeLog
index 3dbde72..c7ef1fa 100644 (file)
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,356 @@
+2006-03-16  Stefan Kost  <ensonic@users.sf.net>
+
+       * docs/faq/cvs.xml:
+       * docs/faq/dependencies.xml:
+       * docs/faq/developing.xml:
+       * docs/faq/faq.xml:
+       * docs/faq/general.xml:
+       * docs/faq/getting.xml:
+       * docs/faq/legal.xml:
+       * docs/faq/troubleshooting.xml:
+       * docs/faq/using.xml:
+       Faq review and update.
+
+2006-03-16  Jan Schmidt  <thaytan@mad.scientist.com>
+
+       * gst/gstpad.c: (gst_pad_accept_caps), (gst_pad_alloc_buffer_full),
+       (gst_pad_push):
+       Don't pound the cpu to pieces by checking get_caps when accept_caps
+       is called with the same caps as the pad already has.
+       Use GST_DEBUG_OBJECT when outputting caps change information.
+
+2006-03-15  Wim Taymans  <wim@fluendo.com>
+
+       * gst/gstclock.c: (gst_clock_class_init):
+       Fix docs.
+
+2006-03-15  Jan Schmidt  <thaytan@mad.scientist.com>
+
+       * gst/gstbuffer.h:
+       Documentation fix.
+
+       * gst/gstpad.c: (gst_pad_init), (gst_pad_acceptcaps_default),
+       (gst_pad_accept_caps), (gst_pad_configure_sink),
+       (gst_pad_configure_src), (gst_pad_chain), (gst_pad_push):
+       Make the default acceptcaps behaviour be to check the requested 
+       caps against the gst_pad_get_caps output. 
+
+       Ensure that gst_pad_accept_caps is used to check caps when a pad
+       doesn't have a setcaps function, so that pads automatically refuse 
+       caps that they don't allow in their pad template. (Fixes #332986)
+
+       When a buffer with attached caps is pushed, ensure that the source 
+       pad receives those caps even if the element didn't call
+       gst_pad_set_caps first.
+
+2006-03-15  Wim Taymans  <wim@fluendo.com>
+
+       * libs/gst/base/gstadapter.c:
+       Add some docs.
+
+2006-03-15  Tim-Philipp Müller  <tim at centricular dot net>
+
+       * win32/common/libgstbase.def:
+       * win32/common/libgstcontroller.def:
+       * win32/common/libgstreamer.def:
+         Add a whole bunch of missing functions (#334434).
+
+2006-03-14  Wim Taymans  <wim@fluendo.com>
+
+       * libs/gst/base/gstbasesink.c: (gst_base_sink_configure_segment),
+       (gst_base_sink_get_sync_times), (gst_base_sink_wait_clock),
+       (gst_base_sink_do_sync), (gst_base_sink_do_qos):
+       Better debug info when we receive a segment event.
+       Reorganize a bit so we can pass the get_times() results around.
+       Use the segment format when calculating the running time.
+       Don't do QoS is sync is disabled or we have no clock or the
+       element does not want us to sync to the clock.
+       Don't drop buffers if QoS is disabled for now.
+
+2006-03-14  Wim Taymans  <wim@fluendo.com>
+
+       * gst/gstclock.c: (gst_clock_class_init), (do_linear_regression):
+       Marked the stats property as unimplemented so people don't get
+       wild ideas.
+       Add debug message when regression goes wrong.
+       Added some more docs.
+
+2006-03-14  Wim Taymans  <wim@fluendo.com>
+
+       * gst/gstsegment.c: (gst_segment_to_stream_time):
+       Return correct return type in case of errors.
+
+2006-03-14  Wim Taymans  <wim@fluendo.com>
+
+       * gst/gstformat.c: (gst_format_get_name), (gst_format_to_quark):
+         Don't segfault on invalid formats.
+
+2006-03-14  Tim-Philipp Müller  <tim at centricular dot net>
+
+       * libs/gst/base/gstbasesink.c: (gst_base_sink_get_sync_times):
+         Can't use gst_segment_to_running_time() when the segment
+         is not in GST_TIME_FORMAT (like with filesink, for example).
+         Stops flac encoding pipelines from spewing critical warnings
+         at EOS (#331248).
+         
+2006-03-14  Tim-Philipp Müller  <tim at centricular dot net>
+
+       * gst/gstpipeline.c: (gst_pipeline_class_init):
+         Add 'Since: 0.10.5' to gtk-doc blurb for added property.
+
+       * plugins/elements/gsttypefindelement.c:
+       (gst_type_find_element_handle_event):
+         Don't try to typefind empty streams.
+
+2006-03-14  Wim Taymans  <wim@fluendo.com>
+
+       * libs/gst/base/gstbasesink.c: (gst_base_sink_do_sync),
+       (gst_base_sink_do_qos):
+       Separate QoS calculation.
+       Only drop buffers when lateness is bigger than the 
+       duration of the buffer.
+
+2006-03-13  Wim Taymans  <wim@fluendo.com>
+
+       * gst/gstpipeline.c: (gst_pipeline_set_property),
+       (gst_pipeline_get_property), (do_pipeline_seek),
+       (gst_pipeline_change_state), (gst_pipeline_set_delay),
+       (gst_pipeline_get_delay):
+       Don't deadlock when reading properties.
+
+2006-03-13  Wim Taymans  <wim@fluendo.com>
+
+       * libs/gst/base/gstbasetransform.c:
+       (gst_base_transform_class_init), (gst_base_transform_init),
+       (gst_base_transform_sink_event),
+       (gst_base_transform_sink_eventfunc),
+       (gst_base_transform_src_event), (gst_base_transform_src_eventfunc),
+       (gst_base_transform_handle_buffer), (gst_base_transform_chain),
+       (gst_base_transform_set_property),
+       (gst_base_transform_get_property),
+       (gst_base_transform_change_state), (gst_base_transform_update_qos),
+       (gst_base_transform_set_qos_enabled),
+       (gst_base_transform_is_qos_enabled):
+       * libs/gst/base/gstbasetransform.h:
+       Make basetransform virtual method for src events too.
+       Handle QOS in basetransform.
+       API: gst_base_transform_update_qos
+       API: gst_base_transform_set_qos_enabled
+       API: gst_base_transform_is_qos_enabled
+
+2006-03-13  Wim Taymans  <wim@fluendo.com>
+
+       * libs/gst/base/gstbasesink.c: (gst_base_sink_init),
+       (gst_base_sink_do_sync):
+       Small cleanups.
+       Use QOS debug category.
+
+2006-03-13  Wim Taymans  <wim@fluendo.com>
+
+       * plugins/elements/gstqueue.c:
+       Very small doc update.
+
+2006-03-13  Wim Taymans  <wim@fluendo.com>
+
+       * gst/gst_private.h:
+       * gst/gstinfo.c: (_gst_debug_init):
+       Added QOS debug category
+
+2006-03-13  Wim Taymans  <wim@fluendo.com>
+
+       * docs/gst/gstreamer-sections.txt:
+       * gst/gstbin.c: (bin_bus_handler), (gst_bin_handle_message_func):
+       * gst/gstbin.h:
+       * gst/gstbus.c: (gst_bus_class_init):
+       * gst/gstbus.h:
+       * gst/gstclock.c:
+       * gst/gstelement.c: (gst_element_set_locked_state):
+       * gst/gstsegment.c:
+       Documentation updates.
+
+       * gst/gstpipeline.c: (gst_pipeline_get_type),
+       (gst_pipeline_class_init), (gst_pipeline_init),
+       (gst_pipeline_dispose), (gst_pipeline_set_property),
+       (gst_pipeline_get_property), (do_pipeline_seek),
+       (gst_pipeline_send_event), (gst_pipeline_change_state),
+       (gst_pipeline_provide_clock_func), (gst_pipeline_set_delay),
+       (gst_pipeline_get_delay):
+       * gst/gstpipeline.h:
+       Added methods for setting the delay.
+       API: gst_pipeline_set_delay
+       API: gst_pipeline_get_delay
+       Add pipeline debug category
+       Various cleanups.
+       Updated docs.
+       Don't reset stream time when seek failed.
+
+2006-03-13  Wim Taymans  <wim@fluendo.com>
+
+       * docs/design/draft-klass.txt:
+       * docs/design/part-clocks.txt:
+       * docs/design/part-events.txt:
+       * docs/design/part-gstbin.txt:
+       * docs/design/part-gstpipeline.txt:
+       * docs/design/part-messages.txt:
+       * docs/design/part-negotiation.txt:
+       * docs/design/part-overview.txt:
+       * docs/design/part-preroll.txt:
+       * docs/design/part-seeking.txt:
+       * docs/design/part-states.txt:
+       * docs/design/part-streams.txt:
+       Documentation updates.
+
+2006-03-12  Julien MOUTTE  <julien@moutte.net>
+
+       * gst/gsttaglist.c: Fix rubbish docs that are encouraging
+       us to leak strings...
+
+2006-03-12  Thomas Vander Stichele  <thomas at apestaart dot org>
+
+       * libs/gst/net/gstnettimeprovider.c:
+         fix docs
+       * win32/common/config.h:
+         update
+
+2006-03-12  Tim-Philipp Müller  <tim at centricular dot net>
+
+       Patch by: Julio M. Merino Vidal <jmmv at netbsd org>
+
+       * configure.ac:
+         Don't check for libgnomeui (leftover from old examples
+         that aren't built or disted any longer) (#334303).
+         
+2006-03-11  Tim-Philipp Müller  <tim at centricular dot net>
+
+       * plugins/elements/gstfdsink.c: (gst_fd_sink_render):
+       * plugins/elements/gstfilesink.c: (gst_file_sink_render):
+         Emit RESOURCE_NO_SPACE_LEFT error here as well when
+         there's no space left on the device.
+
+2006-03-10  Tim-Philipp Müller  <tim at centricular dot net>
+
+       * gst/gstclock.h:
+         Fix GST_CLOCK_TIME_IS_VALID signedness issues - we need
+         to cast the input to GstClockTime before comparing with
+         another GstClockTime value.
+
+2006-03-10  Thomas Vander Stichele  <thomas at apestaart dot org>
+
+       * configure.ac:
+         back to trunk
+
+=== release 0.10.4 ===
+
+2006-03-10  Thomas Vander Stichele <thomas at apestaart dot org>
+
+       * configure.ac:
+         releasing 0.10.4, "Light"
+
+2006-03-10  Michael Smith  <msmith@fluendo.com>
+
+       * libs/gst/dataprotocol/dataprotocol.c:
+         Fix docs for dataprocotol to not get the return types completely
+         wrong for a few functions.
+
+2006-03-09  Tim-Philipp Müller  <tim at centricular dot net>
+
+       * docs/gst/gstreamer-sections.txt:
+       * gst/gstpipeline.c: (gst_pipeline_class_init),
+       (gst_pipeline_init), (gst_pipeline_set_property),
+       (gst_pipeline_get_property), (gst_pipeline_change_state),
+       (gst_pipeline_set_auto_flush_bus),
+       (gst_pipeline_get_auto_flush_bus):
+       * gst/gstpipeline.h:
+         Add new API: gst_pipeline_set_auto_flush_bus() and
+         gst_pipeline_get_auto_flush_bus() to disable automatic
+         flushing of the pipeline's GstBus when going from READY
+         to NULL state (#332045).
+
+2006-03-09  Tim-Philipp Müller  <tim at centricular dot net>
+
+       * docs/gst/gstreamer-sections.txt:
+       * gst/gsturi.c: (gst_uri_has_protocol):
+       * gst/gsturi.h:
+          Add new API: gst_uri_has_protocol() (#333779).
+
+2006-03-09  Wim Taymans  <wim@fluendo.com>
+
+       * gst/gstclock.c: (gst_clock_entry_new),
+       (gst_clock_id_compare_func), (gst_clock_id_wait),
+       (gst_clock_id_wait_async), (gst_clock_id_unschedule),
+       (gst_clock_init), (gst_clock_get_internal_time),
+       (gst_clock_set_master), (do_linear_regression),
+       (gst_clock_add_observation), (gst_clock_set_property):
+       * gst/gstclock.h:
+       Review docs.
+       Small cleanups.
+       Fix a possible segfault when the window-size is made smaller.
+       Calculate jitter before performing the clock wait. Ideally
+       the clock implementation should calculate jitter but we need
+       API breakage for that.
+
+       * gst/gstsystemclock.c: (gst_system_clock_init):
+       Docs review.
+       
+       * libs/gst/base/gstbasesink.c: (gst_base_sink_do_sync):
+       Remove leftover else
+
+       * tests/check/gst/gstsystemclock.c: (GST_START_TEST),
+       (gst_systemclock_suite):
+       Added check to test GST_CLOCK_DIFF.
+
+2006-03-09  Tim-Philipp Müller  <tim at centricular dot net>
+
+       * libs/gst/base/gsttypefindhelper.c: (helper_find_get_length),
+       (gst_type_find_helper_get_range):
+         If we are provided with the size, we should implement
+         GstTypeFind::get_length, so that typefind functions who
+         want to can actually peek at the middle of a file.
+
+2006-03-08  Tim-Philipp Müller  <tim at centricular dot net>
+
+       * docs/manual/advanced-dataaccess.xml:
+         Add some very very basic error checking.
+
+       * docs/pwg/appendix-checklist.xml:
+         Some updates to the list of things to check when writing an element.
+
+2006-03-08  Wim Taymans  <wim@fluendo.com>
+
+       * docs/design/part-element-transform.txt:
+       Added some docs about the design of tranform elements.
+
+       * libs/gst/base/gstbasesrc.c: (gst_base_src_perform_seek),
+       (gst_base_src_loop), (gst_base_src_change_state):
+       Mark buffers with the DISCONT flag.
+
+2006-03-08  Michael Smith  <msmith@fluendo.com>
+
+       * gst/gstregistry.h:
+       * gst/gstregistryxml.c: (gst_registry_save),
+       (gst_registry_save_escaped), (gst_registry_xml_save_caps),
+       (gst_registry_xml_save_pad_template),
+       (gst_registry_xml_save_feature), (gst_registry_xml_save_plugin),
+       (gst_registry_xml_write_cache):
+         Rewrite registry-saving to avoid race conditions and check for
+         failed writes.
+
+2006-03-08  Wim Taymans  <wim@fluendo.com>
+
+       * libs/gst/base/gstbasetransform.c:
+       (gst_base_transform_transform_caps),
+       (gst_base_transform_transform_size),
+       (gst_base_transform_prepare_output_buffer),
+       (gst_base_transform_get_unit_size),
+       (gst_base_transform_buffer_alloc),
+       (gst_base_transform_handle_buffer),
+       (gst_base_transform_change_state):
+       Cleanups, separate normal flow from errors, add sensible
+       DEBUG lines.
+       Don't try to renegotiate when allocating an output buffer.
+       Also copy DISCONT buffer flag when copying a buffer.
+       Reset the transform after we finish streaming, not during.
+
 2006-03-08  Wim Taymans  <wim@fluendo.com>
 
        * libs/gst/base/gstbasesink.c: (gst_base_sink_do_sync):
 
 2006-03-07  Wim Taymans  <wim@fluendo.com>
 
+       Patch by: Christophe Fergeau
+
        * docs/pwg/advanced-tagging.xml:
        * docs/pwg/building-pads.xml:
-       Applied patch from Christophe Fergeau, fixes #333416
+         fixes #333416
 
 2006-03-07  Wim Taymans  <wim@fluendo.com>
 
        (gst_base_sink_get_max_lateness), (gst_base_sink_set_property),
        (gst_base_sink_get_property), (gst_base_sink_do_sync):
        * libs/gst/base/gstbasesink.h:
+       API additions: 
        Added new methods to allow subclass to control max-lateness 
        and sync.
        Generate very basic QoS events based on last sync observation.
 
        * docs/libs/gstreamer-libs-sections.txt:
        * libs/gst/base/gstbasetransform.h:
-       Fix #333669, Add pad accessor defines for GstBaseTransform
+       API addition: Fix #333669, Add pad accessor defines for GstBaseTransform
        Fix docs for GstBaseSrc.
 
 2006-03-07  Wim Taymans  <wim@fluendo.com>
        (gst_base_src_init), (gst_base_src_pad_check_get_range),
        (gst_base_src_default_check_get_range):
        * libs/gst/base/gstbasesrc.h:
-         Add ::check_get_range() vfunc to GstBaseSrc (#332611),
+         API addition:  Add ::check_get_range() vfunc to GstBaseSrc (#332611),
          provide default implementation, and rename
          gst_base_src_check_get_range() to
          gst_base_src_pad_check_get_range() for clarity.
        (gst_base_sink_init), (gst_base_sink_set_property),
        (gst_base_sink_get_property), (gst_base_sink_do_sync):
        * libs/gst/base/gstbasesink.h:
-       Make max-lateness a property.
+       API addition: Make max-lateness a property.
 
 2006-03-06  Wim Taymans  <wim@fluendo.com>
 
 
 2006-03-06  Tim-Philipp Müller  <tim at centricular dot net>
 
+       Patch by: Christophe Fergeau
+
        * gst/gstutils.h:
          Do proper cast here to make GST_BOILERPLATE_WITH_INTERFACE
-         usable in c++ code (#333417; patch by: Christophe Fergeau)
+         usable in c++ code (#333417)
 
 2006-03-06  Thomas Vander Stichele  <thomas at apestaart dot org>
 
 
 2006-03-04  Tim-Philipp Müller  <tim at centricular dot net>
 
+         Patch by: Ross Burton <ross at burtonini dot com>
+
        * gst/gsterror.c: (_gst_resource_errors_init):
        * gst/gsterror.h:
          Add GST_RESOURCE_ERROR_NO_SPACE_LEFT (for #333352;
-         patch by: Ross Burton <ross at burtonini dot com>).
 
 2006-03-03  Jan Schmidt  <thaytan@mad.scientist.com>
 
        * plugins/elements/gstqueue.c: (gst_queue_handle_sink_event):
        Small doc update.
 
-
 2006-02-27  Tim-Philipp Müller  <tim at centricular dot net>
 
        * plugins/elements/gsttypefindelement.c:
          
 2006-02-27  Michael Smith  <msmith@fluendo.com>
 
+       Patch by: Loïc Minier
+
        * configure.ac:
        * docs/Makefile.am:
        * docs/slides/Makefile.am:
-         Patch from Loïc Minier to prevent CVS directories getting disted.
+         prevent CVS directories getting disted.
 
 2006-02-27  Tim-Philipp Müller  <tim at centricular dot net>
 
 
 2006-02-23  Tim-Philipp Müller  <tim at centricular dot net>
 
-       * docs/gst/tmpl/.cvsignore:
-       * docs/plugins/tmpl/.cvsignore:
-       * tests/check/gst/.cvsignore:
-       * tests/check/libs/.cvsignore:
-       * tests/check/pipelines/.cvsignore:
-         Ignore more stuff.
-
-2006-02-23  Tim-Philipp Müller  <tim at centricular dot net>
-
        * tests/check/Makefile.am:
        * tests/check/libs/basesrc.c: (eos_event_counter),
        (basesrc_eos_events_pull), (basesrc_eos_events_push),
 
        * libs/gst/base/gstbasetransform.c:
        (gst_base_transform_change_state): Fix a stupid bug. I was 
-       sure i compiled that.
+       sure I compiled that.
 
 2006-02-20  Julien MOUTTE  <julien@moutte.net>
 
        (gst_pad_set_query_function), (gst_pad_set_query_type_function),
        (gst_pad_set_getcaps_function)
        * gst/parse/grammar.y: (gst_parse_found_pad), (gst_parse_perform_delayed_link)
-               Fixed NULL pointer used in GST_CAT_DEBUG using GST_STR_NULL macro
-               So now, we can use --gst-debug-level=5 on Windows
+         Fixed NULL pointer used in GST_CAT_DEBUG using GST_STR_NULL macro
+         So now, we can use --gst-debug-level=5 on Windows
        * win32/common/libgstcontroller.def:
          Added export of gst_controller_init
        * win32/vs6/libgstcontroller.dsp:
 
 2006-02-14  Wim Taymans  <wim@fluendo.com>
 
+       Patch by: Torsten Schoenfeld
+
        * gst/gstregistry.c: (gst_registry_get_default),
        (_gst_registry_cleanup):
        Protect default registry with lock and ref/sink it.
-       Fixes #324818, patch by Torsten Schoenfeld.
+       Fixes #324818
 
 2006-02-14  Wim Taymans  <wim@fluendo.com>
 
        it. Fixes #330684.
 
        * gst/gstbus.h (GstBus): Use a padding pointer to cache the
-       location of the bus-private structuure.
+       location of the bus-private structure.
        (gst_bus_enable_sync_message_emission)
-       (gst_bus_disable_sync_message_emission): New public functions.
+       (gst_bus_disable_sync_message_emission): API addition
 
 2006-02-10  Jan Schmidt  <thaytan@mad.scientist.com>
 
+       Patch by: Vincent Torri
+
        * docs/pwg/building-boiler.xml:
-       PWG patch from #326800 (Patch by Vincent Torri)
+       PWG patch from #326800
 
 2006-02-09  Tim-Philipp Müller  <tim at centricular dot net>
 
 2006-02-01  Stefan Kost  <ensonic@users.sf.net>
 
        * docs/manual/README:
-          uncover a nasty detail of the docs build
+         uncover a nasty detail of the docs build
 
 2006-01-31  Wim Taymans  <wim@fluendo.com>
 
 2006-01-31  Sebastien Moutte  <sebastien@moutte.net>
        
        * win32/vs7/grammar.vcproj:
-               activate copy of autogenerated files for Release mode
+         activate copy of autogenerated files for Release mode
 
 2006-01-30  Sebastien Moutte  <sebastien@moutte.net>
        
        * win32/common/libgstreamer.def:
-               export gst_value_compare
+         export gst_value_compare
 
 2006-01-30  Jan Schmidt  <thaytan@mad.scientist.com>
 
 2006-01-30  Sebastien Moutte  <sebastien@moutte.net>
        
        * win32/vs6/grammar.dsp:
-               add autogen of gstmarshal.c,h for Release mode
+         add autogen of gstmarshal.c,h for Release mode
                
 2006-01-30  Wim Taymans  <wim@fluendo.com>
 
 
 2006-01-29  Sebastien Moutte  <sebastien@moutte.net>
        * win32/vs6/grammar.dsp:
-               fix some bugs in Release mode for autogenerated files
+         fix some bugs in Release mode for autogenerated files
                
 2006-01-29  Sebastien Moutte  <sebastien@moutte.net>
        * win32/common/libgstbase.def:
        * win32/common/libgstreamer.def:
-               export some new symbols: gst_base_src_set_format,
-               gst_iterator_next, gst_structure_set_valist
+         export some new symbols: gst_base_src_set_format,
+         gst_iterator_next, gst_structure_set_valist
 
 2006-01-29  Julien MOUTTE  <julien@moutte.net>
 
 
 2006-01-29  Sebastien Moutte  <sebastien@moutte.net>
        * win32/vs8:
-               add vs8 project files created by Sergey Scobich
+         add vs8 project files created by Sergey Scobich
 
 2006-01-28  Jan Schmidt  <thaytan@mad.scientist.com>
 
        * gst/gstelement.c: (gst_element_send_event):
        * gst/gstevent.c:
        * gst/gstpad.c: (gst_pad_send_event):
-          added code for downstream events, reviewed docs in gstevent.c
+         added code for downstream events, reviewed docs in gstevent.c
 
 2006-01-25  Julien MOUTTE  <julien@moutte.net>