doc: Remove gtk-doc support

This commit is contained in:
Thibault Saunier 2018-09-14 09:24:26 -03:00
parent 3d5dbfb457
commit 781ad55f68
25 changed files with 1 additions and 7024 deletions

View file

@ -1,5 +1,3 @@
DISTCHECK_CONFIGURE_FLAGS=--enable-gtk-doc
# note: keep in sync with configure.ac
ACLOCAL_AMFLAGS = -I m4 -I common/m4
@ -8,7 +6,6 @@ aclocal_DATA = gst-element-check-1.0.m4
SUBDIRS = pkgconfig \
gst libs plugins tests \
docs \
po \
m4 \
common \
@ -21,7 +18,6 @@ endif
# These are all the possible subdirs
DIST_SUBDIRS = pkgconfig \
gst libs plugins tools tests \
docs \
po \
m4 \
common \
@ -186,8 +182,7 @@ CRUFT_DIRS = \
$(top_builddir)/tests/examples/queue \
$(top_builddir)/tests/examples/typefind \
$(top_builddir)/gst/tmp-introspect* \
$(top_builddir)/libs/gst/*/tmp-introspect* \
$(top_srcdir)/docs/plugins/tmpl
$(top_builddir)/libs/gst/*/tmp-introspect*
include $(top_srcdir)/common/cruft.mak

View file

@ -457,10 +457,6 @@ AM_CONDITIONAL(HAVE_VALGRIND, test ! "x$VALGRIND_PATH" = "xno")
dnl check for gobject-introspection
GOBJECT_INTROSPECTION_CHECK([1.31.1])
dnl check for documentation tools
GTK_DOC_CHECK([1.12])
AG_GST_PLUGIN_DOCS([1.12])
dnl *** checks for libraries ***
dnl check for libm, for sin()
@ -1126,12 +1122,6 @@ tests/examples/streams/Makefile
tools/Makefile
common/Makefile
common/m4/Makefile
docs/Makefile
docs/gst/Makefile
docs/gst/gstreamer.types
docs/libs/Makefile
docs/plugins/Makefile
docs/version.entities
m4/Makefile
pkgconfig/Makefile
stamp.h
@ -1167,8 +1157,6 @@ Configuration
Package name : ${GST_PACKAGE_NAME}
Package origin : ${GST_PACKAGE_ORIGIN}
API Documentation : ${enable_gtk_doc}
Debug logging : ${enable_gst_debug}
Tracing subsystem hooks : ${enable_gst_tracer_hooks}
Command-line parser : ${enable_parse}

View file

@ -1,23 +0,0 @@
if ENABLE_GTK_DOC
if ENABLE_PLUGIN_DOCS
PLUGIN_DOCS_DIRS = plugins
else
PLUGIN_DOCS_DIRS =
endif
else
PLUGIN_DOCS_DIRS = plugins
endif
BUILT_SOURCES = version.entities
SUBDIRS = gst libs $(PLUGIN_DOCS_DIRS)
DIST_SUBDIRS = gst libs plugins
EXTRA_DIST = version.entities.in list-ulink.xsl
upload:
@if test "x$(SUBDIRS)" != x; then for a in $(SUBDIRS); do cd $$a; make upload; cd ..; done; fi
libs: gst
include $(top_srcdir)/common/parallel-subdirs.mak

46
docs/gst/.gitignore vendored
View file

@ -1,46 +0,0 @@
Makefile
Makefile.in
gstreamer-decl-list.txt
gstreamer-decl.txt
gstreamer-undocumented.txt
gstreamer-unused.txt
gstreamer-undeclared.txt
gstreamer.args
gstreamer.hierarchy
gstreamer.interfaces
gstreamer.prerequisites
gstreamer.signals
html
sgml
tmpl
*.stamp
doc-registry.xml
gstreamer.html
gstreamer-presed-scan.c
gstreamer-scan.c
gstreamer-scan
tmpl.stamp
tmpl-build.stamp
sgml.stamp
sgml-build.stamp
scan-build.stamp
html.stamp
html-build.stamp
*.tgz
*.tex
*.log
*.aux
*.dvi
*.ps
*.bak
gtkdoc-fixxref
xml
gst-universe.svg
gstreamer.types
gstreamer-scan.gcno

View file

@ -1,96 +0,0 @@
## Process this file with automake to produce Makefile.in
# The name of the module, e.g. 'glib'.
# DOC_MODULE=gstreamer-@GST_API_VERSION@
DOC_MODULE=gstreamer
# don't want $(DOC_MODULE)-scan.c to be built with -Werror
ERROR_CFLAGS=
BUILT_SOURCES=gstreamer.types
# for upload-doc.mak
DOC=gstreamer
FORMATS=html
html: html-build.stamp
include $(top_srcdir)/common/upload-doc.mak
# The top-level SGML file. Change it if you want.
DOC_MAIN_SGML_FILE=$(DOC_MODULE)-docs.sgml
# The files 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)/gst
# Extra options to supply to gtkdoc-scan.
SCAN_OPTIONS=--deprecated-guards="GST_DISABLE_DEPRECATED" \
--ignore-decorators='GST_API'
# Extra options to supply to gtkdoc-mkdb.
MKDB_OPTIONS=--sgml-mode --output-format=xml --ignore-files=parse
# Extra options to supply to gtkdoc-fixref.
FIXXREF_OPTIONS=--extra-dir=$(GLIB_PREFIX)/share/gtk-doc/html
# Used for dependencies.
HFILE_GLOB=$(top_srcdir)/gst/*.h
CFILE_GLOB=$(top_srcdir)/gst/*.c
# Header files to ignore when scanning. Use base file name, no paths
IGNORE_HFILES= \
gettext.h \
glib-compat-private.h \
glib-compat.h \
gst-i18n-app.h \
gst-i18n-lib.h \
gst_private.h \
gstelementdetails.h \
gstmacros.h \
gstmarshal.h \
math-compat.h \
\
grammar.tab.h \
grammar.tab.pre.h \
parse_lex.h \
types.h \
\
gst-printf.h \
printf-args.h \
printf-extension.h \
printf-parse.h \
vasnprintf.h
gst-universe.svg: gst-universe.dot
-dot -Tsvg $< | sed 's/\(font-size:[0-9]*\.[0-9]*\);/\1px;/g' >$@
# Images to copy into HTML directory.
HTML_IMAGES =
# Extra SGML files that are included by $(DOC_MAIN_SGML_FILE).
content_files = building.xml running.xml gst-universe.svg
# Other files to distribute.
extra_files = gst-universe.dot
# 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_OBJ_CFLAGS) -DGST_USE_UNSTABLE_API
GTKDOC_LIBS = $(GST_OBJ_LIBS) \
$(top_builddir)/gst/libgstreamer-@GST_API_VERSION@.la \
$(top_builddir)/libs/gst/base/libgstbase-@GST_API_VERSION@.la \
$(top_builddir)/libs/gst/controller/libgstcontroller-@GST_API_VERSION@.la \
$(top_builddir)/libs/gst/net/libgstnet-@GST_API_VERSION@.la
GTKDOC_EXTRA_ENVIRONMENT= \
GST_PLUGIN_SCANNER_1_0=$(top_builddir)/libs/gst/helpers/gst-plugin-scanner
# If you need to override some of the declarations, place them in this file
# and uncomment this line.
DOC_OVERRIDES = $(DOC_MODULE)-overrides.txt
include $(top_srcdir)/common/gtk-doc.mak
# gtk-doc.mak defines CLEANFILES
CLEANFILES += gst-universe.svg

View file

@ -1,100 +0,0 @@
<?xml version="1.0"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % version-entities SYSTEM "version.entities">
%version-entities;
<!ENTITY % local.common.attrib "xmlns:xi CDATA #FIXED 'http://www.w3.org/2003/XInclude'">
]>
<refentry id="gst-building" revision="25 mar 2009">
<refmeta>
<refentrytitle>Building GStreamer and GStreamer Applications</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>GStreamer Core</refmiscinfo>
</refmeta>
<refnamediv>
<refname>Building GStreamer and GStreamer Applications</refname>
<refpurpose>
How to build the GStreamer framework and applications using it.
</refpurpose>
</refnamediv>
<refsect1>
<title>Building GStreamer on UNIX</title>
<!-- this has been borrowed from the glib docs -->
<para>
On UNIX, GStreamer uses the standard GNU build system,
using <application>autoconf</application> for package
configuration and resolving portability issues,
<application>automake</application> for building makefiles
that comply with the GNU Coding Standards, and
<application>libtool</application> for building shared
libraries on multiple platforms. The normal sequence for
compiling and installing the GStreamer library is thus:
<literallayout>
<userinput>./configure</userinput>
<userinput>make</userinput>
<userinput>make install</userinput>
</literallayout>
</para>
<para>
The standard options provided by <application>GNU
autoconf</application> may be passed to the
<command>configure</command> script. Please see the
<application>autoconf</application> documentation or run
<command>./configure --help</command> for information about
the standard options.
</para>
<para>
In addition there are several options to activate or deactivate features.
E.g. passing <option>--disable-gst-debug</option> to <command>configure</command>
will turn the debugging subsystem into a non-functional stub and remove all
macro based invocations from within the library (and anything compiled
against the library afterwards.)
</para>
<para>
If library size matters and one builds in a controlled environment, it is
also possible to totally remove subsystem code. This is intentionally not
offered as a configure option as it causes an ABI break. Code built against
a version of GStreamer without these modifications needs to be recompiled.
<literallayout>
<userinput>make CFLAGS="-DGST_REMOVE_DEPRECATED -DGST_REMOVE_DISABLED"</userinput>
</literallayout>
<itemizedlist>
<listitem>
<para>
<symbol>GST_REMOVE_DEPRECATED</symbol> - Omit deprecated functions
from the library.
</para>
</listitem>
<listitem>
<para>
<symbol>GST_REMOVE_DISABLED</symbol> - Omit stubs for disabled
subsystems from the library.
</para>
</listitem>
</itemizedlist>
</para>
</refsect1>
<refsect1>
<title>Building GStreamer Applications</title>
<para>
Applications and libraries can use <command>pkg-config</command> to get all the
needed compiler and linker flags to build against GStreamer. Please note that
GStreamer is split into several libraries itself.
<command>pkg-config --list-all | grep gstreamer</command> will list the
available libraries.
</para>
</refsect1>
</refentry>

View file

@ -1,74 +0,0 @@
/* dot -Tpng gst-universe.dot -ogst-universe.png
*
* other layouts:
* circo -Tpng gst-universe.dot -ogst-universe.circo.png
* neato -Tpng gst-universe.dot -ogst-universe.neato.png
*
* todo:
* - add urls to api docs
* - use color
*/
digraph pipeline {
node [style="filled", shape="box", fillcolor="#eeeeee", fontsize="9px", fontname="Bitstream Vera Sans", target="_top"];
edge [labelfontsize="7px", fontsize="7px", labelfontname="Bitstream Vera Sans", fontname="Bitstream Vera Sans"];
labelloc=t;
nodesep=0.25;
/*
fontname="Bitstream Vera Sans";
fontsize="10px";
label="GStreamer Universe";
*/
/* objects */
application [color=black, fillcolor="#ffdddd"];
bin [href="GstBin.html", color=black, fillcolor="#ccccff"];
bus [href="GstBus.html"];
buffer [href="gstreamer-GstBuffer.html", color=black, fillcolor="#ddffdd"];
caps [href="gstreamer-GstCaps.html"];
clock [href="GstClock.html"];
element [href="GstElement.html", color=black, fillcolor="#ccccff"];
element_factory [href="GstElementFactory.html", label="element factory"];
event [href="gstreamer-GstEvent.html", color=black, fillcolor="#ddffdd"];
message [href="gstreamer-GstMessage.html", color=black, fillcolor="#ddffdd"];
pad [href="GstPad.html", color=black, fillcolor="#ccccff"];
pad_template [href="GstPadTemplate.html", label="pad template"];
pipeline [href="GstPipeline.html", color=black, fillcolor="#ccccff"];
plugin [href="GstPlugin.html"];
plugin_feature [href="GstPluginFeature.html", label="plugin feature"];
query [href="gstreamer-GstQuery.html", color=black, fillcolor="#ddffdd"];
registry [href="GstRegistry.html"];
structure [href="gstreamer-GstStructure.html"];
/* relations */
bin -> element [label="is-a"];
pipeline -> bin [label="is-a"];
pipeline -> bus [label="has 1"];
pipeline -> clock [label="has 1"];
element -> pad_template [label="has n"];
element -> pad [label="has n"];
element -> clock [label="may provide"];
pad -> caps [label="has n"];
pad_template -> caps [label="has n"];
buffer -> caps [label="has n"];
caps -> structure [label="has n"];
bin -> element [label="has n"];
pad -> pad_template [label="is created from"];
element -> element_factory [label="is created from"];
element -> query [label="answers"];
element -> event [label="send & receive"];
element -> buffer [label="send & receive"];
element -> message [label="send"];
bus -> message [label="receive"];
registry -> plugin [label="has n"];
plugin -> plugin_feature [label="has n"];
element_factory -> plugin_feature [label="is-a"];
application -> pipeline [label="has"];
application -> bus [label="listen on"];
application -> query [label="send"];
application -> event [label="send"];
}

View file

