--- /dev/null
+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">
+
g_print ("%s\n\n", _gst_plugin_fault_handler_filename);
g_print ("Please either:\n");
g_print ("- remove it and restart.\n");
- g_print ("- run with --gst-disable-segtrap and debug.\n");
+ g_print
+ ("- run with --gst-disable-segtrap --gst-disable-registry-fork and debug.\n");
exit (-1);
break;
default: