From 9c7f09322ef91a7fa565e23898467d5cd9aafe7e Mon Sep 17 00:00:00 2001 From: peter1138 Date: Thu, 9 Mar 2006 20:37:51 +0000 Subject: [PATCH] (svn r3805) - [FS#62] Fix doxygen comments to refer to the correct parameter. (sulai) --- ai/ai.h | 14 +++++++------- industry_cmd.c | 6 +++--- network.h | 4 ++-- oldloader.c | 10 +++++----- openttd.h | 8 ++++---- order.h | 4 ++-- pool.h | 16 ++++++++-------- vehicle.c | 2 +- vehicle.h | 12 ++++++------ 9 files changed, 38 insertions(+), 38 deletions(-) diff --git a/ai/ai.h b/ai/ai.h index 90527f2df7..dd036fea1a 100644 --- a/ai/ai.h +++ b/ai/ai.h @@ -20,20 +20,20 @@ typedef struct AICommand { /* The struct for an AIScript Player */ typedef struct AIPlayer { - bool active; //! Is this AI active? - AICommand *queue; //! The commands that he has in his queue - AICommand *queue_tail; //! The tail of this queue + bool active; ///< Is this AI active? + AICommand *queue; ///< The commands that he has in his queue + AICommand *queue_tail; ///< The tail of this queue } AIPlayer; /* The struct to keep some data about the AI in general */ typedef struct AIStruct { /* General */ - bool enabled; //! Is AI enabled? - uint tick; //! The current tick (something like _frame_counter, only for AIs) + bool enabled; ///< Is AI enabled? + uint tick; ///< The current tick (something like _frame_counter, only for AIs) /* For network-clients (a OpenTTD client who acts as an AI connected to a server) */ - bool network_client; //! Are we a network_client? - uint8 network_playas; //! The current network player we are connected as + bool network_client; ///< Are we a network_client? + uint8 network_playas; ///< The current network player we are connected as } AIStruct; VARDEF AIStruct _ai; diff --git a/industry_cmd.c b/industry_cmd.c index c949d23605..daa23e65c7 100644 --- a/industry_cmd.c +++ b/industry_cmd.c @@ -90,9 +90,9 @@ typedef struct IndustrySpec { #include "table/build_industry.h" typedef enum IndustryType { - INDUSTRY_NOT_CLOSABLE, //! Industry can never close - INDUSTRY_PRODUCTION, //! Industry can close and change of production - INDUSTRY_CLOSABLE, //! Industry can only close (no production change) + INDUSTRY_NOT_CLOSABLE, ///< Industry can never close + INDUSTRY_PRODUCTION, ///< Industry can close and change of production + INDUSTRY_CLOSABLE, ///< Industry can only close (no production change) } IndustryType; diff --git a/network.h b/network.h index afa17adf36..867d2bb3f6 100644 --- a/network.h +++ b/network.h @@ -170,8 +170,8 @@ VARDEF char _network_server_name[NETWORK_NAME_LENGTH]; VARDEF char _network_server_password[NETWORK_PASSWORD_LENGTH]; VARDEF char _network_rcon_password[NETWORK_PASSWORD_LENGTH]; -VARDEF uint16 _network_max_join_time; //! Time a client can max take to join -VARDEF bool _network_pause_on_join; //! Pause the game when a client tries to join (more chance of succeeding join) +VARDEF uint16 _network_max_join_time; ///< Time a client can max take to join +VARDEF bool _network_pause_on_join; ///< Pause the game when a client tries to join (more chance of succeeding join) VARDEF uint16 _redirect_console_to_client; diff --git a/oldloader.c b/oldloader.c index 76fb79de9b..b786f321c7 100644 --- a/oldloader.c +++ b/oldloader.c @@ -44,12 +44,12 @@ typedef struct LoadgameState { typedef bool OldChunkProc(LoadgameState *ls, int num); typedef struct OldChunks { - uint32 type; //! Type of field - uint32 amount; //! Amount of fields + uint32 type; ///< Type of field + uint32 amount; ///< Amount of fields - void *ptr; //! Pointer where to save the data (may only be set if offset is 0) - uint offset; //! Offset from basepointer (may only be set if ptr is NULL) - OldChunkProc *proc; //! Pointer to function that is called with OC_CHUNK + void *ptr; ///< Pointer where to save the data (may only be set if offset is 0) + uint offset; ///< Offset from basepointer (may only be set if ptr is NULL) + OldChunkProc *proc; ///< Pointer to function that is called with OC_CHUNK } OldChunks; /* OldChunk-Type */ diff --git a/openttd.h b/openttd.h index 8fb3d9f4c5..335902340a 100644 --- a/openttd.h +++ b/openttd.h @@ -65,11 +65,11 @@ typedef byte PlayerID; typedef byte OrderID; typedef byte CargoID; typedef uint16 StringID; -typedef uint32 SpriteID; //! The number of a sprite, without mapping bits and colortables -typedef uint32 PalSpriteID; //! The number of a sprite plus all the mapping bits and colortables +typedef uint32 SpriteID; ///< The number of a sprite, without mapping bits and colortables +typedef uint32 PalSpriteID; ///< The number of a sprite plus all the mapping bits and colortables typedef uint32 CursorID; -typedef uint16 EngineID; //! All enginenumbers should be of this type -typedef uint16 UnitID; //! All unitnumber stuff is of this type (or anyway, should be) +typedef uint16 EngineID; ///< All enginenumbers should be of this type +typedef uint16 UnitID; ///< All unitnumber stuff is of this type (or anyway, should be) typedef uint32 WindowNumber; typedef byte WindowClass; diff --git a/order.h b/order.h index cce9e4d802..dd387161be 100644 --- a/order.h +++ b/order.h @@ -80,9 +80,9 @@ typedef struct Order { uint8 flags; uint16 station; - struct Order *next; //! Pointer to next order. If NULL, end of list + struct Order *next; ///< Pointer to next order. If NULL, end of list - uint16 index; //! Index of the order, is not saved or anything, just for reference + uint16 index; ///< Index of the order, is not saved or anything, just for reference } Order; #define MAX_BACKUP_ORDER_COUNT 40 diff --git a/pool.h b/pool.h index 1994a441d7..179ec7dc8e 100644 --- a/pool.h +++ b/pool.h @@ -14,19 +14,19 @@ typedef void MemoryPoolNewBlock(uint start_item); * please try to avoid manual calls! */ struct MemoryPool { - const char name[10]; //! Name of the pool (just for debugging) + const char name[10]; ///< Name of the pool (just for debugging) - const uint max_blocks; //! The max amount of blocks this pool can have - const uint block_size_bits; //! The size of each block in bits - const uint item_size; //! How many bytes one block is + const uint max_blocks; ///< The max amount of blocks this pool can have + const uint block_size_bits; ///< The size of each block in bits + const uint item_size; ///< How many bytes one block is + /// Pointer to a function that is called after a new block is added MemoryPoolNewBlock *new_block_proc; - //!< Pointer to a function that is called after a new block is added - uint current_blocks; //! How many blocks we have in our pool - uint total_items; //! How many items we now have in this pool + uint current_blocks; ///< How many blocks we have in our pool + uint total_items; ///< How many items we now have in this pool - byte **blocks; //! An array of blocks (one block hold all the items) + byte **blocks; ///< An array of blocks (one block hold all the items) }; /** diff --git a/vehicle.c b/vehicle.c index 6fddacc61f..4492fe4082 100644 --- a/vehicle.c +++ b/vehicle.c @@ -64,7 +64,7 @@ enum { VEHICLES_POOL_BLOCK_SIZE_BITS = 9, /* In bits, so (1 << 9) == 512 */ VEHICLES_POOL_MAX_BLOCKS = 125, - BLOCKS_FOR_SPECIAL_VEHICLES = 2, //! Blocks needed for special vehicles + BLOCKS_FOR_SPECIAL_VEHICLES = 2, ///< Blocks needed for special vehicles }; /** diff --git a/vehicle.h b/vehicle.h index b6ea2b3a0d..71e5c8c417 100644 --- a/vehicle.h +++ b/vehicle.h @@ -185,14 +185,14 @@ struct Vehicle { byte tick_counter;// increased by one for each tick /* Begin Order-stuff */ - Order current_order; //! The current order (+ status, like: loading) - OrderID cur_order_index; //! The index to the current order + Order current_order; ///< The current order (+ status, like: loading) + OrderID cur_order_index; ///< The index to the current order - Order *orders; //! Pointer to the first order for this vehicle - OrderID num_orders; //! How many orders there are in the list + Order *orders; ///< Pointer to the first order for this vehicle + OrderID num_orders; ///< How many orders there are in the list - Vehicle *next_shared; //! If not NULL, this points to the next vehicle that shared the order - Vehicle *prev_shared; //! If not NULL, this points to the prev vehicle that shared the order + Vehicle *next_shared; ///< If not NULL, this points to the next vehicle that shared the order + Vehicle *prev_shared; ///< If not NULL, this points to the prev vehicle that shared the order /* End Order-stuff */ // Boundaries for the current position in the world and a next hash link.