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

[Reimar Döffinger]

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.