[FFmpeg-devel] [PATCH] doc/filters: create a dedicated "Examples" subsection for fade, and use @itemize

[Stefano Sabatini]

---
 doc/filters.texi |   32 ++++++++++++++++++++++++++------
 1 file changed, 26 insertions(+), 6 deletions(-)

diff --git a/doc/filters.texi b/doc/filters.texi
index 9def1dc..42c78b8 100644
--- a/doc/filters.texi
+++ b/doc/filters.texi
@@ -2303,23 +2303,43 @@ If set to 1, fade only alpha channel, if one exists on the input.
 Default value is 0.
 @end table
 
-A few usage examples follow, usable too as test scenarios.
+ at subsection Examples
+ at itemize
+ at item
+Fade in first 30 frames of video:
 @example
-# fade in first 30 frames of video
 fade=in:0:30
+ at end example
+
+The command above is equivalent to:
+ at example
+fade=t=in:s=0:n=30
+ at end example
 
-# fade out last 45 frames of a 200-frame video
+ at item
+Fade out last 45 frames of a 200-frame video:
+ at example
 fade=out:155:45
+ at end example
 
-# fade in first 25 frames and fade out last 25 frames of a 1000-frame video
+ at item
+Fade in first 25 frames and fade out last 25 frames of a 1000-frame video:
+ at example
 fade=in:0:25, fade=out:975:25
+ at end example
 
-# make first 5 frames black, then fade in from frame 5-24
+ at item
+Make first 5 frames black, then fade in from frame 5-24:
+ at example
 fade=in:5:20
+ at end example
 
-# fade in alpha over first 25 frames of video
+ at item
+Fade in alpha over first 25 frames of video:
+ at example
 fade=in:0:25:alpha=1
 @end example
+ at end itemize
 
 @section field
 
-- 
1.7.9.5