gtk-doc.mak: allow out of srcdir build

Right now it is not possible to do out of srcdir builds for gstreamer due to
deficiencies in the api-doc build. Instead of making the srcdir writable and
generate files there, copy the needed files to builddir.

Fixes #636851

scanobj: use factory methods to get metadata

gst-package-release-datetime.m4: make work with FreeBSD's default shell

http://bugzilla-attachments.gnome.org/attachment.cgi?id=175689

Fix dist on some of the buildbots

When disting the tarball, and updating the -dist.[ch] files fails,
just ignore it. It happens when the -dist.[ch] files need updating,
but the srcdir is readonly, in which case we just copy the updated
files directly into the tarball, and don't update the srcdir.

orc.m4: Don't set HAVE_ORCC if orc is disabled

orc: Allow cross-building without orcc

orc: Let the copy rules for non-orc builds depend on the disted source files

gst.supp: Make pango/fontconfig leaks generic

gst.supp: Simply leaks from g_type_init/g_type_register_fundamental

gst-check.m4: drop REQUIRED arg to AG_GST_CHECK_GST_PLUGINS_{GOOD,UGLY,BAD,FFMPEG}

Since .pc files for these modules only exist in uninstalled setups, if at all,
it doesn't really make sense to *require* their presence (or that particular
version). Code (e.g. unit tests) still needs to check element/plugin availability
and versions at runtime, since that's what's required for installed setups
anyway.

gst-checks.m4: document AG_GST_CHECK_GST_PLUGINS_BASE and set GST_PLUGINS_BASE_DIR

Also set GST_PLUGINS_BASE_DIR (in addition to GSTPB_PLUGINS_DIR), for consistency
with the good/ugly/bad/ffmpeg equivalents.

gst-check.m4: document and fix AG_GST_CHECK_GST_PLUGINS_{GOOD,UGLY,BAD,FFMPEG}

Fix them so that configure doesn't error out if the module isn't required.

gst-check.m4: remove duplicate AC_MSG_RESULT(no)

PKG_CHECK_MODULES already does that.

gtk-doc-plugins.mak: add check-outdated-docs target and run it after 'make update'

Make sure we don't keep outdated plugin introspection info around.
This target is a bit more aggressive than than the existing
'check-inspected-versions' one, but also much more useful, since it
actually tries to check if there's still a reference to plugins
in the code.

Allow user to override ORCC using env var

orc: Add --compat $ORC_REQ to the orcc commandlines

This allows orcc to always use the latest features of the required
orc version instead of always generating code that would still work
with 0.4.5 or even earlier.

m4: add AG_GST_PKG_CONFIG_PATH macro

Sets up a GST_PKG_CONFIG_PATH variable for use in Makefile.am
which contains the path of the in-tree pkgconfig directory first
and then any paths specified in PKG_CONFIG_PATH.

We do this mostly so we don't have to use unportable shell constructs
such as ${PKG_CONFIG_PATH:+:$PKG_CONFIG_PATH} in Makefile.am to handle
the case where the environment variable is not set, but also in order
to avoid a trailing ':' in the PKG_CONFIG_PATH which apparently causes
problems with pkg-config on windows with msys/mingw.

Also shows the PKG_CONFIG_PATH set up in the configure output,
which is handy when debugging other people's configure problems.

plugins.xsl: the anchor tag has to be empty

Move the name out of the anchor and move the anchor to refpurpose tag. Fixes
generation of non compliant docbook xml.

*.mak: more spaces/tabs clean-ups

Use tabs consistently for the first indentation, even if it's not
really needed in these cases (continuation lines).

gtk-doc*.mak: use tabs instead of spaces to fix build with make-3.82

https://bugs.freedesktop.org/show_bug.cgi?id=29426

gst-check.m4: add AG_GST_CHECK_GST_PLUGINS_{GOOD,UGLY,BAD,FFMPEG}

For future use, so we can find other plugin dirs in an uninstalled setup
more easily, for unit tests that use plugins from other modules mostly. Not
all of these modules have uninstalled .pc files yet. The currently used
(topdir)/../gst-plugins-foo trick doesn't work in all cases, e.g. when
running 'make distcheck'.

scanobj: only update inspect files when we run in update mode

Check the stamp file to avoid rewriting all inspect files and rescanning.
Fixes #623356

gstdoc-scangobj: output $MODULE.hierarchy sorted alphabetically

Sort hierarchy of types in alphabetical order, so it doesn't
change all the time.

Revert "gtk-doc.mak: make build break on new api that has not been added to the sections file"

This reverts commit 30c7a70b1d4765d26789950ca8e983284c0a05b3.

