av_freep() recommandition

git-svn-id: file:///var/local/repositories/ffmpeg/trunk@4809 9553f0bf-9b14-0410-a0b8-cfaf0461ba5b

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 */