summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorJan Schmidt <thaytan@mad.scientist.com>2008-05-17 17:20:51 +0000
committerJan Schmidt <thaytan@mad.scientist.com>2008-05-17 17:20:51 +0000
commit450fa6366abc7c395141218621f806b9b4930fc7 (patch)
tree2724ca2375a4607bfb5fb1885899b72e6f591f6a
parent2aab2757c0ee2594169f1fed1dcc1c8713467e65 (diff)
docs/Makefile.am: Don't descend into the plugins dir if plugin docs building is disabled.
Original commit message from CVS: * docs/Makefile.am: Don't descend into the plugins dir if plugin docs building is disabled. * docs/README: Add a note about the new type:GTypeName syntax for the plugin documentation .types file.
-rw-r--r--ChangeLog10
m---------common0
-rw-r--r--docs/Makefile.am8
-rw-r--r--docs/README8
4 files changed, 25 insertions, 1 deletions
diff --git a/ChangeLog b/ChangeLog
index 6515df2b2..2a4ce19b4 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,3 +1,13 @@
+2008-05-17 Jan Schmidt <jan.schmidt@sun.com>
+
+ * docs/Makefile.am:
+ Don't descend into the plugins dir if plugin docs building
+ is disabled.
+
+ * docs/README:
+ Add a note about the new type:GTypeName syntax for the plugin
+ documentation .types file.
+
2008-05-17 Sebastian Dröge <slomo@circular-chaos.org>
* gst/gstmessage.c: (gst_message_new_error),
diff --git a/common b/common
-Subproject 3b3631082d04b426f450810e8836de94e9c5d60
+Subproject e365978c480a8fffa4bdb61568fb2cd989d1b19
diff --git a/docs/Makefile.am b/docs/Makefile.am
index 85cc08786..e964f9636 100644
--- a/docs/Makefile.am
+++ b/docs/Makefile.am
@@ -4,9 +4,15 @@ else
SUBDIRS_DOCBOOK =
endif
+if ENABLE_PLUGIN_DOCS
+PLUGIN_DOCS_DIRS = plugins
+else
+PLUGIN_DOCS_DIRS =
+endif
+
BUILT_SOURCES = version.entities
-SUBDIRS = design gst libs plugins $(SUBDIRS_DOCBOOK)
+SUBDIRS = design gst libs $(PLUGIN_DOCS_DIRS) $(SUBDIRS_DOCBOOK)
DIST_SUBDIRS = design gst libs plugins faq manual pwg slides xsl
EXTRA_DIST = \
diff --git a/docs/README b/docs/README
index a531204c2..ed6b37189 100644
--- a/docs/README
+++ b/docs/README
@@ -242,6 +242,14 @@ in the various plugin packages.
cvs add *-plugins-docs.sgml *-plugins.args *-plugins.hierarchy *-plugins.interfaces *-plugins.prerequisites *-plugins.signals *-plugins.types inspect-build.stamp inspect.stamp scanobj-build.stamp
cvs add inspect
cvs add inspect/*.xml
+ - Additional types can be added to the documentation by placing them in
+ the .types file like this:
+ type:GstPlayBaseBin
+ This is useful for documenting plugin-private types that implement
+ signals or properties. The GType is looked up by name after all the
+ element classes have been printed - so this is only useful for types
+ that are created as a consequence of loading plugins and registering
+ the element(s).
- to add a plugin to be documented:
- make sure inspect/ has generated a inspect/plugin-xxx.xml file for it.