@ -1,206 +0,0 @@
<?xml version="1.0"?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % version-entities SYSTEM "version.entities">
%version-entities;
<!ENTITY % local.common.attrib "xmlns:xi CDATA #FIXED 'http://www.w3.org/2003/XInclude'">
<!ENTITY hash "#">
]>
<book id="index" xmlns:xi="http://www.w3.org/2003/XInclude">
<bookinfo>
<title>GStreamer &GST_API_VERSION; Core Reference Manual</title>
<releaseinfo>
for GStreamer Core &GST_API_VERSION; (&GST_VERSION;)
The latest version of this documentation can be found on-line at
<ulink role="online-location" url="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/">http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer/html/</ulink>.
</releaseinfo>
</bookinfo>
<chapter id="gstreamer">
<title>GStreamer Overview</title>
<para>
GStreamer is a streaming media framework.
It uses graphs of elements which operate on data.
The functionality to process media is provided by plug-ins which provide
features like elements, typefinding, and so on.
This allows new functionality to be added simply by installing new plug-ins.
</para>
<para>
GStreamer is cross-platform and works on most UNIX-like platforms as well as
Windows. It is released under the GNU Library General Public License
(GNU LGPL).
</para>
<mediaobject>
<imageobject>
<imagedata fileref="gst-universe.svg" format="SVG"/>
</imageobject>
<caption>
<para>Relation between gstreamer core objects.</para>
</caption>
</mediaobject>
<xi:include href="building.xml" />
<xi:include href="running.xml" />
</chapter>
<chapter id="libgstreamer">
<title>GStreamer Core Library</title>
<para>
libgstreamer-&GST_API_VERSION;.so provides all the core GStreamer services,
including initialization, plugin management and types,
as well as the object hierarchy that defines elements and bins,
along with some more specialized elements.
</para>
<xi:include href="xml/gst.xml" />
<xi:include href="xml/gstallocator.xml" />
<xi:include href="xml/gstatomicqueue.xml" />
<xi:include href="xml/gstbin.xml" />
<xi:include href="xml/gstbuffer.xml" />
<xi:include href="xml/gstbufferlist.xml" />
<xi:include href="xml/gstbufferpool.xml" />
<xi:include href="xml/gstbus.xml" />
<xi:include href="xml/gstcaps.xml" />
<xi:include href="xml/gstcapsfeatures.xml" />
<xi:include href="xml/gstsample.xml" />
<xi:include href="xml/gstchildproxy.xml" />
<xi:include href="xml/gstclock.xml" />
<xi:include href="xml/gstconfig.xml" />
<xi:include href="xml/gstcontext.xml" />
<xi:include href="xml/gstcontrolbinding.xml" />
<xi:include href="xml/gstcontrolsource.xml" />
<xi:include href="xml/gstdatetime.xml" />
<xi:include href="xml/gstdynamictypefactory.xml" />
<xi:include href="xml/gstelement.xml" />
<xi:include href="xml/gstelementfactory.xml" />
<xi:include href="xml/gsterror.xml" />
<xi:include href="xml/gstevent.xml" />
<xi:include href="xml/gstformat.xml" />
<xi:include href="xml/gstghostpad.xml" />
<xi:include href="xml/gstiterator.xml" />
<xi:include href="xml/gstmemory.xml" />
<xi:include href="xml/gstmessage.xml" />
<xi:include href="xml/gstmeta.xml" />
<xi:include href="xml/gstminiobject.xml" />
<xi:include href="xml/gstobject.xml" />
<xi:include href="xml/gstpad.xml" />
<xi:include href="xml/gstpadtemplate.xml" />
<xi:include href="xml/gstparamspec.xml" />
<xi:include href="xml/gstparse.xml" />
<xi:include href="xml/gstpipeline.xml" />
<xi:include href="xml/gstplugin.xml" />
<xi:include href="xml/gstpluginfeature.xml" />
<xi:include href="xml/gstpoll.xml" />
<xi:include href="xml/gstpreset.xml" />
<xi:include href="xml/gstpromise.xml" />
<xi:include href="xml/gstprotection.xml" />
<xi:include href="xml/gstquery.xml" />
<xi:include href="xml/gstregistry.xml" />
<xi:include href="xml/gstsegment.xml" />
<xi:include href="xml/gststreams.xml" />
<xi:include href="xml/gststreamcollection.xml" />
<xi:include href="xml/gststructure.xml" />
<xi:include href="xml/gstsystemclock.xml" />
<xi:include href="xml/gsttaglist.xml" />
<xi:include href="xml/gsttagsetter.xml" />
<xi:include href="xml/gsttask.xml" />
<xi:include href="xml/gsttaskpool.xml" />
<xi:include href="xml/gsttoc.xml" />
<xi:include href="xml/gsttocsetter.xml" />
<xi:include href="xml/gsttypefind.xml" />
<xi:include href="xml/gsttypefindfactory.xml" />
<xi:include href="xml/gsturi.xml" />
<xi:include href="xml/gsturihandler.xml" />
<xi:include href="xml/gstutils.xml" />
<xi:include href="xml/gstvalue.xml" />
<xi:include href="xml/gstversion.xml" />
</chapter>
<chapter id="gstreamer-device-probing">
<title>GStreamer Device Discovery and Device Probing</title>
<xi:include href="xml/gstdevicemonitor.xml" />
<xi:include href="xml/gstdevice.xml" />
<xi:include href="xml/gstdeviceprovider.xml" />
<xi:include href="xml/gstdeviceproviderfactory.xml" />
</chapter>
<chapter id="gstreamer-support">
<title>GStreamer Core Support</title>
<para>
Theses modules support the gstreamer core and plugin development.
Application developers will rarely need to know about it.
</para>
<xi:include href="xml/gstinfo.xml" />
<xi:include href="xml/gsttracer.xml" />
<xi:include href="xml/gsttracerfactory.xml" />
<xi:include href="xml/gsttracerrecord.xml" />
</chapter>
<chapter id="gstreamer-hierarchy">
<title>Object Hierarchy</title>
<xi:include href="xml/tree_index.sgml"/>
</chapter>
<index>
<title>API Index</title>
<xi:include href="xml/api-index-full.xml"><xi:fallback /></xi:include>
</index>
<index role="deprecated">
<title>Index of deprecated API</title>
<xi:include href="xml/api-index-deprecated.xml"><xi:fallback /></xi:include>
</index>
<index>
<title>Index of new API in 1.16</title>
<xi:include href="xml/api-index-1.16.xml"><xi:fallback /></xi:include>
</index>
<index>
<title>Index of new API in 1.14</title>
<xi:include href="xml/api-index-1.14.xml"><xi:fallback /></xi:include>
</index>
<index>
<title>Index of new API in 1.12</title>
<xi:include href="xml/api-index-1.12.xml"><xi:fallback /></xi:include>
</index>
<index>
<title>Index of new API in 1.10</title>
<xi:include href="xml/api-index-1.10.xml"><xi:fallback /></xi:include>
</index>
<index>
<title>Index of new API in 1.8</title>
<xi:include href="xml/api-index-1.8.xml"><xi:fallback /></xi:include>
</index>
<index>
<title>Index of new API in 1.6</title>
<xi:include href="xml/api-index-1.6.xml"><xi:fallback /></xi:include>
</index>
<index>
<title>Index of new API in 1.4</title>
<xi:include href="xml/api-index-1.4.xml"><xi:fallback /></xi:include>
</index>
<index>
<title>Index of new API in 1.2.3</title>
<xi:include href="xml/api-index-1.2.3.xml"><xi:fallback /></xi:include>
</index>
<index>
<title>Index of new API in 1.2</title>
<xi:include href="xml/api-index-1.2.xml"><xi:fallback /></xi:include>
</index>
<index>
<title>Index of new API in 1.0.10</title>
<xi:include href="xml/api-index-1.0.10.xml"><xi:fallback /></xi:include>
</index>
<index>
<title>Index of new API in 1.0.5</title>
<xi:include href="xml/api-index-1.0.5.xml"><xi:fallback /></xi:include>
</index>
<xi:include href="xml/annotation-glossary.xml"><xi:fallback /></xi:include>
</book>

