[FFmpeg-trac] #11044(documentation:new): Frustrated "pad" usage per poor documentation (was: padding is very frustrating.)

[FFmpeg]

#11044: Frustrated "pad" usage per poor documentation
-------------------------------------+-------------------------------------
             Reporter:  elias        |                    Owner:  (none)
  tsolis                             |
                 Type:  defect       |                   Status:  new
             Priority:  normal       |                Component:
                                     |  documentation
              Version:  unspecified  |               Resolution:
             Keywords:               |               Blocked By:
             Blocking:               |  Reproduced by developer:  0
Analyzed by developer:  0            |
-------------------------------------+-------------------------------------
Changes (by MasterQuestionable):

 * cc: MasterQuestionable (added)
 * component:  undetermined => documentation
 * summary:  padding is very frustrating. => Frustrated "pad" usage per poor
     documentation

Comment:

 ͏    In filter description:
 ͏    ":" as the separator of options.
 ͏    "=" as the name-value separator of each option.

 ͏    See also:
 ͏    https://ffmpeg.org/ffmpeg-filters.html#Filtergraph-syntax-1
 \\
 \\
 ͏    Usage of parentheses mostly follows their typical definition in other
 programming languages: merely as priority/associativity override.
 \\
 \\
 ͏    The doc is indeed horrible to some extent.
 ͏    However due to the framed choice of rendering scheme (Texinfo) that
 few would understand how to properly write:
 ͏    Fix may not be easy.
-- 
Ticket URL: <https://trac.ffmpeg.org/ticket/11044#comment:3>
FFmpeg <https://ffmpeg.org>
FFmpeg issue tracker