diff --git a/libavformat/avformat.h b/libavformat/avformat.h
index 51dbca3b1f4cd2252dbbde0e8edf84fa6505d9f2..e13d853453ba594102ee7dacdf603220883b4d8a 100644
--- a/libavformat/avformat.h
+++ b/libavformat/avformat.h
@@ -56,7 +56,11 @@ void av_destruct_packet_nofree(AVPacket *pkt);
  */
 void av_destruct_packet(AVPacket *pkt);
 
-/* initialize optional fields of a packet */
+/**
+ * Initialize optional fields of a packet to default values.
+ *
+ * @param pkt packet
+ */
 void av_init_packet(AVPacket *pkt);
 
 /**