9 files changed, 19 insertions, 1 deletions
diff --git a/src/ai/ai.cpp b/src/ai/ai.cpp
index 4849cf273..5e7330eb1 100644
--- a/src/ai/ai.cpp
+++ b/src/ai/ai.cpp
@@ -1,5 +1,7 @@
 /* $Id$ */
 
+/** @file ai.cpp Base for all AIs. */
+
 #include "../stdafx.h"
 #include "../openttd.h"
 #include "../variables.h"
diff --git a/src/ai/ai.h b/src/ai/ai.h
index 44c6fe78c..430d6a5e8 100644
--- a/src/ai/ai.h
+++ b/src/ai/ai.h
@@ -1,5 +1,7 @@
 /* $Id$ */
 
+/** @file ai.h Base functions for all AIs. */
+
 #ifndef AI_H
 #define AI_H
 
diff --git a/src/ai/default/default.cpp b/src/ai/default/default.cpp
index 3a2d90c94..db9fcd141 100644
--- a/src/ai/default/default.cpp
+++ b/src/ai/default/default.cpp
@@ -1,5 +1,7 @@
 /* $Id$ */
 
+/** @file default.cpp The original AI. */
+
 #include "../../stdafx.h"
 #include "../../openttd.h"
 #include "../../aircraft.h"
diff --git a/src/ai/default/default.h b/src/ai/default/default.h
index bbe84770f..b0a4163be 100644
--- a/src/ai/default/default.h
+++ b/src/ai/default/default.h
@@ -1,5 +1,7 @@
 /* $Id$ */
 
+/** @file default.h The original AI. */
+
 #ifndef DEFAULT_H
 #define DEFAULT_H
 
diff --git a/src/ai/trolly/build.cpp b/src/ai/trolly/build.cpp
index eb7154092..cbb448dc9 100644
--- a/src/ai/trolly/build.cpp
+++ b/src/ai/trolly/build.cpp
@@ -1,5 +1,7 @@
 /* $Id$ */
 
+/** @file build.cpp Building support for the trolly AI. */
+
 #include "../../stdafx.h"
 #include "../../openttd.h"
 #include "../../debug.h"
diff --git a/src/ai/trolly/pathfinder.cpp b/src/ai/trolly/pathfinder.cpp
index e58c92a27..dbb43fc55 100644
--- a/src/ai/trolly/pathfinder.cpp
+++ b/src/ai/trolly/pathfinder.cpp
@@ -1,5 +1,7 @@
 /* $Id$ */
 
+/** @file pathfinder.cpp Pathfinder support for the trolly AI. */
+
 #include "../../stdafx.h"
 #include "../../openttd.h"
 #include "../../bridge_map.h"
diff --git a/src/ai/trolly/shared.cpp b/src/ai/trolly/shared.cpp
index 7773934d3..9f990b554 100644
--- a/src/ai/trolly/shared.cpp
+++ b/src/ai/trolly/shared.cpp
@@ -1,5 +1,7 @@
 /* $Id$ */
 
+/** @file shared.cpp Shared functions for the trolly AI. */
+
 #include "../../stdafx.h"
 #include "../../openttd.h"
 #include "../../debug.h"
diff --git a/src/ai/trolly/trolly.cpp b/src/ai/trolly/trolly.cpp
index 2a369cd03..9672a9664 100644
--- a/src/ai/trolly/trolly.cpp
+++ b/src/ai/trolly/trolly.cpp
@@ -1,6 +1,8 @@
 /* $Id$ */
 
-/*
+/**
+ * @file trolly.cpp Implementation of the trolly AI.
+ *
  * This AI was created as a direct reaction to the big demand for some good AIs
  * in OTTD. Too bad it never left alpha-stage, and it is considered dead in its
  * current form.
diff --git a/src/ai/trolly/trolly.h b/src/ai/trolly/trolly.h
index 352a62761..c25bcb538 100644
--- a/src/ai/trolly/trolly.h
+++ b/src/ai/trolly/trolly.h
@@ -1,5 +1,7 @@
 /* $Id$ */
 
+/** @file trolly.h Functions/defines related to the trolly AI. */
+
 #ifndef AI_TROLLY_H
 #define AI_TROLLY_H