[FFmpeg-devel] [PATCH] doc/APIchanges: attempt to split releases

[wm4]

On Sun, 14 Sep 2014 08:56:02 +0200
Clément Bœsch <u at pkh.me> wrote:

> Based on several git show origin/release/X.Y:doc/APIchanges.
> ---
>  doc/APIchanges | 42 +++++++++++++++++++++++++++++++++++++-----
>  1 file changed, 37 insertions(+), 5 deletions(-)
> 
> diff --git a/doc/APIchanges b/doc/APIchanges
> index 1a0ba78..eaac107 100644
> --- a/doc/APIchanges
> +++ b/doc/APIchanges
> @@ -15,6 +15,9 @@ libavutil:     2014-08-09
>  
>  API changes, most recent first:
>  
> +
> +-------- 8< --------- FFmpeg 2.4 was cut here -------- 8< ---------
> +
>  2014-08-xx - xxxxxxx - lavc 56.1.0 - avcodec.h
>    Add AV_PKT_DATA_STEREO3D to export container-level stereo3d information.
>  
> @@ -102,7 +105,6 @@ API changes, most recent first:
>    Typically, this means you will do 'AVProbeData pd = { 0 };' instead of
>    'AVProbeData pd;'.
>  
> -
>  2014-07-29 - 31e0b5d / 69e7336 - lavu 52.92.100 / 53.19.0 - avstring.h
>    Make name matching function from lavf public as av_match_name().
>  
> @@ -119,6 +121,9 @@ API changes, most recent first:
>  2014-07-23 - 8a4c086 - lavf 55.49.100 - avio.h
>    Add avio_read_to_bprint()
>  
> +
> +-------- 8< --------- FFmpeg 2.3 was cut here -------- 8< ---------
> +
>  2014-07-14 - 62227a7 - lavf 55.47.100 - avformat.h
>    Add av_stream_get_parser()
>  
> @@ -292,6 +297,9 @@ API changes, most recent first:
>    Give the name AVPacketSideData to the previously anonymous struct used for
>    AVPacket.side_data.
>  
> +
> +-------- 8< --------- FFmpeg 2.2 was cut here -------- 8< ---------
> +
>  2014-03-18 - 37c07d4 - lsws 2.5.102
>    Make gray16 full-scale.
>  
> @@ -434,6 +442,9 @@ API changes, most recent first:
>  2013-10-31 - 78265fc / 28096e0 - lavu 52.49.100 / 52.17.0 - frame.h
>    Add AVFrame.flags and AV_FRAME_FLAG_CORRUPT.
>  
> +
> +-------- 8< --------- FFmpeg 2.1 was cut here -------- 8< ---------
> +
>  2013-10-27 - dbe6f9f - lavc 55.39.100 - avcodec.h
>    Add CODEC_CAP_DELAY support to avcodec_decode_subtitle2.
>  
> @@ -506,6 +517,9 @@ API changes, most recent first:
>    Add avcodec_chroma_pos_to_enum()
>    Add avcodec_enum_to_chroma_pos()
>  
> +
> +-------- 8< --------- FFmpeg 2.0 was cut here -------- 8< ---------
> +
>  2013-07-03 - 838bd73 - lavfi 3.78.100 - avfilter.h
>    Deprecate avfilter_graph_parse() in favor of the equivalent
>    avfilter_graph_parse_ptr().
> @@ -578,6 +592,9 @@ API changes, most recent first:
>  2013-03-17 - 7aa9af5 - lavu 52.20.100 - opt.h
>    Add AV_OPT_TYPE_VIDEO_RATE value to AVOptionType enum.
>  
> +
> +-------- 8< --------- FFmpeg 1.2 was cut here -------- 8< ---------
> +
>  2013-03-07 - 9767ec6 - lavu 52.18.100 - avstring.h,bprint.h
>    Add av_escape() and av_bprint_escape() API.
>  
> @@ -590,6 +607,9 @@ API changes, most recent first:
>  2013-01-01 - 2eb2e17 - lavfi 3.34.100
>    Add avfilter_get_audio_buffer_ref_from_arrays_channels.
>  
> +
> +-------- 8< --------- FFmpeg 1.1 was cut here -------- 8< ---------
> +
>  2012-12-20 - 34de47aa - lavfi 3.29.100 - avfilter.h
>    Add AVFilterLink.channels, avfilter_link_get_channels()
>    and avfilter_ref_get_channels().
> @@ -635,6 +655,9 @@ API changes, most recent first:
>    Add LIBSWRESAMPLE_VERSION, LIBSWRESAMPLE_BUILD
>    and LIBSWRESAMPLE_IDENT symbols.
>  
> +
> +-------- 8< --------- FFmpeg 1.0 was cut here -------- 8< ---------
> +
>  2012-09-06 - 29e972f - lavu 51.72.100 - parseutils.h
>    Add av_small_strptime() time parsing function.
>  
> @@ -1053,6 +1076,9 @@ lavd 54.4.100 / 54.0.0, lavfi 3.5.0
>  2012-01-12 - b18e17e / 3167dc9 - lavfi 2.59.100 / 2.15.0
>    Add a new installed header -- libavfilter/version.h -- with version macros.
>  
> +
> +-------- 8< --------- FFmpeg 0.9 was cut here -------- 8< ---------
> +
>  2011-12-08 - a502939 - lavfi 2.52.0
>    Add av_buffersink_poll_frame() to buffersink.h.
>  
> @@ -1262,6 +1288,13 @@ lavd 54.4.100 / 54.0.0, lavfi 3.5.0
>  2011-06-28 - 5129336 - lavu 51.11.0 - avutil.h
>    Define the AV_PICTURE_TYPE_NONE value in AVPictureType enum.
>  
> +
> +-------- 8< --------- FFmpeg 0.7 was cut here -------- 8< ---------
> +
> +
> +
> +-------- 8< --------- FFmpeg 0.8 was cut here -------- 8< ---------
> +
>  2011-06-19 - fd2c0a5 - lavfi 2.23.0 - avfilter.h
>    Add layout negotiation fields and helper functions.
>  
> @@ -1939,6 +1972,9 @@ lavd 54.4.100 / 54.0.0, lavfi 3.5.0
>  2010-06-02 - 7e566bb - lavc 52.73.0 - av_get_codec_tag_string()
>    Add av_get_codec_tag_string().
>  
> +
> +-------- 8< --------- FFmpeg 0.6 was cut here -------- 8< ---------
> +
>  2010-06-01 - 2b99142 - lsws 0.11.0 - convertPalette API
>    Add sws_convertPalette8ToPacked32() and sws_convertPalette8ToPacked24().
>  
> @@ -1956,10 +1992,6 @@ lavd 54.4.100 / 54.0.0, lavfi 3.5.0
>  2010-05-09 - b6bc205 - lavfi 1.20.0 - AVFilterPicRef
>    Add interlaced and top_field_first fields to AVFilterPicRef.
>  
> -------------------------------8<-------------------------------------
> -                   0.6 branch was cut here
> ------------------------------>8--------------------------------------
> -
>  2010-05-01 - 8e2ee18 - lavf 52.62.0 - probe function
>    Add av_probe_input_format2 to API, it allows ignoring probe
>    results below given score and returns the actual probe score.

+++++++++++++++++++1

This is extremely useful, because the lib version numbers have no
relation to release numbers. Libav already did this, and I was wondering
why FFmpeg didn't.

Looks good - I didn't attempt to verify the version numbers though.