[FFmpeg-devel] [PATCH 00/26] Major library version bump

[James Almer <jamrial@gmail.com>]

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-request@ffmpeg.org with subject "unsubscribe".