[FFmpeg-cvslog] fate: document TARGET_EXEC and its usage

[Luca Barbato]

ffmpeg | branch: master | Luca Barbato <lu_zero at gentoo.org> | Mon May 14 15:44:30 2012 -0700| [b0970a69d11919b41c19a2901d4a7c2cf0b4ba2f] | committer: Luca Barbato

fate: document TARGET_EXEC and its usage

TARGET_EXEC allows running FATE on simulators, remote targets and
memory checkers. Also document a known issue with Wine and mixed
Unix/Windows line ending.

> http://git.videolan.org/gitweb.cgi/ffmpeg.git/?a=commit;h=b0970a69d11919b41c19a2901d4a7c2cf0b4ba2f
---

 doc/fate.texi |   12 +++++++++++-
 1 file changed, 11 insertions(+), 1 deletion(-)

diff --git a/doc/fate.texi b/doc/fate.texi
index b69301a..4b02505 100644
--- a/doc/fate.texi
+++ b/doc/fate.texi
@@ -29,6 +29,9 @@ To inform the build system about the testsuite location, pass
 @var{SAMPLES} Make variable or the @var{LIBAV_SAMPLES} environment variable
 to a suitable value.
 
+To use a custom wrapper to run the test, pass @option{--target-exec} to
+ at command{configure} or set the @var{TARGET_EXEC} Make variable.
+
 The dataset is available through @command{rsync}, is possible to fetch
 the current sample using the straight rsync command or through a specific
 @ref{Makefile target}.
@@ -57,7 +60,7 @@ Shortcut to download the fate test samples to the specified testsuite location.
 Run the FATE test suite (requires the fate-suite dataset).
 @end table
 
- at section Fate Makefile variables
+ at section FATE Makefile variables
 @table @option
 @item V
 Verbosity level, can be set to 0, 1 or 2.
@@ -77,6 +80,8 @@ Specify how many threads to use while running regression tests, it is
 quite useful to detect thread-related regressions.
 @item CPUFLAGS
 Specify a mask to be applied to autodetected CPU flags.
+ at item TARGET_EXEC
+Specify or override the wrapper used to run the tests.
 @end table
 
 @example
@@ -131,6 +136,11 @@ makeopts=       # extra options passed to 'make'
                 # stdout, defaults to 'tar c'
 @end example
 
+ at section Special Instances
+The @var{TARGET_EXEC} option provides a way to run FATE wrapped in
+ at command{valgrind}, @command{qemu-user} or @command{wine} or on remote targets
+through @command{ssh}.
+
 @section Submitting Reports
 In order to send reports you need to create an @command{ssh} key and send it
 to @email{root@@libav.org}.