[FFmpeg-devel] [PATCH] build system docs

[Michael Niedermayer]

On Wed, Oct 06, 2010 at 01:29:20AM +0200, Luca Barbato wrote:
> On 10/06/2010 12:44 AM, Michael Niedermayer wrote:
>> If i where configure maintainer a make fate would update the samples or
>> download them if they arent there.
>
> Donning my Gentoo hat now: I'd rather not have that automagically triggered.

well, call it whatever you like but a target that does rsync and make fate is
usefull.


>
> Fetch documentation and a shortcut for lazy people is obviously nice =)
>
>> New patch below (will commit soon if no objections)
>>   commit ec50e7502ee103800e80054ed067def230bcd56e
>> Author: Michael Niedermayer<michaelni at gmx.at>
>> Date:   Tue Oct 5 22:34:34 2010 +0200
>>
>>      custom build system documentation
>>
>> diff --git a/doc/build_system.txt b/doc/build_system.txt
>> new file mode 100644
>> index 0000000..d9e4f0a
>> --- /dev/null
>> +++ b/doc/build_system.txt
>> @@ -0,0 +1,34 @@
>> +FFmpeg currently uses a custom build system, this text attempts to document
>> +some of its obscure features and options.
>> +
>> +Options to make:
>> +make V=1<target>
>> +    Build target with verbosity 1, instead of 1, 2 can be used too
>
> I just checked defining V makes make verbose, no matter the value.

iam sure the value does make a difference for something, maybe fate i dont know
or rather i think i remember that people who should know talked about V=2

new patch below that will be applied soon
              commit 90384fc3d13e934fdc0dca04af408ff6e1613def
Author: Michael Niedermayer <michaelni at gmx.at>
Date:   Tue Oct 5 22:34:34 2010 +0200

    custom build system documentation

diff --git a/doc/build_system.txt b/doc/build_system.txt
new file mode 100644
index 0000000..b22ff84
--- /dev/null
+++ b/doc/build_system.txt
@@ -0,0 +1,34 @@
+FFmpeg currently uses a custom build system, this text attempts to document
+some of its obscure features and options.
+
+Options to make:
+make V=1 <target>
+    Build target with verbosity 1, instead of 1, 2 can be used too
+
+
+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.
+
+
+Targets to make:
+fate-list
+    Will list all fate/regression test targets
+
+fate
+    Run the fate test suite, note you must have installed it
+
+
+Setting up local fate:
+use the following command to get the fate test samples
+rsync -aL rsync://rsync.mplayerhq.hu:/samples/fate-suite/ fate/fate-suite
+pass --samples=<path to the samples> to configure



[...]
-- 
Michael     GnuPG fingerprint: 9FF2128B147EF6730BADF133611EC787040B0FAB

Into a blind darkness they enter who follow after the Ignorance,
they as if into a greater darkness enter who devote themselves
to the Knowledge alone. -- Isha Upanishad
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 198 bytes
Desc: Digital signature
URL: <http://lists.mplayerhq.hu/pipermail/ffmpeg-devel/attachments/20101006/a9ebe9d0/attachment.pgp>