summaryrefslogtreecommitdiff
path: root/doc/developer.texi
diff options
context:
space:
mode:
authorStefano Sabatini <stefasab@gmail.com>2013-07-05 10:22:03 +0200
committerStefano Sabatini <stefasab@gmail.com>2013-07-11 00:01:19 +0200
commite7a6962e7650e3c105b8658788c7a3ee9f5f1f2b (patch)
tree1ef8c4f2cb2db1a3f5c9b5735f7e60e4cc8e0a7e /doc/developer.texi
parentdb4e191d8897162b9dfc5c0eab49a2d443f01a55 (diff)
downloadffmpeg-e7a6962e7650e3c105b8658788c7a3ee9f5f1f2b.tar.gz
doc/developer: update sections about external development
Replace the sections "API" and "Integrating libavcodec or libavformat" with updated / more accurate text. See thread: Subject: [FFmpeg-devel] [PATCH] doc/developer: merge and update sections about external development Date: Fri, 5 Jul 2013 11:07:07 +0200
Diffstat (limited to 'doc/developer.texi')
-rw-r--r--doc/developer.texi40
1 files changed, 17 insertions, 23 deletions
diff --git a/doc/developer.texi b/doc/developer.texi
index 5972d87bfa..af7e7de551 100644
--- a/doc/developer.texi
+++ b/doc/developer.texi
@@ -11,29 +11,23 @@
@chapter Developers Guide
-@section API
-@itemize @bullet
-@item libavcodec is the library containing the codecs (both encoding and
-decoding). Look at @file{doc/examples/decoding_encoding.c} to see how to use
-it.
-
-@item libavformat is the library containing the file format handling (mux and
-demux code for several formats). Look at @file{ffplay.c} to use it in a
-player. See @file{doc/examples/muxing.c} to use it to generate audio or video
-streams.
-
-@end itemize
-
-@section Integrating libavcodec or libavformat in your program
-
-You can integrate all the source code of the libraries to link them
-statically to avoid any version problem. All you need is to provide a
-'config.mak' and a 'config.h' in the parent directory. See the defines
-generated by ./configure to understand what is needed.
-
-You can use libavcodec or libavformat in your commercial program, but
-@emph{any patch you make must be published}. The best way to proceed is
-to send your patches to the FFmpeg mailing list.
+@section Notes for external developers
+
+This document is mostly useful for internal FFmpeg developers.
+External developers who need to use the API in their application should
+refer to the API doxygen documentation in the public headers, and
+check the examples in @file{doc/examples} and in the source code to
+see how the public API is employed.
+
+You can use the FFmpeg libraries in your commercial program, but you
+are encouraged to @emph{publish any patch you make}. In this case the
+best way to proceed is to send your patches to the ffmpeg-devel
+mailing list following the guidelines illustrated in the remainder of
+this document.
+
+For more detailed legal information about the use of FFmpeg in
+external programs read the @file{LICENSE} file in the source tree and
+consult @url{http://ffmpeg.org/legal.html}.
@section Contributing