(svn r8857) -Documentation: Added some doxygen @file tags, repaired others (the @file tag MUST be found before any line of code, that includes preprocessor directives).

src/aircraft.h

@@ -1,6 +1,6 @@
 /* $Id$ */
 
-/** @file aircraft_cmd.h */
+/** @file aircraft.h */
 
 #ifndef AIRCRAFT_H
 #define AIRCRAFT_H

src/network/core/config.h

@@ -1,14 +1,14 @@
 /* $Id$ */
 
+/**
+ * @file config.h Configuration options of the network stuff
+ */
+
 #ifndef NETWORK_CORE_CONFIG_H
 #define NETWORK_CORE_CONFIG_H
 
 #ifdef ENABLE_NETWORK
 
-/**
- * @file config.h Configuration options of the network stuff
- */
-
 /** DNS hostname of the masterserver */
 #define NETWORK_MASTER_SERVER_HOST "master.openttd.org"
 /** Message sent to the masterserver to 'identify' this client as OpenTTD */

src/network/core/core.cpp

@@ -1,5 +1,9 @@
 /* $Id$ */
 
+/**
+ * @file core.cpp Functions used to initialize/shut down the core network
+ */
+
 #ifdef ENABLE_NETWORK
 
 #include "../../stdafx.h"
@@ -8,10 +12,6 @@
 #include "core.h"
 #include "packet.h"
 
-/**
- * @file core.cpp Functions used to initialize/shut down the core network
- */
-
 #ifdef __MORPHOS__
 /* the library base is required here */
 struct Library *SocketBase = NULL;

src/network/core/core.h

@@ -1,5 +1,9 @@
 /* $Id$ */
 
+/**
+ * @file core.h Base for all network types (UDP and TCP)
+ */
+
 #ifndef NETWORK_CORE_H
 #define NETWORK_CORE_H
 
@@ -8,10 +12,6 @@
 #include "os_abstraction.h"
 #include "../../newgrf_config.h"
 
-/**
- * @file core.h Base for all network types (UDP and TCP)
- */
-
 bool NetworkCoreInitialize(void);
 void NetworkCoreShutdown(void);
 

src/network/core/game.h

@@ -1,5 +1,10 @@
 /* $Id$ */
 
+/**
+ * @file game.h Information about a game that is sent between a
+ *              game server, game client and masterserver.
+ */
+
 #ifndef NETWORK_CORE_GAME_H
 #define NETWORK_CORE_GAME_H
 
@@ -9,11 +14,6 @@
 #include "../../date.h"
 #include "../../newgrf_config.h"
 
-/**
- * @file game.h Information about a game that is sent between a
- *              game server, game client and masterserver.
- */
-
 /**
  * This is the struct used by both client and server
  * some fields will be empty on the client (like game_password) by default

src/network/core/os_abstraction.h

@@ -1,14 +1,14 @@
 /* $Id$ */
 
-#ifndef NETWORK_CORE_OS_ABSTRACTION_H
-#define NETWORK_CORE_OS_ABSTRACTION_H
-
 /**
  * @file os_abstraction.h Network stuff has many things that needs to be
  *                        included and/or implemented by default.
  *                        All those things are in this file.
  */
 
+#ifndef NETWORK_CORE_OS_ABSTRACTION_H
+#define NETWORK_CORE_OS_ABSTRACTION_H
+
 /* Include standard stuff per OS */
 
 #ifdef ENABLE_NETWORK

src/network/core/packet.cpp

@@ -1,5 +1,9 @@
 /* $Id$ */
 
+/**
+ * @file packet.cpp Basic functions to create, fill and read packets.
+ */
+
 #ifdef ENABLE_NETWORK
 
 #include "../../stdafx.h"
@@ -9,10 +13,6 @@
 
 #include "packet.h"
 
-/**
- * @file packet.cpp Basic functions to create, fill and read packets.
- */
-
 
 /* Do not want to include functions.h and all required headers */
 extern void NORETURN CDECL error(const char *str, ...);

src/network/core/packet.h

@@ -1,5 +1,9 @@
 /* $Id$ */
 
+/**
+ * @file packet.h Basic functions to create, fill and read packets.
+ */
+
 #ifndef NETWORK_CORE_PACKET_H
 #define NETWORK_CORE_PACKET_H
 
@@ -8,10 +12,6 @@
 #include "config.h"
 #include "core.h"
 
