From a44593349c05e8fe4f65ee1ca6b26120b37137ae Mon Sep 17 00:00:00 2001 From: Stefan Kost Date: Tue, 30 Aug 2005 17:23:19 +0000 Subject: [PATCH] more docs and two more inlined Original commit message from CVS: * docs/gst/tmpl/.cvsignore: * docs/gst/tmpl/gstformat.sgml: * docs/gst/tmpl/gstversion.sgml: * gst/gstbus.h: * gst/gstformat.c: * gst/gstformat.h: * gst/gstversion.h.in: more docs and two more inlined --- ChangeLog | 11 +++++ docs/gst/tmpl/.gitignore | 3 ++ docs/gst/tmpl/gstformat.sgml | 102 ------------------------------------------ docs/gst/tmpl/gstversion.sgml | 51 --------------------- gst/gstbus.h | 3 +- gst/gstformat.c | 8 ++++ gst/gstformat.h | 30 +++++++++++++ gst/gstversion.h.in | 35 ++++++++++++--- 8 files changed, 83 insertions(+), 160 deletions(-) delete mode 100644 docs/gst/tmpl/gstformat.sgml delete mode 100644 docs/gst/tmpl/gstversion.sgml diff --git a/ChangeLog b/ChangeLog index c3c58c8..a3a95c2 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,14 @@ +2005-08-30 Stefan Kost + + * docs/gst/tmpl/.cvsignore: + * docs/gst/tmpl/gstformat.sgml: + * docs/gst/tmpl/gstversion.sgml: + * gst/gstbus.h: + * gst/gstformat.c: + * gst/gstformat.h: + * gst/gstversion.h.in: + more docs and two more inlined + 2005-08-30 Wim Taymans * gst/elements/gstfilesink.c: (gst_file_sink_class_init): diff --git a/docs/gst/tmpl/.gitignore b/docs/gst/tmpl/.gitignore index 9ac1756..12cb4b1 100644 --- a/docs/gst/tmpl/.gitignore +++ b/docs/gst/tmpl/.gitignore @@ -19,10 +19,13 @@ gstfakesrc.sgml gstfakesink.sgml gstfilesrc.sgml gstfilesink.sgml +gstformat.sgml gstmessage.sgml gstminiobject.sgml gstprobe.sgml gstpushsrc.sgml gstquery.sgml gsttask.sgml +gstversion.sgml gstxmlregistry.sgml + diff --git a/docs/gst/tmpl/gstformat.sgml b/docs/gst/tmpl/gstformat.sgml deleted file mode 100644 index 8878345..0000000 --- a/docs/gst/tmpl/gstformat.sgml +++ /dev/null @@ -1,102 +0,0 @@ - -GstFormat - - -Dynamically register new formats - - - -GstFormats functions are used to register a new format to the gstreamer core. -formats can be used to perform seeking or conversions/query operations. - - - - -#GstPad, #GstElement - - - - - - - -Standard predefined formats - - -@GST_FORMAT_UNDEFINED: undefined format -@GST_FORMAT_DEFAULT: the default format of the pad/element -@GST_FORMAT_BYTES: bytes -@GST_FORMAT_TIME: time in nanoseconds -@GST_FORMAT_BUFFERS: buffers -@GST_FORMAT_PERCENT: percentage of stream - - - -The PERCENT format is between 0 and this value - - - - - - -The value used to scale down the reported PERCENT format value to -its real value. - - - - - - -A format definition - - -@value: The unique id of this format -@nick: A short nick of the format -@description: A longer description of the format - - - - - - -@nick: -@description: -@Returns: - - - - - - - -@nick: -@Returns: - - - - - - - -@formats: -@format: -@Returns: - - - - - - - -@format: -@Returns: - - - - - - - -@Returns: - - diff --git a/docs/gst/tmpl/gstversion.sgml b/docs/gst/tmpl/gstversion.sgml deleted file mode 100644 index 4a17d3c..0000000 --- a/docs/gst/tmpl/gstversion.sgml +++ /dev/null @@ -1,51 +0,0 @@ - -GstVersion - - -GStreamer version macros. - - - -Use these macros e.g. when defining own plugins. -The version macros get defined by including "gst/gst.h". - - - - - - - - - - - - -The major version of GStreamer at compile time - - - - - - -The minor version of GStreamer at compile time - - - - - - -The micro version of GStreamer at compile time - - - - - - - - - -@major: -@minor: -@micro: - - diff --git a/gst/gstbus.h b/gst/gstbus.h index f57430d..54eb2c6 100644 --- a/gst/gstbus.h +++ b/gst/gstbus.h @@ -71,7 +71,8 @@ typedef GstBusSyncReply (*GstBusSyncHandler) (GstBus * bus, GstMessage * messag * @data: user data that has been given, when registering the handler * * Handler will be invoked asynchronously, after a new message has been injected - * into the bus. + * into the bus. Return %TRUE if the message has been handled. It will then be + * taken from the bus and _unref()'ed. * * Returns: %TRUE if message should be taken from the bus */ diff --git a/gst/gstformat.c b/gst/gstformat.c index 975be25..2ffb77b 100644 --- a/gst/gstformat.c +++ b/gst/gstformat.c @@ -20,6 +20,14 @@ * Free Software Foundation, Inc., 59 Temple Place - Suite 330, * Boston, MA 02111-1307, USA. */ +/** + * SECTION:gstformat + * @short_description: Dynamically register new data formats + * @see_also: #GstPad, #GstElement + * + * GstFormats functions are used to register a new format to the gstreamer core. + * Formats can be used to perform seeking or conversions/query operations. + */ #include diff --git a/gst/gstformat.h b/gst/gstformat.h index 909f9d9..f38f3d4 100644 --- a/gst/gstformat.h +++ b/gst/gstformat.h @@ -31,6 +31,17 @@ G_BEGIN_DECLS +/** + * GstFormat: + * @GST_FORMAT_UNDEFINED: undefined format + * @GST_FORMAT_DEFAULT: the default format of the pad/element + * @GST_FORMAT_BYTES: bytes + * @GST_FORMAT_TIME: time in nanoseconds + * @GST_FORMAT_BUFFERS: buffers + * @GST_FORMAT_PERCENT: percentage of stream + * + * Standard predefined formats + */ typedef enum { GST_FORMAT_UNDEFINED = 0, /* must be first in list */ GST_FORMAT_DEFAULT = 1, /* samples for audio, frames/fields for video */ @@ -41,11 +52,30 @@ typedef enum { } GstFormat; /* a percentage is always relative to 1000000 */ +/** + * GST_FORMAT_PERCENT_MAX: + * + * The PERCENT format is between 0 and this value + */ #define GST_FORMAT_PERCENT_MAX G_GINT64_CONSTANT (1000000) +/** + * GST_FORMAT_PERCENT_SCALE: + * + * The value used to scale down the reported PERCENT format value to + * its real value. + */ #define GST_FORMAT_PERCENT_SCALE G_GINT64_CONSTANT (10000) typedef struct _GstFormatDefinition GstFormatDefinition; +/** + * GstFormatDefinition: + * @value: The unique id of this format + * @nick: A short nick of the format + * @description: A longer description of the format + * + * A format definition + */ struct _GstFormatDefinition { GstFormat value; diff --git a/gst/gstversion.h.in b/gst/gstversion.h.in index 048a2c3..5424073 100644 --- a/gst/gstversion.h.in +++ b/gst/gstversion.h.in @@ -19,21 +19,44 @@ * Free Software Foundation, Inc., 59 Temple Place - Suite 330, * Boston, MA 02111-1307, USA. */ - +/** + * SECTION:gstversion + * @short_description: GStreamer version macros. + * + * Use the GST_VERSION_* macros e.g. when defining own plugins. The GStreamer + * runtime checks if these plugin and core version match and refuses to use a + * plugin compiled against a different version of GStreamer. + * You can also use the macros to keep the GStreamer version information in your + * application. + * + * Use the gst_version() function if you want to know which version of + * GStreamer you are currently linked against. + * + * The version macros get defined by including "gst/gst.h". + */ #ifndef __GST_VERSION_H__ #define __GST_VERSION_H__ G_BEGIN_DECLS -/* - * Use these only when you want to know what GStreamer version your stuff was - * compiled against. - * Use the #gst_version function if you want to know which version of - * GStreamer you are currently linked against. +/** + * GST_VERSION_MAJOR: + * + * The major version of GStreamer at compile time: */ #define GST_VERSION_MAJOR (@GST_VERSION_MAJOR@) +/** + * GST_VERSION_MINOR: + * + * The minor version of GStreamer at compile time: + */ #define GST_VERSION_MINOR (@GST_VERSION_MINOR@) +/** + * GST_VERSION_MICRO: + * + * The micro version of GStreamer at compile time: + */ #define GST_VERSION_MICRO (@GST_VERSION_MICRO@) void gst_version (guint *major, guint *minor, guint *micro); -- 2.7.4