Lines Matching +full:build +full:- +full:docs
2 # for GStreamer plug-ins
11 @echo check-inspected-versions: make sure the inspected plugin info
16 update: scanobj-update
17 $(MAKE) check-outdated-docs
20 GTKDOC_CC = $(LIBTOOL) --tag=CC --mode=compile $(CC) $(INCLUDES) $(GTKDOC_DEPS_CFLAGS) $(AM_CPPFLAG…
21 GTKDOC_LD = $(LIBTOOL) --tag=CC --mode=link $(CC) $(GTKDOC_DEPS_LIBS) $(AM_CFLAGS) $(CFLAGS) $(AM_L…
22 GTKDOC_RUN = $(LIBTOOL) --mode=execute
36 # thomas: make docs parallel installable
37 TARGET_DIR=$(HTML_DIR)/$(DOC_MODULE)-@GST_API_VERSION@
40 scanobj-build.stamp
51 $(DOC_MODULE)-sections.txt
53 # we don't add scanobj-build.stamp here since they are built manually by docs
56 scan-build.stamp \
57 sgml-build.stamp \
58 html-build.stamp \
63 # files generated/updated by gtkdoc-scangobj
73 .libs/$(DOC_MODULE)-scan.o
75 # files generated/updated by gtkdoc-scan
77 $(DOC_MODULE)-sections.txt \
78 $(DOC_MODULE)-overrides.txt \
79 $(DOC_MODULE)-decl.txt \
80 $(DOC_MODULE)-decl-list.txt
84 $(DOC_MODULE)-undocumented.txt \
85 $(DOC_MODULE)-undeclared.txt \
86 $(DOC_MODULE)-unused.txt
92 inspect-registry.xml
97 all-local: html-build.stamp
99 ### inspect GStreamer plug-ins; done by documentation maintainer ###
102 INSPECT_REGISTRY=$(top_builddir)/docs/plugins/inspect-registry.xml
112 scanobj-update:
113 -rm scanobj-build.stamp
114 $(MAKE) scanobj-build.stamp
116 # gstdoc-scanobj produces 5 output files (.new)
117 # scangobj-merge.py merges them into the file which we commit later
119 scanobj-build.stamp: $(SCANOBJ_DEPS) $(basefiles)
124 if test -e $(srcdir)/$$f; then \
125 cp -u $(srcdir)/$$f . || cp $(srcdir)/$$f . ; \
129 mkdir -p $(INSPECT_DIR); \
132 scanobj_options="--verbose"; \
138 $(GST_DOC_SCANOBJ) $$scanobj_options --type-init-func="gst_init(NULL,NULL)" \
139 --module=$(DOC_MODULE) --source=$(PACKAGE) --inspect-dir=$(INSPECT_DIR) && \
142 $(top_srcdir)/common/scangobj-merge.py $(DOC_MODULE) || exit 1; \
146 cmp -s ./$$f $(srcdir)/$$f || cp ./$$f $(srcdir)/ ; \
149 touch scanobj-build.stamp
151 $(DOC_MODULE)-decl.txt $(SCANOBJ_FILES) $(SCANOBJ_FILES_O): scan-build.stamp
154 ### scan headers; done on every build ###
155 scan-build.stamp: $(HFILE_GLOB) $(EXTRA_HFILES) $(basefiles) scanobj-build.stamp
160 if test -e $(srcdir)/$$f; then \
161 cp -u $(srcdir)/$$f . || cp $(srcdir)/$$f .; \
167 _source_dir="$${_source_dir} --source-dir=$$i" ; \
169 gtkdoc-scan \
171 --module=$(DOC_MODULE) \
173 --ignore-headers="$(IGNORE_HFILES)"; \
174 touch scan-build.stamp
178 sgml-build.stamp: scan-build.stamp $(CFILE_GLOB) $(top_srcdir)/common/plugins.xsl $(expand_content_…
180 @-mkdir -p xml
182 xsltproc --stringparam module $(MODULE) \
185 $(PYTHON) $(top_srcdir)/common/c-to-xml.py $$f > xml/element-`basename $$f .c`.xml; done
188 _source_dir="$${_source_dir} --source-dir=$$i" ; \
190 gtkdoc-mkdb \
191 --module=$(DOC_MODULE) \
193 --expand-content-files="$(expand_content_files)" \
194 --main-sgml-file=$(srcdir)/$(DOC_MAIN_SGML_FILE) \
195 --output-format=xml \
196 --ignore-files="$(IGNORE_HFILES) $(IGNORE_CFILES)" \
198 @$(PYTHON) $(top_srcdir)/common/mangle-db.py xml
200 @touch sgml-build.stamp
202 sgml.stamp: sgml-build.stamp
207 html-build.stamp: sgml.stamp $(DOC_MAIN_SGML_FILE) $(content_files)
209 @rm -rf html
213 @cp -pr xml html
216 gtkdoc-mkhtml 2>&1 --help | grep >/dev/null "\-\-verbose"; \
219 mkhtml_options="$$mkhtml_options --verbose"; \
222 cd html && gtkdoc-mkhtml $$mkhtml_options $(DOC_MODULE)-@GST_API_VERSION@ $(DOC_MAIN_SGML_FILE)
223 @rm -f html/$(DOC_MAIN_SGML_FILE)
224 @rm -rf html/xml
225 @rm -f html/version.entities
228 @echo ' DOC Fixing cross-references'
229 @gtkdoc-fixxref --module=$(DOC_MODULE) --module-dir=html --html-dir=$(HTML_DIR) $(FIXXREF_OPTIONS)
230 @touch html-build.stamp
232 clean-local-gtkdoc:
233 @rm -rf xml tmpl html
234 # clean files copied for nonsrcdir templates build
236 rm -rf $(SCANOBJ_FILES) $(SCAN_FILES) $(REPORT_FILES) \
240 all-local:
241 clean-local-gtkdoc:
244 clean-local: clean-local-gtkdoc
245 @rm -f *~ *.bak
246 @rm -rf .libs
248 distclean-local:
249 @rm -f $(REPORT_FILES) \
250 $(DOC_MODULE)-decl-list.txt $(DOC_MODULE)-decl.txt
251 @rm -rf tmpl/*.sgml.bak
252 @rm -f $(DOC_MODULE).hierarchy
253 @rm -f *.stamp || true
255 rm -f $(DOC_MODULE)-docs.sgml ; \
256 rm -f $(DOC_MODULE).types ; \
257 rm -f $(DOC_MODULE).interfaces ; \
258 rm -f $(DOC_MODULE)-overrides.txt ; \
259 rm -f $(DOC_MODULE).prerequisites ; \
260 rm -f $(DOC_MODULE)-sections.txt ; \
261 rm -rf tmpl/*.sgml ; \
262 rm -rf $(INSPECT_DIR); \
264 @rm -rf *.o
268 # thomas: make docs parallel installable; devhelp requires majorminor too
269 install-data-local:
272 then echo '-- Nothing to install' ; \
276 echo '-- Installing '$$i ; \
282 echo '-- Installing '$$i ; \
286 echo '-- Installing $(builddir)/html/$(DOC_MODULE)-@GST_API_VERSION@.devhelp2' ; \
287 if test -e $(builddir)/html/$(DOC_MODULE)-@GST_API_VERSION@.devhelp2; then \
288 $(INSTALL_DATA) $(builddir)/html/$(DOC_MODULE)-@GST_API_VERSION@.devhelp2 \
289 $(DESTDIR)$(TARGET_DIR)/$(DOC_MODULE)-@GST_API_VERSION@.devhelp2; \
291 $(GTKDOC_REBASE) --relative --dest-dir=$(DESTDIR) --html-dir=$(DESTDIR)$(TARGET_DIR) || true ; \
293 uninstall-local:
294 if test -d $(DESTDIR)$(TARGET_DIR); then \
295 rm -rf $(DESTDIR)$(TARGET_DIR)/*; \
296 rmdir -p $(DESTDIR)$(TARGET_DIR) 2>/dev/null || true; \
298 echo '-- Nothing to uninstall' ; \
305 check-hierarchy: $(DOC_MODULE).hierarchy
311 check: check-hierarchy
315 inspect_files = $(sort $(shell find $(srcdir)/$(INSPECT_DIR) -name '*.xml'))
317 check-inspected-versions:
321 if (grep -H '<version>' $$each | grep -v '<version>$(VERSION)'); then \
323 echo "sed -i -e 's/<version.*version>/<version>$(VERSION)<\/version>/'" $$each; \
330 check-outdated-docs:
333 if [ -d $(top_srcdir)/.git/ ]; then \
334 files=`find $(srcdir)/inspect/ -name '*xml'`; \
338 plugin=`echo $$f | sed -e 's/^.*plugin-//' -e 's/.xml//'`; \
341 pinit=`git grep -A3 GST_PLUGIN_DEFINE -- ext/ gst/ sys/ | grep "\"$$plugin\""`; \
345 printf " **** outdated docs for plugin %-15s: %s\n" $$plugin $$f; \
354 # Require gtk-doc when making dist
357 dist-check-gtkdoc:
359 dist-check-gtkdoc:
360 @echo "*** gtk-doc must be installed and enabled in order to make dist"
365 # also this only works, if the project has been build before
368 dist-hook: dist-check-gtkdoc dist-hook-local
371 -cp $(srcdir)/$(DOC_MODULE).types $(distdir)/
372 -cp $(srcdir)/$(DOC_MODULE)-sections.txt $(distdir)/
373 cd $(distdir) && rm -f $(DISTCLEANFILES)
374 -gtkdoc-rebase --online --relative --html-dir=$(distdir)/html
376 .PHONY : dist-hook-local docs check-outdated-docs inspect
378 # avoid spurious build errors when distchecking with -jN