From: Thomas V. S. <tho...@us...> - 2003-05-18 15:04:39
|
CVS Root: /cvsroot/gstreamer Module: gstreamer Changes by: thomasvs Date: Sun May 18 2003 08:04:38 PDT Log message: converting to xml as intermediary step to fix devhelp generation assorted doc build fixes as well http://bugzilla.gnome.org/show_bug.cgi?id=113195 Modified files: docs : Makefile.am docs/gst : Makefile.am gstreamer-docs.sgml gstreamer-sections.txt docs/libs : Makefile.am gstreamer-libs-docs.sgml gstreamer-libs-sections.txt Links: http://cvs.sf.net/cgi-bin/viewcvs.cgi/gstreamer/gstreamer/docs/Makefile.am.diff?r1=1.22&r2=1.23 http://cvs.sf.net/cgi-bin/viewcvs.cgi/gstreamer/gstreamer/docs/gst/Makefile.am.diff?r1=1.49&r2=1.50 http://cvs.sf.net/cgi-bin/viewcvs.cgi/gstreamer/gstreamer/docs/gst/gstreamer-docs.sgml.diff?r1=1.35&r2=1.36 http://cvs.sf.net/cgi-bin/viewcvs.cgi/gstreamer/gstreamer/docs/gst/gstreamer-sections.txt.diff?r1=1.64&r2=1.65 http://cvs.sf.net/cgi-bin/viewcvs.cgi/gstreamer/gstreamer/docs/libs/Makefile.am.diff?r1=1.10&r2=1.11 http://cvs.sf.net/cgi-bin/viewcvs.cgi/gstreamer/gstreamer/docs/libs/gstreamer-libs-docs.sgml.diff?r1=1.2&r2=1.3 http://cvs.sf.net/cgi-bin/viewcvs.cgi/gstreamer/gstreamer/docs/libs/gstreamer-libs-sections.txt.diff?r1=1.2&r2=1.3 ====Begin Diffs==== Index: Makefile.am =================================================================== RCS file: /cvsroot/gstreamer/gstreamer/docs/Makefile.am,v retrieving revision 1.22 retrieving revision 1.23 diff -u -d -r1.22 -r1.23 --- Makefile.am 19 Oct 2002 09:20:13 -0000 1.22 +++ Makefile.am 18 May 2003 15:04:25 -0000 1.23 @@ -5,8 +5,8 @@ SUBDIRS_PLUGINS = endif -SUBDIRS = faq manual pwg gst libs $(SUBDIRS_PLUGINS) devhelp -DIST_SUBDIRS = faq manual pwg gst libs plugins xsl devhelp +SUBDIRS = faq manual pwg gst libs $(SUBDIRS_PLUGINS) +DIST_SUBDIRS = faq manual pwg gst libs plugins xsl EXTRA_DIST = slides manuals.mak Index: Makefile.am =================================================================== RCS file: /cvsroot/gstreamer/gstreamer/docs/gst/Makefile.am,v retrieving revision 1.49 retrieving revision 1.50 diff -u -d -r1.49 -r1.50 --- Makefile.am 8 Dec 2002 14:39:33 -0000 1.49 +++ Makefile.am 18 May 2003 15:04:25 -0000 1.50 @@ -1,8 +1,29 @@ ## Process this file with automake to produce Makefile.in # The name of the module, e.g. 'glib'. +# DOC_MODULE=gstreamer-@GST_MAJORMINOR@ DOC_MODULE=gstreamer +# generated basefiles +#basefiles = \ +# gstreamer-@GST_MAJORMINOR@.types \ +# gstreamer-@GST_MAJORMINOR@-sections.txt \ +# gstreamer-@GST_MAJORMINOR@-docs.sgml + +# ugly hack to make -unused.sgml work +#unused-build.stamp: +# BUILDDIR=`pwd` && \ +# cd $(srcdir)/tmpl && \ +# ln -sf gstreamer-unused.sgml \ +# $$BUILDDIR/tmpl/gstreamer-@GST_MAJORMINOR@-unused.sgml +# touch unused-build.stamp + +# these rules are added to create parallel docs using GST_MAJORMINOR +#$(basefiles): gstreamer-@GST_MAJORMINOR@%: gstreamer% +# cp $< $@ + +#CLEANFILES = $(basefiles) + # The top-level SGML file. Change it if you want. DOC_MAIN_SGML_FILE=$(DOC_MODULE)-docs.sgml @@ -20,21 +41,21 @@ #EXTRA_DIST = gstreamer.types.in gstreamer.hierarchy $(DOC_MODULE)-sections.txt gstreamer-sections.txt $(DOC_MAIN_SGML_FILE) # Extra options to supply to gtkdoc-mkdb. -MKDB_OPTIONS= +MKDB_OPTIONS=--sgml-mode --output-format=xml --ignore-files=trio # Extra options to supply to gtkdoc-fixref. FIXXREF_OPTIONS= # Used for dependencies. -# FIXME deal with the subdirs too... HFILE_GLOB=$(DOC_SOURCE_DIR)/*.h CFILE_GLOB=$(DOC_SOURCE_DIR)/*.c # this is a wingo addition # thomasvs: another nice wingo addition would be an explanation on why # this is useful ;) -SCANOBJ_DEPS = $(top_builddir)/gst/elements/libgstelements.la \ - $(top_builddir)/gst/schedulers/libgstbasicomegascheduler.la + +#SCANOBJ_DEPS = $(top_builddir)/gst/elements/libgstelements.la \ +# $(top_builddir)/gst/schedulers/libgstbasicomegascheduler.la # Header files to ignore when scanning. IGNORE_HFILES= @@ -65,8 +86,17 @@ ########################################################################### # Everything below here is generic and you shouldn't need to change it. ########################################################################### +# thomas: except of course that we did -# added majorminor here because we want parallel installs +# thomas: copied from glib-2 +# We set GPATH here; this gives us semantics for GNU make +# which are more like other make's VPATH, when it comes to +# whether a source that is a target of one rule is then +# searched for in VPATH/GPATH. +# +GPATH = $(srcdir) + +# thomas: make docs parallel installable TARGET_DIR=$(HTML_DIR)/$(DOC_MODULE)-@GST_MAJORMINOR@ EXTRA_DIST = \ @@ -90,8 +120,9 @@ #### scan #### + # wingo addition -scan-build.stamp: $(HFILE_GLOB) $(SCANOBJ_DEPS) +scan-build.stamp: $(HFILE_GLOB) $(SCANOBJ_DEPS) $(basefiles) @echo '*** Scanning header files ***' if grep -l '^..*$$' $(srcdir)/$(DOC_MODULE).types > /dev/null ; then \ CC="$(GTKDOC_CC)" LD="$(GTKDOC_LD)" CFLAGS="$(GTKDOC_CFLAGS)" LDFLAGS="$(GTKDOC_LIBS)" $(GTK_DOC_SCANOBJ) --module=$(DOC_MODULE) --output-dir=$(srcdir) ; \ @@ -131,18 +162,22 @@ #### html #### +# FIXME: setting LANG=C is a hack to work with gtk-doc < 1.1, because +# that forces a non-utf8 locale. gtk-doc >= 1.1 solves this by calling +# use bytes; in gtkdoc-fixxref html-build.stamp: sgml.stamp $(DOC_MAIN_SGML_FILE) $(content_files) @echo '*** Building HTML ***' test -d $(srcdir)/html || mkdir $(srcdir)/html cd $(srcdir)/html && gtkdoc-mkhtml $(DOC_MODULE) ../$(DOC_MAIN_SGML_FILE) test "x$(HTML_IMAGES)" = "x" || ( cd $(srcdir) && cp $(HTML_IMAGES) html ) @echo '-- Fixing Crossreferences' - cd $(srcdir) && gtkdoc-fixxref --module-dir=html --html-dir=$(HTML_DIR) $(FIXXREF_OPTIONS) + cd $(srcdir) && LANG=C && gtkdoc-fixxref --module-dir=html --html-dir=$(HTML_DIR) $(FIXXREF_OPTIONS) touch html-build.stamp endif clean-local: rm -f *~ *.bak $(SCANOBJ_FILES) *-unused.txt $(DOC_STAMPS) + rm -rf xml html maintainer-clean-local: clean cd $(srcdir) && rm -rf sgml html $(DOC_MODULE)-decl-list.txt $(DOC_MODULE)-decl.txt @@ -151,14 +186,15 @@ # make distcheck work distclean-local: clean rm -rf $(DOC_MODULE)-decl-list.txt - rm -rf gstreamer-*.txt + rm -rf $(DOC_MODULE)-*.txt rm -rf tmpl/*.sgml - rm -f gstreamer.hierarchy + rm -f $(DOC_MODULE).hierarchy rm -f *.stamp || true +# thomas: make docs parallel installable; devhelp requires majorminor too install-data-local: $(mkinstalldirs) $(DESTDIR)$(TARGET_DIR) - (installfiles=`echo $(srcdir)/html/*.html`; \ + (installfiles=`echo $(srcdir)/html/*.html $(srcdir)/html/*.png`; \ if test "$$installfiles" = '$(srcdir)/html/*.html'; \ then echo '-- Nothing to install' ; \ else \ @@ -166,6 +202,9 @@ echo '-- Installing '$$i ; \ $(INSTALL_DATA) $$i $(DESTDIR)$(TARGET_DIR); \ done; \ + echo '-- Installing $(srcdir)/html/$(DOC_MODULE).devhelp' ; \ + $(INSTALL_DATA) $(srcdir)/html/$(DOC_MODULE).devhelp \ + $(DESTDIR)$(TARGET_DIR)/$(DOC_MODULE)-@GST_MAJORMINOR@.devhelp; \ echo '-- Installing $(srcdir)/html/index.sgml' ; \ $(INSTALL_DATA) $(srcdir)/html/index.sgml $(DESTDIR)$(TARGET_DIR); \ fi) @@ -183,10 +222,10 @@ dist-hook: dist-check-gtkdoc dist-hook-local mkdir $(distdir)/tmpl - mkdir $(distdir)/sgml + mkdir $(distdir)/xml mkdir $(distdir)/html -cp $(srcdir)/tmpl/*.sgml $(distdir)/tmpl - -cp $(srcdir)/sgml/*.sgml $(distdir)/sgml + -cp $(srcdir)/sgml/*.xml $(distdir)/xml -cp $(srcdir)/html/index.sgml $(distdir)/html -cp $(srcdir)/html/*.html $(srcdir)/html/*.css $(distdir)/html Index: gstreamer-docs.sgml =================================================================== RCS file: /cvsroot/gstreamer/gstreamer/docs/gst/gstreamer-docs.sgml,v retrieving revision 1.35 retrieving revision 1.36 diff -u -d -r1.35 -r1.36 --- gstreamer-docs.sgml 10 Feb 2003 23:00:38 -0000 1.35 +++ gstreamer-docs.sgml 18 May 2003 15:04:25 -0000 1.36 @@ -1,70 +1,73 @@ -<!doctype book PUBLIC "-//Davenport//DTD DocBook V3.0//EN" [ - -<!entity Gst SYSTEM "sgml/gst.sgml"> -<!entity GstAutoplug SYSTEM "sgml/gstautoplug.sgml"> -<!entity GstAutoplugFactory SYSTEM "sgml/gstautoplugfactory.sgml"> -<!entity GstAtomic SYSTEM "sgml/gstatomic.sgml"> -<!entity GstBin SYSTEM "sgml/gstbin.sgml"> -<!entity GstData SYSTEM "sgml/gstdata.sgml"> -<!entity GstBuffer SYSTEM "sgml/gstbuffer.sgml"> -<!entity GstEvent SYSTEM "sgml/gstevent.sgml"> -<!entity GstBufferPool SYSTEM "sgml/gstbufferpool.sgml"> -<!entity GstCpu SYSTEM "sgml/gstcpu.sgml"> -<!entity GstElement SYSTEM "sgml/gstelement.sgml"> -<!entity GstElementFactory SYSTEM "sgml/gstelementfactory.sgml"> -<!entity GstFormat SYSTEM "sgml/gstformat.sgml"> -<!entity GstInfo SYSTEM "sgml/gstinfo.sgml"> -<!entity GstLog SYSTEM "sgml/gstlog.sgml"> -<!entity GstMemChunk SYSTEM "sgml/gstmemchunk.sgml"> -<!entity GstObject SYSTEM "sgml/gstobject.sgml"> -<!entity GstPad SYSTEM "sgml/gstpad.sgml"> -<!entity GstPadTemplate SYSTEM "sgml/gstpadtemplate.sgml"> -<!entity GstParse SYSTEM "sgml/gstparse.sgml"> -<!entity GstProbe SYSTEM "sgml/gstprobe.sgml"> -<!entity GstPipeline SYSTEM "sgml/gstpipeline.sgml"> -<!entity GstPlugin SYSTEM "sgml/gstplugin.sgml"> -<!entity GstPluginFeature SYSTEM "sgml/gstpluginfeature.sgml"> -<!entity GstQuery SYSTEM "sgml/gstquery.sgml"> -<!entity GstThread SYSTEM "sgml/gstthread.sgml"> -<!entity GstRegistry SYSTEM "sgml/gstregistry.sgml"> -<!entity GstRegistryPool SYSTEM "sgml/gstregistrypool.sgml"> -<!entity GstScheduler SYSTEM "sgml/gstscheduler.sgml"> -<!entity GstSchedulerFactory SYSTEM "sgml/gstschedulerfactory.sgml"> -<!entity GstTrace SYSTEM "sgml/gsttrace.sgml"> -<!entity GstType SYSTEM "sgml/gsttype.sgml"> -<!entity GstTypeFactory SYSTEM "sgml/gsttypefactory.sgml"> -<!entity GstCaps SYSTEM "sgml/gstcaps.sgml"> -<!entity GstProps SYSTEM "sgml/gstprops.sgml"> -<!entity GstClock SYSTEM "sgml/gstclock.sgml"> -<!entity GstSystemClock SYSTEM "sgml/gstsystemclock.sgml"> -<!entity GstUtils SYSTEM "sgml/gstutils.sgml"> -<!entity GstUri SYSTEM "sgml/gsturi.sgml"> -<!entity GstXML SYSTEM "sgml/gstxml.sgml"> -<!entity GstQueue SYSTEM "sgml/gstqueue.sgml"> -<!entity GstTypeFind SYSTEM "sgml/gsttypefind.sgml"> -<!entity GstIndex SYSTEM "sgml/gstindex.sgml"> -<!entity GstIndexFactory SYSTEM "sgml/gstindexfactory.sgml"> -<!entity cothreads SYSTEM "sgml/cothreads.sgml"> +<?xml version="1.0"?> +<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" + "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [ +<!ENTITY Gst SYSTEM "xml/gst.xml"> +<!ENTITY GstAutoplug SYSTEM "xml/gstautoplug.xml"> +<!ENTITY GstAutoplugFactory SYSTEM "xml/gstautoplugfactory.xml"> +<!ENTITY GstAtomic SYSTEM "xml/gstatomic.xml"> +<!ENTITY GstBin SYSTEM "xml/gstbin.xml"> +<!ENTITY GstData SYSTEM "xml/gstdata.xml"> +<!ENTITY GstBuffer SYSTEM "xml/gstbuffer.xml"> +<!ENTITY GstEvent SYSTEM "xml/gstevent.xml"> +<!ENTITY GstBufferPool SYSTEM "xml/gstbufferpool.xml"> +<!ENTITY GstCpu SYSTEM "xml/gstcpu.xml"> +<!ENTITY GstElement SYSTEM "xml/gstelement.xml"> +<!ENTITY GstElementFactory SYSTEM "xml/gstelementfactory.xml"> +<!ENTITY GstFormat SYSTEM "xml/gstformat.xml"> +<!ENTITY GstInfo SYSTEM "xml/gstinfo.xml"> +<!ENTITY GstLog SYSTEM "xml/gstlog.xml"> +<!ENTITY GstMemChunk SYSTEM "xml/gstmemchunk.xml"> +<!ENTITY GstObject SYSTEM "xml/gstobject.xml"> +<!ENTITY GstPad SYSTEM "xml/gstpad.xml"> +<!ENTITY GstPadTemplate SYSTEM "xml/gstpadtemplate.xml"> +<!ENTITY GstParse SYSTEM "xml/gstparse.xml"> +<!ENTITY GstProbe SYSTEM "xml/gstprobe.xml"> +<!ENTITY GstPipeline SYSTEM "xml/gstpipeline.xml"> +<!ENTITY GstPlugin SYSTEM "xml/gstplugin.xml"> +<!ENTITY GstPluginFeature SYSTEM "xml/gstpluginfeature.xml"> +<!ENTITY GstQuery SYSTEM "xml/gstquery.xml"> +<!ENTITY GstThread SYSTEM "xml/gstthread.xml"> +<!ENTITY GstRegistry SYSTEM "xml/gstregistry.xml"> +<!ENTITY GstRegistryPool SYSTEM "xml/gstregistrypool.xml"> +<!ENTITY GstScheduler SYSTEM "xml/gstscheduler.xml"> +<!ENTITY GstSchedulerFactory SYSTEM "xml/gstschedulerfactory.xml"> +<!ENTITY GstTrace SYSTEM "xml/gsttrace.xml"> +<!ENTITY GstType SYSTEM "xml/gsttype.xml"> +<!ENTITY GstTypeFactory SYSTEM "xml/gsttypefactory.xml"> +<!ENTITY GstCaps SYSTEM "xml/gstcaps.xml"> +<!ENTITY GstProps SYSTEM "xml/gstprops.xml"> +<!ENTITY GstClock SYSTEM "xml/gstclock.xml"> +<!ENTITY GstSystemClock SYSTEM "xml/gstsystemclock.xml"> +<!ENTITY GstUtils SYSTEM "xml/gstutils.xml"> +<!ENTITY GstUri SYSTEM "xml/gsturi.xml"> +<!ENTITY GstXML SYSTEM "xml/gstxml.xml"> +<!-- these are elements without API docs +<!ENTITY GstQueue SYSTEM "xml/gstqueue.xml"> +<!ENTITY GstTypeFind SYSTEM "xml/gsttypefind.xml"> +--> +<!ENTITY GstIndex SYSTEM "xml/gstindex.xml"> +<!ENTITY GstIndexFactory SYSTEM "xml/gstindexfactory.xml"> +<!ENTITY cothreads SYSTEM "xml/cothreads.xml"> -<!entity GstStaticAutoplug SYSTEM "sgml/gststaticautoplug.sgml"> -<!entity GstStaticAutoplugRender SYSTEM "sgml/gststaticautoplugrender.sgml"> -<!entity GstAggregator SYSTEM "sgml/gstaggregator.sgml"> -<!entity GstFakeSrc SYSTEM "sgml/gstfakesrc.sgml"> -<!entity GstFakeSink SYSTEM "sgml/gstfakesink.sgml"> -<!entity GstFileSrc SYSTEM "sgml/gstfilesrc.sgml"> -<!entity GstDiskSink SYSTEM "sgml/gstdisksink.sgml"> -<!entity GstFdSrc SYSTEM "sgml/gstfdsrc.sgml"> -<!entity GstFdSink SYSTEM "sgml/gstfdsink.sgml"> -<!entity GstIdentity SYSTEM "sgml/gstidentity.sgml"> -<!entity GstPipefilter SYSTEM "sgml/gstpipefilter.sgml"> -<!entity GstStatistics SYSTEM "sgml/gststatistics.sgml"> -<!entity GstMD5Sink SYSTEM "sgml/gstmd5sink.sgml"> -<!entity GstTee SYSTEM "sgml/gsttee.sgml"> +<!-- if none of the API is documented, these shouldn't go in +<!ENTITY GstStaticAutoplug SYSTEM "xml/gststaticautoplug.xml"> +<!ENTITY GstStaticAutoplugRender SYSTEM "xml/gststaticautoplugrender.xml"> +--> +<!ENTITY GstAggregator SYSTEM "xml/gstaggregator.xml"> +<!ENTITY GstFakeSrc SYSTEM "xml/gstfakesrc.xml"> +<!ENTITY GstFakeSink SYSTEM "xml/gstfakesink.xml"> +<!ENTITY GstFileSrc SYSTEM "xml/gstfilesrc.xml"> +<!ENTITY GstDiskSink SYSTEM "xml/gstdisksink.xml"> +<!ENTITY GstFdSrc SYSTEM "xml/gstfdsrc.xml"> +<!ENTITY GstFdSink SYSTEM "xml/gstfdsink.xml"> +<!ENTITY GstIdentity SYSTEM "xml/gstidentity.xml"> +<!ENTITY GstPipefilter SYSTEM "xml/gstpipefilter.xml"> +<!ENTITY GstStatistics SYSTEM "xml/gststatistics.xml"> +<!ENTITY GstMD5Sink SYSTEM "xml/gstmd5sink.xml"> +<!ENTITY GstTee SYSTEM "xml/gsttee.xml"> -<!entity gstreamer-tree-index SYSTEM "sgml/tree_index.sgml"> +<!ENTITY gstreamer-tree-index SYSTEM "xml/tree_index.xml"> ]> - - <book> <bookinfo> <title>GStreamer Core Reference Manual</title> @@ -114,7 +117,8 @@ &GstProbe; &GstProps; &GstQuery; - &GstQueue; +<!-- no API docs + &GstQueue; --> &GstRegistry; &GstRegistryPool; &GstScheduler; @@ -123,7 +127,8 @@ &GstThread; &GstType; &GstTypeFactory; - &GstTypeFind; +<!-- no API docs + &GstTypeFind; --> &GstUri; &GstUtils; &GstXML; @@ -161,6 +166,7 @@ --> </chapter> +<!-- no API is documented of these elements <chapter id="autopluggers"> <title>GStreamer Autopluggers</title> @@ -170,7 +176,9 @@ &GstStaticAutoplug; &GstStaticAutoplugRender; </chapter> +--> +<!-- <chapter id="gst-index"> <title>Index</title> @@ -179,4 +187,5 @@ &gstreamer-tree-index; </sect1> </chapter> +--> </book> Index: gstreamer-sections.txt =================================================================== RCS file: /cvsroot/gstreamer/gstreamer/docs/gst/gstreamer-sections.txt,v retrieving revision 1.64 retrieving revision 1.65 diff -u -d -r1.64 -r1.65 --- gstreamer-sections.txt 11 Feb 2003 20:38:41 -0000 1.64 +++ gstreamer-sections.txt 18 May 2003 15:04:25 -0000 1.65 @@ -2,10 +2,9 @@ <SECTION> <FILE>cothreads</FILE> -CURRENT_STACK_FRAME cothread_state -cothread_context cothread_func +cothread_context COTHREAD_STARTED COTHREAD_DESTROYED cothread_context_init @@ -127,7 +126,6 @@ GST_SCHEDULER_STATE GstSchedulerState GstSchedulerFlags -gst_scheduler_destroy gst_scheduler_setup gst_scheduler_reset gst_scheduler_add_element @@ -214,7 +212,6 @@ GstBin GstBinPrePostIterateFunction gst_bin_new -gst_bin_destroy gst_bin_add gst_bin_add_many gst_bin_remove @@ -280,7 +277,6 @@ GstDataFreeFunction GstDataCopyFunction GstDataFlags -GST_DATA_IS_READONLY GST_DATA_REFCOUNT GST_DATA_REFCOUNT_VALUE GST_DATA_COPY_FUNC @@ -289,7 +285,6 @@ gst_data_dispose gst_data_copy_into gst_data_copy -gst_data_needs_copy_on_write gst_data_copy_on_write gst_data_free gst_data_ref @@ -337,7 +332,6 @@ gst_buffer_ref_by_count gst_buffer_unref gst_buffer_copy -gst_buffer_needs_copy_on_write gst_buffer_copy_on_write gst_buffer_free gst_buffer_create_sub @@ -373,7 +367,6 @@ gst_buffer_pool_get_user_data gst_buffer_pool_get_default gst_buffer_pool_default_free -gst_buffer_pool_needs_copy_on_write <SUBSECTION Standard> GST_TYPE_BUFFER_POOL </SECTION> @@ -442,7 +435,6 @@ <FILE>gstelement</FILE> <TITLE>GstElement</TITLE> GstElement -gst_element_destroy gst_element_get_name gst_element_set_name gst_element_get_factory @@ -817,7 +809,6 @@ gst_object_unref gst_object_replace gst_object_sink -gst_object_destroy gst_object_save_thyself gst_object_restore_thyself gst_object_get_path_string @@ -900,7 +891,6 @@ gst_pad_new gst_pad_custom_new gst_pad_custom_new_from_template -gst_pad_destroy gst_pad_new_from_template gst_pad_get_direction gst_pad_set_chain_function @@ -1100,7 +1090,6 @@ <TITLE>GstPipeline</TITLE> GstPipeline gst_pipeline_new -gst_pipeline_destroy <SUBSECTION Standard> GstPipelineClass gst_pipeline_get_type @@ -1369,7 +1358,6 @@ gst_props_set gst_props_get gst_props_get_safe -gst_props_has_property gst_props_has_fixed_property gst_props_has_property_typed gst_props_intersect @@ -1386,6 +1374,7 @@ gst_props_entry_copy gst_props_entry_destroy gst_props_entry_get +gst_props_entry_get_type gst_props_entry_get_boolean gst_props_entry_get_float gst_props_entry_get_float_range Index: Makefile.am =================================================================== RCS file: /cvsroot/gstreamer/gstreamer/docs/libs/Makefile.am,v retrieving revision 1.10 retrieving revision 1.11 diff -u -d -r1.10 -r1.11 --- Makefile.am 8 Dec 2002 14:39:35 -0000 1.10 +++ Makefile.am 18 May 2003 15:04:26 -0000 1.11 @@ -1,51 +1,198 @@ ## Process this file with automake to produce Makefile.in -# The name of the module. +# The name of the module, e.g. 'glib'. +#DOC_MODULE=gstreamer-libs-@GST_MAJORMINOR@ DOC_MODULE=gstreamer-libs -# The top-level SGML file. +# generated basefiles +#basefiles = \ +## $(DOC_MODULE).types \ +# $(DOC_MODULE)-sections.txt \ +# $(DOC_MODULE)-docs.sgml + +# ugly hack to make -unused.sgml work +#unused-build.stamp: +# BUILDDIR=`pwd` && \ +# cd $(srcdir)/tmpl && \ +# ln -sf gstreamer-libs-unused.sgml \ +# $$BUILDDIR/tmpl/gstreamer-libs-@GST_MAJORMINOR@-unused.sgml +# touch unused-build.stamp + +# these rules are added to create parallel docs using GST_MAJORMINOR +#$(basefiles): gstreamer-libs-@GST_MAJORMINOR@%: gstreamer-libs% +# cp $< $@ + +#CLEANFILES = $(basefiles) + +# The top-level SGML file. Change it if you want. DOC_MAIN_SGML_FILE=$(DOC_MODULE)-docs.sgml -# The directory containing the source code (if it contains documentation). -DOC_SOURCE_DIR=$(top_srcdir)/libs +# The directory containing the source code. Relative to $(top_srcdir). +# gtk-doc will search all .c & .h files beneath here for inline comments +# documenting functions and macros. +DOC_SOURCE_DIR=$(top_srcdir)/libs/gst -EXTRA_DIST = $(DOC_MODULE)-docs.sgml $(DOC_MODULE)-sections.txt +# Extra options to supply to gtkdoc-scan. +SCAN_OPTIONS= + +# FIXME : +# there's something wrong with gstreamer-sections.txt not being in the dist +# maybe it doesn't resolve; we're adding it below for now +#EXTRA_DIST = gstreamer.types.in gstreamer.hierarchy $(DOC_MODULE)-sections.txt gstreamer-sections.txt $(DOC_MAIN_SGML_FILE) + +# Extra options to supply to gtkdoc-mkdb. +MKDB_OPTIONS=--sgml-mode --output-format=xml --ignore-files=trio + +# Extra options to supply to gtkdoc-fixref. +FIXXREF_OPTIONS=--extra-dir=../gst/html + +# Used for dependencies. +HFILE_GLOB=$(DOC_SOURCE_DIR)/*/*.h +CFILE_GLOB=$(DOC_SOURCE_DIR)/*/*.c + +# this is a wingo addition +# thomasvs: another nice wingo addition would be an explanation on why +# this is useful ;) + +#SCANOBJ_DEPS = $(top_builddir)/gst/elements/libgstelements.la \ +# $(top_builddir)/gst/schedulers/libgstbasicomegascheduler.la + +# Header files to ignore when scanning. +IGNORE_HFILES= + +# Images to copy into HTML directory. +HTML_IMAGES = + +# Extra SGML files that are included by $(DOC_MAIN_SGML_FILE). +content_files = + +# Other files to distribute. +extra_files = + +# CFLAGS and LDFLAGS for compiling scan program. Only needed if your app/lib +# contains GtkObjects/GObjects and you want to document signals and properties. +GTKDOC_CFLAGS = $(GST_CFLAGS) +GTKDOC_LIBS = $(GST_LIBS) $(SCANOBJ_DEPS) + +GTKDOC_CC=$(LIBTOOL) --mode=compile $(CC) +GTKDOC_LD=$(LIBTOOL) --mode=link $(CC) + +# If you need to override some of the declarations, place them in this file +# and uncomment this line. +#DOC_OVERRIDES = $(DOC_MODULE)-overrides.txt + + + +########################################################################### +# Everything below here is generic and you shouldn't need to change it. +########################################################################### +# thomas: except of course that we did + +# thomas: copied from glib-2 +# We set GPATH here; this gives us semantics for GNU make +# which are more like other make's VPATH, when it comes to +# whether a source that is a target of one rule is then +# searched for in VPATH/GPATH. +# +GPATH = $(srcdir) -HTML_DIR=@HTML_DIR@ -# add major minor here for parallel installs TARGET_DIR=$(HTML_DIR)/$(DOC_MODULE)-@GST_MAJORMINOR@ +EXTRA_DIST = \ + $(content_files) \ + $(extra_files) \ + $(HTML_IMAGES) \ + $(DOC_MAIN_SGML_FILE) \ + $(DOC_MODULE).types \ + $(DOC_MODULE)-sections.txt + +DOC_STAMPS=scan-build.stamp tmpl-build.stamp sgml-build.stamp html-build.stamp \ + $(srcdir)/tmpl.stamp $(srcdir)/sgml.stamp $(srcdir)/html.stamp + +SCANOBJ_FILES = \ + $(DOC_MODULE).args \ + $(DOC_MODULE).hierarchy \ + $(DOC_MODULE).signals + if HAVE_GTK_DOC -html: html/book1.html -else -html: -endif +all-local: html-build.stamp -# rule to make the html -html/book1.html: sgml/$(DOC_MODULE)-doc.bottom $(DOC_MAIN_SGML_FILE) - if ! test -d html ; then mkdir html ; fi - -cd html && gtkdoc-mkhtml $(DOC_MODULE) ../$(DOC_MAIN_SGML_FILE) +#### scan #### -# rule to cause scanning to be done -$(DOC_MODULE)-decl.txt: - gtkdoc-scan --module=$(DOC_MODULE) --source-dir=$(DOC_SOURCE_DIR) --ignore-headers="" -# rule to cause tmpls to be made -tmpl/$(DOC_MODULE)-unused.sgml: $(DOC_MODULE)-decl.txt $(DOC_MODULE)-sections.txt - gtkdoc-mktmpl --module=$(DOC_MODULE) +# wingo addition +scan-build.stamp: $(HFILE_GLOB) $(SCANOBJ_DEPS) $(basefiles) + @echo '*** Scanning header files ***' + if grep -l '^..*$$' $(srcdir)/$(DOC_MODULE).types > /dev/null ; then \ + CC="$(GTKDOC_CC)" LD="$(GTKDOC_LD)" CFLAGS="$(GTKDOC_CFLAGS)" LDFLAGS="$(GTKDOC_LIBS)" $(GTK_DOC_SCANOBJ) --module=$(DOC_MODULE) --output-dir=$(srcdir) ; \ + else \ + cd $(srcdir) ; \ + for i in $(SCANOBJ_FILES) ; do \ + test -f $$i || touch $$i ; \ + done \ + fi + cd $(srcdir) && \ + gtkdoc-scan --module=$(DOC_MODULE) --source-dir=$(DOC_SOURCE_DIR) --ignore-headers="$(IGNORE_HFILES)" $(SCAN_OPTIONS) $(EXTRA_HFILES) + touch scan-build.stamp -# rule to make sgml -sgml/$(DOC_MODULE)-doc.bottom: tmpl/$(DOC_MODULE)-unused.sgml - gtkdoc-mkdb --module=$(DOC_MODULE) --source-dir=$(DOC_SOURCE_DIR) +$(DOC_MODULE)-decl.txt $(SCANOBJ_FILES): scan-build.stamp + @true -all-local: html +#### templates #### + +tmpl-build.stamp: $(DOC_MODULE)-decl.txt $(SCANOBJ_FILES) $(DOC_MODULE)-sections.txt $(DOC_OVERRIDES) + @echo '*** Rebuilding template files ***' + cd $(srcdir) && gtkdoc-mktmpl --module=$(DOC_MODULE) + touch tmpl-build.stamp + +tmpl.stamp: tmpl-build.stamp + @true + +#### sgml #### + +sgml-build.stamp: tmpl.stamp $(CFILE_GLOB) + @echo '*** Building SGML ***' + cd $(srcdir) && \ + gtkdoc-mkdb --module=$(DOC_MODULE) --source-dir=$(DOC_SOURCE_DIR) --main-sgml-file=$(DOC_MAIN_SGML_FILE) $(MKDB_OPTIONS) + touch sgml-build.stamp + +sgml.stamp: sgml-build.stamp + @true + +#### html #### + +# FIXME: setting LANG=C is a hack to work with gtk-doc < 1.1, because +# that forces a non-utf8 locale. gtk-doc >= 1.1 solves this by calling +# use bytes; in gtkdoc-fixxref +html-build.stamp: sgml.stamp $(DOC_MAIN_SGML_FILE) $(content_files) + @echo '*** Building HTML ***' + test -d $(srcdir)/html || mkdir $(srcdir)/html + cd $(srcdir)/html && gtkdoc-mkhtml $(DOC_MODULE) ../$(DOC_MAIN_SGML_FILE) + test "x$(HTML_IMAGES)" = "x" || ( cd $(srcdir) && cp $(HTML_IMAGES) html ) + @echo '-- Fixing Crossreferences' + cd $(srcdir) && gtkdoc-fixxref --module-dir=html --html-dir=$(HTML_DIR) $(FIXXREF_OPTIONS) + touch html-build.stamp +endif clean-local: - $(RM) -rf *~ *.bak *.signals *-unused.txt *.args html sgml tmpl/*.bak $(DOC_MODULE)-decl-list.txt $(DOC_MODULE)-decl.txt + rm -f *~ *.bak $(SCANOBJ_FILES) *-unused.txt $(DOC_STAMPS) + rm -rf xml html -install-data-local: html - @$(mkinstalldirs) $(DESTDIR)$(TARGET_DIR) - @(installfiles=`echo $(srcdir)/html/*.html`; \ +maintainer-clean-local: clean + cd $(srcdir) && rm -rf sgml html $(DOC_MODULE)-decl-list.txt $(DOC_MODULE)-decl.txt + +# FIXME : thomas added all sgml files and some other things to make +# make distcheck work +distclean-local: clean + rm -rf $(DOC_MODULE)-decl-list.txt + rm -rf $(DOC_MODULE)-*.txt + rm -rf tmpl/*.sgml + rm -f $(DOC_MODULE).hierarchy + rm -f *.stamp || true + +install-data-local: + $(mkinstalldirs) $(DESTDIR)$(TARGET_DIR) + (installfiles=`echo $(srcdir)/html/*.html $(srcdir)/html/*.png`; \ if test "$$installfiles" = '$(srcdir)/html/*.html'; \ then echo '-- Nothing to install' ; \ else \ @@ -53,14 +200,36 @@ echo '-- Installing '$$i ; \ $(INSTALL_DATA) $$i $(DESTDIR)$(TARGET_DIR); \ done; \ + echo '-- Installing $(srcdir)/html/$(DOC_MODULE).devhelp' ; \ + $(INSTALL_DATA) $(srcdir)/html/$(DOC_MODULE).devhelp \ + $(DESTDIR)$(TARGET_DIR)/$(DOC_MODULE)-@GST_MAJORMINOR@.devhelp; \ echo '-- Installing $(srcdir)/html/index.sgml' ; \ $(INSTALL_DATA) $(srcdir)/html/index.sgml $(DESTDIR)$(TARGET_DIR); \ - echo '-- Fixing Crossreferences' ; \ - gtkdoc-fixxref --module=$(DOC_MODULE) --html-dir=$(HTML_DIR)|| true; \ fi) -uninstall-local: - @echo '-- Uninstalling '$(DESTDIR)$(TARGET_DIR) ; \ - $(RM) -rf $(DESTDIR)$(TARGET_DIR) +# +# Require gtk-doc when making dist +# +if HAVE_GTK_DOC +dist-check-gtkdoc: +else +dist-check-gtkdoc: + @echo "*** gtk-doc must be installed and enabled in order to make dist" + @false +endif -.PHONY : html +dist-hook: dist-check-gtkdoc dist-hook-local + mkdir $(distdir)/tmpl + mkdir $(distdir)/xml + mkdir $(distdir)/html + -cp $(srcdir)/tmpl/*.sgml $(distdir)/tmpl + -cp $(srcdir)/sgml/*.xml $(distdir)/xml + -cp $(srcdir)/html/index.sgml $(distdir)/html + -cp $(srcdir)/html/*.html $(srcdir)/html/*.css $(distdir)/html + + images=$(HTML_IMAGES) ; \ + for i in $$images ; do \ + cp $(srcdir)/$$i $(distdir)/html ; \ + done + +.PHONY : dist-hook-local Index: gstreamer-libs-docs.sgml =================================================================== RCS file: /cvsroot/gstreamer/gstreamer/docs/libs/gstreamer-libs-docs.sgml,v retrieving revision 1.2 retrieving revision 1.3 diff -u -d -r1.2 -r1.3 --- gstreamer-libs-docs.sgml 16 Apr 2002 16:27:26 -0000 1.2 +++ gstreamer-libs-docs.sgml 18 May 2003 15:04:26 -0000 1.3 @@ -1,11 +1,10 @@ -<!doctype book PUBLIC "-//Davenport//DTD DocBook V3.0//EN" [ - -<!entity GstColorSpace SYSTEM "sgml/gstcolorspace.sgml"> -<!entity GstGetbits SYSTEM "sgml/gstgetbits.sgml"> -<!entity GstIDCT SYSTEM "sgml/gstidct.sgml"> -<!entity GstPutbits SYSTEM "sgml/gstputbits.sgml"> -<!entity GstVideoScale SYSTEM "sgml/gstvideoscale.sgml"> -<!entity GstRiff SYSTEM "sgml/gstriff.sgml"> +<?xml version="1.0"?> +<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" + "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd" [ +<!ENTITY GstGetbits SYSTEM "xml/gstgetbits.xml"> +<!ENTITY GstIDCT SYSTEM "xml/gstidct.xml"> +<!ENTITY GstPutbits SYSTEM "xml/gstputbits.xml"> +<!ENTITY GstControl SYSTEM "xml/gstcontrol.xml"> ]> @@ -24,12 +23,10 @@ <para> GStreamer provides some standard libraries you can use to create plugins. </para> - &GstColorSpace; &GstGetbits; &GstIDCT; &GstPutbits; - &GstVideoScale; - &GstRiff; + &GstControl; </chapter> Index: gstreamer-libs-sections.txt =================================================================== RCS file: /cvsroot/gstreamer/gstreamer/docs/libs/gstreamer-libs-sections.txt,v retrieving revision 1.2 retrieving revision 1.3 diff -u -d -r1.2 -r1.3 --- gstreamer-libs-sections.txt 7 Nov 2000 21:38:33 -0000 1.2 +++ gstreamer-libs-sections.txt 18 May 2003 15:04:26 -0000 1.3 @@ -1,275 +1,4 @@ <SECTION> -<FILE>gstcolorspace</FILE> -<INCLUDE>libs/colorspace/gstcolorspace.h</INCLUDE> -GstColorSpaceType -GstColorSpaceConverter -GstColorSpaceConvertFunction -GST_COLORSPACE_RGB_FIRST -GST_COLORSPACE_YUV_FIRST -GST_COLORSPACE_YUV_LAST -GST_COLORSPACE_RGB_LAST -GST_COLORSPACE_IS_YUV_TYPE -GST_COLORSPACE_IS_RGB_TYPE -gst_colorspace_converter_new -gst_colorspace_convert -gst_colorspace_destroy -<SUBSECTION Standard> -</SECTION> - - -<SECTION> -<FILE>gstriff</FILE> -<INCLUDE>libs/riff/gstriff.h</INCLUDE> -GstRiffReturn -GstRiffParserState -GST_RIFF_OK -GST_RIFF_ENOTRIFF -GST_RIFF_EINVAL -GST_RIFF_ENOMEM -GST_RIFF_STATE_INITIAL -GST_RIFF_STATE_HASAVIH -GST_RIFF_STATE_HASSTRH -GST_RIFF_STATE_HASSTRF -GST_RIFF_STATE_MOVI -MAKE_FOUR_CC -GST_RIFF_RIFF_WAVE -GST_RIFF_RIFF_AVI -GST_RIFF_TAG_RIFF -GST_RIFF_TAG_RIFX -GST_RIFF_TAG_LIST -GST_RIFF_TAG_avih -GST_RIFF_TAG_strd -GST_RIFF_TAG_strh -GST_RIFF_TAG_strf -GST_RIFF_TAG_vedt -GST_RIFF_TAG_JUNK -GST_RIFF_TAG_idx1 -GST_RIFF_TAG_fmt -GST_RIFF_TAG_data -GST_RIFF_LIST_movi -GST_RIFF_LIST_hdrl -GST_RIFF_LIST_strl -GST_RIFF_FCC_vids -GST_RIFF_FCC_auds -GST_RIFF_FCC_pads -GST_RIFF_FCC_txts -GST_RIFF_FCC_vidc -GST_RIFF_FCCH_RLE -GST_RIFF_FCCH_msvc -GST_RIFF_FCCH_MSVC -GST_RIFF_FF00 -GST_RIFF_00 -GST_RIFF_01 -GST_RIFF_02 -GST_RIFF_03 -GST_RIFF_04 -GST_RIFF_05 -GST_RIFF_06 -GST_RIFF_07 -GST_RIFF_00pc -GST_RIFF_01pc -GST_RIFF_00dc -GST_RIFF_00dx -GST_RIFF_00db -GST_RIFF_00xx -GST_RIFF_00id -GST_RIFF_00rt -GST_RIFF_0021 -GST_RIFF_00iv -GST_RIFF_0031 -GST_RIFF_0032 -GST_RIFF_00vc -GST_RIFF_00xm -GST_RIFF_01wb -GST_RIFF_01dc -GST_RIFF_cram -GST_RIFF_CRAM -GST_RIFF_wham -GST_RIFF_WHAM -GST_RIFF_rgb -GST_RIFF_RGB -GST_RIFF_rle8 -GST_RIFF_RLE8 -GST_RIFF_rle4 -GST_RIFF_RLE4 -GST_RIFF_none -GST_RIFF_NONE -GST_RIFF_pack -GST_RIFF_PACK -GST_RIFF_tran -GST_RIFF_TRAN -GST_RIFF_ccc -GST_RIFF_CCC -GST_RIFF_cyuv -GST_RIFF_CYUV -GST_RIFF_jpeg -GST_RIFF_JPEG -GST_RIFF_MJPG -GST_RIFF_mJPG -GST_RIFF_IJPG -GST_RIFF_rt21 -GST_RIFF_RT21 -GST_RIFF_iv31 -GST_RIFF_IV31 -GST_RIFF_iv32 -GST_RIFF_IV32 -GST_RIFF_iv41 -GST_RIFF_IV41 -GST_RIFF_iv50 -GST_RIFF_IV50 -GST_RIFF_cvid -GST_RIFF_CVID -GST_RIFF_ULTI -GST_RIFF_ulti -GST_RIFF_YUV9 -GST_RIFF_YVU9 -GST_RIFF_XMPG -GST_RIFF_xmpg -GST_RIFF_VDOW -GST_RIFF_MVI1 -GST_RIFF_v422 -GST_RIFF_V422 -GST_RIFF_mvi1 -GST_RIFF_MPIX -GST_RIFF_AURA -GST_RIFF_DMB1 -GST_RIFF_dmb1 -GST_RIFF_BW10 -GST_RIFF_bw10 -GST_RIFF_yuy2 -GST_RIFF_YUY2 -GST_RIFF_YUV8 -GST_RIFF_WINX -GST_RIFF_WPY2 -GST_RIFF_m263 -GST_RIFF_M263 -GST_RIFF_Q1_0 -GST_RIFF_SFMC -GST_RIFF_y41p -GST_RIFF_Y41P -GST_RIFF_yv12 -GST_RIFF_YV12 -GST_RIFF_vixl -GST_RIFF_VIXL -GST_RIFF_iyuv -GST_RIFF_IYUV -GST_RIFF_i420 -GST_RIFF_I420 -GST_RIFF_vyuy -GST_RIFF_VYUY -GST_RIFF_DIV3 -GST_RIFF_rpza -GST_RIFF_azpr -GST_RIFF_ISFT -GST_RIFF_IDIT -GST_RIFF_00AM -GST_RIFF_DISP -GST_RIFF_ISBJ -GST_RIFF_rec -gst_riff_avih -gst_riff_strh -gst_riff_strf_vids -gst_riff_strf_auds -gst_riff_riff -gst_riff_list -gst_riff_chunk -gst_riff_index_entry -GstRiff -GstRiffChunk -GstRiffCallback -gst_riff_parser_new -gst_riff_parser_next_buffer -gst_riff_parser_resync -gst_riff_encoder_new -gst_riff_encoder_avih -gst_riff_encoder_strh -gst_riff_encoder_strf -gst_riff_encoder_chunk -gst_riff_encoder_get_buffer -gst_riff_encoder_get_and_reset_buffer -gst_riff_fourcc_to_id -gst_riff_id_to_fourcc -</SECTION> - -<SECTION> -<FILE>gstgetbits_inl</FILE> -debug2 -debug -checklength2 -checklength -swab32 -gst_getbits_init -gst_getbits_newbuf -gst_getbits_bitoffset -gst_getbits_bufferpos -gst_getbits_bytesleft -gst_getbits_bitsleft -gst_getbits1 -gst_getbits2 -gst_getbitsX -gst_getbits3 -gst_getbits4 -gst_getbits5 -gst_getbits6 -gst_getbits7 -gst_getbits8 -gst_getbits9 -gst_getbits10 -gst_getbits11 -gst_getbits12 -gst_getbits13 -gst_getbits14 -gst_getbits15 -gst_getbits16 -gst_getbits17 -gst_getbits18 -gst_getbits19 -gst_getbits20 -gst_getbits21 -gst_getbits22 -gst_getbits32 -gst_getbitsn -gst_showbits32 -gst_showbitsX -gst_showbits1 -gst_showbits2 -gst_showbits3 -gst_showbits4 -gst_showbits5 -gst_showbits6 -gst_showbits7 -gst_showbits8 -gst_showbits9 -gst_showbits10 -gst_showbits11 -gst_showbits12 -gst_showbits13 -gst_showbits14 -gst_showbits15 -gst_showbits16 -gst_showbits17 -gst_showbits18 -gst_showbits19 -gst_showbits20 -gst_showbits21 -gst_showbits22 -gst_showbits23 -gst_showbits24 -gst_showbits25 -gst_showbits26 -gst_showbits27 -gst_showbits28 -gst_showbits29 -gst_showbits30 -gst_showbits31 -gst_showbitsn -gst_flushbits32 -gst_flushbitsn -gst_backbits24 -gst_backbitsn -</SECTION> - -<SECTION> <FILE>gstgetbits</FILE> <INCLUDE>libs/getbits/gstgetbits.h</INCLUDE> gst_getbits_t @@ -350,17 +79,6 @@ </SECTION> <SECTION> -<FILE>gstvideoscale</FILE> -<INCLUDE>libs/videoscale/gstvideoscale.h</INCLUDE> -GstVideoScaleMethod -GstVideoScale -GstVideoScaleScaler -gst_videoscale_new -gst_videoscale_scale -gst_videoscale_destroy -</SECTION> - -<SECTION> <FILE>gstputbits</FILE> <INCLUDE>libs/putbits/gstputbits.h</INCLUDE> gst_putbits_t @@ -398,25 +116,6 @@ </SECTION> <SECTION> -<FILE>externals</FILE> -ext_unknown -</SECTION> - -<SECTION> -<FILE>wineacm</FILE> -MSACM_hHeap -MSACM_pFirstACMDriverID -MSACM_pLastACMDriverID -MSACM_RegisterDriver -MSACM_RegisterAllDrivers -MSACM_UnregisterDriver -MSACM_UnregisterAllDrivers -MSACM_GetDriverID -MSACM_GetDriver -MSACM_GetObj -</SECTION> - -<SECTION> <FILE>dct</FILE> DCTSIZE DCTSIZE2 @@ -447,3 +146,8 @@ gst_idct_destroy </SECTION> +<SECTION> +<FILE>gstcontrol</FILE> +<INCLUDE>libs/control/control.h</INCLUDE> +gst_control_init +</SECTION> |