update-common: fix case statement
[platform/upstream/gst-common.git] / gtk-doc-plugins.mak
index ad06a19..f19e7d7 100644 (file)
@@ -13,8 +13,7 @@ help:
        @echo
 
 # update the stuff maintained by doc maintainers
-update:
-       $(MAKE) scanobj-update
+update: scanobj-update
        $(MAKE) check-outdated-docs
 
 # We set GPATH here; this gives us semantics for GNU make
@@ -25,7 +24,7 @@ update:
 GPATH = $(srcdir)
 
 # thomas: make docs parallel installable
-TARGET_DIR=$(HTML_DIR)/$(DOC_MODULE)-@GST_MAJORMINOR@
+TARGET_DIR=$(HTML_DIR)/$(DOC_MODULE)-@GST_API_VERSION@
 
 MAINTAINER_DOC_STAMPS =                        \
        scanobj-build.stamp
@@ -95,9 +94,9 @@ all-local: html-build.stamp
 INSPECT_REGISTRY=$(top_builddir)/docs/plugins/inspect-registry.xml
 INSPECT_ENVIRONMENT=\
        LC_ALL=C \
-       GST_PLUGIN_SYSTEM_PATH= \
-       GST_PLUGIN_PATH=$(top_builddir)/gst:$(top_builddir)/sys:$(top_builddir)/ext:$(top_builddir)/plugins:$(top_builddir)/src:$(top_builddir)/gnl \
-       GST_REGISTRY=$(INSPECT_REGISTRY) \
+       GST_PLUGIN_SYSTEM_PATH_1_0= \
+       GST_PLUGIN_PATH_1_0=$(top_builddir)/gst:$(top_builddir)/sys:$(top_builddir)/ext:$(top_builddir)/plugins:$(top_builddir)/src:$(top_builddir)/gnl \
+       GST_REGISTRY_1_0=$(INSPECT_REGISTRY) \
        PKG_CONFIG_PATH="$(GST_PKG_CONFIG_PATH)" \
        $(INSPECT_EXTRA_ENVIRONMENT)
 
@@ -106,9 +105,9 @@ scanobj-update:
        -rm scanobj-build.stamp
        $(MAKE) scanobj-build.stamp
 
-# TODO: finish elite script that updates the output files of this step
-# instead of rewriting them, so that multiple maintainers can generate
-# a collective set of args and signals
+# gstdoc-scanobj produces 5 output files (.new)
+# scangobj-merge.py merges them into the file which we commit later
+# TODO: also merge the hierarchy
 scanobj-build.stamp: $(SCANOBJ_DEPS) $(basefiles)
        @echo "  DOC   Introspecting gobjects"
        @if test x"$(srcdir)" != x. ; then                              \
@@ -130,7 +129,7 @@ scanobj-build.stamp: $(SCANOBJ_DEPS) $(basefiles)
            --module=$(DOC_MODULE) --source=$(PACKAGE) --inspect-dir=$(INSPECT_DIR) &&          \
            echo "  DOC   Merging introspection data" && \
            $(PYTHON)                                           \
-           $(top_srcdir)/common/scangobj-merge.py $(DOC_MODULE);       \
+           $(top_srcdir)/common/scangobj-merge.py $(DOC_MODULE) || exit 1;     \
        if test x"$(srcdir)" != x. ; then                               \
            for f in $(SCANOBJ_FILES);                                  \
            do                                                          \
@@ -145,10 +144,20 @@ $(DOC_MODULE)-decl.txt $(SCANOBJ_FILES) $(SCANOBJ_FILES_O): scan-build.stamp
 ### scan headers; done on every build ###
 scan-build.stamp: $(HFILE_GLOB) $(EXTRA_HFILES) $(basefiles) scanobj-build.stamp
        @echo '  DOC   Scanning header files'
