(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.

11 files changed, 22 insertions, 1 deletions

diff --git a/src/video/cocoa/cocoa_keys.h b/src/video/cocoa/cocoa_keys.h
index 1e69c1425..579cd1f45 100644
--- a/src/video/cocoa/cocoa_keys.h
+++ b/src/video/cocoa/cocoa_keys.h
@@ -1,5 +1,7 @@
 /* $Id$ */
 
+/** @file cocoa_keys.h Mappings of Cocoa keys. */
+
 #ifndef COCOA_KEYS_H
 #define COCOA_KEYS_H
 
diff --git a/src/video/cocoa/cocoa_v.h b/src/video/cocoa/cocoa_v.h
index 10c408f0a..cfc63147d 100644
--- a/src/video/cocoa/cocoa_v.h
+++ b/src/video/cocoa/cocoa_v.h
@@ -1,5 +1,7 @@
 /* $Id$ */
 
+/** @file cocoa_v.h The Cocoa video driver. */
+
 #ifndef VIDEO_COCOA_H
 #define VIDEO_COCOA_H
 
diff --git a/src/video/dedicated_v.cpp b/src/video/dedicated_v.cpp
index 8389d4874..523bb403d 100644
--- a/src/video/dedicated_v.cpp
+++ b/src/video/dedicated_v.cpp
@@ -1,5 +1,7 @@
 /* $Id$ */
 
+/** @file dedicated_v.cpp Dedicated server video 'driver'. */
+
 #include "../stdafx.h"
 
 #ifdef ENABLE_NETWORK
diff --git a/src/video/dedicated_v.h b/src/video/dedicated_v.h
index 434a3c041..731b7a723 100644
--- a/src/video/dedicated_v.h
+++ b/src/video/dedicated_v.h
@@ -1,5 +1,7 @@
 /* $Id$ */
 
+/** @file dedicated_v.h Base for the dedicated video driver. */
+
 #ifndef VIDEO_DEDICATED_H
 #define VIDEO_DEDICATED_H
 
diff --git a/src/video/null_v.cpp b/src/video/null_v.cpp
index cc488af11..f8258950d 100644
--- a/src/video/null_v.cpp
+++ b/src/video/null_v.cpp
@@ -1,5 +1,7 @@
 /* $Id$ */
 
+/** @file null_v.cpp The videio driver that doesn't blit. */
+
 #include "../stdafx.h"
 #include "../openttd.h"
 #include "../gfx_func.h"
diff --git a/src/video/null_v.h b/src/video/null_v.h
index e32a88536..c45a5a46c 100644
--- a/src/video/null_v.h
+++ b/src/video/null_v.h
@@ -1,5 +1,7 @@
 /* $Id$ */
 
+/** @file null_v.h Base of the video driver that doesn't blit. */
+
 #ifndef VIDEO_NULL_H
 #define VIDEO_NULL_H
 
diff --git a/src/video/sdl_v.cpp b/src/video/sdl_v.cpp
index de9bbbfa4..a9a13411c 100644
--- a/src/video/sdl_v.cpp
+++ b/src/video/sdl_v.cpp
@@ -1,9 +1,10 @@
 /* $Id$ */
 
-#include "../stdafx.h"
+/** @file sdl_v.cpp Implementation of the SDL video driver. */
 
 #ifdef WITH_SDL
 
+#include "../stdafx.h"
 #include "../openttd.h"
 #include "../debug.h"
 #include "../gfx_func.h"
diff --git a/src/video/sdl_v.h b/src/video/sdl_v.h
index ab56f99c3..5b7758e26 100644
--- a/src/video/sdl_v.h
+++ b/src/video/sdl_v.h
@@ -1,5 +1,7 @@
 /* $Id$ */
 
+/** @file sdl_v.h Base of the SDL video driver. */
+
 #ifndef VIDEO_SDL_H
 #define VIDEO_SDL_H
 
diff --git a/src/video/video_driver.hpp b/src/video/video_driver.hpp
index 2cd81154e..7a165ec17 100644
--- a/src/video/video_driver.hpp
+++ b/src/video/video_driver.hpp
@@ -1,5 +1,7 @@
 /* $Id$ */
 
+/** @file video_driver.hpp Base of all video drivers. */
+
 #ifndef VIDEO_VIDEO_DRIVER_HPP
 #define VIDEO_VIDEO_DRIVER_HPP
 
diff --git a/src/video/win32_v.cpp b/src/video/win32_v.cpp
index eb78408f4..35d698455 100644
--- a/src/video/win32_v.cpp
+++ b/src/video/win32_v.cpp
@@ -1,5 +1,7 @@
 /* $Id$ */
 
+/** @file win32_v.cpp Implementation of the Windows (GDI) video driver. */
+
 #include "../stdafx.h"
 #include "../openttd.h"
 #include "../gfx_func.h"
diff --git a/src/video/win32_v.h b/src/video/win32_v.h
index 223772d75..4f001dff6 100644
--- a/src/video/win32_v.h
+++ b/src/video/win32_v.h
@@ -1,5 +1,7 @@
 /* $Id$ */
 
+/** @file win32_v.h Base of the Windows video driver. */
+
 #ifndef VIDEO_WIN32_H
 #define VIDEO_WIN32_H