doc/filters: improve xfade description and add one example

1 files changed, 13 insertions, 2 deletions

diff --git a/doc/filters.texi b/doc/filters.texi
index 13403fd96c..2c9486ae58 100644
--- a/doc/filters.texi
+++ b/doc/filters.texi
@@ -20073,8 +20073,8 @@ Set cross fade duration in seconds.
 Default duration is 1 second.
 
 @item offset
-Set cross fade start relative to first input stream.
-Default offset it 0.
+Set cross fade start relative to first input stream in seconds.
+Default offset is 0.
 
 @item expr
 Set expression for custom transition effect.
@@ -20118,6 +20118,17 @@ first/second/third/fourth component of second input.
 @end table
 @end table
 
+@subsection Examples
+
+@itemize
+@item
+Cross fade from one input video to another input video, with fade transition and duration of transition
+of 2 seconds starting at offset of 5 seconds:
+@example
+ffmpeg -i first.mp4 -i second.mp4 -filter_complex xfade=transition=fade:duration=2:offset=5 output.mp4
+@end example
+@end itemize
+
 @section xstack
 Stack video inputs into custom layout.