diff --git a/doc/examples/output.c b/doc/examples/output.c
index 06fdf509aceb32654a0e6c4410e08385c994d8e8..3be85dec9a3c545fabc2505e96a44c4c8eea5d35 100644
--- a/doc/examples/output.c
+++ b/doc/examples/output.c
@@ -25,8 +25,8 @@
  * libavformat API example.
  *
  * @example doc/examples/output.c
- * 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.
  */
 
 #include <stdlib.h>
diff --git a/doc/examples/transcode_aac.c b/doc/examples/transcode_aac.c
index 46f61d8c80f631f2b7509f7f6a8af8f9682c3a90..07f7fe765ee8ac325938f03ab8b73605eb78713f 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 Libav.
  * @author Andreas Unterweger (dustsigns@gmail.com)
  */