On Tue, Mar 05, 2013 at 09:11:41AM +0100, Anton Khirnov wrote: > On Mon, 04 Mar 2013 23:17:09 +0100, Diego Biurrun <[email protected]> wrote: > > On Mon, Mar 04, 2013 at 11:35:05AM +0100, Anton Khirnov wrote: > > > +/** > > > + * Allocate an AVBuffer of the given size using av_malloc(). > > > + * > > > + * @return an AVBufferRef of given size or NULL when out of memory > > > + */ > > > +AVBufferRef *av_buffer_alloc(int size); > > > + > > > +/** > > > + * Same as av_buffer_alloc(), except the returned buffer will be > > > initialized > > > + * to zero. > > > + */ > > > +AVBufferRef *av_buffer_allocz(int size); > > > > Please document the parameters. > > They are already documented. > I fail to see any advantage in adding one more tautological line
It allows automatic extraction of parameter documentation. It allows IDE-like tools to show documentation for parameters, etc... Diego _______________________________________________ libav-devel mailing list [email protected] https://lists.libav.org/mailman/listinfo/libav-devel
