diff --git a/doc/examples/muxing.c b/doc/examples/muxing.c
index a849e0abc6..9483607611 100644
--- a/doc/examples/muxing.c
+++ b/doc/examples/muxing.c
@@ -24,8 +24,8 @@
  * @file
  * libavformat API example.
  *
- * Output a media file in any supported libavformat format.
- * The default codecs are used.
+ * Output a media file in any supported libavformat format. The default
+ * codecs are used.
  * @example doc/examples/muxing.c
  */
 
diff --git a/doc/examples/transcode_aac.c b/doc/examples/transcode_aac.c
index 35deb4c03e..2d4e55a2d3 100644
--- a/doc/examples/transcode_aac.c
+++ b/doc/examples/transcode_aac.c
@@ -17,7 +17,10 @@
  */
 
 /**
- * @file simple audio converter
+ * @file
+ * simple audio converter
+ *
+ * @example doc/examples/transcode_aac.c
  * Convert an input audio file to AAC in an MP4 container using FFmpeg.
  * @author Andreas Unterweger (dustsigns@gmail.com)
  */