doc/build_system.txt
a6be21d3
 FFmpeg currently uses a custom build system, this text attempts to document
326ede48
 some of its obscure features and options.
 
c535d089
 Makefile variables:
326ede48
 
c535d089
 V
     Disable the default terse mode, the full command issued by make and its
     output will be shown on the screen.
326ede48
 
bc8e044d
 DBG
     Preprocess x86 external assembler files to a .dbg.asm file in the object
     directory, which then gets compiled. Helps developping those assembler
     files.
 
c535d089
 DESTDIR
     Destination directory for the install targets, useful to prepare packages
34c27ada
     or install FFmpeg in cross-environments.
326ede48
 
1cf87e16
 GEN
     Set to ‘1’ to generate the missing or mismatched references.
 
c535d089
 Makefile targets:
326ede48
 
c535d089
 all
     Default target, builds all the libraries and the executables.
326ede48
 
27ef7b1b
 fate
     Run the fate test suite, note you must have installed it
 
 fate-list
     Will list all fate/regression test targets
 
c535d089
 install
     Install headers, libraries and programs.
326ede48
 
a30f1b15
 examples
     Build all examples located in doc/examples.
 
c535d089
 libavformat/output-example
     Build the libavformat basic example.
326ede48
 
c535d089
 libavcodec/api-example
     Build the libavcodec basic example.
326ede48
 
c535d089
 libswscale/swscale-test
     Build the swscale self-test (useful also as example).
326ede48
 
a30f1b15
 config
     Reconfigure the project with current configuration.
 
326ede48
 
 Useful standard make commands:
 make -t <target>
     Touch all files that otherwise would be build, this is useful to reduce
     unneeded rebuilding when changing headers, but note you must force rebuilds
     of files that actually need it by hand then.
 
 make -j<num>
     rebuild with multiple jobs at the same time. Faster on multi processor systems
 
 make -k
     continue build in case of errors, this is useful for the regression tests
     sometimes but note it will still not run all reg tests.