diff --git a/src/namegen.h b/src/namegen.h
index 65105f03ce..d10e6f4456 100644
--- a/src/namegen.h
+++ b/src/namegen.h
@@ -1,6 +1,6 @@
 /* $Id$ */
 
-/** @file namegen.h */
+/** @file src/namegen.h Town name generator stuff */
 
 #ifndef NAMEGEN_H
 #define NAMEGEN_H
diff --git a/src/roadveh.h b/src/roadveh.h
index b5d8a1096b..410dab64ec 100644
--- a/src/roadveh.h
+++ b/src/roadveh.h
@@ -1,6 +1,6 @@
 /* $Id$ */
 
-/** @file roadveh.h */
+/** @file src/roadveh.h Road vehicle states */
 
 #ifndef ROADVEH_H
 #define ROADVEH_H
diff --git a/src/table/namegen.h b/src/table/namegen.h
index 99845c8b0f..456b26aa3f 100644
--- a/src/table/namegen.h
+++ b/src/table/namegen.h
@@ -1,5 +1,7 @@
 /* $Id$ */
 
+/** @file table/namegen.h Namepart tables for the town name generator */
+
 #include "../stdafx.h"
 #include "../openttd.h"
 
diff --git a/src/table/roadveh.h b/src/table/roadveh.h
index 46f084e8e2..8f051e876d 100644
--- a/src/table/roadveh.h
+++ b/src/table/roadveh.h
@@ -1,5 +1,7 @@
 /* $Id$ */
 
+/** @file table/roadveh.h Data about how a road vehicle must drive on a tile */
+
 static const RoadDriveEntry _roadveh_drive_data_0[] = {
 	{15, 5},
 	{14, 5},