add notes on our autotools setup

Original commit message from CVS:
add notes on our autotools setup
This commit is contained in:
Thomas Vander Stichele 2006-06-11 11:56:36 +00:00
parent d739dfa75f
commit 40b94d3b15
2 changed files with 62 additions and 1 deletions

2
common

@ -1 +1 @@
Subproject commit 5d58e7652bf38a637dceca167d6e47e7794b2b52
Subproject commit 7ae3fb3bea2b518268add7962f95b7e23624b42f

61
docs/random/autotools Normal file
View file

@ -0,0 +1,61 @@
These are some notes on our autotools setup, and some things to remember.
plugin Makefile.am:
- plugindir gets defined for you, don't set it in Makefile.am
- plugin_LTLIBRARIES should contain the name of every plugin,
starting with libgst and ending in .la
- put compile/link variables in the following order: CFLAGS, LIBADD, LDFLAGS
- order _CFLAGS and _LIBADD with the highest in the stack first;
e.g. $(GST_PLUGINS_BASE_LIBS) $(GST_LIBS) $(MUSICBRAINZ_LIBS)
this makes sure that the one you're most likely to be hacking on
(GStreamer) has its -L flags pointing to your hacking directory,
and comes first on the link line. If it were to come later and you
had the library installed in the same place as the dependency, it
would take that version instead
- DO NOT put any libraries in _LDFLAGS. Typically, _LDFLAGS should only
have $(GST_PLUGIN_LDFLAGS)
- when using gst-plugins-base libraries, use $(GST_PLUGINS_BASE_LIBS) then
add -lgst(library)-$(GST_MAJORMINOR). Example:
libgstsdlvideosink_la_LIBADD = $(GST_PLUGINS_BASE_LIBS) \
-lgstvideo-$(GST_MAJORMINOR) \
-lgstaudio-$(GST_MAJORMINOR) \
-lgstinterfaces-$(GST_MAJORMINOR) \
$(SDL_LIBS)
- don't forget to use noinst_HEADERS if you have private headers
plugin configure.ac snippet:
- ORDER THEM ALPHABETICALLY PLEASE
- wrap your check in a block like this:
translit(dnm, m, l) AM_CONDITIONAL(USE_DEP, true)
GST_CHECK_FEATURE(DEP, [(dependency description)], (plug-in-name), [
(here go the checks)
])
- plug-in name is the name of the *plug-in*, not the element; ie, the
first column when running gst-inspect
- For the checks, in the simplest case, use something like:
GST_PKG_CHECK_MODULES(LIBOIL, liboil-0.3 >= 0.3.2)
This will:
- do the check
- show a decent message if it can't find it, without failing
- set HAVE_LIBOIL to yes or no
- set LIBOIL_CFLAGS and LBOIL_LIBS
- if you want to make sure configure fails when this dependency is missing,
use:
GST_PKG_CHECK_MODULES(LIBOIL, liboil-0.3 >= 0.3.2, yes)
- if your library does not come with a .pc file, you have to roll your own
check
pkg.m4: (last checked: version 0.20)
- was changed at some point to hide the error message from you, and error
out by default if no ACTION-IF-NOT-FOUND is given.
- caller is responsible for doing AC_MSG_RESULT if ACTION-IF-NOT-FOUND
is given
- for automake-1.6, AC_SUBST((PKG)_CFLAGS) and AC_SUBST((PKG)_LIBS) is not
done automatically. Starting from 1.7, it is. We require 1.7 now.