-       @gtkdoc-scan                                                    \
+       @if test x"$(srcdir)" != x. ; then                              \
+           for f in $(SCANOBJ_FILES) $(SCAN_FILES);                    \
+           do                                                          \
+               if test -e $(srcdir)/$$f; then cp -u $(srcdir)/$$f . ; fi;      \
+           done;                                                       \
+       fi
+       @_source_dir='' ;                                               \
+       for i in $(DOC_SOURCE_DIR) ; do                                 \
+           _source_dir="$${_source_dir} --source-dir=$$i" ;            \
+       done ;                                                          \
+       gtkdoc-scan                                                     \
            $(SCAN_OPTIONS) $(EXTRA_HFILES)                             \
            --module=$(DOC_MODULE)                                      \
-           --source-dir=$(DOC_SOURCE_DIR)                              \
+           $${_source_dir}                                             \
            --ignore-headers="$(IGNORE_HFILES)";                        \
        touch scan-build.stamp
 
@@ -207,13 +216,13 @@ html-build.stamp: sgml.stamp $(DOC_MAIN_SGML_FILE) $(content_files)
        @cp -pr xml html
        @cp ../version.entities html
        @mkhtml_options=""; \
-       if test "x$(V)" = "x1"; then \
-           mkhtml_options="--verbose"; \
+       gtkdoc-mkhtml 2>&1 --help | grep  >/dev/null "\-\-verbose"; \
+       if test "$(?)" = "0"; then \
+         if test "x$(V)" = "x1"; then \
+           mkhtml_options="$$mkhtml_options --verbose"; \
+         fi; \
        fi; \
-       cd html && gtkdoc-mkhtml $$mkhtml_options $(DOC_MODULE) $(DOC_MAIN_SGML_FILE)
-       @mv html/index.sgml html/index.sgml.bak
-       @$(SED) "s/ href=\"$(DOC_MODULE)\// href=\"$(DOC_MODULE)-@GST_MAJORMINOR@\//g" html/index.sgml.bak >html/index.sgml
-       @rm -f html/index.sgml.bak
+       cd html && gtkdoc-mkhtml $$mkhtml_options $(DOC_MODULE)-@GST_API_VERSION@ $(DOC_MAIN_SGML_FILE)
        @rm -f html/$(DOC_MAIN_SGML_FILE)
        @rm -rf html/xml
        @rm -f html/version.entities
@@ -277,13 +286,12 @@ install-data-local:
              $(INSTALL_DATA) $$i $(DESTDIR)$(TARGET_DIR); \
            done; \
          fi; \
-         echo '-- Installing $(builddir)/html/$(DOC_MODULE).devhelp2' ; \
-         if test -e $(builddir)/html/$(DOC_MODULE).devhelp2; then \
-                   $(INSTALL_DATA) $(builddir)/html/$(DOC_MODULE).devhelp2 \
-                   $(DESTDIR)$(TARGET_DIR)/$(DOC_MODULE)-@GST_MAJORMINOR@.devhelp2; \
+         echo '-- Installing $(builddir)/html/$(DOC_MODULE)-@GST_API_VERSION@.devhelp2' ; \
+         if test -e $(builddir)/html/$(DOC_MODULE)-@GST_API_VERSION@.devhelp2; then \
+                   $(INSTALL_DATA) $(builddir)/html/$(DOC_MODULE)-@GST_API_VERSION@.devhelp2 \
+                   $(DESTDIR)$(TARGET_DIR)/$(DOC_MODULE)-@GST_API_VERSION@.devhelp2; \
          fi; \
-         (which gtkdoc-rebase >/dev/null && \
-           gtkdoc-rebase --relative --dest-dir=$(DESTDIR) --html-dir=$(DESTDIR)$(TARGET_DIR)) || true ; \
+         $(GTKDOC_REBASE) --relative --dest-dir=$(DESTDIR) --html-dir=$(DESTDIR)$(TARGET_DIR) || true ; \
        fi)
 uninstall-local:
        if test -d $(DESTDIR)$(TARGET_DIR); then \