document passing the fate samples location via make variable
[ffmpeg.git] / doc / build_system.txt
1 FFmpeg currently uses a custom build system, this text attempts to document
2 some of its obscure features and options.
3
4 Options to make:
5 make V=1 <target>
6     Build target with verbosity 1, instead of 1, 2 can be used too
7 make SAMPLES=<path to the fate samples> <target>
8     specify the path to the fate samples at make time
9
10
11 Useful standard make commands:
12 make -t <target>
13     Touch all files that otherwise would be build, this is useful to reduce
14     unneeded rebuilding when changing headers, but note you must force rebuilds
15     of files that actually need it by hand then.
16
17 make -j<num>
18     rebuild with multiple jobs at the same time. Faster on multi processor systems
19
20 make -k
21     continue build in case of errors, this is useful for the regression tests
22     sometimes but note it will still not run all reg tests.
23
24
25 Targets to make:
26 fate-list
27     Will list all fate/regression test targets
28
29 fate
30     Run the fate test suite, note you must have installed it
31
32
33 Setting up local fate:
34 use the following command to get the fate test samples
35 rsync -aL rsync://rsync.mplayerhq.hu:/samples/fate-suite/ fate/fate-suite
36 pass --samples=<path to the samples> to configure or pass the path with the
37 SAMPLES variable to make