diff mbox

[FFmpeg-devel] doc/fate: Document how to upload samples to the fate suite

Message ID 1514809038-22475-1-git-send-email-michael@niedermayer.cc
State Accepted
Commit fba00b7465b23d1c96fe01a8298afeda01a5d8eb
Headers show

Commit Message

Michael Niedermayer Jan. 1, 2018, 12:17 p.m. UTC
Suggested-by: Compn

Signed-off-by: Michael Niedermayer <michael@niedermayer.cc>
---
 doc/fate.texi | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

Comments

Michael Niedermayer Jan. 5, 2018, 9:49 p.m. UTC | #1
On Mon, Jan 01, 2018 at 01:17:18PM +0100, Michael Niedermayer wrote:
> Suggested-by: Compn
> 
> Signed-off-by: Michael Niedermayer <michael@niedermayer.cc>
> ---
>  doc/fate.texi | 20 ++++++++++++++++++++
>  1 file changed, 20 insertions(+)

will apply


[...]
diff mbox

Patch

diff --git a/doc/fate.texi b/doc/fate.texi
index 7a96c25..c9c0d3a 100644
--- a/doc/fate.texi
+++ b/doc/fate.texi
@@ -147,6 +147,26 @@  process.
 The only thing left is to automate the execution of the fate.sh script and
 the synchronisation of the samples directory.
 
+@chapter Uploading new samples to the fate suite
+
+This is for developers who have an account on the fate suite server.
+If you upload new samples, please make sure they are as small as possible,
+space on each client, network bandwidth and so on benefit from smaller test cases.
+Also keep in mind older checkouts use existing sample files, that means in
+practice generally do not replace, remove or overwrite files as it likely would
+break older checkouts or releases.
+
+@example
+#First update your local samples copy:
+rsync -vauL --chmod=Dg+s,Duo+x,ug+rw,o+r,o-w,+X fate-suite.ffmpeg.org:/home/samples/fate-suite/ ~/fate-suite
+
+#Then do a dry run checking what would be uploaded:
+rsync -vanL --no-g --chmod=Dg+s,Duo+x,ug+rw,o+r,o-w,+X ~/fate-suite/ fate-suite.ffmpeg.org:/home/samples/fate-suite
+
+#Upload the files:
+rsync -vaL  --no-g --chmod=Dg+s,Duo+x,ug+rw,o+r,o-w,+X ~/fate-suite/ fate-suite.ffmpeg.org:/home/samples/fate-suite
+@end example
+
 
 @chapter FATE makefile targets and variables