# HG changeset patch
# User ivo
# Date 1201558161 0
# Node ID 4df11ac927fcf0eb8524cc00d483bba32cfbf9db
# Parent  7b82d835bed1026e2ae3ca68c67a617eb4d64528
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.

diff -r 7b82d835bed1 -r 4df11ac927fc DOCS/tech/codec-devel.txt
--- 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
 ------------
diff -r 7b82d835bed1 -r 4df11ac927fc DOCS/tech/libmpcodecs.txt
--- 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
 ==================================
diff -r 7b82d835bed1 -r 4df11ac927fc libmpcodecs/vd.c
--- 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
 };
 
diff -r 7b82d835bed1 -r 4df11ac927fc libmpcodecs/ve.c
--- 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
 };
 
diff -r 7b82d835bed1 -r 4df11ac927fc libmpdemux/demuxer.c
--- 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
 };