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

13 files changed, 26 insertions, 0 deletions

diff --git a/src/network/network.cpp b/src/network/network.cpp
index a73337ae6..9d596ae5b 100644
--- a/src/network/network.cpp
+++ b/src/network/network.cpp
@@ -1,5 +1,7 @@
 /* $Id$ */
 
+/** @file network.cpp Base functions for networking support. */
+
 #include "../stdafx.h"
 #include "network_data.h"
 
diff --git a/src/network/network.h b/src/network/network.h
index fbe2a31cc..d3bf3d3e1 100644
--- a/src/network/network.h
+++ b/src/network/network.h
@@ -1,5 +1,7 @@
 /* $Id$ */
 
+/** @file network.h Basic functions/variables used all over the place. */
+
 #ifndef NETWORK_H
 #define NETWORK_H
 
diff --git a/src/network/network_client.cpp b/src/network/network_client.cpp
index 65eb3e31b..02608bc38 100644
--- a/src/network/network_client.cpp
+++ b/src/network/network_client.cpp
@@ -1,5 +1,7 @@
 /* $Id$ */
 
+/** @file network_client.cpp Client part of the network protocol. */
+
 #ifdef ENABLE_NETWORK
 
 #include "../stdafx.h"
diff --git a/src/network/network_client.h b/src/network/network_client.h
index 1778bc8fe..11dd26b93 100644
--- a/src/network/network_client.h
+++ b/src/network/network_client.h
@@ -1,5 +1,7 @@
 /* $Id$ */
 
+/** @file network_client.h Client part of the network protocol. */
+
 #ifndef NETWORK_CLIENT_H
 #define NETWORK_CLIENT_H
 
diff --git a/src/network/network_data.cpp b/src/network/network_data.cpp
index a968b3114..ede255ba9 100644
--- a/src/network/network_data.cpp
+++ b/src/network/network_data.cpp
@@ -1,5 +1,7 @@
 /* $Id$ */
 
+/** @file network_data.cpp Command handling over network connections. */
+
 #ifdef ENABLE_NETWORK
 
 #include "../stdafx.h"
diff --git a/src/network/network_data.h b/src/network/network_data.h
index 2034de5b9..32ed82a8e 100644
--- a/src/network/network_data.h
+++ b/src/network/network_data.h
@@ -1,5 +1,7 @@
 /* $Id$ */
 
+/** @file network_data.h Internal functions. */
+
 #ifndef NETWORK_DATA_H
 #define NETWORK_DATA_H
 
diff --git a/src/network/network_gamelist.h b/src/network/network_gamelist.h
index 83ce10021..31ec69171 100644
--- a/src/network/network_gamelist.h
+++ b/src/network/network_gamelist.h
@@ -1,5 +1,7 @@
 /* $Id$ */
 
+/** @file network_gamelist.h Handling of the list of games. */
+
 #ifndef NETWORK_GAMELIST_H
 #define NETWORK_GAMELIST_H
 
diff --git a/src/network/network_gui.cpp b/src/network/network_gui.cpp
index 36313b5ee..fdfe1f870 100644
--- a/src/network/network_gui.cpp
+++ b/src/network/network_gui.cpp
@@ -1,5 +1,7 @@
 /* $Id$ */
 
+/** @file network_gui.cpp Implementation of the Network related GUIs. */
+
 #ifdef ENABLE_NETWORK
 #include "../stdafx.h"
 #include "../openttd.h"
diff --git a/src/network/network_gui.h b/src/network/network_gui.h
index 34597b4bb..20fb528f8 100644
--- a/src/network/network_gui.h
+++ b/src/network/network_gui.h
@@ -1,5 +1,7 @@
 /* $Id$ */
 
+/** @file network_gui.h GUIs related to networking. */
+
 #ifndef NETWORK_GUI_H
 #define NETWORK_GUI_H
 
diff --git a/src/network/network_internal.h b/src/network/network_internal.h
index f44d36133..753cce206 100644
--- a/src/network/network_internal.h
+++ b/src/network/network_internal.h
@@ -1,5 +1,7 @@
 /* $Id$ */
 
+/** @file network_internal.h Variables and function used internally. */
+
 #ifndef NETWORK_INTERNAL_H
 #define NETWORK_INTERNAL_H
 
diff --git a/src/network/network_server.cpp b/src/network/network_server.cpp
index 51bc76233..e75b2b001 100644
--- a/src/network/network_server.cpp
+++ b/src/network/network_server.cpp
@@ -1,5 +1,7 @@
 /* $Id$ */
 
+/** @file network_server.cpp Server part of the network protocol. */
+
 #ifdef ENABLE_NETWORK
 
 #include "../stdafx.h"
diff --git a/src/network/network_server.h b/src/network/network_server.h
index aea76f33e..07f9cf29a 100644
--- a/src/network/network_server.h
+++ b/src/network/network_server.h
@@ -1,5 +1,7 @@
 /* $Id$ */
 
+/** @file network_server.h Server part of the network protocol. */
+
 #ifndef NETWORK_SERVER_H
 #define NETWORK_SERVER_H
 
diff --git a/src/network/network_udp.h b/src/network/network_udp.h
index f62f3c016..4071ddc0f 100644
--- a/src/network/network_udp.h
+++ b/src/network/network_udp.h
@@ -1,5 +1,7 @@
 /* $Id$ */
 
+/** @file network_udp.h Sending and receiving UDP messages. */
+
 #ifndef NETWORK_UDP_H
 #define NETWORK_UDP_H