File diff suppressed because it is too large Load diff

View file

@ -1,51 +0,0 @@
% add a _get_type for every GObject whose properties and signals you want
% documented
% add the relevant includes to be able to call those _get_type functions
% adding a get_type here will:
% - change output file name from gstreamer-(whatever).html to (whatever).html
% - document properties and signals
#include <gst/gst.h>
#include <gst/gsttracer.h>
#include <gst/gsttracerrecord.h>
gst_bin_get_type
gst_buffer_pool_get_type
gst_bus_get_type
gst_child_proxy_get_type
gst_clock_get_type
gst_control_binding_get_type
gst_control_source_get_type
gst_element_factory_get_type
gst_element_get_type
gst_ghost_pad_get_type
gst_object_get_type
gst_pad_get_type
gst_pad_template_get_type
gst_pipeline_get_type
gst_plugin_feature_get_type
gst_preset_get_type
gst_promise_get_type
gst_registry_get_type
gst_system_clock_get_type
gst_tag_setter_get_type
gst_task_get_type
gst_tracer_get_type
gst_tracer_factory_get_type
gst_tracer_record_get_type
gst_type_find_factory_get_type
gst_uri_handler_get_type
gst_buffer_get_type
gst_buffer_list_get_type
gst_caps_get_type
gst_context_get_type
gst_event_get_type
gst_memory_get_type
gst_message_get_type
gst_query_get_type
gst_sample_get_type
gst_tag_list_get_type
gst_toc_get_type
gst_toc_entry_get_type

View file

@ -1,16 +0,0 @@
types = configure_file(input : 'gstreamer.types.in',
output : 'gstreamer.types',
copy: true)
gnome.gtkdoc('gstreamer',
main_sgml : 'gstreamer-docs.sgml',
src_dir : '@0@/../../gst'.format(meson.current_source_dir()),
scan_args : ['--deprecated-guards=GST_DISABLE_DEPRECATED',
'--ignore-decorators=GST_API',
'--ignore-headers=gettext.h glib-compat-private.h glib-compat.h gst-i18n-app.h gst-i18n-lib.h gst_private.h gstelementdetails.h gstmacros.h grammar.tab.h grammar.tab.pre.h math-compat.h types.h'
],
scanobjs_args : ['--type-init-func="gst_init(NULL,NULL)"'],
gobject_typesfile : types,
dependencies : [gst_dep],
content_files: ['building.xml', 'running.xml', version_entities],
install : true)

View file

