diff --git a/BUGS b/BUGS
index 6b08ba4ca..57a538438 100644
--- a/BUGS
+++ b/BUGS
@@ -44,3 +44,6 @@ transform attachments to links so you will not be bloating anyones mail
 box.  Please keep attachments to less than 100KB.
 
  */
+/** @file
+This file contains the @ref bugs page.
+*/
diff --git a/PATCHES b/PATCHES
index 361a15913..95eb500a8 100644
--- a/PATCHES
+++ b/PATCHES
@@ -1,4 +1,4 @@
-/** @page patchguide OpenOCD Patch Policies
+/** @page patchguide Patch Policies
 
 Please mail patches to:
 
@@ -46,3 +46,6 @@ If you have a decent SVN GUI, then that should be
 able to create and apply patches as well...
  
  */
+/** @file
+This file contains the @ref patchguide page.
+*/
diff --git a/TODO b/TODO
index f6acf7e34..7b5b83232 100644
--- a/TODO
+++ b/TODO
@@ -148,3 +148,6 @@ Feel free to send patches to add or clarify items on this list, too.
   - use bug tracking?  we need something!
 
 */
+/** @file
+This file contains the @ref thelist page.
+*/