[FFmpeg-devel] [PATCH] faq: explain dependency problems with static libs.

[Nicolas George]

Signed-off-by: Nicolas George <nicolas.george at normalesup.org>
---
 doc/faq.texi |   18 ++++++++++++++++++
 1 file changed, 18 insertions(+)


Updated to take remarks into account.


diff --git a/doc/faq.texi b/doc/faq.texi
index da44adb..d10faa1 100644
--- a/doc/faq.texi
+++ b/doc/faq.texi
@@ -383,6 +383,24 @@ Yes, as long as the code is optional and can easily and cleanly be placed
 under #if CONFIG_GPL without breaking anything. So, for example, a new codec
 or filter would be OK under GPL while a bug fix to LGPL code would not.
 
+ at section I'm using FFmpeg from within my C application but the linker complains about missing symbols from the libraries themselves.
+
+FFmpeg builds static libraries by default. In static libraries, dependencies
+are not handled. That has two consequences. First, you must specify the
+libraries in dependency order: @code{-lavdevice} must come before
+ at code{-lavformat}, @code{-lavutil} must come after everything else, etc.
+Second, external libraries that are used in FFmpeg have to be specified too.
+
+An easy way to get the full list of required libraries in dependency order
+is to use @code{pkg-config}.
+
+ at example
+  c99 -o program program.c $(pkg-config --cflags --libs libavformat libavcodec)
+ at end example
+
+See @file{doc/example/Makefile} and @file{doc/example/pc-uninstalled} for
+more details.
+
 @section I'm using FFmpeg from within my C++ application but the linker complains about missing symbols which seem to be available.
 
 FFmpeg is a pure C project, so to use the libraries within your C++ application
-- 
1.7.10.4