(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/music/bemidi.cpp

@@ -1,6 +1,6 @@
 /* $Id$ */
 
-/** @file bemidi.cpp */
+/** @file bemidi.cpp Support for BeOS midi. */
 
 #include "../stdafx.h"
 #include "../openttd.h"

src/music/bemidi.h

@@ -1,5 +1,7 @@
 /* $Id$ */
 
+/** @file bemidi.h Base of BeOS Midi support. */
+
 #ifndef MUSIC_BEMIDI_H
 #define MUSIC_BEMIDI_H
 

src/music/dmusic.cpp

@@ -1,6 +1,6 @@
 /* $Id$ */
 
-/** @file dmusic.cpp */
+/** @file dmusic.cpp Playing music via DirectMusic. */
 
 #ifdef WIN32_ENABLE_DIRECTMUSIC_SUPPORT
 

src/music/dmusic.h

@@ -1,5 +1,7 @@
 /* $Id$ */
 
+/** @file dmusic.h Base of playing music via DirectMusic.
+
 #ifndef MUSIC_DMUSIC_H
 #define MUSIC_DMUSIC_H
 

src/music/extmidi.cpp

@@ -1,5 +1,7 @@
 /* $Id$ */
 
+/** @file extmidi.cpp Playing music via an external player. */
+
 #ifndef __MORPHOS__
 #include "../stdafx.h"
 #include "../openttd.h"

src/music/extmidi.h

@@ -1,5 +1,7 @@
 /* $Id$ */
 
+/** @file extmidi.h Base support for playing music via an external application. */
+
 #ifndef MUSIC_EXTERNAL_H
 #define MUSIC_EXTERNAL_H
 

src/music/libtimidity.cpp

@@ -1,5 +1,7 @@
 /* $Id$ */
 
+/** @file libtimidity.cpp Playing music via the timidity library. */
+
 #include "../stdafx.h"
 #include "../openttd.h"
 #include "../sound_type.h"

src/music/libtimidity.h

@@ -1,5 +1,7 @@
 /* $Id$ */
 
+/** @file libtimidity.h Base for LibTimidity music playback. */
+
 #ifndef MUSIC_LIBTIMIDITY_H
 #define MUSIC_LIBTIMIDITY_H
 

src/music/music_driver.hpp

@@ -1,5 +1,7 @@
 /* $Id$ */
 
+/** @file music_driver.hpp Base for all music playback. */
+
 #ifndef MUSIC_MUSIC_DRIVER_HPP
 #define MUSIC_MUSIC_DRIVER_HPP
 

src/music/null_m.cpp

@@ -1,5 +1,7 @@
 /* $Id$ */
 
+/** @file null_m.cpp The music playback that is silent. */
+
 #include "../stdafx.h"
 #include "null_m.h"
 

src/music/null_m.h

@@ -1,5 +1,7 @@
 /* $Id$ */
 
+/** @file null_m.h Base for the silent music playback. */
+
 #ifndef MUSIC_NULL_H
 #define MUSIC_NULL_H
 

src/music/os2_m.cpp

@@ -1,5 +1,7 @@
 /* $Id$ */
 
+/** @file os2_m.cpp Music playback on OS/2. */
+
 #include "../stdafx.h"
 #include "../openttd.h"
 #include "os2_m.h"

src/music/os2_m.h

@@ -1,5 +1,7 @@
 /* $Id$ */
 
+/** @file os2_m.h Base for OS2 music playback. */
+
 #ifndef MUSIC_OS2_H
 #define MUSIC_OS2_H
 

src/music/qtmidi.h

@@ -1,5 +1,7 @@
 /* $Id$ */
 
+/** @file qtmidi.h Base of music playback via the QuickTime driver. */
+
 #ifndef MUSIC_MACOSX_QUICKTIME_H
 #define MUSIC_MACOSX_QUICKTIME_H
 

src/music/win32_m.cpp

@@ -1,5 +1,7 @@
 /* $Id$ */
 
+/** @file win32_m.cpp Music playback for Windows. */
+
 #include "../stdafx.h"
 #include "win32_m.h"
 #include <windows.h>

src/music/win32_m.h

@@ -1,5 +1,7 @@
 /* $Id$ */
 
+/** @file win32_m.h Base for Windows music playback. */
+
 #ifndef MUSIC_WIN32_H
 #define MUSIC_WIN32_H