@ -1,559 +0,0 @@
<?xml version="1.0"?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
"http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
<!ENTITY % version-entities SYSTEM "version.entities">
%version-entities;
<!ENTITY % local.common.attrib "xmlns:xi CDATA #FIXED 'http://www.w3.org/2003/XInclude'">
]>
<refentry id="gst-running" revision="08 Oct 2005">
<refmeta>
<refentrytitle>Running GStreamer Applications</refentrytitle>
<manvolnum>3</manvolnum>
<refmiscinfo>GStreamer Core</refmiscinfo>
</refmeta>
<refnamediv>
<refname>Running GStreamer Applications</refname>
<refpurpose>
How to run and debug your GStreamer application
</refpurpose>
</refnamediv>
<refsect1>
<title>Running and debugging GStreamer Applications</title>
<refsect2>
<title>Environment variables</title>
<para>
GStreamer inspects a few of environment variables in addition to standard
variables like <envar>LANG</envar>, <envar>PATH</envar> or <envar>HOME</envar>.
</para>
<formalpara id="GST_PLUGIN_SYSTEM_PATH">
<title><envar>GST_PLUGIN_SYSTEM_PATH</envar>,
<envar>GST_PLUGIN_SYSTEM_PATH_1_0</envar></title>
<para>
This environment variable can be set to a colon-separated list of paths (or
semicolon-separated list on Windows).
If this variable is not set, GStreamer will fill in this list for you
with
<itemizedlist>
<listitem>
<para>
plug-ins in the user's home directory, or rather the user's "data home"
directory according to the xdg base dir specification. Usually this will be
a directory called
<filename>plugins</filename> inside the
<filename>.local/share/gstreamer-&GST_API_VERSION;</filename> directory in
the user's home directory by default, though this search path may change if
the XDG_DATA_HOME environment variable is set.
</para>
</listitem>
<listitem>
<para>
plug-ins installed system-wide. On this system, they are stored in
<filename>&GST_PLUGINS_DIR;</filename>.
</para>
</listitem>
</itemizedlist>
</para>
<para>
GStreamer will scan these paths for GStreamer plug-ins. These plug-ins will
be loaded after the plug-ins in the GST_PLUGIN_PATH variable below.
The paths are scanned in the given order. This allows a user to override
system-installed plug-ins with his own versions.
</para>
<para>
The GST_PLUGIN_SYSTEM_PATH_1_0 variant is useful if both the old GStreamer 0.10
version and the new GStreamer 1.0 version need to be pointed to new plugin
paths. The latter will use the _1_0 variant over the non-versioned one if
it is set.
</para>
<para>
Setting this variable to an empty string will cause GStreamer not to scan any
system paths at all for plug-ins. This can be useful if you're running
uninstalled (for development purposes) or while running testsuites.
</para>
</formalpara>
<formalpara id="GST_PLUGIN_PATH">
<title><envar>GST_PLUGIN_PATH</envar>, <envar>GST_PLUGIN_PATH_1_0</envar></title>
<para>
This environment variable can be set to a colon-separated list of paths (or a
semicolon-separated list on Windows).
GStreamer will scan these paths for GStreamer plug-ins. These plug-ins will
be loaded in addition to, and before, the plug-ins in the system paths.
</para>
<para>
The GST_PLUGIN_PATH_1_0 variant is useful if both the old GStreamer 0.10
version and the new GStreamer 1.0 version need to be pointed to new plugin
paths. The latter will use the _1_0 variant over the non-versioned one if
it is set.
</para>
</formalpara>
<formalpara id="GST_DEBUG">
<title><envar>GST_DEBUG</envar></title>
<para>
If GStreamer has been configured with <option>--enable-gst-debug=yes</option>,
this variable can be set to a list of debug options, which cause GStreamer
to print out different types of debugging information to stderr.
</para>
<para>
The variable takes a comma-separated list of "category_name:level" pairs
to set specific levels for the individual categories.
The level value ranges from 0 (nothing) to 9 (MEMDUMP).
<variablelist>
<varlistentry>
<term>1 - <option>ERROR</option></term>
<listitem>
<para>
Logs all fatal errors. These are errors that do not allow the core or elements
to perform the requested action. The application can still recover if
programmed to handle the conditions that triggered the error.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>2 - <option>WARNING</option></term>
<listitem>
<para>
Logs all warnings. Typically these are non-fatal, but user-visible problems
are expected to happen.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>3 - <option>FIXME</option></term>
<listitem>
<para>
Logs all fixme messages. Fixme messages are messages that indicate that something
in the executed code path is not fully implemented or handled yet. The purpose
of this message is to make it easier to spot incomplete/unfinished pieces of
code when reading the debug log.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>4 - <option>INFO</option></term>
<listitem>
<para>
Logs all informational messages. These are typically used for events in
the system that only happen once, or are important and rare enough to be
logged at this level.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>5 - <option>DEBUG</option></term>
<listitem>
<para>
Logs all debug messages. These are general debug messages for events
that happen only a limited number of times during an object's lifetime;
these include setup, teardown, change of parameters, ...
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>6 - <option>LOG</option></term>
<listitem>
<para>
Logs all log messages. These are messages for events
that happen repeatedly during an object's lifetime;
these include streaming and steady-state conditions.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>7 - <option>TRACE</option></term>
<listitem>
<para>
Logs all trace messages. These messages for events
that happen repeatedly during an object's lifetime such as the
ref/unref cycles.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>9 - <option>MEMDUMP</option></term>
<listitem>
<para>
Log all memory dump messages. Memory dump messages are used to log
(small) chunks of data as memory dumps in the log. They will be displayed
as hexdump with ASCII characters.
</para>
</listitem>
</varlistentry>
</variablelist>
The category_name can contain "<option>*"</option> as a wildcard.
</para>
<para>
For example, setting <envar>GST_DEBUG</envar> to
<option>GST_AUTOPLUG:6,GST_ELEMENT_*:4</option>, will cause the
<option>GST_AUTOPLUG</option> category to be logged at full
<option>LOG</option> level, while all categories starting with
<option>GST_ELEMENT_</option> will be logged at <option>INFO</option> level.
</para>
<para>
To get all possible debug output, set
<envar>GST_DEBUG</envar>
to <option>*:9</option>. For debugging purposes a <option>*:6</option> debug
log is usually the most useful, as it contains all important information, but
hides a lot of noise such as refs/unrefs. For bug reporting purposes, a
<option>*:6</option> log is also what will be requested usually. It's often
also worth running with <option>*:3</option> to see if there are any
non-fatal errors or warnings that might be related to the problem at hand.
</para>
<para>
Since GStreamer 1.2 it is also possible to specify debug levels by name,
e.g. GST_DEBUG=*:WARNING,*audio*:LOG
</para>
</formalpara>
<formalpara id="GST_DEBUG_NO_COLOR">
<title><envar>GST_DEBUG_NO_COLOR</envar></title>
<para>
Set this environment variable to any value ("1" typically) to switch off
colouring in GST_DEBUG output. This has the same effect as specifying the
<option>--gst-debug-no-color</option> or
<option>--gst-debug-color-mode</option>=off command line option to
well-behaved GStreamer applications (ie. those that pass command-line
options correctly to GStreamer).
This is particularly useful to reduce the size of debug output and also allows
for the output to be compressed much better than with colours turned on.
</para>
<para>
Has the same effect as setting GST_DEBUG_COLOR_MODE environment variable to
"off".
</para>
</formalpara>
<formalpara id="GST_DEBUG_COLOR_MODE">
<title><envar>GST_DEBUG_COLOR_MODE</envar></title>
<para>
Set this environment variable to change log colouring in GST_DEBUG output.
Possible values:
<variablelist>
<varlistentry>
<term><option>on</option></term>
<listitem>
<para>
Enables debug log output coloring. Uses default coloring method for current
platform. This is the default.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>off</option></term>
<listitem>
<para>
Disables debug log output coloring. This has the same effect as specifying the
<option>--gst-debug-color-mode</option>=off command line option to
well-behaved GStreamer applications (ie. those that pass command-line
options correctly to GStreamer).
This is particularly useful to reduce the size of debug output and also allows
for the output to be compressed much better than with colours turned on.
</para>
<para>
Has the same effect as setting GST_DEBUG_NO_COLOR environment variable to
any value.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>auto</option></term>
<listitem>
<para>
Same as <option>on</option>.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>disable</option></term>
<listitem>
<para>
Same as <option>off</option>.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>unix</option></term>
<listitem>
<para>
Enables debug log output coloring and forces the use of UNIX termial codes
for coloring, even if this method is not normally used on current platform.
This has the same effect as specifying the
<option>--gst-debug-color-mode</option>=unix command line option to
well-behaved GStreamer applications (ie. those that pass command-line options
correctly to GStreamer).
This is particularly useful to dump debug output into a file on non-UNIX
platforms to be sent to developers who have viewers that support UNIX terminal
codes.
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</formalpara>
<formalpara id="GST_DEBUG_OPTIONS">
<title><envar>GST_DEBUG_OPTIONS</envar></title>
<para>
This environment variable can be used to tweak the behaviour of the debugging
system. Currently the only options supported are "pretty-tags" and "full-tags".
In "pretty-tags" mode (the default), taglists in the debug log will be
serialized so that only the first few and last few bytes of a buffer-type tag
will be serialized into the log, to avoid dumping hundreds of lines of useless
output into the log in case of large image tags and the like.
</para>
</formalpara>
<formalpara id="GST_DEBUG_DUMP_DOT_DIR">
<title><envar>GST_DEBUG_DUMP_DOT_DIR</envar></title>
<para>
Set this environment variable to a path to turn on all
#GST_DEBUG_BIN_TO_DOT_FILE or #GST_DEBUG_BIN_TO_DOT_FILE_WITH_TS calls
and have the dot files in that location.
</para>
<para>
This will only work if the application in question makes these calls in
strategic places (like when the pipeline state changes or an error occurs).
gst-launch-&GST_API_VERSION; is one such application.
</para>
<para>
When gst-launch-&GST_API_VERSION; changes state through NULL to PLAYING
and back to NULL, a dot file is generated on each state change. To have
gst-launch-&GST_API_VERSION; write a snapshot of the pipeline state, send
a SIGHUP to the gst-launch-&GST_API_VERSION; process.
</para>
<para>
These .dot files can then be turned into images using the 'dot' utility
from the graphviz set of tools, like this:
<command>dot foo.dot -Tsvg -o foo.svg</command> or
<command>dot foo.dot -Tpng -o foo.png</command> or
<command>dot foo.dot -Tjpg -o foo.jpg</command>.
</para>
<para>
There is also a utility called <command>xdot</command> which allows you to
view the dot file directly without converting it first.
</para>
</formalpara>
<formalpara id="GST_REGISTRY">
<title><envar>GST_REGISTRY</envar>, <envar>GST_REGISTRY_1_0</envar></title>
<para>
Set this environment variable to make GStreamer use a different file for the
plugin cache / registry than the default one. This is useful when operating
in a separate environment which should not affect the default cache in the
user's home directory.
</para>
</formalpara>
<formalpara id="GST_REGISTRY_FORK">
<title><envar>GST_REGISTRY_FORK</envar></title>
<para>
Set this environment variable to "no" to prevent GStreamer from forking on
startup in order to update the plugin registry. This is useful for debugging
purposes, but should not be used under normal circumstances, since it means
that plugins may be loaded into memory even if they are not needed by the
application.
</para>
</formalpara>
<formalpara id="GST_REGISTRY_UPDATE">
<title><envar>GST_REGISTRY_UPDATE</envar></title>
<para>
Set this environment variable to "no" to prevent GStreamer from updating the
plugin registry. This is useful for embedded device which is not updating the
plugins frequently, it will save time when doing gst_init().
</para>
</formalpara>
<formalpara id="GST_TRACE">
<title><envar>GST_TRACE</envar></title>
<para>
Enable memory allocation tracing. Most GStreamer objects have support for
tracing the number of unfreed objects and their memory pointers.
</para>
<para>
The variable takes a comma-separated list of tracing options to enable.
<variablelist>
<varlistentry>
<term>live</term>
<listitem>
<para>
Counts all live objects and dumps an overview of the number of unfreed
objects at program exit.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>mem-live</term>
<listitem>
<para>
Keep track of the unfreed memory pointers and dump an overview of all unfreed
memory at program exit. Together with a level 9 debug log this can be used to
follow the lifecycle of leaked objects in order to track down where they are
leaked. This can be useful for debugging memory leaks in situations where
tools such as valgrind are not available, or not an option.
</para>
</listitem>
</varlistentry>
</variablelist>
Use <option>all</option> to enable all tracing flags.
</para>
</formalpara>
<formalpara id="GST_DEBUG_FILE">
<title><envar>GST_DEBUG_FILE</envar></title>
<para>
Set this variable to a file path to redirect all GStreamer debug
messages to this file. If left unset, debug messages with be output
unto the standard error.
</para>
</formalpara>
<formalpara id="ORC_CODE">
<title><envar>ORC_CODE</envar></title>
<para>
Useful Orc environment variable. Set ORC_CODE=debug to enable debuggers
such as gdb to create useful backtraces from Orc-generated code. Set
ORC_CODE=backup or ORC_CODE=emulate if you suspect Orc's SIMD code
generator is producing incorrect code (Quite a few important
GStreamer plugins like videotestsrc, audioconvert or audioresample use Orc).
One can also combine flags like ORC_CODE=backup,debug.
</para>
</formalpara>
<formalpara id="G_DEBUG">
<title><envar>G_DEBUG</envar></title>
<para>
Useful GLib environment variable. Set G_DEBUG=fatal_warnings to make
GStreamer programs abort when a critical warning such as an assertion failure
occurs. This is useful if you want to find out which part of the code caused
that warning to be triggered and under what circumstances. Simply set G_DEBUG
as mentioned above and run the program in gdb (or let it core dump). Then get
a stack trace in the usual way.
</para>
</formalpara>
<formalpara id="G_SLICE">
<title><envar>G_SLICE</envar></title>
<para>
Useful GLib environment variable. Set G_SLICE=always-malloc when running
GStreamer programs in valgrind, or debugging memory leaks with other tools.
See the GLib API reference for more details.
</para>
</formalpara>
<formalpara id="GST_TAG_ENCODING">
<title><envar>GST_TAG_ENCODING</envar></title>
<para>
Try this character encoding first for tag-related strings where the encoding
is not defined and which are not UTF-8 already. By default the current locale
will be tried (if not UTF-8).
</para>
</formalpara>
<formalpara id="GST_TAG_ID3_ENCODING">
<title><envar>GST_TAG_ID3_ENCODING</envar></title>
<para>
Try this character encoding first for ID3 tag-related strings where the
encoding is not defined and which are not UTF-8 already. By default the current
locale will be tried (if not UTF-8).
</para>
</formalpara>
<formalpara id="GST_TAG_ID3V1_ENCODING">
<title><envar>GST_TAG_ID3V1_ENCODING</envar></title>
<para>
Try this character encoding first for ID3v1 tag-related strings where the
encoding does not look like UTF-8.
</para>
</formalpara>
<formalpara id="GST_GL_WINDOW">
<title><envar>GST_GL_WINDOW</envar></title>
<para>
Influences the window system to use by the GStreamer OpenGL library.
Common values are 'x11', 'wayland', 'win32' or 'cocoa'.
</para>
</formalpara>
<formalpara id="GST_GL_PLATFORM">
<title><envar>GST_GL_PLATFORM</envar></title>
<para>
Influences the OpenGL platform to use by the GStreamer OpenGL library.
Common values are 'egl', 'glx', 'wgl' or 'cgl'.
</para>
</formalpara>
<formalpara id="GST_GL_API">
<title><envar>GST_GL_API</envar></title>
<para>
Influences the OpenGL API requested by the OpenGL platform.
Common values are 'opengl' or 'gles2'.
</para>
</formalpara>
</refsect2>
</refsect1>
</refentry>

