On Thu, 16 May 2013 12:59:42 +0200, Diego Biurrun <[email protected]> wrote: > On 05/16/2013 09:17 AM, Anton Khirnov wrote: > > On Wed, 15 May 2013 23:15:24 +0200, Diego Biurrun <[email protected]> wrote: > >> On 05/14/2013 09:37 AM, Anton Khirnov wrote: > >>> --- a/libavfilter/avfilter.h > >>> +++ b/libavfilter/avfilter.h > >>> @@ -427,29 +448,71 @@ typedef struct AVFilter { > >>> > >>> /** > >>> + * Filter initialization function. > >>> + * > >>> + * This callback will be called only once during the filter > >>> lifetime, after > >> > >> Let's increase literary value via s/called/invoked/. > > > > I think the documentation should be above all easy to understand. Invoke is > > a > > much more obscure word than call, some non-native readers might have > > problems > > with it. Also 'call a function' is a standard term, so i'd go with that. > > Documentation in simple English? :) I don't think that's our target > audience. Anyway, I don't care. >
Not necessarily simple english, but we shouldn't go out of our way to use fancy words when not needed. -- Anton Khirnov _______________________________________________ libav-devel mailing list [email protected] https://lists.libav.org/mailman/listinfo/libav-devel
