av_freep() recommandition

Originally committed as revision 4809 to svn://svn.ffmpeg.org/ffmpeg/trunk

libavcodec/mem.c

@@ -117,7 +117,11 @@ void *av_realloc(void *ptr, unsigned int size)
 #endif
 }
 
-/* NOTE: ptr = NULL is explicetly allowed */
+/**
+ * Free memory which has been allocated with av_malloc(z)() or av_realloc().
+ * NOTE: ptr = NULL is explicetly allowed 
+ * Note2: it is recommanded that you use av_freep() instead
+ */
 void av_free(void *ptr)
 {
     /* XXX: this test should not be needed on most libcs */