Merge remote-tracking branch 'qatar/release/0.8' into release/0.10
[ffmpeg.git] / doc / RELEASE_NOTES
1 Release Notes
2 =============
3
4 * 0.10 "Freedom"  January, 2012
5
6
7 General notes
8 -------------
9 This release is binary compatible with 0.8 and 0.9.
10
11 See the Changelog file for a list of significant changes. Note, there
12 are many more new features and bugfixes than whats listed there.
13
14 Bugreports against FFmpeg git master or the most recent FFmpeg release are
15 accepted. If you are experiencing issues with any formally released version of
16 FFmpeg, please try git master to check if the issue still exists. If it does,
17 make your report against the development code following the usual bug reporting
18 guidelines.
19
20
21 API changes
22 -----------
23
24 A number of additional APIs have been introduced and some existing
25 functions have been deprecated and are scheduled for removal in the next
26 release. Significant API changes include:
27
28 * new audio decoding API which decodes from an AVPacket to an AVFrame and
29 is able to use AVCodecContext.get_buffer() in the similar way as video decoding.
30
31 * new audio encoding API which encodes from an AVFrame to an AVPacket, thus
32 allowing it to properly output timing information and side data.
33
34 Please see the git history and the file doc/APIchanges for details.
35
36
37 Other notable changes
38 ---------------------
39
40 Libavcodec and libavformat built as shared libraries now hide non-public
41 symbols. This will break applications using those symbols. Possible solutions
42 are, in order of preference:
43 1) Try finding a way of accomplishing the same with public API.
44 2) If there is no corresponding public API, but you think there should be,
45 post a request on the developer mailing list or IRC channel.
46 3) Finally if your program needs access to FFmpeg / libavcodec / libavformat
47 internals for some special reason then the best solution is to link statically.
48
49 Please see the Changelog file and git history for a more detailed list of changes.