[FFmpeg-devel] [PATCH] doc/filter_design: reword a sentence to avoid a misunderstanding.

[Nicolas George]

L'octidi 28 floréal, an CCXX, Clément Bœsch a écrit :
> I may be wrong, but the next paragraph explains the special case of multiple
> output frames, so an infinitive looks more correct to me here.
> ---
>  doc/filter_design.txt |    2 +-
>  1 file changed, 1 insertion(+), 1 deletion(-)
> 
> diff --git a/doc/filter_design.txt b/doc/filter_design.txt
> index 4157fd1..7f066c5 100644
> --- a/doc/filter_design.txt
> +++ b/doc/filter_design.txt
> @@ -52,7 +52,7 @@ Frame scheduling
>      They can be called at any time except in a reentrant way.
>  
>      If the input frame is enough to produce output, then the filter should
> -    push the output frames on the output link immediately.
> +    push the output frame on the output link immediately.
>  
>      As an exception to the previous rule, if the input frame is enough to
>      produce several output frames, then the filter needs output only at

The filter can produce either one or several frames, and it must push
it/them.

As a special exception (in the next paragraph), if there are several, it
_can_ push only the first one.

Maybe this:

#      If the input frame is enough to produce one output frame or several,
#      then the filter should push the output frame(s) on the output link
#      immediately.

would be clearer?

Regards,

-- 
  Nicolas George
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 198 bytes
Desc: Digital signature
URL: <http://ffmpeg.org/pipermail/ffmpeg-devel/attachments/20120518/293fe0e6/attachment.asc>