1 # Makefile.in generated by automake 1.11.1 from Makefile.am.
4 # Copyright (C) 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002,
5 # 2003, 2004, 2005, 2006, 2007, 2008, 2009 Free Software Foundation,
7 # This Makefile.in is free software; the Free Software Foundation
8 # gives unlimited permission to copy and/or distribute it,
9 # with or without modifications, as long as this notice is preserved.
11 # This program is distributed in the hope that it will be useful,
12 # but WITHOUT ANY WARRANTY, to the extent permitted by law; without
13 # even the implied warranty of MERCHANTABILITY or FITNESS FOR A
18 # this snippet is to be included by both our docbook manuals
19 # and gtk-doc API references
21 # it adds an upload target to each of these dir's Makefiles
23 # each Makefile.am should define the following variables:
24 # - DOC: the base name of the documentation
25 # (faq, manual, pwg, gstreamer, gstreamer-libs)
26 # - FORMATS: the formats in which DOC is output
29 # if you want to use it, make sure your $HOME/.ssh/config file contains the
30 # correct User entry for the Host entry for the DOC_SERVER
32 # This is an include file specifically tuned for building documentation
33 # for GStreamer plug-ins
35 pkgdatadir = $(datadir)/@PACKAGE@
36 pkgincludedir = $(includedir)/@PACKAGE@
37 pkglibdir = $(libdir)/@PACKAGE@
38 pkglibexecdir = $(libexecdir)/@PACKAGE@
39 am__cd = CDPATH="$${ZSH_VERSION+.}$(PATH_SEPARATOR)" && cd
40 install_sh_DATA = $(install_sh) -c -m 644
41 install_sh_PROGRAM = $(install_sh) -c
42 install_sh_SCRIPT = $(install_sh) -c
43 INSTALL_HEADER = $(INSTALL_DATA)
44 transform = $(program_transform_name)
51 build_triplet = @build@
53 DIST_COMMON = $(srcdir)/Makefile.am $(srcdir)/Makefile.in \
54 $(top_srcdir)/common/gtk-doc-plugins.mak \
55 $(top_srcdir)/common/upload-doc.mak
57 ACLOCAL_M4 = $(top_srcdir)/aclocal.m4
58 am__aclocal_m4_deps = $(top_srcdir)/common/m4/as-ac-expand.m4 \
59 $(top_srcdir)/common/m4/as-auto-alt.m4 \
60 $(top_srcdir)/common/m4/as-compiler-flag.m4 \
61 $(top_srcdir)/common/m4/as-gcc-inline-assembly.m4 \
62 $(top_srcdir)/common/m4/as-objc.m4 \
63 $(top_srcdir)/common/m4/as-python.m4 \
64 $(top_srcdir)/common/m4/as-scrub-include.m4 \
65 $(top_srcdir)/common/m4/as-version.m4 \
66 $(top_srcdir)/common/m4/ax_create_stdint_h.m4 \
67 $(top_srcdir)/common/m4/gst-arch.m4 \
68 $(top_srcdir)/common/m4/gst-args.m4 \
69 $(top_srcdir)/common/m4/gst-check.m4 \
70 $(top_srcdir)/common/m4/gst-default.m4 \
71 $(top_srcdir)/common/m4/gst-dowhile.m4 \
72 $(top_srcdir)/common/m4/gst-error.m4 \
73 $(top_srcdir)/common/m4/gst-feature.m4 \
74 $(top_srcdir)/common/m4/gst-gettext.m4 \
75 $(top_srcdir)/common/m4/gst-glib2.m4 \
76 $(top_srcdir)/common/m4/gst-package-release-datetime.m4 \
77 $(top_srcdir)/common/m4/gst-platform.m4 \
78 $(top_srcdir)/common/m4/gst-plugin-docs.m4 \
79 $(top_srcdir)/common/m4/gst-plugindir.m4 \
80 $(top_srcdir)/common/m4/gst-x11.m4 \
81 $(top_srcdir)/common/m4/gst.m4 \
82 $(top_srcdir)/common/m4/gtk-doc.m4 \
83 $(top_srcdir)/common/m4/orc.m4 $(top_srcdir)/common/m4/pkg.m4 \
84 $(top_srcdir)/m4/aalib.m4 $(top_srcdir)/m4/esd.m4 \
85 $(top_srcdir)/m4/gconf-2.m4 $(top_srcdir)/m4/gettext.m4 \
86 $(top_srcdir)/m4/gst-fionread.m4 \
87 $(top_srcdir)/m4/gst-shout2.m4 $(top_srcdir)/m4/iconv.m4 \
88 $(top_srcdir)/m4/intlmacosx.m4 $(top_srcdir)/m4/lib-ld.m4 \
89 $(top_srcdir)/m4/lib-link.m4 $(top_srcdir)/m4/lib-prefix.m4 \
90 $(top_srcdir)/m4/libtool.m4 $(top_srcdir)/m4/ltoptions.m4 \
91 $(top_srcdir)/m4/ltsugar.m4 $(top_srcdir)/m4/ltversion.m4 \
92 $(top_srcdir)/m4/lt~obsolete.m4 $(top_srcdir)/m4/nls.m4 \
93 $(top_srcdir)/m4/po.m4 $(top_srcdir)/m4/progtest.m4 \
94 $(top_srcdir)/configure.ac
95 am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \
97 mkinstalldirs = $(install_sh) -d
98 CONFIG_HEADER = $(top_builddir)/config.h
100 CONFIG_CLEAN_VPATH_FILES =
101 AM_V_GEN = $(am__v_GEN_$(V))
102 am__v_GEN_ = $(am__v_GEN_$(AM_DEFAULT_VERBOSITY))
103 am__v_GEN_0 = @echo " GEN " $@;
104 AM_V_at = $(am__v_at_$(V))
105 am__v_at_ = $(am__v_at_$(AM_DEFAULT_VERBOSITY))
109 DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST)
110 AALIB_CFLAGS = @AALIB_CFLAGS@
111 AALIB_CONFIG = @AALIB_CONFIG@
112 AALIB_LIBS = @AALIB_LIBS@
114 ACLOCAL_AMFLAGS = @ACLOCAL_AMFLAGS@
116 AM_DEFAULT_VERBOSITY = @AM_DEFAULT_VERBOSITY@
117 ANNODEX_CFLAGS = @ANNODEX_CFLAGS@
118 ANNODEX_LIBS = @ANNODEX_LIBS@
121 AUTOCONF = @AUTOCONF@
122 AUTOHEADER = @AUTOHEADER@
123 AUTOMAKE = @AUTOMAKE@
125 BZ2_LIBS = @BZ2_LIBS@
126 CAIRO_CFLAGS = @CAIRO_CFLAGS@
127 CAIRO_GOBJECT_CFLAGS = @CAIRO_GOBJECT_CFLAGS@
128 CAIRO_GOBJECT_LIBS = @CAIRO_GOBJECT_LIBS@
129 CAIRO_LIBS = @CAIRO_LIBS@
132 CCASDEPMODE = @CCASDEPMODE@
133 CCASFLAGS = @CCASFLAGS@
134 CCDEPMODE = @CCDEPMODE@
137 CPPFLAGS = @CPPFLAGS@
140 CXXDEPMODE = @CXXDEPMODE@
141 CXXFLAGS = @CXXFLAGS@
142 CYGPATH_W = @CYGPATH_W@
143 DEFAULT_AUDIOSINK = @DEFAULT_AUDIOSINK@
144 DEFAULT_AUDIOSRC = @DEFAULT_AUDIOSRC@
145 DEFAULT_VIDEOSINK = @DEFAULT_VIDEOSINK@
146 DEFAULT_VIDEOSRC = @DEFAULT_VIDEOSRC@
147 DEFAULT_VISUALIZER = @DEFAULT_VISUALIZER@
150 DEPRECATED_CFLAGS = @DEPRECATED_CFLAGS@
151 DIRECTSOUND_CFLAGS = @DIRECTSOUND_CFLAGS@
152 DIRECTSOUND_LDFLAGS = @DIRECTSOUND_LDFLAGS@
153 DIRECTSOUND_LIBS = @DIRECTSOUND_LIBS@
155 DSYMUTIL = @DSYMUTIL@
157 DV1394_CFLAGS = @DV1394_CFLAGS@
158 DV1394_LIBS = @DV1394_LIBS@
163 ERROR_CFLAGS = @ERROR_CFLAGS@
164 ERROR_CXXFLAGS = @ERROR_CXXFLAGS@
165 ESD_CFLAGS = @ESD_CFLAGS@
166 ESD_CONFIG = @ESD_CONFIG@
167 ESD_LIBS = @ESD_LIBS@
171 FLAC_CFLAGS = @FLAC_CFLAGS@
172 FLAC_LIBS = @FLAC_LIBS@
173 GCONFTOOL = @GCONFTOOL@
174 GCONF_CFLAGS = @GCONF_CFLAGS@
175 GCONF_LIBS = @GCONF_LIBS@
176 GCONF_SCHEMA_CONFIG_SOURCE = @GCONF_SCHEMA_CONFIG_SOURCE@
177 GCONF_SCHEMA_FILE_DIR = @GCONF_SCHEMA_FILE_DIR@
179 GCOV_CFLAGS = @GCOV_CFLAGS@
180 GCOV_LIBS = @GCOV_LIBS@
181 GDK_PIXBUF_CFLAGS = @GDK_PIXBUF_CFLAGS@
182 GDK_PIXBUF_LIBS = @GDK_PIXBUF_LIBS@
183 GETTEXT_MACRO_VERSION = @GETTEXT_MACRO_VERSION@
184 GETTEXT_PACKAGE = @GETTEXT_PACKAGE@
185 GLIB_CFLAGS = @GLIB_CFLAGS@
186 GLIB_LIBS = @GLIB_LIBS@
187 GLIB_PREFIX = @GLIB_PREFIX@
188 GLIB_REQ = @GLIB_REQ@
190 GMSGFMT_015 = @GMSGFMT_015@
192 GSTPB_PLUGINS_DIR = @GSTPB_PLUGINS_DIR@
193 GSTPB_PREFIX = @GSTPB_PREFIX@
194 GST_ALL_LDFLAGS = @GST_ALL_LDFLAGS@
195 GST_BASE_CFLAGS = @GST_BASE_CFLAGS@
196 GST_BASE_LIBS = @GST_BASE_LIBS@
197 GST_CFLAGS = @GST_CFLAGS@
198 GST_CHECK_CFLAGS = @GST_CHECK_CFLAGS@
199 GST_CHECK_LIBS = @GST_CHECK_LIBS@
200 GST_CONTROLLER_CFLAGS = @GST_CONTROLLER_CFLAGS@
201 GST_CONTROLLER_LIBS = @GST_CONTROLLER_LIBS@
202 GST_CXXFLAGS = @GST_CXXFLAGS@
203 GST_GDP_CFLAGS = @GST_GDP_CFLAGS@
204 GST_GDP_LIBS = @GST_GDP_LIBS@
205 GST_LEVEL_DEFAULT = @GST_LEVEL_DEFAULT@
206 GST_LIBS = @GST_LIBS@
207 GST_LICENSE = @GST_LICENSE@
208 GST_LT_LDFLAGS = @GST_LT_LDFLAGS@
209 GST_MAJORMINOR = @GST_MAJORMINOR@
210 GST_OPTION_CFLAGS = @GST_OPTION_CFLAGS@
211 GST_OPTION_CXXFLAGS = @GST_OPTION_CXXFLAGS@
212 GST_PACKAGE_NAME = @GST_PACKAGE_NAME@
213 GST_PACKAGE_ORIGIN = @GST_PACKAGE_ORIGIN@
214 GST_PLUGINS_ALL = @GST_PLUGINS_ALL@
215 GST_PLUGINS_BASE_CFLAGS = @GST_PLUGINS_BASE_CFLAGS@
216 GST_PLUGINS_BASE_DIR = @GST_PLUGINS_BASE_DIR@
217 GST_PLUGINS_BASE_LIBS = @GST_PLUGINS_BASE_LIBS@
218 GST_PLUGINS_DIR = @GST_PLUGINS_DIR@
219 GST_PLUGINS_SELECTED = @GST_PLUGINS_SELECTED@
220 GST_PLUGIN_LDFLAGS = @GST_PLUGIN_LDFLAGS@
221 GST_PREFIX = @GST_PREFIX@
222 GST_TOOLS_DIR = @GST_TOOLS_DIR@
223 GTKDOC_CHECK = @GTKDOC_CHECK@
224 GTK_CFLAGS = @GTK_CFLAGS@
225 GTK_LIBS = @GTK_LIBS@
226 GTK_X11_CFLAGS = @GTK_X11_CFLAGS@
227 GTK_X11_LIBS = @GTK_X11_LIBS@
228 GUDEV_CFLAGS = @GUDEV_CFLAGS@
229 GUDEV_LIBS = @GUDEV_LIBS@
230 HAL_CFLAGS = @HAL_CFLAGS@
231 HAL_LIBS = @HAL_LIBS@
232 HAVE_AVC1394 = @HAVE_AVC1394@
233 HAVE_BZ2 = @HAVE_BZ2@
234 HAVE_CXX = @HAVE_CXX@
235 HAVE_DIRECTSOUND = @HAVE_DIRECTSOUND@
236 HAVE_GCONFTOOL = @HAVE_GCONFTOOL@
237 HAVE_ROM1394 = @HAVE_ROM1394@
238 HAVE_SPEEX = @HAVE_SPEEX@
240 HAVE_XSHM = @HAVE_XSHM@
241 HAVE_ZLIB = @HAVE_ZLIB@
242 HTML_DIR = @HTML_DIR@
244 INSTALL_DATA = @INSTALL_DATA@
245 INSTALL_PROGRAM = @INSTALL_PROGRAM@
246 INSTALL_SCRIPT = @INSTALL_SCRIPT@
247 INSTALL_STRIP_PROGRAM = @INSTALL_STRIP_PROGRAM@
248 INTLLIBS = @INTLLIBS@
249 INTL_MACOSX_LIBS = @INTL_MACOSX_LIBS@
250 JACK_0_120_1_CFLAGS = @JACK_0_120_1_CFLAGS@
251 JACK_0_120_1_LIBS = @JACK_0_120_1_LIBS@
252 JACK_1_9_7_CFLAGS = @JACK_1_9_7_CFLAGS@
253 JACK_1_9_7_LIBS = @JACK_1_9_7_LIBS@
254 JACK_CFLAGS = @JACK_CFLAGS@
255 JACK_LIBS = @JACK_LIBS@
256 JPEG_LIBS = @JPEG_LIBS@
259 LIBCACA_CFLAGS = @LIBCACA_CFLAGS@
260 LIBCACA_CONFIG = @LIBCACA_CONFIG@
261 LIBCACA_LIBS = @LIBCACA_LIBS@
262 LIBDV_CFLAGS = @LIBDV_CFLAGS@
263 LIBDV_LIBS = @LIBDV_LIBS@
264 LIBICONV = @LIBICONV@
265 LIBIEC61883_CFLAGS = @LIBIEC61883_CFLAGS@
266 LIBIEC61883_LIBS = @LIBIEC61883_LIBS@
270 LIBPNG_CFLAGS = @LIBPNG_CFLAGS@
271 LIBPNG_LIBS = @LIBPNG_LIBS@
274 LIBV4L2_CFLAGS = @LIBV4L2_CFLAGS@
275 LIBV4L2_LIBS = @LIBV4L2_LIBS@
278 LOCALEDIR = @LOCALEDIR@
279 LTLIBICONV = @LTLIBICONV@
280 LTLIBINTL = @LTLIBINTL@
281 LTLIBOBJS = @LTLIBOBJS@
283 MAKEINFO = @MAKEINFO@
286 MSGFMT_015 = @MSGFMT_015@
287 MSGMERGE = @MSGMERGE@
291 OBJCDEPMODE = @OBJCDEPMODE@
292 OBJC_LDFLAGS = @OBJC_LDFLAGS@
296 ORCC_FLAGS = @ORCC_FLAGS@
297 ORC_CFLAGS = @ORC_CFLAGS@
298 ORC_LIBS = @ORC_LIBS@
302 PACKAGE_BUGREPORT = @PACKAGE_BUGREPORT@
303 PACKAGE_NAME = @PACKAGE_NAME@
304 PACKAGE_STRING = @PACKAGE_STRING@
305 PACKAGE_TARNAME = @PACKAGE_TARNAME@
306 PACKAGE_URL = @PACKAGE_URL@
307 PACKAGE_VERSION = @PACKAGE_VERSION@
308 PACKAGE_VERSION_MAJOR = @PACKAGE_VERSION_MAJOR@
309 PACKAGE_VERSION_MICRO = @PACKAGE_VERSION_MICRO@
310 PACKAGE_VERSION_MINOR = @PACKAGE_VERSION_MINOR@
311 PACKAGE_VERSION_NANO = @PACKAGE_VERSION_NANO@
312 PACKAGE_VERSION_RELEASE = @PACKAGE_VERSION_RELEASE@
313 PATH_SEPARATOR = @PATH_SEPARATOR@
314 PKG_CONFIG = @PKG_CONFIG@
315 PLUGINDIR = @PLUGINDIR@
317 PROFILE_CFLAGS = @PROFILE_CFLAGS@
318 PULSE_0_9_11_CFLAGS = @PULSE_0_9_11_CFLAGS@
319 PULSE_0_9_11_LIBS = @PULSE_0_9_11_LIBS@
320 PULSE_0_9_12_CFLAGS = @PULSE_0_9_12_CFLAGS@
321 PULSE_0_9_12_LIBS = @PULSE_0_9_12_LIBS@
322 PULSE_0_9_13_CFLAGS = @PULSE_0_9_13_CFLAGS@
323 PULSE_0_9_13_LIBS = @PULSE_0_9_13_LIBS@
324 PULSE_0_9_15_CFLAGS = @PULSE_0_9_15_CFLAGS@
325 PULSE_0_9_15_LIBS = @PULSE_0_9_15_LIBS@
326 PULSE_0_9_16_CFLAGS = @PULSE_0_9_16_CFLAGS@
327 PULSE_0_9_16_LIBS = @PULSE_0_9_16_LIBS@
328 PULSE_0_9_20_CFLAGS = @PULSE_0_9_20_CFLAGS@
329 PULSE_0_9_20_LIBS = @PULSE_0_9_20_LIBS@
330 PULSE_CFLAGS = @PULSE_CFLAGS@
331 PULSE_LIBS = @PULSE_LIBS@
333 PYTHON_EXEC_PREFIX = @PYTHON_EXEC_PREFIX@
334 PYTHON_PLATFORM = @PYTHON_PLATFORM@
335 PYTHON_PREFIX = @PYTHON_PREFIX@
336 PYTHON_VERSION = @PYTHON_VERSION@
338 RAW1394_CFLAGS = @RAW1394_CFLAGS@
339 RAW1394_LIBS = @RAW1394_LIBS@
341 SET_MAKE = @SET_MAKE@
343 SHOUT2_CFLAGS = @SHOUT2_CFLAGS@
344 SHOUT2_LIBS = @SHOUT2_LIBS@
345 SOUP_CFLAGS = @SOUP_CFLAGS@
346 SOUP_LIBS = @SOUP_LIBS@
347 SPEEX_CFLAGS = @SPEEX_CFLAGS@
348 SPEEX_LIBS = @SPEEX_LIBS@
350 TAGLIB_CFLAGS = @TAGLIB_CFLAGS@
351 TAGLIB_CXXFLAGS = @TAGLIB_CXXFLAGS@
352 TAGLIB_LIBS = @TAGLIB_LIBS@
354 VALGRIND_CFLAGS = @VALGRIND_CFLAGS@
355 VALGRIND_LIBS = @VALGRIND_LIBS@
356 VALGRIND_PATH = @VALGRIND_PATH@
358 WARNING_CFLAGS = @WARNING_CFLAGS@
359 WARNING_CXXFLAGS = @WARNING_CXXFLAGS@
360 WAVPACK_CFLAGS = @WAVPACK_CFLAGS@
361 WAVPACK_LIBS = @WAVPACK_LIBS@
362 WIN32_LIBS = @WIN32_LIBS@
363 XDAMAGE_CFLAGS = @XDAMAGE_CFLAGS@
364 XDAMAGE_LIBS = @XDAMAGE_LIBS@
365 XFIXES_CFLAGS = @XFIXES_CFLAGS@
366 XFIXES_LIBS = @XFIXES_LIBS@
367 XGETTEXT = @XGETTEXT@
368 XGETTEXT_015 = @XGETTEXT_015@
369 XGETTEXT_EXTRA_OPTIONS = @XGETTEXT_EXTRA_OPTIONS@
371 XSHM_LIBS = @XSHM_LIBS@
372 XVIDEO_LIBS = @XVIDEO_LIBS@
373 X_CFLAGS = @X_CFLAGS@
374 X_EXTRA_LIBS = @X_EXTRA_LIBS@
376 X_PRE_LIBS = @X_PRE_LIBS@
377 ZLIB_LIBS = @ZLIB_LIBS@
378 abs_builddir = @abs_builddir@
379 abs_srcdir = @abs_srcdir@
380 abs_top_builddir = @abs_top_builddir@
381 abs_top_srcdir = @abs_top_srcdir@
382 ac_ct_CC = @ac_ct_CC@
383 ac_ct_CXX = @ac_ct_CXX@
384 ac_ct_DUMPBIN = @ac_ct_DUMPBIN@
385 ac_ct_OBJC = @ac_ct_OBJC@
386 am__include = @am__include@
387 am__leading_dot = @am__leading_dot@
388 am__quote = @am__quote@
390 am__untar = @am__untar@
393 build_alias = @build_alias@
394 build_cpu = @build_cpu@
395 build_os = @build_os@
396 build_vendor = @build_vendor@
397 builddir = @builddir@
399 datarootdir = @datarootdir@
402 exec_prefix = @exec_prefix@
404 host_alias = @host_alias@
405 host_cpu = @host_cpu@
407 host_vendor = @host_vendor@
409 includedir = @includedir@
411 install_sh = @install_sh@
413 libexecdir = @libexecdir@
414 localedir = @localedir@
415 localstatedir = @localstatedir@
419 oldincludedir = @oldincludedir@
421 pkgpyexecdir = @pkgpyexecdir@
422 pkgpythondir = @pkgpythondir@
423 plugindir = @plugindir@
425 program_transform_name = @program_transform_name@
427 pyexecdir = @pyexecdir@
428 pythondir = @pythondir@
430 sharedstatedir = @sharedstatedir@
432 sysconfdir = @sysconfdir@
433 target_alias = @target_alias@
434 top_build_prefix = @top_build_prefix@
435 top_builddir = @top_builddir@
436 top_srcdir = @top_srcdir@
437 GST_DOC_SCANOBJ = $(top_srcdir)/common/gstdoc-scangobj
439 # The name of the module, e.g. 'glib'.
440 #DOC_MODULE=gst-plugins-libs-@GST_MAJORMINOR@
441 MODULE = gst-plugins-good
442 DOC_MODULE = $(MODULE)-plugins
445 DOC = $(MODULE)-plugins
448 # these variables define the location of the online docs
449 DOC_SERVER = gstreamer.freedesktop.org
450 DOC_BASE = /srv/gstreamer.freedesktop.org/www/data/doc
451 DOC_URL = $(DOC_SERVER):$(DOC_BASE)
453 # generated basefiles
455 # $(DOC_MODULE)-sections.txt \
456 # $(DOC_MODULE)-docs.sgml
458 # ugly hack to make -unused.sgml work
460 # BUILDDIR=`pwd` && \
461 # cd $(srcdir)/tmpl && \
462 # ln -sf gstreamer-libs-unused.sgml \
463 # $$BUILDDIR/tmpl/gstreamer-libs-@GST_MAJORMINOR@-unused.sgml
464 # touch unused-build.stamp
466 # these rules are added to create parallel docs using GST_MAJORMINOR
467 #$(basefiles): gstreamer-libs-@GST_MAJORMINOR@%: gstreamer-libs%
470 #CLEANFILES = $(basefiles)
472 # The top-level SGML file. Change it if you want.
473 DOC_MAIN_SGML_FILE = $(DOC_MODULE)-docs.sgml
475 # The directory containing the source code. Relative to $(top_srcdir).
476 # gtk-doc will search all .c & .h files beneath here for inline comments
477 # documenting functions and macros.
478 DOC_SOURCE_DIR = $(top_srcdir)
480 # Extra options to supply to gtkdoc-scan.
483 # Extra options to supply to gtkdoc-mkdb.
484 MKDB_OPTIONS = --sgml-mode --source-suffixes=c,h,cc
486 # Extra options to supply to gtkdoc-fixref.
487 FIXXREF_OPTIONS = --extra-dir=$(GLIB_PREFIX)/share/gtk-doc/html \
488 --extra-dir=$(GST_PREFIX)/share/gtk-doc/html \
489 --extra-dir=$(GSTPB_PREFIX)/share/gtk-doc/html
492 # Used for dependencies.
493 HFILE_GLOB = $(DOC_SOURCE_DIR)/*/*/*.h
494 CFILE_GLOB = $(DOC_SOURCE_DIR)/*/*/*.c $(DOC_SOURCE_DIR)/*/*/*.cc $(DOC_SOURCE_DIR)/*/*/*.m
496 # this is a wingo addition
497 # thomasvs: another nice wingo addition would be an explanation on why
501 # Header files to ignore when scanning.
505 # we add all .h files of elements that have signals/args we want
506 # sadly this also pulls in the private methods - maybe we should
507 # move those around in the source ?
508 # also, we should add some stuff here conditionally based on whether
509 # or not the plugin will actually build
510 # but I'm not sure about that - it might be this Just Works given that
511 # the registry won't have the element
513 $(top_srcdir)/ext/aalib/gstaasink.h \
514 $(top_srcdir)/ext/annodex/gstcmmldec.h \
515 $(top_srcdir)/ext/annodex/gstcmmlenc.h \
516 $(top_srcdir)/ext/cairo/gsttextoverlay.h \
517 $(top_srcdir)/ext/cairo/gsttimeoverlay.h \
518 $(top_srcdir)/ext/cairo/gstcairorender.h \
519 $(top_srcdir)/ext/cairo/gstcairooverlay.h \
520 $(top_srcdir)/ext/dv/gstdvdec.h \
521 $(top_srcdir)/ext/dv/gstdvdemux.h \
522 $(top_srcdir)/ext/esd/esdsink.h \
523 $(top_srcdir)/ext/flac/gstflacdec.h \
524 $(top_srcdir)/ext/flac/gstflacenc.h \
525 $(top_srcdir)/ext/flac/gstflactag.h \
526 $(top_srcdir)/ext/gconf/gstgconfaudiosrc.h \
527 $(top_srcdir)/ext/gconf/gstgconfaudiosink.h \
528 $(top_srcdir)/ext/gconf/gstgconfvideosrc.h \
529 $(top_srcdir)/ext/gconf/gstgconfvideosink.h \
530 $(top_srcdir)/ext/gdk_pixbuf/gstgdkpixbufsink.h \
531 $(top_srcdir)/ext/hal/gsthalaudiosink.h \
532 $(top_srcdir)/ext/hal/gsthalaudiosrc.h \
533 $(top_srcdir)/ext/jack/gstjackaudiosrc.h \
534 $(top_srcdir)/ext/jack/gstjackaudiosink.h \
535 $(top_srcdir)/ext/jpeg/gstjpegdec.h \
536 $(top_srcdir)/ext/jpeg/gstjpegenc.h \
537 $(top_srcdir)/ext/jpeg/gstsmokedec.h \
538 $(top_srcdir)/ext/jpeg/gstsmokeenc.h \
539 $(top_srcdir)/ext/libcaca/gstcacasink.h \
540 $(top_srcdir)/ext/libpng/gstpngdec.h \
541 $(top_srcdir)/ext/libpng/gstpngenc.h \
542 $(top_srcdir)/ext/raw1394/gstdv1394src.h \
543 $(top_srcdir)/ext/raw1394/gsthdv1394src.h \
544 $(top_srcdir)/ext/soup/gstsouphttpsrc.h \
545 $(top_srcdir)/ext/taglib/gstapev2mux.h \
546 $(top_srcdir)/ext/taglib/gstid3v2mux.h \
547 $(top_srcdir)/ext/pulse/pulsesink.h \
548 $(top_srcdir)/ext/pulse/pulsesrc.h \
549 $(top_srcdir)/ext/pulse/pulsemixer.h \
550 $(top_srcdir)/ext/speex/gstspeexenc.h \
551 $(top_srcdir)/ext/speex/gstspeexdec.h \
552 $(top_srcdir)/ext/wavpack/gstwavpackdec.h \
553 $(top_srcdir)/ext/wavpack/gstwavpackenc.h \
554 $(top_srcdir)/ext/wavpack/gstwavpackparse.h \
555 $(top_srcdir)/gst/alpha/gstalpha.h \
556 $(top_srcdir)/gst/alpha/gstalphacolor.h \
557 $(top_srcdir)/gst/apetag/gstapedemux.h \
558 $(top_srcdir)/gst/audiofx/audioamplify.h \
559 $(top_srcdir)/gst/audiofx/audioecho.h \
560 $(top_srcdir)/gst/audiofx/audiodynamic.h \
561 $(top_srcdir)/gst/audiofx/audioinvert.h \
562 $(top_srcdir)/gst/audiofx/audiokaraoke.h \
563 $(top_srcdir)/gst/audiofx/audiopanorama.h \
564 $(top_srcdir)/gst/audiofx/audiocheblimit.h \
565 $(top_srcdir)/gst/audiofx/audiochebband.h \
566 $(top_srcdir)/gst/audiofx/audioiirfilter.h \
567 $(top_srcdir)/gst/audiofx/audiowsincband.h \
568 $(top_srcdir)/gst/audiofx/audiowsinclimit.h \
569 $(top_srcdir)/gst/audiofx/audiofirfilter.h \
570 $(top_srcdir)/gst/audioparsers/gstaacparse.h \
571 $(top_srcdir)/gst/audioparsers/gstac3parse.h \
572 $(top_srcdir)/gst/audioparsers/gstamrparse.h \
573 $(top_srcdir)/gst/audioparsers/gstflacparse.h \
574 $(top_srcdir)/gst/audioparsers/gstdcaparse.h \
575 $(top_srcdir)/gst/audioparsers/gstmpegaudioparse.h \
576 $(top_srcdir)/gst/auparse/gstauparse.h \
577 $(top_srcdir)/gst/autodetect/gstautoaudiosink.h \
578 $(top_srcdir)/gst/autodetect/gstautoaudiosrc.h \
579 $(top_srcdir)/gst/autodetect/gstautovideosink.h \
580 $(top_srcdir)/gst/autodetect/gstautovideosrc.h \
581 $(top_srcdir)/gst/avi/gstavidemux.h \
582 $(top_srcdir)/gst/avi/gstavimux.h \
583 $(top_srcdir)/gst/avi/gstavisubtitle.h \
584 $(top_srcdir)/gst/cutter/gstcutter.h \
585 $(top_srcdir)/gst/debugutils/gstcapssetter.h \
586 $(top_srcdir)/gst/debugutils/gsttaginject.h \
587 $(top_srcdir)/gst/debugutils/progressreport.h \
588 $(top_srcdir)/gst/deinterlace/gstdeinterlace.h \
589 $(top_srcdir)/gst/effectv/gstaging.h \
590 $(top_srcdir)/gst/effectv/gstdice.h \
591 $(top_srcdir)/gst/effectv/gstedge.h \
592 $(top_srcdir)/gst/effectv/gstquark.h \
593 $(top_srcdir)/gst/effectv/gstrev.h \
594 $(top_srcdir)/gst/effectv/gstshagadelic.h \
595 $(top_srcdir)/gst/effectv/gstvertigo.h \
596 $(top_srcdir)/gst/effectv/gstwarp.h \
597 $(top_srcdir)/gst/effectv/gststreak.h \
598 $(top_srcdir)/gst/effectv/gstripple.h \
599 $(top_srcdir)/gst/effectv/gstop.h \
600 $(top_srcdir)/gst/effectv/gstradioac.h \
601 $(top_srcdir)/gst/equalizer/gstiirequalizer.h \
602 $(top_srcdir)/gst/equalizer/gstiirequalizer3bands.h \
603 $(top_srcdir)/gst/equalizer/gstiirequalizer10bands.h \
604 $(top_srcdir)/gst/equalizer/gstiirequalizernbands.h \
605 $(top_srcdir)/gst/flv/gstflvdemux.h \
606 $(top_srcdir)/gst/flv/gstflvmux.h \
607 $(top_srcdir)/gst/flx/gstflxdec.h \
608 $(top_srcdir)/gst/goom/gstgoom.h \
609 $(top_srcdir)/gst/goom2k1/gstgoom.h \
610 $(top_srcdir)/gst/law/alaw-decode.h \
611 $(top_srcdir)/gst/law/alaw-encode.h \
612 $(top_srcdir)/gst/law/mulaw-decode.h \
613 $(top_srcdir)/gst/law/mulaw-encode.h \
614 $(top_srcdir)/gst/icydemux/gsticydemux.h \
615 $(top_srcdir)/gst/id3demux/gstid3demux.h \
616 $(top_srcdir)/gst/imagefreeze/gstimagefreeze.h \
617 $(top_srcdir)/gst/interleave/deinterleave.h \
618 $(top_srcdir)/gst/interleave/interleave.h \
619 $(top_srcdir)/gst/level/gstlevel.h \
620 $(top_srcdir)/gst/matroska/matroska-demux.h \
621 $(top_srcdir)/gst/matroska/matroska-mux.h \
622 $(top_srcdir)/gst/matroska/webm-mux.h \
623 $(top_srcdir)/gst/monoscope/gstmonoscope.h \
624 $(top_srcdir)/gst/multifile/gstmultifilesink.h \
625 $(top_srcdir)/gst/multifile/gstmultifilesrc.h \
626 $(top_srcdir)/gst/multipart/multipartdemux.h \
627 $(top_srcdir)/gst/multipart/multipartmux.h \
628 $(top_srcdir)/gst/isomp4/qtdemux.h \
629 $(top_srcdir)/gst/isomp4/gstqtmux.h \
630 $(top_srcdir)/gst/isomp4/gstqtmux-doc.h \
631 $(top_srcdir)/gst/replaygain/gstrganalysis.h \
632 $(top_srcdir)/gst/replaygain/gstrglimiter.h \
633 $(top_srcdir)/gst/replaygain/gstrgvolume.h \
634 $(top_srcdir)/gst/rtp/gstrtpj2kpay.h \
635 $(top_srcdir)/gst/rtp/gstrtpjpegpay.h \
636 $(top_srcdir)/gst/rtpmanager/gstrtpbin.h \
637 $(top_srcdir)/gst/rtpmanager/gstrtpjitterbuffer.h \
638 $(top_srcdir)/gst/rtpmanager/gstrtpptdemux.h \
639 $(top_srcdir)/gst/rtpmanager/gstrtpsession.h \
640 $(top_srcdir)/gst/rtpmanager/gstrtpssrcdemux.h \
641 $(top_srcdir)/gst/rtsp/gstrtpdec.h \
642 $(top_srcdir)/gst/rtsp/gstrtspsrc.h \
643 $(top_srcdir)/gst/shapewipe/gstshapewipe.h \
644 $(top_srcdir)/gst/smpte/gstsmpte.h \
645 $(top_srcdir)/gst/smpte/gstsmptealpha.h \
646 $(top_srcdir)/gst/spectrum/gstspectrum.h \
647 $(top_srcdir)/gst/udp/gstmultiudpsink.h \
648 $(top_srcdir)/gst/udp/gstudpsrc.h \
649 $(top_srcdir)/gst/udp/gstudpsink.h \
650 $(top_srcdir)/gst/videobox/gstvideobox.h \
651 $(top_srcdir)/gst/videocrop/gstvideocrop.h \
652 $(top_srcdir)/gst/videocrop/gstaspectratiocrop.h \
653 $(top_srcdir)/gst/videofilter/gstgamma.h \
654 $(top_srcdir)/gst/videofilter/gstvideobalance.h \
655 $(top_srcdir)/gst/videofilter/gstvideoflip.h \
656 $(top_srcdir)/gst/videomixer/videomixer.h \
657 $(top_srcdir)/gst/videomixer/videomixerpad.h \
658 $(top_srcdir)/gst/videomixer/videomixer2.h \
659 $(top_srcdir)/gst/videomixer/videomixer2pad.h \
660 $(top_srcdir)/gst/wavenc/gstwavenc.h \
661 $(top_srcdir)/gst/wavparse/gstwavparse.h \
662 $(top_srcdir)/gst/y4m/gsty4mencode.h \
663 $(top_srcdir)/sys/directsound/gstdirectsoundsink.h \
664 $(top_srcdir)/sys/oss4/oss4-mixer.h \
665 $(top_srcdir)/sys/oss4/oss4-sink.h \
666 $(top_srcdir)/sys/oss4/oss4-source.h \
667 $(top_srcdir)/sys/oss/gstossmixerelement.h \
668 $(top_srcdir)/sys/oss/gstosssink.h \
669 $(top_srcdir)/sys/oss/gstosssrc.h \
670 $(top_srcdir)/sys/osxaudio/gstosxaudiosrc.h \
671 $(top_srcdir)/sys/osxaudio/gstosxaudiosink.h \
672 $(top_srcdir)/sys/osxvideo/osxvideosink.h \
673 $(top_srcdir)/sys/v4l2/gstv4l2src.h \
674 $(top_srcdir)/sys/v4l2/gstv4l2sink.h \
675 $(top_srcdir)/sys/v4l2/gstv4l2radio.h \
676 $(top_srcdir)/sys/waveform/gstwaveformsink.h \
677 $(top_srcdir)/sys/ximage/gstximagesrc.h
680 # example code that needs to be converted to xml and placed in xml/
682 $(top_srcdir)/tests/examples/level/level-example.c \
683 $(top_srcdir)/tests/examples/spectrum/spectrum-example.c \
684 $(top_srcdir)/tests/examples/audiofx/firfilter-example.c \
685 $(top_srcdir)/tests/examples/audiofx/iirfilter-example.c
688 # Images to copy into HTML directory.
691 # Extra SGML files that are included by $(DOC_MAIN_SGML_FILE).
694 # Other files to distribute.
697 # CFLAGS and LDFLAGS for compiling scan program. Only needed if your app/lib
698 # contains GtkObjects/GObjects and you want to document signals and properties.
699 GTKDOC_CFLAGS = $(GST_BASE_CFLAGS) -I$(top_builddir)
700 GTKDOC_LIBS = $(SCANOBJ_DEPS) $(GST_BASE_LIBS)
701 GTKDOC_CC = $(LIBTOOL) --tag=CC --mode=compile $(CC)
702 GTKDOC_LD = $(LIBTOOL) --tag=CC --mode=link $(CC)
704 # If you need to override some of the declarations, place them in this file
705 # and uncomment this line.
706 #DOC_OVERRIDES = $(DOC_MODULE)-overrides.txt
709 # We set GPATH here; this gives us semantics for GNU make
710 # which are more like other make's VPATH, when it comes to
711 # whether a source that is a target of one rule is then
712 # searched for in VPATH/GPATH.
716 # thomas: make docs parallel installable
717 TARGET_DIR = $(HTML_DIR)/$(DOC_MODULE)-@GST_MAJORMINOR@
718 MAINTAINER_DOC_STAMPS = \
722 $(MAINTAINER_DOC_STAMPS) \
723 $(srcdir)/inspect/*.xml \
728 $(DOC_MAIN_SGML_FILE) \
730 $(DOC_MODULE)-sections.txt
733 # we don't add scanobj-build.stamp here since they are built manually by docs
734 # maintainers and result is commited to git
746 # files generated/updated by gtkdoc-scangobj
748 $(DOC_MODULE).signals \
749 $(DOC_MODULE).hierarchy \
750 $(DOC_MODULE).interfaces \
751 $(DOC_MODULE).prerequisites \
752 $(DOC_MODULE).types \
756 .libs/$(DOC_MODULE)-scan.o
759 # files generated/updated by gtkdoc-scan
761 $(DOC_MODULE)-sections.txt \
762 $(DOC_MODULE)-overrides.txt \
763 $(DOC_MODULE)-decl.txt \
764 $(DOC_MODULE)-decl-list.txt
767 $(DOC_MODULE)-undocumented.txt \
768 $(DOC_MODULE)-undeclared.txt \
769 $(DOC_MODULE)-unused.txt
772 # FC3 seems to need -scan.c to be part of CLEANFILES for distcheck
773 # no idea why FC4 can do without
776 $(DOC_MODULE)-scan.c \
781 INSPECT_DIR = inspect
783 ### inspect GStreamer plug-ins; done by documentation maintainer ###
785 # only look at the plugins in this module when building inspect .xml stuff
786 @ENABLE_GTK_DOC_TRUE@INSPECT_REGISTRY = $(top_builddir)/docs/plugins/inspect-registry.xml
787 @ENABLE_GTK_DOC_TRUE@INSPECT_ENVIRONMENT = \
788 @ENABLE_GTK_DOC_TRUE@ LC_ALL=C \
789 @ENABLE_GTK_DOC_TRUE@ GST_PLUGIN_SYSTEM_PATH= \
790 @ENABLE_GTK_DOC_TRUE@ GST_PLUGIN_PATH=$(top_builddir)/gst:$(top_builddir)/sys:$(top_builddir)/ext:$(top_builddir)/plugins:$(top_builddir)/src:$(top_builddir)/gnl \
791 @ENABLE_GTK_DOC_TRUE@ GST_REGISTRY=$(INSPECT_REGISTRY) \
792 @ENABLE_GTK_DOC_TRUE@ PKG_CONFIG_PATH="$(GST_PKG_CONFIG_PATH)" \
793 @ENABLE_GTK_DOC_TRUE@ $(INSPECT_EXTRA_ENVIRONMENT)
795 MAINTAINERCLEANFILES = $(MAINTAINER_DOC_STAMPS)
797 # wildcard is apparently not portable to other makes, hence the use of find
798 inspect_files = $(shell find $(srcdir)/$(INSPECT_DIR) -name '*.xml')
802 $(srcdir)/Makefile.in: @MAINTAINER_MODE_TRUE@ $(srcdir)/Makefile.am $(top_srcdir)/common/upload-doc.mak $(top_srcdir)/common/gtk-doc-plugins.mak $(am__configure_deps)
804 case '$(am__configure_deps)' in \
806 ( cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh ) \
807 && { if test -f $@; then exit 0; else break; fi; }; \
811 echo ' cd $(top_srcdir) && $(AUTOMAKE) --gnu docs/plugins/Makefile'; \
812 $(am__cd) $(top_srcdir) && \
813 $(AUTOMAKE) --gnu docs/plugins/Makefile
815 Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status
818 cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh;; \
820 echo ' cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe)'; \
821 cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe);; \
824 $(top_builddir)/config.status: $(top_srcdir)/configure $(CONFIG_STATUS_DEPENDENCIES)
825 cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh
827 $(top_srcdir)/configure: @MAINTAINER_MODE_TRUE@ $(am__configure_deps)
828 cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh
829 $(ACLOCAL_M4): @MAINTAINER_MODE_TRUE@ $(am__aclocal_m4_deps)
830 cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh
831 $(am__aclocal_m4_deps):
845 distdir: $(DISTFILES)
846 @srcdirstrip=`echo "$(srcdir)" | sed 's/[].[^$$\\*]/\\\\&/g'`; \
847 topsrcdirstrip=`echo "$(top_srcdir)" | sed 's/[].[^$$\\*]/\\\\&/g'`; \
848 list='$(DISTFILES)'; \
849 dist_files=`for file in $$list; do echo $$file; done | \
850 sed -e "s|^$$srcdirstrip/||;t" \
851 -e "s|^$$topsrcdirstrip/|$(top_builddir)/|;t"`; \
852 case $$dist_files in \
853 */*) $(MKDIR_P) `echo "$$dist_files" | \
854 sed '/\//!d;s|^|$(distdir)/|;s,/[^/]*$$,,' | \
857 for file in $$dist_files; do \
858 if test -f $$file || test -d $$file; then d=.; else d=$(srcdir); fi; \
859 if test -d $$d/$$file; then \
860 dir=`echo "/$$file" | sed -e 's,/[^/]*$$,,'`; \
861 if test -d "$(distdir)/$$file"; then \
862 find "$(distdir)/$$file" -type d ! -perm -700 -exec chmod u+rwx {} \;; \
864 if test -d $(srcdir)/$$file && test $$d != $(srcdir); then \
865 cp -fpR $(srcdir)/$$file "$(distdir)$$dir" || exit 1; \
866 find "$(distdir)/$$file" -type d ! -perm -700 -exec chmod u+rwx {} \;; \
868 cp -fpR $$d/$$file "$(distdir)$$dir" || exit 1; \
870 test -f "$(distdir)/$$file" \
871 || cp -p $$d/$$file "$(distdir)/$$file" \
875 $(MAKE) $(AM_MAKEFLAGS) \
876 top_distdir="$(top_distdir)" distdir="$(distdir)" \
880 all-am: Makefile all-local
883 install-exec: install-exec-am
884 install-data: install-data-am
885 uninstall: uninstall-am
888 @$(MAKE) $(AM_MAKEFLAGS) install-exec-am install-data-am
890 installcheck: installcheck-am
892 $(MAKE) $(AM_MAKEFLAGS) INSTALL_PROGRAM="$(INSTALL_STRIP_PROGRAM)" \
893 install_sh_PROGRAM="$(INSTALL_STRIP_PROGRAM)" INSTALL_STRIP_FLAG=-s \
894 `test -z '$(STRIP)' || \
895 echo "INSTALL_PROGRAM_ENV=STRIPPROG='$(STRIP)'"` install
899 -test -z "$(CLEANFILES)" || rm -f $(CLEANFILES)
902 -test -z "$(CONFIG_CLEAN_FILES)" || rm -f $(CONFIG_CLEAN_FILES)
903 -test . = "$(srcdir)" || test -z "$(CONFIG_CLEAN_VPATH_FILES)" || rm -f $(CONFIG_CLEAN_VPATH_FILES)
905 maintainer-clean-generic:
906 @echo "This command is intended for maintainers to use"
907 @echo "it deletes files that may require special tools to rebuild."
908 -test -z "$(MAINTAINERCLEANFILES)" || rm -f $(MAINTAINERCLEANFILES)
911 clean-am: clean-generic clean-libtool clean-local mostlyclean-am
913 distclean: distclean-am
915 distclean-am: clean-am distclean-generic distclean-local
927 install-data-am: install-data-local
929 install-dvi: install-dvi-am
935 install-html: install-html-am
939 install-info: install-info-am
945 install-pdf: install-pdf-am
949 install-ps: install-ps-am
955 maintainer-clean: maintainer-clean-am
957 maintainer-clean-am: distclean-am maintainer-clean-generic
959 mostlyclean: mostlyclean-am
961 mostlyclean-am: mostlyclean-generic mostlyclean-libtool
971 uninstall-am: uninstall-local
973 .MAKE: install-am install-strip
975 .PHONY: all all-am all-local check check-am clean clean-generic \
976 clean-libtool clean-local dist-hook distclean \
977 distclean-generic distclean-libtool distclean-local distdir \
978 dvi dvi-am html html-am info info-am install install-am \
979 install-data install-data-am install-data-local install-dvi \
980 install-dvi-am install-exec install-exec-am install-html \
981 install-html-am install-info install-info-am install-man \
982 install-pdf install-pdf-am install-ps install-ps-am \
983 install-strip installcheck installcheck-am installdirs \
984 maintainer-clean maintainer-clean-generic mostlyclean \
985 mostlyclean-generic mostlyclean-libtool pdf pdf-am ps ps-am \
986 uninstall uninstall-am uninstall-local
988 html: html-build.stamp
991 @if echo $(FORMATS) | grep html > /dev/null; then \
992 echo "Preparing docs for upload (rebasing cross-references) ..." ; \
993 if test x$(builddir) != x$(srcdir); then \
994 echo "make upload can only be used if srcdir == builddir"; \
997 # gtkdoc-rebase sometimes gets confused, so reset everything to \
998 # local links before rebasing to online links \
999 gtkdoc-rebase --html-dir=$(builddir)/html 2>/dev/null 2>/dev/null ; \
1000 rebase=`gtkdoc-rebase --verbose --online --html-dir=$(builddir)/html` ; \
1001 echo "$$rebase" | grep -e "On-*line"; \
1002 for req in glib gobject gstreamer gstreamer-libs gst-plugins-base-libs; do \
1003 if ! ( echo "$$rebase" | grep -i -e "On-*line.*/$$req/" ); then \
1004 echo "===============================================================================" ; \
1005 echo " Could not determine online location for $$req docs. Cross-referencing will be " ; \
1006 echo " broken, so not uploading. Make sure the library's gtk-doc documentation is " ; \
1007 echo " installed somewhere in /usr/share/gtk-doc. " ; \
1008 echo "===============================================================================" ; \
1012 export SRC="$$SRC html"; \
1014 if echo $(FORMATS) | grep ps > /dev/null; then export SRC="$$SRC $(DOC).ps"; fi; \
1015 if echo $(FORMATS) | grep pdf > /dev/null; then export SRC="$$SRC $(DOC).pdf"; fi; \
1017 # upload releases to both 0.10.X/ and head/ subdirectories \
1018 if test "x$(PACKAGE_VERSION_NANO)" = x0; then \
1019 export DIR=$(DOC_BASE)/gstreamer/$(VERSION)/$(DOC); \
1020 echo Uploading $$SRC to $(DOC_SERVER):$$DIR; \
1021 ssh $(DOC_SERVER) mkdir -p $$DIR; \
1022 rsync -rv -e ssh --delete $$SRC $(DOC_SERVER):$$DIR; \
1023 ssh $(DOC_SERVER) chmod -R g+w $$DIR; \
1026 export DIR=$(DOC_BASE)/gstreamer/head/$(DOC); \
1027 echo Uploading $$SRC to $(DOC_SERVER):$$DIR; \
1028 ssh $(DOC_SERVER) mkdir -p $$DIR; \
1029 rsync -rv -e ssh --delete $$SRC $(DOC_SERVER):$$DIR; \
1030 ssh $(DOC_SERVER) chmod -R g+w $$DIR; \
1032 if echo $(FORMATS) | grep html > /dev/null; then \
1033 echo "Un-preparing docs for upload (rebasing cross-references) ..." ; \
1034 gtkdoc-rebase --html-dir=$(builddir)/html ; \
1040 @echo "If you are a doc maintainer, run 'make update' to update"
1041 @echo "the documentation files maintained in git"
1043 @echo Other useful make targets:
1045 @echo check-inspected-versions: make sure the inspected plugin info
1046 @echo is up to date before a release
1049 # update the stuff maintained by doc maintainers
1051 $(MAKE) scanobj-update
1052 $(MAKE) check-outdated-docs
1054 @ENABLE_GTK_DOC_TRUE@all-local: html-build.stamp
1056 # update the element and plugin XML descriptions; store in inspect/
1057 @ENABLE_GTK_DOC_TRUE@inspect:
1058 @ENABLE_GTK_DOC_TRUE@ @-mkdir -p $(INSPECT_DIR)
1060 #### scan gobjects; done by documentation maintainer ####
1061 @ENABLE_GTK_DOC_TRUE@scanobj-update:
1062 @ENABLE_GTK_DOC_TRUE@ -rm scanobj-build.stamp
1063 @ENABLE_GTK_DOC_TRUE@ $(MAKE) scanobj-build.stamp
1065 # TODO: finish elite script that updates the output files of this step
1066 # instead of rewriting them, so that multiple maintainers can generate
1067 # a collective set of args and signals
1068 @ENABLE_GTK_DOC_TRUE@scanobj-build.stamp: $(SCANOBJ_DEPS) $(basefiles) inspect
1069 @ENABLE_GTK_DOC_TRUE@ @echo '*** Scanning GObjects ***'
1070 @ENABLE_GTK_DOC_TRUE@ @if test x"$(srcdir)" != x. ; then \
1071 @ENABLE_GTK_DOC_TRUE@ for f in $(SCANOBJ_FILES) $(SCAN_FILES); \
1072 @ENABLE_GTK_DOC_TRUE@ do \
1073 @ENABLE_GTK_DOC_TRUE@ if test -e $(srcdir)/$$f; then cp -u $(srcdir)/$$f . ; fi; \
1074 @ENABLE_GTK_DOC_TRUE@ done; \
1075 @ENABLE_GTK_DOC_TRUE@ fi; \
1076 @ENABLE_GTK_DOC_TRUE@ $(INSPECT_ENVIRONMENT) \
1077 @ENABLE_GTK_DOC_TRUE@ CC="$(GTKDOC_CC)" LD="$(GTKDOC_LD)" \
1078 @ENABLE_GTK_DOC_TRUE@ CFLAGS="$(GTKDOC_CFLAGS) $(CFLAGS) $(WARNING_CFLAGS)" \
1079 @ENABLE_GTK_DOC_TRUE@ LDFLAGS="$(GTKDOC_LIBS) $(LDFLAGS)" \
1080 @ENABLE_GTK_DOC_TRUE@ $(GST_DOC_SCANOBJ) --type-init-func="gst_init(NULL,NULL)" \
1081 @ENABLE_GTK_DOC_TRUE@ --module=$(DOC_MODULE) --source=$(PACKAGE) --inspect-dir=$(INSPECT_DIR) && \
1082 @ENABLE_GTK_DOC_TRUE@ $(PYTHON) \
1083 @ENABLE_GTK_DOC_TRUE@ $(top_srcdir)/common/scangobj-merge.py $(DOC_MODULE); \
1084 @ENABLE_GTK_DOC_TRUE@ if test x"$(srcdir)" != x. ; then \
1085 @ENABLE_GTK_DOC_TRUE@ for f in $(SCANOBJ_FILES); \
1086 @ENABLE_GTK_DOC_TRUE@ do \
1087 @ENABLE_GTK_DOC_TRUE@ cmp -s ./$$f $(srcdir)/$$f || cp ./$$f $(srcdir)/ ; \
1088 @ENABLE_GTK_DOC_TRUE@ done; \
1089 @ENABLE_GTK_DOC_TRUE@ fi; \
1090 @ENABLE_GTK_DOC_TRUE@ touch scanobj-build.stamp
1092 @ENABLE_GTK_DOC_TRUE@$(DOC_MODULE)-decl.txt $(SCANOBJ_FILES) $(SCANOBJ_FILES_O): scan-build.stamp
1093 @ENABLE_GTK_DOC_TRUE@ @true
1095 ### scan headers; done on every build ###
1096 @ENABLE_GTK_DOC_TRUE@scan-build.stamp: $(HFILE_GLOB) $(EXTRA_HFILES) $(basefiles) scanobj-build.stamp
1097 @ENABLE_GTK_DOC_TRUE@ @echo '*** Scanning header files ***'
1098 @ENABLE_GTK_DOC_TRUE@ gtkdoc-scan \
1099 @ENABLE_GTK_DOC_TRUE@ $(SCAN_OPTIONS) $(EXTRA_HFILES) \
1100 @ENABLE_GTK_DOC_TRUE@ --module=$(DOC_MODULE) \
1101 @ENABLE_GTK_DOC_TRUE@ --source-dir=$(DOC_SOURCE_DIR) \
1102 @ENABLE_GTK_DOC_TRUE@ --ignore-headers="$(IGNORE_HFILES)"; \
1103 @ENABLE_GTK_DOC_TRUE@ touch scan-build.stamp
1105 #### update templates; done on every build ####
1107 ### FIXME: make this error out again when docs are fixed for 0.X
1108 # in a non-srcdir build, we need to copy files from the previous step
1109 # and the files from previous runs of this step
1110 @ENABLE_GTK_DOC_TRUE@tmpl-build.stamp: $(DOC_MODULE)-decl.txt $(SCANOBJ_FILES) $(DOC_MODULE)-sections.txt $(DOC_OVERRIDES)
1111 @ENABLE_GTK_DOC_TRUE@ @echo '*** Rebuilding template files ***'
1112 @ENABLE_GTK_DOC_TRUE@ @if test x"$(srcdir)" != x. ; then \
1113 @ENABLE_GTK_DOC_TRUE@ for f in $(SCANOBJ_FILES) $(SCAN_FILES); \
1114 @ENABLE_GTK_DOC_TRUE@ do \
1115 @ENABLE_GTK_DOC_TRUE@ if test -e $(srcdir)/$$f; then cp -u $(srcdir)/$$f . ; fi; \
1116 @ENABLE_GTK_DOC_TRUE@ done; \
1117 @ENABLE_GTK_DOC_TRUE@ fi
1118 @ENABLE_GTK_DOC_TRUE@ gtkdoc-mktmpl --module=$(DOC_MODULE) | tee tmpl-build.log
1119 @ENABLE_GTK_DOC_TRUE@ $(PYTHON) \
1120 @ENABLE_GTK_DOC_TRUE@ $(top_srcdir)/common/mangle-tmpl.py $(srcdir)/$(INSPECT_DIR) tmpl
1121 @ENABLE_GTK_DOC_TRUE@ @rm -f tmpl-build.log
1122 @ENABLE_GTK_DOC_TRUE@ touch tmpl-build.stamp
1124 @ENABLE_GTK_DOC_TRUE@tmpl.stamp: tmpl-build.stamp
1125 @ENABLE_GTK_DOC_TRUE@ @true
1127 #### build xml; done on every build ####
1129 ### FIXME: make this error out again when docs are fixed for 0.9
1130 @ENABLE_GTK_DOC_TRUE@sgml-build.stamp: tmpl.stamp scan-build.stamp $(CFILE_GLOB) $(top_srcdir)/common/plugins.xsl $(expand_content_files)
1131 @ENABLE_GTK_DOC_TRUE@ @echo '*** Building XML ***'
1132 @ENABLE_GTK_DOC_TRUE@ @-mkdir -p xml
1133 @ENABLE_GTK_DOC_TRUE@ @for a in $(srcdir)/$(INSPECT_DIR)/*.xml; do \
1134 @ENABLE_GTK_DOC_TRUE@ xsltproc --stringparam module $(MODULE) \
1135 @ENABLE_GTK_DOC_TRUE@ $(top_srcdir)/common/plugins.xsl $$a > xml/`basename $$a`; done
1136 @ENABLE_GTK_DOC_TRUE@ @for f in $(EXAMPLE_CFILES); do \
1137 @ENABLE_GTK_DOC_TRUE@ $(PYTHON) $(top_srcdir)/common/c-to-xml.py $$f > xml/element-`basename $$f .c`.xml; done
1138 @ENABLE_GTK_DOC_TRUE@ gtkdoc-mkdb \
1139 @ENABLE_GTK_DOC_TRUE@ --module=$(DOC_MODULE) \
1140 @ENABLE_GTK_DOC_TRUE@ --source-dir=$(DOC_SOURCE_DIR) \
1141 @ENABLE_GTK_DOC_TRUE@ --expand-content-files="$(expand_content_files)" \
1142 @ENABLE_GTK_DOC_TRUE@ --main-sgml-file=$(srcdir)/$(DOC_MAIN_SGML_FILE) \
1143 @ENABLE_GTK_DOC_TRUE@ --output-format=xml \
1144 @ENABLE_GTK_DOC_TRUE@ --ignore-files="$(IGNORE_HFILES) $(IGNORE_CFILES)" \
1145 @ENABLE_GTK_DOC_TRUE@ $(MKDB_OPTIONS) \
1146 @ENABLE_GTK_DOC_TRUE@ | tee sgml-build.log
1147 @ENABLE_GTK_DOC_TRUE@ @if grep "WARNING:" sgml-build.log > /dev/null; then true; fi # exit 1; fi
1148 @ENABLE_GTK_DOC_TRUE@ cp ../version.entities xml
1149 @ENABLE_GTK_DOC_TRUE@ rm sgml-build.log
1150 @ENABLE_GTK_DOC_TRUE@ touch sgml-build.stamp
1152 @ENABLE_GTK_DOC_TRUE@sgml.stamp: sgml-build.stamp
1153 @ENABLE_GTK_DOC_TRUE@ @true
1155 #### build html; done on every step ####
1157 @ENABLE_GTK_DOC_TRUE@html-build.stamp: sgml.stamp $(DOC_MAIN_SGML_FILE) $(content_files)
1158 @ENABLE_GTK_DOC_TRUE@ @echo '*** Building HTML ***'
1159 @ENABLE_GTK_DOC_TRUE@ if test -d html; then rm -rf html; fi
1160 @ENABLE_GTK_DOC_TRUE@ mkdir html
1161 @ENABLE_GTK_DOC_TRUE@ cp $(srcdir)/$(DOC_MAIN_SGML_FILE) html
1162 @ENABLE_GTK_DOC_TRUE@ @for f in $(content_files); do cp $(srcdir)/$$f html; done
1163 @ENABLE_GTK_DOC_TRUE@ cp -pr xml html
1164 @ENABLE_GTK_DOC_TRUE@ cp ../version.entities html
1165 @ENABLE_GTK_DOC_TRUE@ cd html && gtkdoc-mkhtml $(DOC_MODULE) $(DOC_MAIN_SGML_FILE)
1166 @ENABLE_GTK_DOC_TRUE@ mv html/index.sgml html/index.sgml.bak
1167 @ENABLE_GTK_DOC_TRUE@ $(SED) "s/ href=\"$(DOC_MODULE)\// href=\"$(DOC_MODULE)-@GST_MAJORMINOR@\//g" html/index.sgml.bak >html/index.sgml
1168 @ENABLE_GTK_DOC_TRUE@ rm -f html/index.sgml.bak
1169 @ENABLE_GTK_DOC_TRUE@ rm -f html/$(DOC_MAIN_SGML_FILE)
1170 @ENABLE_GTK_DOC_TRUE@ rm -rf html/xml
1171 @ENABLE_GTK_DOC_TRUE@ rm -f html/version.entities
1172 @ENABLE_GTK_DOC_TRUE@ test "x$(HTML_IMAGES)" = "x" || for i in "" $(HTML_IMAGES) ; do \
1173 @ENABLE_GTK_DOC_TRUE@ if test "$$i" != ""; then cp $(srcdir)/$$i html ; fi; done
1174 @ENABLE_GTK_DOC_TRUE@ @echo '-- Fixing Crossreferences'
1175 @ENABLE_GTK_DOC_TRUE@ gtkdoc-fixxref --module=$(DOC_MODULE) --module-dir=html --html-dir=$(HTML_DIR) $(FIXXREF_OPTIONS)
1176 @ENABLE_GTK_DOC_TRUE@ touch html-build.stamp
1178 @ENABLE_GTK_DOC_TRUE@clean-local-gtkdoc:
1179 @ENABLE_GTK_DOC_TRUE@ rm -rf xml tmpl html
1180 # clean files copied for nonsrcdir templates build
1181 @ENABLE_GTK_DOC_TRUE@ if test x"$(srcdir)" != x. ; then \
1182 @ENABLE_GTK_DOC_TRUE@ rm -rf $(SCANOBJ_FILES) $(SCAN_FILES) $(REPORT_FILES) \
1183 @ENABLE_GTK_DOC_TRUE@ $(MAINTAINER_DOC_STAMPS); \
1184 @ENABLE_GTK_DOC_TRUE@ fi
1185 @ENABLE_GTK_DOC_FALSE@all-local:
1186 @ENABLE_GTK_DOC_FALSE@clean-local-gtkdoc:
1188 clean-local: clean-local-gtkdoc
1193 rm -f $(REPORT_FILES) \
1194 $(DOC_MODULE)-decl-list.txt $(DOC_MODULE)-decl.txt
1195 rm -rf tmpl/*.sgml.bak
1196 rm -f $(DOC_MODULE).hierarchy
1197 rm -f *.stamp || true
1198 if test "$(abs_srcdir)" != "$(abs_builddir)" ; then \
1199 rm -f $(DOC_MODULE)-docs.sgml ; \
1200 rm -f $(DOC_MODULE).types ; \
1201 rm -f $(DOC_MODULE).interfaces ; \
1202 rm -f $(DOC_MODULE)-overrides.txt ; \
1203 rm -f $(DOC_MODULE).prerequisites ; \
1204 rm -f $(DOC_MODULE)-sections.txt ; \
1205 rm -rf tmpl/*.sgml ; \
1206 rm -rf $(INSPECT_DIR); \
1210 # thomas: make docs parallel installable; devhelp requires majorminor too
1212 (installfiles=`echo $(builddir)/html/*.sgml $(builddir)/html/*.html $(builddir)/html/*.png $(builddir)/html/*.css`; \
1213 if test "$$installfiles" = '$(builddir)/html/*.sgml $(builddir)/html/*.html $(builddir)/html/*.png $(builddir)/html/*.css'; \
1214 then echo '-- Nothing to install' ; \
1216 $(mkinstalldirs) $(DESTDIR)$(TARGET_DIR); \
1217 for i in $$installfiles; do \
1218 echo '-- Installing '$$i ; \
1219 $(INSTALL_DATA) $$i $(DESTDIR)$(TARGET_DIR); \
1221 pngfiles=`echo ./html/*.png`; \
1222 if test "$$pngfiles" != './html/*.png'; then \
1223 for i in $$pngfiles; do \
1224 echo '-- Installing '$$i ; \
1225 $(INSTALL_DATA) $$i $(DESTDIR)$(TARGET_DIR); \
1228 echo '-- Installing $(builddir)/html/$(DOC_MODULE).devhelp' ; \
1229 $(INSTALL_DATA) $(builddir)/html/$(DOC_MODULE).devhelp \
1230 $(DESTDIR)$(TARGET_DIR)/$(DOC_MODULE)-@GST_MAJORMINOR@.devhelp; \
1231 if test -e $(builddir)/html/$(DOC_MODULE).devhelp2; then \
1232 $(INSTALL_DATA) $(builddir)/html/$(DOC_MODULE).devhelp2 \
1233 $(DESTDIR)$(TARGET_DIR)/$(DOC_MODULE)-@GST_MAJORMINOR@.devhelp2; \
1235 (which gtkdoc-rebase >/dev/null && \
1236 gtkdoc-rebase --relative --dest-dir=$(DESTDIR) --html-dir=$(DESTDIR)$(TARGET_DIR)) || true ; \
1239 if test -d $(DESTDIR)$(TARGET_DIR); then \
1240 rm -rf $(DESTDIR)$(TARGET_DIR)/*; \
1241 rmdir -p $(DESTDIR)$(TARGET_DIR) 2>/dev/null || true; \
1243 echo '-- Nothing to uninstall' ; \
1249 @ENABLE_GTK_DOC_TRUE@check-hierarchy: $(DOC_MODULE).hierarchy
1250 @ENABLE_GTK_DOC_TRUE@ @if grep ' ' $(DOC_MODULE).hierarchy; then \
1251 @ENABLE_GTK_DOC_TRUE@ echo "$(DOC_MODULE).hierarchy contains tabs, please fix"; \
1252 @ENABLE_GTK_DOC_TRUE@ /bin/false; \
1253 @ENABLE_GTK_DOC_TRUE@ fi
1255 @ENABLE_GTK_DOC_TRUE@check: check-hierarchy
1257 check-inspected-versions:
1258 @echo Checking plugin versions of inspected plugin data ...; \
1260 for each in $(inspect_files) ; do \
1261 if (grep -H '<version>' $$each | grep -v '<version>$(VERSION)'); then \
1262 echo $$each should be fixed to say version $(VERSION) or be removed ; \
1263 echo "sed -i -e 's/<version.*version>/<version>$(VERSION)<\/version>/'" $$each; \
1270 check-outdated-docs:
1271 $(AM_V_GEN)echo Checking for outdated plugin inspect data ...; \
1273 if [ -d $(top_srcdir)/.git/ ]; then \
1274 files=`find $(srcdir)/inspect/ -name '*xml'`; \
1275 for f in $$files; do \
1276 ver=`grep '<version>$(PACKAGE_VERSION)</version>' $$f`; \
1277 if test "x$$ver" = "x"; then \
1278 plugin=`echo $$f | sed -e 's/^.*plugin-//' -e 's/.xml//'`; \
1279 # echo "Checking $$plugin $$f"; \
1280 pushd "$(top_srcdir)" >/dev/null; \
1281 pinit=`git grep -A3 GST_PLUGIN_DEFINE -- ext/ gst/ sys/ | grep "\"$$plugin\""`; \
1283 # echo "[$$pinit]"; \
1284 if test "x$$pinit" = "x"; then \
1285 printf " **** outdated docs for plugin %-15s: %s\n" $$plugin $$f; \
1294 # Require gtk-doc when making dist
1296 @ENABLE_GTK_DOC_TRUE@dist-check-gtkdoc:
1297 @ENABLE_GTK_DOC_FALSE@dist-check-gtkdoc:
1298 @ENABLE_GTK_DOC_FALSE@ @echo "*** gtk-doc must be installed and enabled in order to make dist"
1299 @ENABLE_GTK_DOC_FALSE@ @false
1301 # FIXME: decide whether we want to dist generated html or not
1302 # also this only works, if the project has been build before
1303 # we could dist html only if its there, but that might lead to missing html in
1305 dist-hook: dist-check-gtkdoc dist-hook-local
1306 mkdir $(distdir)/html
1307 cp html/* $(distdir)/html
1308 -cp $(srcdir)/$(DOC_MODULE).types $(distdir)/
1309 -cp $(srcdir)/$(DOC_MODULE)-sections.txt $(distdir)/
1310 cd $(distdir) && rm -f $(DISTCLEANFILES)
1311 -gtkdoc-rebase --online --relative --html-dir=$(distdir)/html
1313 .PHONY : dist-hook-local docs check-outdated-docs inspect
1315 # avoid spurious build errors when distchecking with -jN
1318 # Tell versions [3.59,3.63) of GNU make to not export all variables.
1319 # Otherwise a system limit (for SysV at least) may be exceeded.