diff --git a/libavformat/avformat.h b/libavformat/avformat.h
index 51dbca3b1f..e13d853453 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);
 
 /**