changeset 25880:4df11ac927fc

clarify comments/docs about lav* being the preferred place to implement new codecs and (de)muxers, except for wrappers around external libraries and codecs and (de)muxers requiring binary support.
author ivo
date Mon, 28 Jan 2008 22:09:21 +0000
parents 7b82d835bed1
children c6f535c5f65b
files DOCS/tech/codec-devel.txt DOCS/tech/libmpcodecs.txt libmpcodecs/vd.c libmpcodecs/ve.c libmpdemux/demuxer.c
diffstat 5 files changed, 18 insertions(+), 10 deletions(-) [+]
line wrap: on
line diff
--- a/DOCS/tech/codec-devel.txt	Mon Jan 28 18:29:26 2008 +0000
+++ b/DOCS/tech/codec-devel.txt	Mon Jan 28 22:09:21 2008 +0000
@@ -4,8 +4,9 @@
 
 SEE ALSO: libmpcodecs.txt !!!
 
-NOTE: If you want to implement a new codec, please add it to libavcodec.
-libmpcodecs is considered deprecated.
+NOTE: If you want to implement a new native codec, please add it to
+libavcodec. libmpcodecs is considered mostly deprecated, except for wrappers
+around external libraries and codecs requiring binary support.
 
 Introduction
 ------------
--- a/DOCS/tech/libmpcodecs.txt	Mon Jan 28 18:29:26 2008 +0000
+++ b/DOCS/tech/libmpcodecs.txt	Mon Jan 28 22:09:21 2008 +0000
@@ -1,5 +1,6 @@
-NOTE: If you want to implement a new decoder, please add it to libavcodec.
-libmpcodecs is considered deprecated.
+NOTE: If you want to implement a new native codec, please add it to
+libavcodec. libmpcodecs is considered mostly deprecated, except for wrappers
+around external libraries and codecs requiring binary support.
 
 The libMPcodecs API details, hints - by A'rpi
 ==================================
--- a/libmpcodecs/vd.c	Mon Jan 28 18:29:26 2008 +0000
+++ b/libmpcodecs/vd.c	Mon Jan 28 22:09:21 2008 +0000
@@ -50,7 +50,8 @@
 extern vd_functions_t mpcodecs_vd_qtvideo;
 
 /* Please do not add any new decoders here. If you want to implement a new
- * decoder, add it to libavcodec */
+ * decoder, add it to libavcodec, except for wrappers around external
+ * libraries and decoders requiring binary support. */
 
 vd_functions_t* mpcodecs_vd_drivers[] = {
         &mpcodecs_vd_null,
@@ -101,7 +102,8 @@
 	&mpcodecs_vd_qtvideo,
 #endif
     /* Please do not add any new decoders here. If you want to implement a new
-     * decoder, add it to libavcodec */
+     * decoder, add it to libavcodec, except for wrappers around external
+     * libraries and decoders requiring binary support. */
 	NULL
 };
 
--- a/libmpcodecs/ve.c	Mon Jan 28 18:29:26 2008 +0000
+++ b/libmpcodecs/ve.c	Mon Jan 28 22:09:21 2008 +0000
@@ -19,7 +19,8 @@
 extern vf_info_t ve_info_x264;
 
 /* Please do not add any new encoders here. If you want to implement a new
- * encoder, add it to libavcodec */
+ * encoder, add it to libavcodec, except for wrappers around external
+ * libraries and encoders requiring binary support. */
 
 static vf_info_t* encoder_list[]={
 #ifdef USE_LIBAVCODEC
@@ -45,7 +46,8 @@
     &ve_info_x264,
 #endif
     /* Please do not add any new encoders here. If you want to implement a new
-     * encoder, add it to libavcodec */
+     * encoder, add it to libavcodec, except for wrappers around external
+     * libraries and encoders requiring binary support. */
     NULL
 };
 
--- a/libmpdemux/demuxer.c	Mon Jan 28 18:29:26 2008 +0000
+++ b/libmpdemux/demuxer.c	Mon Jan 28 22:09:21 2008 +0000
@@ -75,7 +75,8 @@
 extern const demuxer_desc_t demuxer_desc_nut;
 
 /* Please do not add any new demuxers here. If you want to implement a new
- * demuxer, add it to libavformat */
+ * demuxer, add it to libavformat, except for wrappers around external
+ * libraries and demuxers requiring binary support. */
 
 const demuxer_desc_t* const demuxer_list[] = {
   &demuxer_desc_rawaudio,
@@ -145,7 +146,8 @@
   &demuxer_desc_xmms,
 #endif
   /* Please do not add any new demuxers here. If you want to implement a new
-   * demuxer, add it to libavformat */
+   * demuxer, add it to libavformat, except for wrappers around external
+   * libraries and demuxers requiring binary support. */
   NULL
 };