<div>Recently migrated fom 2.3 to 3.0 .<br /><br />Can't say that that was extreemly easy, but there is a clearly defined way:</div><div>- read static assertions after compiling</div><div>- see comments over the deprecated funtions<br /><br />for my usage of libavcodec + swscale it helped . But there was some old ugly hack for swscale, and some bugs with broken video appeared during the testing (thank god it was automated). So I had to remove this hack and use swscale simply by the api.<br /><br />So: static assertions and comments solve the problem of migrating, it was even <span>more convenient then some pdf or html document, because I could use the redirection of IDE. </span>But it <span data-align="0:16">left feeling, that I probably missed something and don't even know it.</span></div><div> </div><div>Looks like for such a big project to make <span>comprehensive </span>documentation is a quite a big task.</div><div> </div><div>-- </div><div>С уважением,</div><div>Слободенюк Александр Игоревич</div><div> </div><div>контактный телефон: +7-925-050-64-62</div><div> </div><div> </div><div> </div><div>19.06.2016, 01:44, "salsaman" <salsaman@gmail.com>:</div><blockquote type="cite"><div><br /><div><div>On Sat, Jun 18, 2016 at 4:40 PM, Ben Woods <span><<a href="mailto:woodsb02@gmail.com" target="_blank">woodsb02@gmail.com</a>></span> wrote:<br /><blockquote style="margin:0px 0px 0px 0.8ex;border-left:1px solid #cccccc;padding-left:1ex;"><div><span>On 18 June 2016 at 17:23, salsaman <span><<a href="mailto:salsaman@gmail.com" target="_blank">salsaman@gmail.com</a>></span> wrote:<br /></span><div><div><blockquote style="margin:0px 0px 0px 0.8ex;border-left:1px solid #cccccc;padding-left:1ex;"><div><div><div><div>Creating a migration guide is standard practice when changing the major version of a well used library API. <br />Is there really no documentation anywhere ? That seems to defeat the purpose of providing a usable library.<br /><br /></div>Code examples only provide solutions for specific implementation details.<br /><br /><br /></div>Regards,</div>Salsaman.</div></blockquote><div> </div><div>I second that. FreeBSD is still going through the motions of trying to update numerous open source software packages to use the newest API. And there are plenty which have not yet done it themselves, and therefore require manual patching. We use patches from Linux distributions when they are available, but some are not and we work it out from examples.<br /><br /></div><div>I believe that a good API documentation should not just explain what is available in each version, but what has changed since the last version and the recommended alternative.<br /><br /></div><div>Regards,</div><div>Ben </div></div></div></div></blockquote><div><br /><br /></div><div>For reference, here is an example of what I consider to be good migration documentation:<br /><br /><br /></div><div><a href="https://developer.gnome.org/gtk3/stable/gtk-migrating-2-to-3.html">https://developer.gnome.org/gtk3/stable/gtk-migrating-2-to-3.html</a><br /><br /><br /><br /></div><div>Gabriel.<br /><br /></div><div><br /><br /><a href="http://lives-video.com/" target="_blank">http://lives-video.com</a><br /><a href="https://www.openhub.net/accounts/salsaman" target="_blank">https://www.openhub.net/accounts/salsaman</a><br /><br /><br /><br /><br /></div></div></div></div>,<p>_______________________________________________<br />Libav-user mailing list<br /><a href="mailto:Libav-user@ffmpeg.org">Libav-user@ffmpeg.org</a><br /><a href="http://ffmpeg.org/mailman/listinfo/libav-user">http://ffmpeg.org/mailman/listinfo/libav-user</a></p></blockquote>