Docs stuff should never break the build (it's fragile enough as it is), especially
not when whether things break or not depends on factors outside of the source tree
such as, for example, the gtk-doc version being used. Also, hooks like this are
probably more appropriate for the check or distcheck target.

https://bugzilla.gnome.org/show_bug.cgi?id=625862

Add AG_GST_SET_PACKAGE_RELEASE_DATETIME and _DATETIME_WITH_NANO macros for configure

Sets GST_PACKAGE_RELEASE_DATETIME, either to the current date and time, or
to the specified datetime, or to the date of the current release based on
the .doap file.

In a GStreamer module context, one could use it like this:
AG_GST_SET_PACKAGE_RELEASE_DATETIME_WITH_NANO([$PACKAGE_VERSION_NANO],
  ["${srcdir}/$PACKAGE.doap"],
    [$PACKAGE_VERSION_MAJOR.$PACKAGE_VERSION_MINOR.$PACKAGE_VERSION_MICRO])

https://bugzilla.gnome.org/show_bug.cgi?id=623040

gstdoc-scangobj: serialise doubles and floats always with a decimal dot

Make sure floats and double property values are output with a decimal dot
(and not e.g. a comma) irrespective of the current locale. g_ascii_formatd() is
used here instead of g_ascii_dtostr() because we want nice human-readable
numbers and do not need the exact same bit representation when deserialising.

Other parts of gtk-doc may need fixing as well to make sure to always
deserialise floats and doubles in C locale.

hooks: use 'git do-something' instead of the old 'git-do-something'

docs: remove cruft and clean additional copied files

Remove lines still referencing the inspect-stamps. Clean scanobj-build.stamp
file (scanobj-build.stamp rule always creates that one). Fixes #622546

gst-error.m4: use 'dnl' instead of 'Dnl' for comment line

gstdoc-scangobj: fix build with C compilers that don't support -Wall

Don't unconditionally pass -Wall to the compiler. Use WARNING_CFLAGS instead
if it is defined. Fixes build with Sun Studio Compiler.

Fixes #621963.

gstdoc-scanobj: sort pad templates

Avoid pad template order ping-pong in generated version-controlled
files by sorting the pad templates before processing them.

gstdoc-scangobj: abort with an error if we couldn't open a file for writing

gstdoc-scanobj: skip static coreelements plugin with bin and pipeline factories

Same as we did before. It's best not to expose GstBin and GstPipeline here to
avoid confusion. People are better off consulting the GstBin and GstPipeline
API docs and constructing bins and pipelines using the API provided there.

gstdoc-scangobj: maintain previous XML formatting

Maintain the previous XML formatting, ie. add newlines after each xml item.
Also make sure file does not end with a newline character. Simplify xmlprint()
function a little to not use home-baked xml escaping - there's a GLib function
for that, so we may just as well do it properly.

Makefile.am: Don't dist file that has gone

docs: use g_string instead of fragile static strings

docs: make static string buffers bigger

docs: move gst-xmlinspect.py functionality to gstdoc-scanobj

gst-xmlinspect was causing a circular dependency (as it uses gst-python). It
also caused and extra build step and double registry scan.

gst-glib2.m4: Add our custom GLib CFLAGS to GLIB_EXTRA_CFLAGS

GLIB_CFLAGS is only used by core and all other modules
get the flags from gstreamer-0.10.pc.

gst-glib.m4: Define G_DISABLE_DEPRECATED for GIT versions

If deprecated API is found, for which the replacement is in
a newer version of GLib than we currently depend on, use
the new API in a #if GLIB_CHECK_VERSION block and remove
that block after depending on a new enougb GLib version.

Fixes bug #605100.

gst.supp: Update dl_relocate_object suppression for libc in /lib instead of /lib64

Add orc.m4 to dist files

Add autoconf macros for Orc

orc.mak: Use automake silent rules for the orcc calls if automake 1.11 is used

orc.mak: rename from orc.mk

All the other makefile snippets are called *.mak.

orc.mk: change generated file/variable names

orc: Fix distcheck problems in orc.mk

Add gst-indent to common, since orc.mk uses it to clean up
source files.

Add a makefile fragment for Orc

Not updating all the modules, because it's only used on the Orc
branch for now.

glib-gen.mak: Don't use == for comparisons in shell scripts

gst-error.m4: Don't use == for comparisons in shell scripts

This only works with bash and not strictly POSIX compatible shells.

gst.supp: suppress dash leaks

upload-doc.mak: upload release docs to the right place

On our website, all doc links point to the docs for head, which
is where git docs get uploaded to, while release docs for some
reason get uploaded to docs/$version where no one will ever
find them. Change upload rule to upload release docs to both
the versioned directory and head, so that new docs will actually
be visible on the website when the new-release script in www
uploads them as part of the release process.

win32.mak: rename check-nonportable-int64-print-format rule and check for %zu

Rename check-nonportable-int64-print-format rule to check-nonportable-print-format
and also check for %zu, %zd, etc.

gst-arch.m4: fix detection on Solaris

stop-gap measure to fix CPU/arch detection on solaris, which
makes the goom problems work properly on solaris. Probably
needs more fixes after the release (use target_* etc.).

Fixes #615996.

pre-commit: Add --leave-preprocessor-space

This puts it in sync with core/tools/gst-indent.

gst-glib2.m4: Add configure parameter to disable GObject type checks

...and disable them by default for pre-releases and releases.

Fixes bug #612540.

cruft.mak: add make rule to remove cruft

download-translations: make sure existing translations are listed in LINGUAS

Fixes #509662.

gst.supp: Make ALSA suppressions a bit more generic

gst.supp: Make some suppressions more generic

Make sure new parallel-subdirs.mak gets disted

It seems to get disted automagically already when used, but better be safe..

gst-libxml2.m4: fix error message - we are building GStreamer, not glib2

parallel-subdirs.mak: snippet to include in Makefiles to build subdirectories in parallel

Build sub-directories in parallel if make -jN is used. We'll descend
into the sub-directories a second time after the first parallel run,
but at that point there shouldn't be anything left to do. Assumes
there are no dependencies between any of the sub-directories.

check.mak: fix typo in make help

gst.supp: Simplify some more suppressions

check.mak: Add a "make valgrind.gen-suppressions" rule

This allows generating suppressions for all tests

gst.supp: More suppressions for glib 2.23

See on gentoo ~amd64. Also simplified existing ones.

gst.supp: update valgrind suppressions for newer glib

check.mak: fix 'make check-valgrind'

Don't use @ on a continuation line, that will lead to syntax errors.
Also replace some spaces with tabs.

Make sure MORE_FLAGS are evaluated one by one

Previously the argument was just evaluated as a single string.

I still don't get shell and m4 (un)escaping rules...

Clean up the brokenness from my latest changes

- Fix calling AG_GST_SET_ERROR_CFLAGS() without a second parameter
- Make AG_GST_SET_ERROR_CXXFLAGS() actually work

Split ERROR_{C|CXX} flags into WARNING and ERROR flags

The WARNING flags now contain all warning flags, the ERROR flags contain
the flags related to making warnings fatal. For more explanation, see
the inline docs.

The rationale is that we want to turn on a lot more warning flags, but
generated and imported sources might not have the same quality. For
those, we want to use the WARNING_CFLAGS but not the ERROR_CFLAGS.

Add a MORE_FLAGS argument to AG_GST_SET_ERROR_{C|XX}FLAGS

This allows modules to specify additional warning flags to
AG_GST_SET_ERROR_CFLAGS() and AG_GST_SET_ERROR_CXXFLAGS() that will be
added to the ERROR_CFLAGS.

https://bugzilla.gnome.org/show_bug.cgi?id=611690

Don't try to dist shave files that have been removed

build: Make some generic rules silent

Remove shave from common, all modules are using AM_SILENT_RULES now

gst.supp: Add another type registration, one-time leak in GObject

gst.supp: even more valgrind suppressions

GLib 2.23.2, debian sid, amd64. Also make use of ... some more.

gst.supp: add some more valgrind suppressions for newer glib versions

GLib 2.23.2, debian sid, amd64

gst-glib2.m4: add -DG_THREADS_MANDATORY to GLIB_CFLAGS

Threading is always enabled in GStreamer code, so we may just as well
add -DG_THREADS_MANDATORY to GLIB_CFLAGS so that all GStreamer modules
are automatically compiled with it (optimisation).

gst-arch.m4: fix unaligned detection for x86-64 when cross compiling

Commit 4221e9dc (amd64/x86_64 allows unaligned memory access too) added
x86-64 to the unaligned access whitelist, but missed the trailing
wildcards, so the test never succeeds (host is something like
x86_64-unknown-linux-gnu).

When building natively, this isn't a big deal as the AC_TRY_RUN test
correctly detects it, but that doesn't work when cross compiling so
the build dies with:

configure: error: cannot run test program while cross compiling
See `config.log' for more details.

Fix it by adding the trailing wildcards.

Fixes bug #607317.

Don't forget to dist new cruft.mak file

Add cruft.mak file that can be included from modules to check for cruft

When plugins get renamed, moved or removed we often leave behind unwanted
left-overs in our source tree, since no one runs 'make clean' before every
git update. This can cause problems and be confusing, so add a little
Makefile rule to include to print a warning for if any of the files or
directories specified in CRUFT_FILES and/or CRUFT_DIRS are still present
in our uninstalled tree.

gtk-doc*.mak: html is created in build directory, not source directory

Fixes make dist for out-of-source build.

gst.supp: Add some more invalid read variations for 64-bit

Dist new gst-platform.m4

m4: Add gst-platform.m4 for platform specific checks and defines

These are currently copied from core but some/most of them are
useful for other modules too.

gst.supp: Suppression for macosx (Leopard) loader

gst.supp: More suppressions for data only created once at initialization

gst.supp: Suppression for allocation done only once at initialization

Tags are only registered once, and we keep a reference to some classes.

gst.supp: Another dlopen suppression

gst.supp: Add suppressions for new registry system

gst.supp: make gstffmpegc suppression more flexible

gst.supp: Make ALSA suppressions more flexible

gst.supp: Add suppression for leak in glib static types

gst.supp: Add suppressions for recent alsa

gst.supp: Add some glibc 2.11 leaks

gst.supp: Make some dlopen suppressions more flexible

gst.supp: Add suppression for glibc-2.11 relocatable conditional

gst-args: fix version checking

Without the 'test' configure will look for a binary call x and
fail to find it..