diff --git a/doc/filters.texi b/doc/filters.texi
index 07ae1c9b1cbfd4c4d5ccb6794019a314b8ed4fbe..d7e31bd12ecacec0ce8ae6285c642ae8e3947e31 100644
--- a/doc/filters.texi
+++ b/doc/filters.texi
@@ -1750,15 +1750,26 @@ interpreted accorinding to the following syntax:
 drawbox=@var{x}:@var{y}:@var{width}:@var{height}:@var{color}
 @end example
 
-Follow some examples:
+Some examples follow:
+@itemize
+@item
+Draw a black box around the edge of the input image:
 @example
-# draw a black box around the edge of the input image
 drawbox
+@end example
 
-# draw a box with color red and an opacity of 50%
-drawbox=10:20:200:60:red@@0.5"
+@item
+Draw a box with color red and an opacity of 50%:
+@example
+drawbox=10:20:200:60:red@@0.5
 @end example
 
+The previous example can be specified as:
+@example
+drawbox=x=10:y=20:w=200:h=60:color=red@@0.5
+@end example
+@end itemize
+
 @section drawtext
 
 Draw text string or text from specified file on top of video using the