It's been a while since the last bump, so it's time to do some cleaning and remove deprecated APIs. This will also give us an "Open ABI season" in which we can do breaking changes (like changing public struct offsets, public enum values, adding fields to structs that have their size tied to the ABI, etc) for a few weeks.
I'm also taking this opportunity to suggest a change in our deprecation period policy. Until now it's been a generic two years period, with no concrete reason for it other than giving library users "time" to migrate. What we have seen however is that users migrate in two cases: As soon as things are deprecated when they use git head to get rid of deprecation warnings, or when they have no choice (aka, when they want to move their project to a new ffmpeg version that no longer has the symbols they depended on). In the latter case, any arbitrary amount of time will make no difference whatsoever. Projects could right now still be using ffmpeg 4.3 (since that's what Debian stable ships) and would not consider moving to 5.1 or any future version for the foreseeable future. So the suggestion is to change to a release based scheme, which will in some form be time based anyway. Namely, every three releases we do a major bump, which will be a good year or so in real world terms, in which all API deprecated during that period, as long as it's present in a release, is removed. This would also go with the idea of a recurrent LTS release, so if we do three releases per major version, it could be x.0 (initial release) x.1 (LTS), and x.2 (last release made pre bump). If we go the above route, we could also remove API like the old lavu FIFO stuff, a deprecation that's slightly less than a year old but effectively present in v5.1. We'd also need to add all this in writing, because this kind of policy can't just be "oh yeah, we do it that way" in random emails. James Almer (26): avcodec: remove FF_API_OPENH264_SLICE_MODE avcodec: remove FF_API_OPENH264_CABAC avcodec: remove FF_API_UNUSED_CODEC_CAPS avcodec: remove FF_API_THREAD_SAFE_CALLBACKS avcodec: remove FF_API_DEBUG_MV avcodec: remove FF_API_GET_FRAME_CLASS avcodec: remove FF_API_AUTO_THREADS avcodec: remove FF_API_AVCTX_TIMEBASE avcodec: remove FF_API_FLAG_TRUNCATED avcodec: remove FF_API_SUB_TEXT_FORMAT avformat: remove FF_API_LAVF_PRIV_OPT avformat: remove FF_API_AVIOCONTEXT_WRITTEN avformat: remove FF_HLS_TS_OPTIONS avformat: remove FF_API_AVSTREAM_CLASS avfilter: remove FF_API_SWS_PARAM_OPTION avfilter: remove FF_API_BUFFERSINK_ALLOC avfilter: remove FF_API_PAD_COUNT avdevice: remove FF_API_DEVICE_CAPABILITIES avutil: remove FF_API_D2STR avutil: remove FF_API_DECLARE_ALIGNED avutil: remove FF_API_COLORSPACE_NAME avutil: remove FF_API_AV_MALLOCZ_ARRAY avutil/version: postpone the remaining API deprecations avcodec/version: postpone the remaining API deprecations avformat/version: postpone the remaining API deprecations Bump major versions of all libraries doc/APIchanges | 16 +- fftools/ffmpeg.c | 5 - fftools/ffmpeg_mux_init.c | 11 -- fftools/ffprobe.c | 2 +- libavcodec/av1_parser.c | 3 - libavcodec/avcodec.c | 5 - libavcodec/avcodec.h | 61 +------- libavcodec/avs2_parser.c | 4 +- libavcodec/avs3_parser.c | 4 +- libavcodec/codec.h | 20 --- libavcodec/cpia.c | 8 - libavcodec/decode.c | 22 --- libavcodec/encode.c | 7 +- libavcodec/frame_thread_encoder.c | 20 --- libavcodec/h263_parser.c | 11 -- libavcodec/h263_parser.h | 29 ---- libavcodec/h263dec.c | 42 ------ libavcodec/h264_parser.c | 7 +- libavcodec/h264dec.c | 6 - libavcodec/libopenh264enc.c | 22 --- libavcodec/mjpegdec.c | 2 +- libavcodec/mpeg12.c | 66 --------- libavcodec/mpeg12.h | 9 -- libavcodec/mpeg12dec.c | 31 ---- libavcodec/mpeg4video_parser.c | 16 +- libavcodec/mpeg4video_parser.h | 34 ----- libavcodec/mpeg4videodec.c | 6 - libavcodec/mpegvideo.c | 9 -- libavcodec/mpegvideo.h | 7 - libavcodec/mpegvideo_dec.c | 8 - libavcodec/mpegvideo_parser.c | 12 +- libavcodec/options.c | 33 ----- libavcodec/options_table.h | 7 - libavcodec/pthread.c | 3 - libavcodec/pthread_frame.c | 237 +----------------------------- libavcodec/qdmc.c | 1 + libavcodec/thread.h | 12 -- libavcodec/vc1_parser.c | 2 - libavcodec/version.h | 2 +- libavcodec/version_major.h | 24 +-- libavdevice/avdevice.c | 19 --- libavdevice/avdevice.h | 130 ---------------- libavdevice/version.h | 4 +- libavdevice/version_major.h | 3 +- libavfilter/avfilter.c | 21 --- libavfilter/avfilter.h | 10 -- libavfilter/buffersink.c | 22 --- libavfilter/buffersink.h | 36 ----- libavfilter/buffersrc.c | 11 -- libavfilter/version.h | 2 +- libavfilter/version_major.h | 6 +- libavformat/avformat.c | 33 +++-- libavformat/avformat.h | 5 - libavformat/avio.h | 10 -- libavformat/aviobuf.c | 10 -- libavformat/demux.c | 41 +++--- libavformat/hlsenc.c | 3 - libavformat/options.c | 3 - libavformat/version.h | 2 +- libavformat/version_major.h | 12 +- libavutil/avstring.c | 10 -- libavutil/avstring.h | 9 -- libavutil/frame.c | 17 --- libavutil/frame.h | 9 -- libavutil/mem.c | 10 -- libavutil/mem.h | 88 ----------- libavutil/mem_internal.h | 2 - libavutil/tests/avstring.c | 16 -- libavutil/version.h | 20 +-- libpostproc/version.h | 2 +- libpostproc/version_major.h | 2 +- libswscale/version.h | 4 +- libswscale/version_major.h | 2 +- 73 files changed, 103 insertions(+), 1297 deletions(-) delete mode 100644 libavcodec/h263_parser.h delete mode 100644 libavcodec/mpeg4video_parser.h -- 2.39.0 _______________________________________________ ffmpeg-devel mailing list ffmpeg-devel@ffmpeg.org https://ffmpeg.org/mailman/listinfo/ffmpeg-devel To unsubscribe, visit link above, or email ffmpeg-devel-requ...@ffmpeg.org with subject "unsubscribe".