-/**
- * @file packet.h Basic functions to create, fill and read packets.
- */
-
 typedef uint16 PacketSize; ///< Size of the whole packet.
 typedef uint8  PacketType; ///< Identifier for the packet
 

src/network/core/tcp.cpp

@@ -1,5 +1,9 @@
 /* $Id$ */
 
+/**
+ * @file tcp.cpp Basic functions to receive and send TCP packets.
+ */
+
 #ifdef ENABLE_NETWORK
 
 #include "../../stdafx.h"
@@ -14,10 +18,6 @@
 #include "tcp.h"
 #include "../../helpers.hpp"
 
-/**
- * @file tcp.cpp Basic functions to receive and send TCP packets.
- */
-
 /** Very ugly temporary hack !!! */
 void NetworkTCPSocketHandler::Initialize()
 {

src/network/core/tcp.h

@@ -1,5 +1,9 @@
 /* $Id$ */
 
+/**
+ * @file tcp.h Basic functions to receive and send TCP packets.
+ */
+
 #ifndef NETWORK_CORE_TCP_H
 #define NETWORK_CORE_TCP_H
 
@@ -9,10 +13,6 @@
 #include "core.h"
 #include "packet.h"
 
-/**
- * @file tcp.h Basic functions to receive and send TCP packets.
- */
-
 /**
  * Enum with all types of UDP packets.
  * The order of the first 4 packets MUST not be changed, as

src/network/core/udp.cpp

@@ -1,5 +1,9 @@
 /* $Id$ */
 
+/**
+ * @file core/udp.cpp Basic functions to receive and send UDP packets.
+ */
+
 #ifdef ENABLE_NETWORK
 
 #include "../../stdafx.h"
@@ -9,10 +13,6 @@
 #include "packet.h"
 #include "udp.h"
 
-/**
- * @file core/udp.cpp Basic functions to receive and send UDP packets.
- */
-
 /**
  * Start listening on the given host and port.
  * @param host      the host (ip) to listen on

src/network/core/udp.h

@@ -1,16 +1,5 @@
 /* $Id$ */
 
-#ifndef NETWORK_CORE_UDP_H
-#define NETWORK_CORE_UDP_H
-
-#ifdef ENABLE_NETWORK
-
-#include "os_abstraction.h"
-#include "core.h"
-#include "game.h"
-#include "packet.h"
-#include "../../debug.h"
-
 /**
  * @file udp.h Basic functions to receive and send UDP packets.
  *
@@ -72,6 +61,17 @@
  *   1+       1       whether the server is dedicated (0 = no, 1 = yes)
  */
 
+#ifndef NETWORK_CORE_UDP_H
+#define NETWORK_CORE_UDP_H
+
+#ifdef ENABLE_NETWORK
+
+#include "os_abstraction.h"
+#include "core.h"
+#include "game.h"
+#include "packet.h"
+#include "../../debug.h"
+
 /** Enum with all types of UDP packets. The order MUST not be changed **/
 enum PacketUDPType {
 	PACKET_UDP_CLIENT_FIND_SERVER,   ///< Queries a game server for game information

src/network/network_gamelist.cpp

@@ -1,5 +1,10 @@
 /* $Id$ */
 
+/**
+ * @file network_gamelist.cpp This file handles the GameList
+ * Also, it handles the request to a server for data about the server
+ */
+
 #ifdef ENABLE_NETWORK
 
 #include "../stdafx.h"
@@ -11,11 +16,6 @@
 #include "network_gamelist.h"
 #include "network_gui.h"
 
-/**
- * @file network_gamelist.cpp This file handles the GameList
- * Also, it handles the request to a server for data about the server
- */
-
 NetworkGameList *_network_game_list = NULL;
 
 /** Should we stop/contiue requerying of offline servers? */

src/network/network_udp.cpp

@@ -1,5 +1,12 @@
 /* $Id$ */
 
+/**
+ * @file network_udp.cpp This file handles the UDP related communication.
+ *
+ * This is the GameServer <-> MasterServer and GameServer <-> GameClient
+ * communication before the game is being joined.
+ */
+
 #ifdef ENABLE_NETWORK
 
 #include "../stdafx.h"
@@ -15,13 +22,6 @@
 
 #include "core/udp.h"
 
-/**
- * @file network_udp.c This file handles the UDP related communication.
- *
- * This is the GameServer <-> MasterServer and GameServer <-> GameClient
- * communication before the game is being joined.
- */
-
 enum {
 	ADVERTISE_NORMAL_INTERVAL = 30000, // interval between advertising in ticks (15 minutes)
 	ADVERTISE_RETRY_INTERVAL  =   300, // readvertise when no response after this many ticks (9 seconds)

src/station.cpp

@@ -1,6 +1,6 @@
 /* $Id$ */
 
-/** @file station_cmd.cpp */
+/** @file station.cpp */
 
 #include "stdafx.h"
 #include "openttd.h"

src/yapf/follow_track.hpp

@@ -1,5 +1,7 @@
 /* $Id$ */
 
+/** @file follow_track.hpp Template function for track followers */
+
 #ifndef  FOLLOW_TRACK_HPP
 #define  FOLLOW_TRACK_HPP
 

src/yapf/nodelist.hpp

@@ -1,5 +1,7 @@
 /* $Id$ */
 
+/** @file nodelist.hpp */
+
 #ifndef  NODELIST_HPP
 #define  NODELIST_HPP
 

src/yapf/yapf.h

@@ -1,5 +1,7 @@
 /* $Id$ */
 
+/** @file yapf.h */
+
 #ifndef  YAPF_H
 #define  YAPF_H
 

src/yapf/yapf_base.hpp

@@ -1,5 +1,7 @@
 /* $Id$ */
 
+/** @file yapf_base.hpp */
+
 #ifndef  YAPF_BASE_HPP
 #define  YAPF_BASE_HPP
 

src/yapf/yapf_common.hpp

@@ -1,5 +1,7 @@
 /* $Id$ */
 
+/** @file yapf_common.hpp */
+
 #ifndef  YAPF_COMMON_HPP
 #define  YAPF_COMMON_HPP
 

src/yapf/yapf_costcache.hpp

@@ -1,4 +1,7 @@
 /* $Id$ */
+
+/** @file yapf_costcache.hpp */
+
 #ifndef  YAPF_COSTCACHE_HPP
 #define  YAPF_COSTCACHE_HPP
 

src/yapf/yapf_costrail.hpp

@@ -1,5 +1,7 @@
 /* $Id$ */
 
+/** @file yapf_costrail.hpp */
+
 #ifndef  YAPF_COSTRAIL_HPP
 #define  YAPF_COSTRAIL_HPP
 

src/yapf/yapf_destrail.hpp

@@ -1,5 +1,7 @@
 /* $Id$ */
 
+/** @file yapf_destrail.hpp */
+
 #ifndef  YAPF_DESTRAIL_HPP
 #define  YAPF_DESTRAIL_HPP
 

src/yapf/yapf_node.hpp

@@ -1,5 +1,7 @@
 /* $Id$ */
 
+/** @file yapf_node.hpp */
+
 #ifndef  YAPF_NODE_HPP
 #define  YAPF_NODE_HPP
 

src/yapf/yapf_node_rail.hpp

@@ -1,5 +1,7 @@
 /* $Id$ */
 
+/** @file yapf_node_rail.hpp */
+
 #ifndef  YAPF_NODE_RAIL_HPP
 #define  YAPF_NODE_RAIL_HPP
 

src/yapf/yapf_node_road.hpp

@@ -1,5 +1,7 @@
 /* $Id$ */
 
+/** @file yapf_node_road.hpp */
+
 #ifndef  YAPF_NODE_ROAD_HPP
 #define  YAPF_NODE_ROAD_HPP
 

src/yapf/yapf_rail.cpp

@@ -1,5 +1,7 @@
 /* $Id$ */
 
+/** @file yapf_rail.cpp */
+
 #include "../stdafx.h"
 
 #include "yapf.hpp"

src/yapf/yapf_road.cpp

@@ -1,5 +1,7 @@
 /* $Id$ */
 
+/** @file yapf_road.cpp */
+
 #include "../stdafx.h"
 
 #include "yapf.hpp"

src/yapf/yapf_settings.h

@@ -1,4 +1,7 @@
 /* $Id$ */
+
+/** @file yapf_settings.h */
+
 #if !defined(YAPF_SETTINGS_H) || defined(YS_DEF)
 
 # ifndef  YAPF_SETTINGS_H

src/yapf/yapf_ship.cpp

@@ -1,5 +1,7 @@
 /* $Id$ */
 
+/** @file yapf_ship.cpp */
+
 #include "../stdafx.h"
 
 #include "yapf.hpp"