(svn r12971) -Documentation: add @file in files that missed them and add something more than whitespace as description of files that don't have a description.

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"

src/ai/ai.h

@@ -1,5 +1,7 @@
 /* $Id$ */
 
+/** @file ai.h Base functions for all AIs. */
+
 #ifndef AI_H
 #define AI_H
 

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"

src/ai/default/default.h

@@ -1,5 +1,7 @@
 /* $Id$ */
 
+/** @file default.h The original AI. */
+
 #ifndef DEFAULT_H
 #define DEFAULT_H
 

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"

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"

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"

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.

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