[PATCH] Document internal API updating policy.

Stefano Sabatini stefano.sabatini-lala
Sun May 16 19:53:22 CEST 2010


---
 doc/developer.texi |   12 ++++++++++++
 1 files changed, 12 insertions(+), 0 deletions(-)

diff --git a/doc/developer.texi b/doc/developer.texi
index edce7ea..7ce799f 100644
--- a/doc/developer.texi
+++ b/doc/developer.texi
@@ -221,6 +221,18 @@ should also be avoided if they don't make the code easier to understand.
     existing data structure).
     Incrementing the third component means a noteworthy binary compatible
     change (e.g. encoder bug fix that matters for the decoder).
+    When a new public symbol is added the minor version must be
+    bumped. If a symbol of the internal API is added the minor version
+    must be bumped.
+    Public API symbols or internal API symbols used by other FFmpeg
+    libraries cannot be changed unless major bumps, so in case of renames
+    or if a function signature referenced by such a symbol is changed, the
+    old symbol must continue to exist in the library.
+    When a dependency between two libraries is added (e.g. libavformat
+    starts to use a symbol of the internal or public API defined in
+    libavcodec) the micro number of the library must be bumped.
+    The last rule should help to track and document the internal
+    dependancies between the FFmpeg libraries.
 @item
     Compiler warnings indicate potential bugs or code with bad style. If a type of
     warning always points to correct and clean code, that warning should
-- 
1.7.0


--DocE+STaALJfprDB--



More information about the ffmpeg-devel mailing list