From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from ffbox0-bg.ffmpeg.org (ffbox0-bg.ffmpeg.org [79.124.17.100]) by master.gitmailbox.com (Postfix) with ESMTPS id 7BE7E4C4CB for ; Thu, 13 Nov 2025 07:38:31 +0000 (UTC) Authentication-Results: ffbox; dkim=fail (body hash mismatch (got b'3cPgn+DnjNiz+1ZamL4M1JeJnxej7dvJ2ablI7F1VRE=', expected b'xoIvzx+U/R/64sBGWUu0VpIynUyNxmuKWR0sx2iVico=')) header.d=ffmpeg.org header.i=@ffmpeg.org header.a=rsa-sha256 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=ffmpeg.org; i=@ffmpeg.org; q=dns/txt; s=mail; t=1763019496; h=mime-version : to : date : message-id : reply-to : subject : list-id : list-archive : list-archive : list-help : list-owner : list-post : list-subscribe : list-unsubscribe : from : cc : content-type : content-transfer-encoding : from; bh=3cPgn+DnjNiz+1ZamL4M1JeJnxej7dvJ2ablI7F1VRE=; b=xIEgR/+/pk9mZyIy2o+9oqtpONRlrrcugwNP9x3Crl2DCSFiAqCybuQdsQXPbmENLBr3y FCDyKe5J0O02aDozUxylIRmKhE9JoFCpMOaa+P2iyM1CENKu7OlN66Vg37ArOwY9o5Tc8u2 TWiY6PPDxlzeVVCfuDzpjGAmzaEuccL8cuFEExOvvpna6ycJmIlJCzyOEqg68AOBjO9NF7O hzTIJ4GmevZ8r68vVmfnGuMXGuu2902baiiO2cHeN3X/cmY4z+W4Z4Saz8zhsIL/l+2Y6Jl 2mbrA2jDNXXHx9z6VCEI+W0QqQeYed8XH7+UP6yER1zFj8iyFa2w07pJ6MFQ== Received: from [172.19.0.2] (unknown [172.19.0.2]) by ffbox0-bg.ffmpeg.org (Postfix) with ESMTP id 0C48568FC42; Thu, 13 Nov 2025 09:38:16 +0200 (EET) ARC-Seal: i=1; cv=none; a=rsa-sha256; d=ffmpeg.org; s=arc; t=1763019474; b=Ldev6I9odiNEUhTxKmuhiCvpSQ9rRhTZ+iJR4R5UfEmz1lHOMJzfpI9CUFndvts6N07k6 HaX4maqvdrPUUjXY8j/Pfh8I4wiZBEHDqtny6br1lbx5utWGQtSiGiTqQEuHzHLl5M+CBIc uzXtHKgVQSq1cVGUPNgHbcL9Y4j3NhfZu9CE4ycYPsp+6HRSKgQy0Yt68w/IbsMqoJcp1K0 ZapUA34JlGp6AhtNLIuzCxGKQA1ONG3mLvnH/SPAsX/bH99VbpGL/YyGc/tMBZiAhc7y6F3 PUq5RWPAikkXObo0wtdv7xME5bIevchOzvYHCu34GGhYmOtuKwlCCjVnxsFA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=ffmpeg.org; s=arc; t=1763019474; h=from : sender : reply-to : subject : date : message-id : to : cc : mime-version : content-type : content-transfer-encoding : content-id : content-description : resent-date : resent-from : resent-sender : resent-to : resent-cc : resent-message-id : in-reply-to : references : list-id : list-help : list-unsubscribe : list-subscribe : list-post : list-owner : list-archive; bh=XeNlRLZiAkCHzPDaA8vS/RUV4Gn6RboOnExHp/zVIdw=; b=YRVd758GgnNbkuAia47I3ED5hxG7YLD0hWL/fGbivDX0v4OLn5vLBLdTskA5FyQdycK3Q ji7fhrz0onvDynZLd6pz2Ry5iL63vjj6iq1Y1nL666Tk+lnIInEE3QrQbO5V26oRNEaiIyX 5tO4dXnbQRqjPxUYz+t3iKW/L8LJBr7/BnTBRfeKy4XYLXOQ8VC8+w8JT0BR/uvQ1epI9Z4 5MNTwjvUvfhU2etQLfdwezK9wycmH0eDNYL0kHDxEgq93Hi/X+NYOaUuqKicdkU3oljxcRS V2iF8giXMxrL2tfugQTjx4zkOSegdg2KTBHCb+Xq6sbbhn3WxhFxlFIM/ZAQ== ARC-Authentication-Results: i=1; ffmpeg.org; dkim=pass header.d=ffmpeg.org header.i=@ffmpeg.org; arc=none; dmarc=pass header.from=ffmpeg.org policy.dmarc=quarantine Authentication-Results: ffmpeg.org; dkim=pass header.d=ffmpeg.org header.i=@ffmpeg.org; arc=none (Message is not ARC signed); dmarc=pass (Used From Domain Record) header.from=ffmpeg.org policy.dmarc=quarantine DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=ffmpeg.org; i=@ffmpeg.org; q=dns/txt; s=mail; t=1763019466; h=content-type : mime-version : content-transfer-encoding : from : to : reply-to : subject : date : from; bh=xoIvzx+U/R/64sBGWUu0VpIynUyNxmuKWR0sx2iVico=; b=XvsA7GCKMwyEFimH8riaCL303BNRtmhYkq7+gvqL5dnuJ8MAzNddK1SHZtH1RFOsWNLve CNEBvhyBLWpFP22g5Sftv7XR/OFHoNCfM0yA5O9juhmMgg6OP05kgWhZHOdU/t64Ada6L60 WWY5DxZH12HXg1EUds/jGGohiZdF1xt7bFlnS7dX0xmRt+d4vnACQ1iZPJi8720nzxWEBwC AqpKiziHGTllOJUV5l0Axn5g0rxFQYRis1PyJujswAoWnspJiwhBut0cb/rKI0oRRw33+93 bljqbFbxAI8PCzGP9eUiDHQpqqIO3TL5SLqd3/LSj2RpJSOyU4Q9GMnWznVg== Received: from 188d6d40ca7a (code.ffmpeg.org [188.245.149.3]) by ffbox0-bg.ffmpeg.org (Postfix) with ESMTPS id 8C5C768FC3E for ; Thu, 13 Nov 2025 09:37:46 +0200 (EET) MIME-Version: 1.0 To: ffmpeg-devel@ffmpeg.org Date: Thu, 13 Nov 2025 07:37:46 -0000 Message-ID: <176301946670.25.15887315352711234590@2cb04c0e5124> Message-ID-Hash: 63VZCLJHXL4TLBKCDQZGUZQ3DJXV3MKJ X-Message-ID-Hash: 63VZCLJHXL4TLBKCDQZGUZQ3DJXV3MKJ X-MailFrom: code@ffmpeg.org X-Mailman-Rule-Hits: nonmember-moderation X-Mailman-Rule-Misses: dmarc-mitigation; no-senders; approved; loop; banned-address; header-match-ffmpeg-devel.ffmpeg.org-0; header-match-ffmpeg-devel.ffmpeg.org-1; header-match-ffmpeg-devel.ffmpeg.org-2; header-match-ffmpeg-devel.ffmpeg.org-3; emergency; member-moderation X-Mailman-Version: 3.3.10 Precedence: list Reply-To: FFmpeg development discussions and patches Subject: [FFmpeg-devel] [PATCH] doc/fate: improve section on running FATE (PR #20907) List-Id: FFmpeg development discussions and patches Archived-At: Archived-At: List-Archive: List-Archive: List-Help: List-Owner: List-Post: List-Subscribe: List-Unsubscribe: From: Gyan Doshi via ffmpeg-devel Cc: Gyan Doshi Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: 7bit Archived-At: List-Archive: List-Post: PR #20907 opened by Gyan Doshi (GyanD) URL: https://code.ffmpeg.org/FFmpeg/FFmpeg/pulls/20907 Patch URL: https://code.ffmpeg.org/FFmpeg/FFmpeg/pulls/20907.patch Supersedes #20905 >>From 0c47fd58ab7a7eff4f19c6d138efa420b478e682 Mon Sep 17 00:00:00 2001 From: Gyan Doshi Date: Thu, 13 Nov 2025 13:05:10 +0530 Subject: [PATCH] doc/fate: improve section on running FATE --- doc/fate.texi | 47 +++++++++++++++++++++++++++++------------------ 1 file changed, 29 insertions(+), 18 deletions(-) diff --git a/doc/fate.texi b/doc/fate.texi index 7a2e0edfcc..3783de7971 100644 --- a/doc/fate.texi +++ b/doc/fate.texi @@ -42,41 +42,51 @@ targets and variables. @chapter Using FATE from your FFmpeg source directory -If you want to run FATE on your machine you need to have the samples -in place. You can get the samples via the build target fate-rsync. -Use this command from the top-level source directory: +If you want to run FATE on your machine, FFmpeg needs to be configured first. +You may specify the location of samples during configuration by adding the +argument @code{--samples=/path/to/fate-suite}. @example -make fate-rsync SAMPLES=fate-suite/ -make fate SAMPLES=fate-suite/ +./configure --enable-somelib --samples=/path/to/fate-suite @end example -The above commands set the samples location by passing a makefile -variable via command line. It is also possible to set the samples -location at source configuration time by invoking configure with -@option{--samples=}. Afterwards you can -invoke the makefile targets without setting the @var{SAMPLES} makefile -variable. This is illustrated by the following commands: +After successful configuration, you need to add and/or update the samples in place: @example -./configure --samples=fate-suite/ make fate-rsync +@end example + +Now you are ready to run FATE: + +@example make fate @end example -Yet another way to tell FATE about the location of the sample -directory is by making sure the environment variable FATE_SAMPLES -contains the path to your samples directory. This can be achieved -by e.g. putting that variable in your shell profile or by setting -it in your interactive session. +See @ref{makefile variables} for a list of arguments that can be added. + +If you did not set the samples path during configuration, or if you wish to +override it just before starting FATE, you can do so in one of two ways. + +Either by setting a make variable: @example -FATE_SAMPLES=fate-suite/ make fate +make fate-rsync SAMPLES=/path/to/fate-suite +make fate SAMPLES=/path/to/fate-suite @end example +or by prepending an environment variable: + +@example +FATE_SAMPLES=/path/to/fate-suite make fate-rsync +FATE_SAMPLES=/path/to/fate-suite make fate +@end example + +This variable can also be set in your shell profile. + @float NOTE Do not put a '~' character in the samples path to indicate a home directory. Because of shell nuances, this will cause FATE to fail. +Also, on Windows the path has to be relative to the FFmpeg source directory. @end float Beware that some assertions are disabled by default, so mind setting @@ -220,6 +230,7 @@ Run the FATE test suite (requires the fate-suite dataset). @end table @section Makefile variables +@anchor {makefile variables} @table @env @item V -- 2.49.1 _______________________________________________ ffmpeg-devel mailing list -- ffmpeg-devel@ffmpeg.org To unsubscribe send an email to ffmpeg-devel-leave@ffmpeg.org