From 2ff20585caa432abd7419160d3487b5be9f6ca46 Mon Sep 17 00:00:00 2001 From: Thomas Vander Stichele Date: Sun, 10 Mar 2002 11:43:11 +0000 Subject: [PATCH] final commit before tagging say, can anyone make a judgment call on whether or not these .sgml files still need to be... Original commit message from CVS: final commit before tagging say, can anyone make a judgment call on whether or not these .sgml files still need to be in cvs ??? --- RELEASE | 124 +++-- configure.ac | 2 +- docs/devhelp/gstreamer-libs.devhelp | 2 +- docs/devhelp/gstreamer.devhelp | 768 +--------------------------- docs/gst/tmpl/cothreads.sgml | 21 +- docs/gst/tmpl/gstaggregator.sgml | 5 + docs/gst/tmpl/gstbin.sgml | 1 + docs/gst/tmpl/gstcaps.sgml | 1 + docs/gst/tmpl/gstclock.sgml | 61 +-- docs/gst/tmpl/gstelement.sgml | 10 +- docs/gst/tmpl/gstevent.sgml | 7 +- docs/gst/tmpl/gstfakesink.sgml | 5 + docs/gst/tmpl/gstfakesrc.sgml | 5 + docs/gst/tmpl/gstfilesrc.sgml | 10 +- docs/gst/tmpl/gstidentity.sgml | 5 + docs/gst/tmpl/gstobject.sgml | 9 + docs/gst/tmpl/gstpad.sgml | 10 +- docs/gst/tmpl/gstparse.sgml | 1 + docs/gst/tmpl/gstreamer-unused.sgml | 66 +++ docs/gst/tmpl/gsttee.sgml | 5 + 20 files changed, 220 insertions(+), 898 deletions(-) diff --git a/RELEASE b/RELEASE index c4f7a65904..54357efbfc 100644 --- a/RELEASE +++ b/RELEASE @@ -1,46 +1,77 @@ -GStreamer 0.3.2 "Do-B-day" released -Release Notes + GStreamer "GUADEC By Foot" 0.3.3 released + + Preliminary release notes The GStreamer team is happy to announce another release of the - GStreamer streaming-media framework. GStreamer now contains close to - 100 plugins for reading, writing and manipulating audio and video. We - are rapidly approaching a stable set of libraries. Our sample - applications are, however, still under development. + GStreamer streaming-media framework. This is our first release using + GLib 2.0 and libxml2 as the sole compile platform. We have also + started including all our documentation in our RPMS starting this + release. People wanting to build GStreamer themselves with + documentation should look at the DOCBUILDING file for some information + on what packages are needed to build that successfully. - We now have a gst-all module prepared that includes all of our source - modules in one easy-to-compile package. + Another new feature of this release is the gst-launch-ext command-line + application. It uses predefined pipelines to play back media files + based on their file extension. This means that you don't need to + construct your own pipelines using gst-launch if all you want to do is + play a file. Just type gst-launch-ext [filename] and the audiofile or + movie plays for you. This of course also being a work in progress + means that sometimes it might decide on the wrong pipeline, or cause + jitter, as well as random headaches. -Future Plans - - Our goal for the next release is stabilizing and improving the current - feature set of GStreamer further, including introducing an improved - autoplugger module for even better handling of media formats. We will - also focus more attention at our media player sample application as - this is the application most users and developers probably will use to - get aquinted with the framework. - - For help building GStreamer, take a look at our build help document. + For help building GStreamer, take a look at our [1]build help document + . Updates and Enhancements - * new capabilities negotiation system - * xml support bugfixes - * sdlvideosink enhancements - * gst-xmllaunch added - * fixes in avi plugin - * fli plugin now works again - * fixes to old gstmediaplayer making it work - * lots of fixes on the v4l plugin - * new cdxa plugin - * new mjpeg encoder and decoder plugins - * new example plugin using GOB - * partial update of documentation and examples - * miscellaneous bugfixes + * modplug plugin, plays the same media as mikmod plugin but without + an external library dependency + * Ogg Tarkin encoding and decoding plugins + * New gst-launch-ext commandline tool for more failproof + mediaplayback + * Improvements on build system + * Audio/video masterclock system + * Problems with .vob playback with autoplugger fixed + * Fixes in avi and v4l plugins + * new gstrec plugin for improved video recording + * Consolidation of number of RPMS + * More portability work + * Documentation added to gstreamer RPM + * Devhelp (http://devhelp.sourceforge.net) books of GStreamer + documentation added + * new cothreads package + + portable machine context switching code taken from GNU Pth + (thanks, Ralf!) + + new stack allocation methods allow essentially infinite + number of cothreads with run-time configurability + + stack allocation code should be able to run within kernel + threads of all pthread implementations, unlike old cothreads + package + * new scheduler that uses the new cothreads package + + uses new cothreads package + + allows multiple managing bins (pipelines) within same pthread + (GThread actually) + + pass --gst-scheduler=standard to your app to use + * capsnego updates to many plugins + * complete switch to glib2 and libxml + * popt integration + * major update of dparams API + * many updates to the player application, finally + * Goom visualisation plugin now part of stable build + * Synaesthesia visualisation plugin now works + * Monoscope visualisation added + * ESD Monitor plugin added + * autogen.sh allows specification of different autoconf/automake + paths (beta) - More details on these features can be found, along with the release - tarballs and some RPMs, on the project's website, - http://gstreamer.net/. + More details on these features can be found on the project's website, + [2]http://gstreamer.net/. Source tarballs are also mirrored at + [3]http://gstreamer.net/releases/current/src/. If you use Red Hat (or + possibly other RPM-based systems), RPMs for both GStreamer itself, + external libraries and development tools not included in the standard + reference distribution (RedHat 7.2) can be found in + [4]http://gstreamer.net/releases/current/redhat. GStreamer is hosted on SourceForge, so support requests and bugs may be filed as usual. Interested developers of the core library, plugins, @@ -53,23 +84,36 @@ Updates and Enhancements Contributors to this release -Core + Core * Erik Walthinsen * Wim Taymans * Thomas Vander Stichele * Andy Wingo + * Benjamin Otte + * Michael Meeks + + Plugins and Sample Applications + + * Richard Boulton * David Lehn - -Plugins and Sample Applications - * Ronald Bultje * Bastien Nocera * Martin Enlund - * Benjamin Otte + * Leif Morgan Johnson + * Arik Devens + * Jérémy SIMON + * Zeeshan Ali Khattak + * Steve Baker -Misc + Misc * Christian Schaller * wrobell +References + + 1. http://gstreamer.net/releases/current/buildhelp.php + 2. http://gstreamer.net/ + 3. http://gstreamer.net/releases/current/src/ + 4. http://gstreamer.net/releases/current/redhat/ diff --git a/configure.ac b/configure.ac index ab41864a47..3c7180d624 100644 --- a/configure.ac +++ b/configure.ac @@ -2,7 +2,7 @@ AC_INIT AC_CANONICAL_TARGET([]) dnl when going to/from release please set the nano (fourth number) right ! -AS_VERSION(gstreamer, GST_VERSION, 0, 3, 2, 3) +AS_VERSION(gstreamer, GST_VERSION, 0, 3, 2, ) AM_INIT_AUTOMAKE($PACKAGE,$VERSION) AS_LIBTOOL(GST, 0, 0, 0, yes) diff --git a/docs/devhelp/gstreamer-libs.devhelp b/docs/devhelp/gstreamer-libs.devhelp index 0b35eef8ff..c746c99405 100644 --- a/docs/devhelp/gstreamer-libs.devhelp +++ b/docs/devhelp/gstreamer-libs.devhelp @@ -1,7 +1,7 @@ diff --git a/docs/devhelp/gstreamer.devhelp b/docs/devhelp/gstreamer.devhelp index 9075c7292b..b670a2a72d 100644 --- a/docs/devhelp/gstreamer.devhelp +++ b/docs/devhelp/gstreamer.devhelp @@ -1,7 +1,7 @@ @@ -58,568 +58,247 @@ - + - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - + @@ -628,46 +307,24 @@ - - - - - - - - - - - - - - - - - - - - - - @@ -682,743 +339,326 @@ - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - @@ -1466,8 +706,6 @@ - - diff --git a/docs/gst/tmpl/cothreads.sgml b/docs/gst/tmpl/cothreads.sgml index dc602cc86f..3d8a844694 100644 --- a/docs/gst/tmpl/cothreads.sgml +++ b/docs/gst/tmpl/cothreads.sgml @@ -35,6 +35,7 @@ Get the current stack frame. @ctx: @threadnum: +@priv: @func: @argc: @argv: @@ -136,26 +137,6 @@ Indicates the cothread is destroyed. @thread: - - - - - -@thread: -@key: -@data: - - - - - - - -@thread: -@key: -@Returns: - - diff --git a/docs/gst/tmpl/gstaggregator.sgml b/docs/gst/tmpl/gstaggregator.sgml index 0777fce60a..afcfb6f16c 100644 --- a/docs/gst/tmpl/gstaggregator.sgml +++ b/docs/gst/tmpl/gstaggregator.sgml @@ -40,3 +40,8 @@ methods to request buffers from its pads. + + + + + diff --git a/docs/gst/tmpl/gstbin.sgml b/docs/gst/tmpl/gstbin.sgml index 457df14988..d9f337d333 100644 --- a/docs/gst/tmpl/gstbin.sgml +++ b/docs/gst/tmpl/gstbin.sgml @@ -53,6 +53,7 @@ Flags for a bin. @GST_BIN_FLAG_MANAGER: @GST_BIN_SELF_SCHEDULABLE: @GST_BIN_FLAG_PREFER_COTHREADS: +@GST_BIN_FLAG_FIXED_CLOCK: @GST_BIN_FLAG_LAST: diff --git a/docs/gst/tmpl/gstcaps.sgml b/docs/gst/tmpl/gstcaps.sgml index 3dc368d8b0..f556aecef4 100644 --- a/docs/gst/tmpl/gstcaps.sgml +++ b/docs/gst/tmpl/gstcaps.sgml @@ -484,5 +484,6 @@ Get the value of the named property as a float. @caps: +@label: diff --git a/docs/gst/tmpl/gstclock.sgml b/docs/gst/tmpl/gstclock.sgml index 45b8c9a212..e045e38a32 100644 --- a/docs/gst/tmpl/gstclock.sgml +++ b/docs/gst/tmpl/gstclock.sgml @@ -42,51 +42,12 @@ timestamp is less than the second timestamp. -@name: +@object: @start_time: -@current_time: -@adjust: -@locking: -@sinkobjects: -@num: -@num_locked: -@sinkmutex: -@lock: - - - - - - -@name: -@Returns: - - - - - - - -@Returns: - - - - - - - -@clock: -@obj: - - - - - - - -@clock: -@time: - +@speed: +@active: +@active_mutex: +@active_cond: @@ -103,16 +64,8 @@ timestamp is less than the second timestamp. @clock: @time: +@Returns: + @obj: - - - - - -@clock: -@time: -@Returns: - - diff --git a/docs/gst/tmpl/gstelement.sgml b/docs/gst/tmpl/gstelement.sgml index ce417b5fb9..dc1c1da8a6 100644 --- a/docs/gst/tmpl/gstelement.sgml +++ b/docs/gst/tmpl/gstelement.sgml @@ -377,6 +377,7 @@ instead. @element: @pad: @name: +@Returns: @@ -570,14 +571,7 @@ Is trigered whenever an error occured @gstelement: the object which received the signal. @arg1: the error message - - - - - - -@gstelement: the object which received the signal. -@arg1: +@arg2: diff --git a/docs/gst/tmpl/gstevent.sgml b/docs/gst/tmpl/gstevent.sgml index c58ca09b84..8ef71f91fc 100644 --- a/docs/gst/tmpl/gstevent.sgml +++ b/docs/gst/tmpl/gstevent.sgml @@ -38,6 +38,7 @@ The different major types of events. @GST_EVENT_EMPTY: an empty event. @GST_EVENT_SEEK: a seek event. @GST_EVENT_DISCONTINUOUS: a discontinuous event to indicate the stream has a discontinuity. +@GST_EVENT_NEW_MEDIA: @GST_EVENT_INFO: an informational event @GST_EVENT_ERROR: an error event @@ -71,8 +72,10 @@ The different types of seek events. @GST_SEEK_ANY: the seek is performed anyway. -@GST_SEEK_TIMEOFFSET: this is a seek to specific timeoffset -@GST_SEEK_BYTEOFFSET: this is a seek to specific byteoffset +@GST_SEEK_TIMEOFFSET_SET: +@GST_SEEK_BYTEOFFSET_SET: +@GST_SEEK_BYTEOFFSET_CUR: +@GST_SEEK_BYTEOFFSET_END: diff --git a/docs/gst/tmpl/gstfakesink.sgml b/docs/gst/tmpl/gstfakesink.sgml index b0a7392774..b0c9fe8794 100644 --- a/docs/gst/tmpl/gstfakesink.sgml +++ b/docs/gst/tmpl/gstfakesink.sgml @@ -39,3 +39,8 @@ with the buffer. (fakesink) + + + + + diff --git a/docs/gst/tmpl/gstfakesrc.sgml b/docs/gst/tmpl/gstfakesrc.sgml index 8171c549d8..58611a1aa1 100644 --- a/docs/gst/tmpl/gstfakesrc.sgml +++ b/docs/gst/tmpl/gstfakesrc.sgml @@ -92,3 +92,8 @@ The GstFakeSrc generates empty buffers. (fakesrc) + + + + + diff --git a/docs/gst/tmpl/gstfilesrc.sgml b/docs/gst/tmpl/gstfilesrc.sgml index 404552b55b..555111af27 100644 --- a/docs/gst/tmpl/gstfilesrc.sgml +++ b/docs/gst/tmpl/gstfilesrc.sgml @@ -14,6 +14,11 @@ GstFileSrc + + + + + @@ -34,11 +39,6 @@ GstFileSrc - - - - - diff --git a/docs/gst/tmpl/gstidentity.sgml b/docs/gst/tmpl/gstidentity.sgml index defd51ed38..1835c706b6 100644 --- a/docs/gst/tmpl/gstidentity.sgml +++ b/docs/gst/tmpl/gstidentity.sgml @@ -52,3 +52,8 @@ Pass data without modification. + + + + + diff --git a/docs/gst/tmpl/gstobject.sgml b/docs/gst/tmpl/gstobject.sgml index 0e6e97867b..c265c123ff 100644 --- a/docs/gst/tmpl/gstobject.sgml +++ b/docs/gst/tmpl/gstobject.sgml @@ -279,6 +279,15 @@ Check if the object has been destroyed. @Returns: + + + + + +@gstobject: the object which received the signal. +@arg1: +@arg2: + Is trigered whenever a new object is saved to XML. You can connect to diff --git a/docs/gst/tmpl/gstpad.sgml b/docs/gst/tmpl/gstpad.sgml index 97d289aff8..a493015c34 100644 --- a/docs/gst/tmpl/gstpad.sgml +++ b/docs/gst/tmpl/gstpad.sgml @@ -537,9 +537,12 @@ Destroy the pad. -@pad: +@srcpad: +@sinkpad: @filtercaps: @Returns: + +@pad: @@ -547,9 +550,12 @@ Destroy the pad. -@pad: +@srcpad: +@sinkpad: @filtercaps: @Returns: + +@pad: diff --git a/docs/gst/tmpl/gstparse.sgml b/docs/gst/tmpl/gstparse.sgml index 58ef86a314..b97b55c8ea 100644 --- a/docs/gst/tmpl/gstparse.sgml +++ b/docs/gst/tmpl/gstparse.sgml @@ -53,6 +53,7 @@ can be made with . @GST_PARSE_ERROR_CREATING_ELEMENT: @GST_PARSE_ERROR_NOSUCH_ELEMENT: @GST_PARSE_ERROR_INTERNAL: +@GST_PARSE_ERROR_CONNECT: diff --git a/docs/gst/tmpl/gstreamer-unused.sgml b/docs/gst/tmpl/gstreamer-unused.sgml index 55504ee4e5..d9b85b0bf9 100644 --- a/docs/gst/tmpl/gstreamer-unused.sgml +++ b/docs/gst/tmpl/gstreamer-unused.sgml @@ -2616,6 +2616,14 @@ Get the size of the file. @GST_DISKSRC_OPEN: @GST_DISKSRC_FLAG_LAST: + + + + + +@gstelement: the object which received the signal. +@arg1: + @@ -3237,6 +3245,15 @@ must be defined to activate the tracing functionality. + + + + + +@thread: +@key: +@Returns: + @@ -3250,6 +3267,15 @@ must be defined to activate the tracing functionality. @Returns: + + + + + +@thread: +@key: +@data: + @@ -4306,6 +4332,46 @@ must be defined to activate the tracing functionality. @Returns: @count: + + + + + +@clock: +@time: +@Returns: + + + + + + +@Returns: + + + + + + +@name: +@Returns: + + + + + + +@clock: +@obj: + + + + + + +@clock: +@time: + diff --git a/docs/gst/tmpl/gsttee.sgml b/docs/gst/tmpl/gsttee.sgml index f5be67fe4d..868ee2ba91 100644 --- a/docs/gst/tmpl/gsttee.sgml +++ b/docs/gst/tmpl/gsttee.sgml @@ -24,3 +24,8 @@ A tee can be used to split out the filter graph. + + + + +