[FFmpeg-devel] [PATCH] doc/filters: itemize scale examples, and create a dedicated subsection for them

[Stefano Sabatini]

---
 doc/filters.texi |   60 +++++++++++++++++++++++++++++++++++++++++++----------
 1 files changed, 48 insertions(+), 12 deletions(-)

diff --git a/doc/filters.texi b/doc/filters.texi
index d56a51a..a13d5ed 100644
--- a/doc/filters.texi
+++ b/doc/filters.texi
@@ -3088,41 +3088,77 @@ If the value for @var{width} or @var{height} is -1, the scale filter will
 use, for the respective output size, a value that maintains the aspect
 ratio of the input image.
 
-Some examples follow:
+ at subsection Examples
+
+ at itemize
+ at item
+Scale the input video to a size of 200x100:
 @example
-# scale the input video to a size of 200x100.
 scale=200:100
+ at end example
 
-# the above example is the same as:
+ at item
+The above example is the same as:
+ at example
 scale=w=200:h=100
+ at end example
 
-# scale the input to 2x
+ at item
+Scale the input to 2x:
+ at example
 scale=2*iw:2*ih
-# the above is the same as
+ at end example
+
+ at item
+The above is the same as:
+ at example
 scale=2*in_w:2*in_h
+ at end example
 
-# scale the input to 2x with forced interlaced scaling
+ at item
+Scale the input to 2x with forced interlaced scaling:
+ at example
 scale=2*iw:2*ih:interl=1
+ at end example
 
-# scale the input to half size
+ at item
+Scale the input to half size:
+ at example
 scale=iw/2:ih/2
+ at end example
 
-# increase the width, and set the height to the same size
+ at item
+Increase the width, and set the height to the same size:
+ at example
 scale=3/2*iw:ow
+ at end example
 
-# seek for Greek harmony
+ at item
+Seek for Greek harmony:
+ at example
 scale=iw:1/PHI*iw
 scale=ih*PHI:ih
+ at end example
 
-# increase the height, and set the width to 3/2 of the height
+ at item
+Increase the height, and set the width to 3/2 of the height:
+ at example
 scale=3/2*oh:3/5*ih
+ at end example
 
-# increase the size, but make the size a multiple of the chroma
+ at item
+Increase the size, but make the size a multiple of the chroma:
+ at example
 scale="trunc(3/2*iw/hsub)*hsub:trunc(3/2*ih/vsub)*vsub"
+ at end example
 
-# increase the width to a maximum of 500 pixels, keep the same input aspect ratio
+ at item
+Increase the width to a maximum of 500 pixels, keep the same input
+aspect ratio:
+ at example
 scale='min(500\, iw*3/2):-1'
 @end example
+ at end itemize
 
 @section select
 Select frames to pass in output.
-- 
1.7.5.4