5 files changed, 11 insertions, 1 deletions
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