19
docs/libs/.gitignore vendored
View file

@ -1,19 +0,0 @@
*.bak
*.stamp
html
xml
doc-registry.xml
Makefile
Makefile.in
gstreamer-libs-decl.txt
gstreamer-libs-decl-list.txt
gstreamer-libs-presed-scan.c
gstreamer-libs-undocumented.txt
gstreamer-libs-unused.txt
gstreamer-libs-undeclared.txt
gstreamer-libs.args
gstreamer-libs.hierarchy
gstreamer-libs.interfaces
gstreamer-libs.prerequisites
gstreamer-libs.signals
gstreamer-libs-scan.gcno

View file

@ -1,83 +0,0 @@
## Process this file with automake to produce Makefile.in
# The name of the module, e.g. 'glib'.
#DOC_MODULE=gstreamer-libs-@GST_API_VERSION@
DOC_MODULE=gstreamer-libs
# don't want $(DOC_MODULE)-scan.c to be built with -Werror
ERROR_CFLAGS=
# for upload-doc.mak
DOC=gstreamer-libs
FORMATS=html
html: html-build.stamp
include $(top_srcdir)/common/upload-doc.mak
# The top-level SGML file. Change it if you want.
DOC_MAIN_SGML_FILE=$(DOC_MODULE)-docs.sgml
# The directory containing the source code.
# 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 options to supply to gtkdoc-scan.
SCAN_OPTIONS=--deprecated-guards="GST_DISABLE_DEPRECATED" \
--ignore-decorators="GST_API|GST_BASE_API|GST_CHECK_API|GST_CONTROLLER_API|GST_NET_API"
# Extra options to supply to gtkdoc-mkdb.
MKDB_OPTIONS=--sgml-mode --output-format=xml --ignore-files="$(IGNORE_HFILES)"
# Extra options to supply to gtkdoc-fixref.
FIXXREF_OPTIONS=--extra-dir=$(top_builddir)/docs/gst/html \
--extra-dir=$(GLIB_PREFIX)/share/gtk-doc/html \
--extra-dir=$(datadir)/gtk-doc/html
# Used for dependencies.
HFILE_GLOB=$(top_srcdir)/libs/gst/*/*.h
CFILE_GLOB=$(top_srcdir)/libs/gst/*/*.c
# Extra options to pass to gtkdoc-scanobj or gtkdoc-scangobj.
SCANOBJ_OPTIONS=--type-init-func="gst_init(&argc,&argv)"
CHECK_HFILES=$(wildcard $(top_srcdir)/libs/gst/check/libcheck/*.h)
CHECK_HFILES+=$(wildcard $(top_srcdir)/libs/gst/check/libcheck/libcompat/*.h)
# Header files to ignore when scanning.
IGNORE_HFILES = \
$(CHECK_HFILES) \
check/libcheck internal-check.h \
gstinterpolationcontrolsourceprivate.h \
gstlfocontrolsourceprivate.h \
gstgetbits_inl.h \
gstindex.h \
dp-private.h \
gstntppacket.h
# Images to copy into HTML directory.
HTML_IMAGES = gdp-header.png
# 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 = -I$(top_builddir) -I$(top_builddir)/libs $(GST_OBJ_CFLAGS)
GTKDOC_LIBS = \
$(top_builddir)/libs/gst/controller/libgstcontroller-@GST_API_VERSION@.la \
$(top_builddir)/libs/gst/base/libgstbase-@GST_API_VERSION@.la \
$(top_builddir)/libs/gst/net/libgstnet-@GST_API_VERSION@.la \
$(top_builddir)/libs/gst/check/libgstcheck-@GST_API_VERSION@.la \
$(GST_OBJ_LIBS)
GTKDOC_EXTRA_ENVIRONMENT= \
GST_PLUGIN_SCANNER_1_0=$(top_builddir)/libs/gst/helpers/gst-plugin-scanner
# If you need to override some of the declarations, place them in this file
# and uncomment this line.
DOC_OVERRIDES = $(DOC_MODULE)-overrides.txt
include $(top_srcdir)/common/gtk-doc.mak

Binary file not shown.

Before

Width:  |  Height:  |  Size: 24 KiB

View file

@ -1,168 +0,0 @@
<?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 % version-entities SYSTEM "version.entities">
%version-entities;
<!ENTITY % local.common.attrib "xmlns:xi CDATA #FIXED 'http://www.w3.org/2003/XInclude'">
<!ENTITY hash "#">
]>
<book id="index" xmlns:xi="http://www.w3.org/2003/XInclude">
<bookinfo>
<title>GStreamer &GST_API_VERSION; Library Reference Manual</title>
<releaseinfo>
for GStreamer Library &GST_API_VERSION; (&GST_VERSION;)
The latest version of this documentation can be found on-line at
<ulink role="online-location" url="http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer-libs/html/">http://gstreamer.freedesktop.org/data/doc/gstreamer/head/gstreamer-libs/html/</ulink>.
</releaseinfo>
</bookinfo>
<part id="gstreamer-libs">
<title>GStreamer Libraries</title>
<para>
To ease the creation of plugins, a library system was created. The most common
functions for a plugin can be found in a library.
</para>
<para>
GStreamer provides some standard libraries you can use to create plugins.
</para>
<chapter id="gstreamer-base">
<title>GStreamer Base and Utility Classes</title>
<para>
libgstbase-&GST_API_VERSION;.so provides some base classes to be extended
by elements and utility classes that are most useful for plugin developers.
</para>
<xi:include href="xml/gstaggregator.xml" />
<xi:include href="xml/gstaggregatorpad.xml" />
<xi:include href="xml/gstbaseparse.xml" />
<xi:include href="xml/gstbasesrc.xml" />
<xi:include href="xml/gstbasesink.xml" />
<xi:include href="xml/gstbasetransform.xml" />
<xi:include href="xml/gstpushsrc.xml" />
<xi:include href="xml/gstadapter.xml" />
<xi:include href="xml/gstbitreader.xml" />
<xi:include href="xml/gstbitwriter.xml" />
<xi:include href="xml/gstbytereader.xml" />
<xi:include href="xml/gstbytewriter.xml" />
<xi:include href="xml/gstcollectpads.xml" />
<xi:include href="xml/gstflowcombiner.xml" />
<xi:include href="xml/gsttypefindhelper.xml" />
<xi:include href="xml/gstdataqueue.xml" />
<xi:include href="xml/gstqueuearray.xml" />
</chapter>
<chapter id="gstreamer-control">
<title>GStreamer Dynamic Parameter Control</title>
<para>
libgstcontroller-&GST_API_VERSION;.so provides functionality to animate
element properties over time.
</para>
<xi:include href="xml/gstargbcontrolbinding.xml" />
<xi:include href="xml/gstdirectcontrolbinding.xml" />
<xi:include href="xml/gstproxycontrolbinding.xml" />
<xi:include href="xml/gsttimedvaluecontrolsource.xml" />
<xi:include href="xml/gstinterpolationcontrolsource.xml" />
<xi:include href="xml/gstlfocontrolsource.xml" />
<xi:include href="xml/gsttriggercontrolsource.xml" />
</chapter>
<chapter id="gstreamer-net">
<title>GStreamer Network Classes</title>
<para>
libgstnet-&GST_API_VERSION;.so provides network elements and objects.
</para>
<xi:include href="xml/gstnetaddressmeta.xml" />
<xi:include href="xml/gstnetclientclock.xml" />
<xi:include href="xml/gstnetcontrolmessagemeta.xml" />
<xi:include href="xml/gstnettimepacket.xml" />
<xi:include href="xml/gstnettimeprovider.xml" />
<xi:include href="xml/gstptpclock.xml" />
<xi:include href="xml/gstnetutils.xml" />
</chapter>
<chapter id="gstreamer-check">
<title>GStreamer Check Unit Testing</title>
<para>
libgstcheck-&GST_API_VERSION;.so provides functionality for writing
unit tests that use the check framework.
</para>
<xi:include href="xml/gstcheck.xml" />
<xi:include href="xml/gstcheckbufferstraw.xml" />
<xi:include href="xml/gstcheckconsistencychecker.xml" />
<xi:include href="xml/gstharness.xml" />
<xi:include href="xml/gsttestclock.xml" />
</chapter>
</part>
<chapter id="gstreamer-hierarchy">
<title>Object Hierarchy</title>
<xi:include href="xml/tree_index.sgml"/>
</chapter>
<index>
<title>API Index</title>
<xi:include href="xml/api-index-full.xml"><xi:fallback /></xi:include>
</index>
<index role="deprecated">
<title>Index of deprecated API</title>
<xi:include href="xml/api-index-deprecated.xml"><xi:fallback /></xi:include>
</index>
<index>
<title>Index of new API in 1.16</title>
<xi:include href="xml/api-index-1.16.xml"><xi:fallback /></xi:include>
</index>
<index>
<title>Index of new API in 1.14.3</title>
<xi:include href="xml/api-index-1.14.3.xml"><xi:fallback /></xi:include>
</index>
<index>
<title>Index of new API in 1.14.1</title>
<xi:include href="xml/api-index-1.14.1.xml"><xi:fallback /></xi:include>
</index>
<index>
<title>Index of new API in 1.14</title>
<xi:include href="xml/api-index-1.14.xml"><xi:fallback /></xi:include>
</index>
<index>
<title>Index of new API in 1.12.1</title>
<xi:include href="xml/api-index-1.12.1.xml"><xi:fallback /></xi:include>
</index>
<index>
<title>Index of new API in 1.12</title>
<xi:include href="xml/api-index-1.12.xml"><xi:fallback /></xi:include>
</index>
<index>
<title>Index of new API in 1.10</title>
<xi:include href="xml/api-index-1.10.xml"><xi:fallback /></xi:include>
</index>
<index>
<title>Index of new API in 1.8</title>
<xi:include href="xml/api-index-1.8.xml"><xi:fallback /></xi:include>
</index>
<index>
<title>Index of new API in 1.6</title>
<xi:include href="xml/api-index-1.6.xml"><xi:fallback /></xi:include>
</index>
<index>
<title>Index of new API in 1.4</title>
<xi:include href="xml/api-index-1.4.xml"><xi:fallback /></xi:include>
</index>
<index>
<title>Index of new API in 1.2</title>
<xi:include href="xml/api-index-1.2.xml"><xi:fallback /></xi:include>
</index>
<index>
<title>Index of new API in 1.0.1</title>
<xi:include href="xml/api-index-1.0.1.xml"><xi:fallback /></xi:include>
</index>
<xi:include href="xml/annotation-glossary.xml"><xi:fallback /></xi:include>
</book>

File diff suppressed because it is too large Load diff

View file

@ -1,53 +0,0 @@
#include <gst/gst.h>
% base classes
#include <gst/base/gstadapter.h>
#include <gst/base/gstaggregator.h>
#include <gst/base/gstbaseparse.h>
#include <gst/base/gstbasesrc.h>
#include <gst/base/gstbasesink.h>
#include <gst/base/gstbasetransform.h>
#include <gst/base/gstcollectpads.h>
#include <gst/base/gstpushsrc.h>
gst_adapter_get_type
gst_aggregator_get_type
gst_aggregator_pad_get_type
gst_base_parse_get_type
gst_base_src_get_type
gst_base_sink_get_type
gst_base_transform_get_type
gst_collect_pads_get_type
gst_push_src_get_type
% controller
#include <gst/controller/gstargbcontrolbinding.h>
#include <gst/controller/gstdirectcontrolbinding.h>
#include <gst/controller/gsttimedvaluecontrolsource.h>
#include <gst/controller/gstinterpolationcontrolsource.h>
#include <gst/controller/gstlfocontrolsource.h>
#include <gst/controller/gsttriggercontrolsource.h>
gst_argb_control_binding_get_type
gst_direct_control_binding_get_type
gst_timed_value_control_source_get_type
gst_interpolation_control_source_get_type
gst_lfo_control_source_get_type
gst_trigger_control_source_get_type
% net
#include <gst/net/net.h>
gst_net_client_clock_get_type
gst_net_time_provider_get_type
gst_ntp_clock_get_type
gst_ptp_clock_get_type
% check
#include <gst/check/gsttestclock.h>
gst_test_clock_get_type

View file

@ -1,16 +0,0 @@
types = configure_file(input : 'gstreamer-libs.types',
output : 'gstreamer-libs.types',
copy: true)
gnome.gtkdoc('gstreamer-libs',
main_sgml : 'gstreamer-libs-docs.sgml',
src_dir : '@0@/../../libs/gst'.format(meson.current_source_dir()),
scan_args : ['--deprecated-guards=GST_DISABLE_DEPRECATED',
'--ignore-decorators=GST_API|GST_BASE_API|GST_CHECK_API|GST_CONTROLLER_API|GST_NET_API',
'--ignore-headers=gettext.h glib-compat-private.h glib-compat.h gst-i18n-app.h gst-i18n-lib.h gst_private.h gstelementdetails.h gstmacros.h grammar.tab.h grammar.tab.pre.h math-compat.h types.h'
],
scanobjs_args : ['--type-init-func="gst_init(NULL,NULL)"'],
gobject_typesfile : types,
content_files : [version_entities],
dependencies : [gst_base_dep, gst_check_dep, gst_controller_dep, gst_net_dep],
install : true)

View file

@ -1,8 +0,0 @@
<?xml version='1.0'?>
<xsl:stylesheet xmlns:xsl='http://www.w3.org/1999/XSL/Transform' version='1.0'>
<xsl:output method='text'/>
<xsl:template xmlns:xi='http://www.w3.org/2003/XInclude' match='ulink'>
<xsl:value-of select='@url'/><xsl:text>&#xa;</xsl:text>
</xsl:template>
<xsl:template match='text()|@*'/>
</xsl:stylesheet>

View file

@ -1,12 +0,0 @@
docconf = configuration_data()
docconf.set('GST_API_VERSION', apiversion)
docconf.set('PACKAGE_VERSION', gst_version)
docconf.set('PLUGINDIR', '@0@/lib/gstreamer-1.0'.format(get_option('prefix')))
version_entities = configure_file(input : 'version.entities.in',
output : 'version.entities',
configuration : docconf)
subdir('gst')
subdir('libs')

View file

@ -1,3 +0,0 @@
<!ENTITY GST_API_VERSION "@GST_API_VERSION@">
<!ENTITY GST_VERSION "@PACKAGE_VERSION@">
<!ENTITY GST_PLUGINS_DIR "@PLUGINDIR@">

View file

@ -530,16 +530,6 @@ endif
configure_file(output : 'config.h', configuration : cdata)
if build_machine.system() == 'windows'
message('Disabling gtk-doc while building on Windows')
else
if find_program('gtkdoc-scan', required : get_option('gtk_doc')).found()
subdir('docs')
else
message('Not building documentation as gtk-doc was not found')
endif
endif
run_command(python3, '-c', 'import shutil; shutil.copy("hooks/pre-commit.hook", ".git/hooks/pre-commit")')
install_data('gst-element-check-1.0.m4', install_dir : join_paths(get_option('datadir'), 'aclocal'))