mirror of
https://gitlab.freedesktop.org/gstreamer/gstreamer.git
synced 2024-12-30 12:10:37 +00:00
51 lines
1.6 KiB
Text
51 lines
1.6 KiB
Text
Plugin Docs
|
|
===========
|
|
|
|
In contrast to normal gtk-doc workflow modules will include
|
|
common/gtk-doc-plugins.mak. This provides an additional 'make udpate' target.
|
|
|
|
the "make update" target calls
|
|
1.) common/gstdoc-scangobj --type-init-func="gst_init(NULL,NULL)" --module=$(DOC_MODULE) --source=$(PACKAGE)
|
|
common/scangobj-merge.py $(DOC_MODULE)
|
|
|
|
the "tmpl" target is modified to run this extra step after "gtkdoc-mktmpl":
|
|
2.) common/mangle-tmpl.py $(srcdir)/inspect tmpl
|
|
|
|
and the "sgml" target is modified to run this step before "gtkdoc-mkdb":
|
|
3.) for a in $(srcdir)/inspect/*.xml; do \
|
|
xsltproc --stringparam module $(MODULE) $(top_srcdir)/common/plugins.xsl $$a > xml/`basename $$a`;
|
|
done
|
|
|
|
Details
|
|
=======
|
|
|
|
1a.) gstdoc-scangobj
|
|
-------------------
|
|
- get types from registry instead of .types file
|
|
- outputs inspect/plugin-<pluginname>.xml files
|
|
- outputs signal and args files
|
|
|
|
1b.) scangobj-merge.py
|
|
---------------------
|
|
- parse, update and write .signals and .args files
|
|
|
|
2.) mangle-tmpl.py
|
|
------------------
|
|
- read data from inspect/plugin-<pluginname>.xml
|
|
- insert/overwrite "Short Description" and "Long Description" in tmpl/
|
|
- the "Long Description" contains a <xi:inlcude> for xml/element-<name>-details.xml
|
|
|
|
3.) common/plugins.xsl
|
|
----------------------
|
|
- creates xml/plugin-<name>.xml and xml/element-<name>-details.xml
|
|
|
|
|
|
TODO:
|
|
-----
|
|
- scangobj-merge.py -> gstdoc-scangobj
|
|
- need a way to skip the tmpl step
|
|
- gtkdoc-mkdb needs a way to insert extra content
|
|
- maybe patch generated xml/*.xml files
|
|
- could common/plugins.xsl patch the files?
|
|
<refsect1 id="gstreamer-plugins-capsfilter.description" role="desc">
|
|
|