[FFmpeg-devel] [PATCH] avcodec.h: document needed buffer size for av_get_codec_tag_string()

Reimar Döffinger Reimar.Doeffinger at gmx.de
Sun Dec 21 22:45:24 CET 2014

On 21.12.2014, at 00:10, Nicolas George <george at nsup.org> wrote:
> Le primidi 1er nivôse, an CCXXIII, Thomas Volkert a écrit :
>> If the code is changed, the documentation should be changed as well.
> That will not update applications written with the documentation for the old
> version but built with the new version. Or applications using shared
> libraries.
> Documentation must tell how an API should be used, not how it works.

Either way, in order to allow even better source compatibility, a define would be preferable over purely documentation.
Binary compatibility we can handle via a major bump in the worst case, but if everyone has to manually change their code manually it gets messy.

More information about the ffmpeg-devel mailing list