From d03994098be29bd48f3b715c533ffac3b1315eb0 Mon Sep 17 00:00:00 2001 From: rubidium Date: Tue, 6 May 2008 15:11:33 +0000 Subject: [PATCH] (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. --- Doxyfile | 2 +- src/ai/ai.cpp | 2 + src/ai/ai.h | 2 + src/ai/default/default.cpp | 2 + src/ai/default/default.h | 2 + src/ai/trolly/build.cpp | 2 + src/ai/trolly/pathfinder.cpp | 2 + src/ai/trolly/shared.cpp | 2 + src/ai/trolly/trolly.cpp | 4 +- src/ai/trolly/trolly.h | 2 + src/aircraft.h | 2 +- src/aircraft_gui.cpp | 2 +- src/airport.cpp | 2 +- src/airport_gui.cpp | 2 +- src/animated_tile_func.h | 2 +- src/articulated_vehicles.cpp | 2 +- src/articulated_vehicles.h | 2 +- src/autoreplace_gui.cpp | 2 +- src/autoslope.h | 2 +- src/aystar.cpp | 2 +- src/blitter/32bpp_anim.cpp | 2 + src/blitter/32bpp_anim.hpp | 2 +- src/blitter/32bpp_base.cpp | 2 + src/blitter/32bpp_base.hpp | 2 +- src/blitter/32bpp_optimized.cpp | 2 + src/blitter/32bpp_optimized.hpp | 2 +- src/blitter/32bpp_simple.cpp | 2 + src/blitter/32bpp_simple.hpp | 2 +- src/blitter/8bpp_base.cpp | 2 + src/blitter/8bpp_base.hpp | 2 +- src/blitter/8bpp_debug.cpp | 2 +- src/blitter/8bpp_debug.hpp | 2 +- src/blitter/8bpp_optimized.cpp | 2 +- src/blitter/8bpp_optimized.hpp | 2 +- src/blitter/8bpp_simple.cpp | 2 +- src/blitter/8bpp_simple.hpp | 2 +- src/blitter/base.hpp | 2 + src/blitter/factory.hpp | 2 + src/blitter/null.hpp | 2 +- src/bmp.cpp | 2 +- src/bmp.h | 2 +- src/build_vehicle_gui.cpp | 2 +- src/callback_table.cpp | 2 +- src/callback_table.h | 2 +- src/cargopacket.h | 2 +- src/cargotype.cpp | 2 +- src/cargotype.h | 2 +- src/cheat.cpp | 2 +- src/cheat_gui.cpp | 2 +- src/clear_cmd.cpp | 2 +- src/cmd_helper.h | 2 + src/command.cpp | 2 +- src/console.cpp | 2 +- src/console.h | 2 +- src/console_cmds.cpp | 2 +- src/core/alloc_func.cpp | 2 +- src/core/alloc_type.hpp | 1 - src/core/bitmath_func.cpp | 2 +- src/core/bitmath_func.hpp | 2 +- src/core/endian_func.hpp | 2 +- src/core/random_func.cpp | 2 +- src/core/random_func.hpp | 2 +- src/currency.cpp | 2 +- src/currency.h | 2 +- src/date.cpp | 2 +- src/debug.cpp | 2 +- src/debug.h | 2 +- src/dedicated.cpp | 2 +- src/depot.cpp | 2 +- src/depot_base.h | 2 +- src/depot_gui.cpp | 2 +- src/dock_gui.cpp | 2 +- src/driver.cpp | 2 +- src/driver.h | 2 +- src/dummy_land.cpp | 2 +- src/economy.cpp | 2 +- src/effectvehicle.cpp | 2 +- src/effectvehicle_func.h | 2 +- src/elrail.cpp | 1 + src/engine.cpp | 2 +- src/engine_func.h | 2 +- src/engine_gui.cpp | 2 +- src/fiber.hpp | 2 +- src/fontcache.cpp | 2 +- src/fontcache.h | 2 + src/functions.h | 2 +- src/genworld.cpp | 2 +- src/genworld.h | 2 +- src/genworld_gui.cpp | 2 +- src/gfx.cpp | 2 +- src/gfxinit.cpp | 2 +- src/gfxinit.h | 2 +- src/graph_gui.cpp | 2 +- src/group.h | 2 +- src/group_gui.cpp | 2 +- src/gui.h | 2 +- src/heightmap.cpp | 2 +- src/heightmap.h | 2 +- src/helpers.cpp | 2 +- src/industry.h | 2 +- src/industry_cmd.cpp | 2 +- src/industry_gui.cpp | 2 +- src/intro_gui.cpp | 2 +- src/landscape.cpp | 2 + src/landscape.h | 2 +- src/livery.h | 2 +- src/main_gui.cpp | 2 +- src/map.cpp | 2 +- src/map_func.h | 2 +- src/md5.cpp | 2 +- src/md5.h | 2 +- src/minilzo.cpp | 67 +++++++++++++++--------------- src/minilzo.h | 68 +++++++++++++++---------------- src/misc.cpp | 2 +- src/misc/array.hpp | 2 +- src/misc/binaryheap.hpp | 2 +- src/misc/blob.hpp | 2 +- src/misc/countedobj.cpp | 2 + src/misc/crc32.hpp | 2 +- src/misc/dbg_helpers.cpp | 3 +- src/misc/dbg_helpers.h | 2 +- src/misc/fixedsizearray.hpp | 2 +- src/misc/hashtable.hpp | 2 +- src/misc/smallvec.h | 2 +- src/misc/str.hpp | 2 +- src/misc/strapi.hpp | 2 +- src/misc_cmd.cpp | 2 +- src/misc_gui.cpp | 2 +- src/mixer.cpp | 2 +- src/mixer.h | 2 +- src/music.cpp | 2 +- src/music.h | 2 +- src/music/bemidi.cpp | 2 +- src/music/bemidi.h | 2 + src/music/dmusic.cpp | 2 +- src/music/dmusic.h | 2 + src/music/extmidi.cpp | 2 + src/music/extmidi.h | 2 + src/music/libtimidity.cpp | 2 + src/music/libtimidity.h | 2 + src/music/music_driver.hpp | 2 + src/music/null_m.cpp | 2 + src/music/null_m.h | 2 + src/music/os2_m.cpp | 2 + src/music/os2_m.h | 2 + src/music/qtmidi.h | 2 + src/music/win32_m.cpp | 2 + src/music/win32_m.h | 2 + src/music_gui.cpp | 2 +- src/namegen.cpp | 2 +- src/namegen_func.h | 2 +- src/network/network.cpp | 2 + src/network/network.h | 2 + src/network/network_client.cpp | 2 + src/network/network_client.h | 2 + src/network/network_data.cpp | 2 + src/network/network_data.h | 2 + src/network/network_gamelist.h | 2 + src/network/network_gui.cpp | 2 + src/network/network_gui.h | 2 + src/network/network_internal.h | 2 + src/network/network_server.cpp | 2 + src/network/network_server.h | 2 + src/network/network_udp.h | 2 + src/newgrf.cpp | 2 +- src/newgrf.h | 2 +- src/newgrf_callbacks.h | 4 +- src/newgrf_canal.cpp | 2 + src/newgrf_canal.h | 2 + src/newgrf_cargo.cpp | 2 + src/newgrf_cargo.h | 2 +- src/newgrf_config.cpp | 2 +- src/newgrf_config.h | 2 +- src/newgrf_engine.cpp | 2 +- src/newgrf_engine.h | 2 +- src/newgrf_generic.cpp | 2 + src/newgrf_generic.h | 2 + src/newgrf_gui.cpp | 2 +- src/newgrf_house.cpp | 2 +- src/newgrf_house.h | 2 +- src/newgrf_industries.cpp | 2 +- src/newgrf_industries.h | 2 +- src/newgrf_industrytiles.cpp | 2 +- src/newgrf_industrytiles.h | 2 +- src/newgrf_sound.cpp | 2 +- src/newgrf_sound.h | 2 +- src/newgrf_spritegroup.cpp | 2 +- src/newgrf_spritegroup.h | 2 +- src/newgrf_town.cpp | 2 +- src/newgrf_town.h | 2 +- src/newgrf_townname.h | 9 ++-- src/news_gui.cpp | 1 + src/npf.cpp | 2 +- src/npf.h | 2 +- src/oldloader.cpp | 2 +- src/oldpool.cpp | 2 +- src/oldpool.h | 2 +- src/oldpool_func.h | 3 ++ src/openttd.cpp | 2 +- src/openttd.h | 2 +- src/order_base.h | 2 +- src/order_cmd.cpp | 2 +- src/order_gui.cpp | 2 +- src/os/macosx/G5_detector.cpp | 2 + src/os/macosx/macos.h | 2 + src/os/macosx/osx_stdafx.h | 2 + src/os/macosx/splash.cpp | 2 + src/os/macosx/splash.h | 2 + src/os2.cpp | 2 +- src/os_timer.cpp | 2 +- src/pathfind.cpp | 2 +- src/pathfind.h | 2 +- src/player_gui.cpp | 2 +- src/players.cpp | 4 +- src/queue.cpp | 2 +- src/queue.h | 2 +- src/rail.cpp | 2 +- src/rail.h | 2 +- src/rail_cmd.cpp | 2 +- src/road.cpp | 2 + src/road_cmd.cpp | 2 +- src/road_cmd.h | 2 +- src/road_gui.cpp | 2 +- src/road_map.cpp | 2 +- src/road_map.h | 2 +- src/roadveh_cmd.cpp | 2 +- src/roadveh_gui.cpp | 2 +- src/saveload.h | 2 +- src/screenshot.cpp | 2 + src/screenshot.h | 2 +- src/sdl.cpp | 2 +- src/sdl.h | 2 +- src/settings_gui.cpp | 2 +- src/ship.h | 2 +- src/ship_cmd.cpp | 2 +- src/ship_gui.cpp | 2 +- src/signs.cpp | 2 +- src/signs_gui.cpp | 2 +- src/smallmap_gui.cpp | 2 +- src/sound.cpp | 2 +- src/sound/cocoa_s.cpp | 2 + src/sound/cocoa_s.h | 2 + src/sound/null_s.cpp | 2 + src/sound/null_s.h | 2 + src/sound/sdl_s.cpp | 2 + src/sound/sdl_s.h | 2 + src/sound/sound_driver.hpp | 2 + src/sound/win32_s.cpp | 2 + src/sound/win32_s.h | 2 + src/sprite.h | 2 +- src/spritecache.cpp | 2 +- src/spritecache.h | 2 +- src/spriteloader/grf.cpp | 2 +- src/spriteloader/grf.hpp | 2 +- src/spriteloader/png.cpp | 2 +- src/spriteloader/png.hpp | 2 +- src/spriteloader/spriteloader.hpp | 2 +- src/station.cpp | 2 +- src/station_cmd.cpp | 2 +- src/station_gui.cpp | 2 +- src/station_map.h | 2 +- src/statusbar_gui.cpp | 2 +- src/stdafx.h | 2 +- src/strgen/strgen.cpp | 2 + src/string.cpp | 2 +- src/strings.cpp | 2 +- src/subsidy_gui.cpp | 2 +- src/table/ai_rail.h | 2 + src/table/autorail.h | 2 + src/table/build_industry.h | 2 +- src/table/cargo_const.h | 2 +- src/table/clear_land.h | 2 + src/table/control_codes.h | 9 ++-- src/table/elrail_data.h | 1 + src/table/engines.h | 6 +-- src/table/files.h | 2 + src/table/genland.h | 2 + src/table/industry_land.h | 2 +- src/table/landscape_sprite.h | 2 + src/table/palettes.h | 2 + src/table/road_land.h | 2 + src/table/sprites.h | 6 +-- src/table/station_land.h | 2 + src/table/town_land.h | 3 +- src/table/track_land.h | 2 + src/table/train_cmd.h | 2 + src/table/tree_land.h | 2 + src/table/unicode.h | 1 + src/table/unmovable_land.h | 1 + src/table/water_land.h | 2 + src/terraform_gui.cpp | 2 +- src/texteff.cpp | 2 +- src/texteff.hpp | 2 + src/tgp.h | 2 +- src/thread.h | 2 +- src/tile_map.cpp | 2 +- src/timetable.h | 2 +- src/timetable_cmd.cpp | 2 +- src/timetable_gui.cpp | 2 +- src/town.h | 2 +- src/town_cmd.cpp | 2 +- src/town_gui.cpp | 2 +- src/train.h | 2 +- src/train_cmd.cpp | 2 +- src/train_gui.cpp | 2 +- src/transparency.h | 2 +- src/transparency_gui.cpp | 2 + src/transparency_gui.h | 2 + src/tree_cmd.cpp | 2 +- src/tree_map.h | 2 +- src/tunnel_map.cpp | 2 +- src/tunnel_map.h | 2 +- src/unix.cpp | 2 +- src/unmovable.h | 2 +- src/unmovable_cmd.cpp | 2 +- src/unmovable_map.h | 2 +- src/variables.h | 2 +- src/vehicle.cpp | 2 +- src/vehicle_func.h | 2 +- src/vehicle_gui.cpp | 2 +- src/vehicle_gui.h | 2 +- src/video/cocoa/cocoa_keys.h | 2 + src/video/cocoa/cocoa_v.h | 2 + src/video/dedicated_v.cpp | 2 + src/video/dedicated_v.h | 2 + src/video/null_v.cpp | 2 + src/video/null_v.h | 2 + src/video/sdl_v.cpp | 3 +- src/video/sdl_v.h | 2 + src/video/video_driver.hpp | 2 + src/video/win32_v.cpp | 2 + src/video/win32_v.h | 2 + src/viewport.cpp | 2 +- src/void_map.h | 2 +- src/water_cmd.cpp | 2 +- src/water_map.h | 2 +- src/waypoint.cpp | 2 +- src/waypoint.h | 2 +- src/widget.cpp | 2 +- src/widgets/dropdown.cpp | 2 + src/widgets/dropdown_func.h | 2 + src/widgets/dropdown_type.h | 2 + src/window.cpp | 2 +- src/yapf/nodelist.hpp | 2 +- src/yapf/yapf.h | 2 +- src/yapf/yapf.hpp | 2 + src/yapf/yapf_base.hpp | 2 +- src/yapf/yapf_common.hpp | 2 +- src/yapf/yapf_costbase.hpp | 2 + src/yapf/yapf_costcache.hpp | 2 +- src/yapf/yapf_costrail.hpp | 2 +- src/yapf/yapf_destrail.hpp | 2 +- src/yapf/yapf_node.hpp | 2 +- src/yapf/yapf_node_rail.hpp | 2 +- src/yapf/yapf_node_road.hpp | 2 +- src/yapf/yapf_rail.cpp | 2 +- src/yapf/yapf_road.cpp | 2 +- src/yapf/yapf_settings.h | 2 +- src/yapf/yapf_ship.cpp | 2 +- src/zoom_func.h | 2 +- 360 files changed, 542 insertions(+), 335 deletions(-) diff --git a/Doxyfile b/Doxyfile index 6eb9d1232b..6ece8dbcdf 100644 --- a/Doxyfile +++ b/Doxyfile @@ -76,7 +76,7 @@ WARN_LOGFILE = #--------------------------------------------------------------------------- # configuration options related to the input files #--------------------------------------------------------------------------- -INPUT = ./ +INPUT = ./src/ FILE_PATTERNS = *.c \ *.cc \ *.cxx \ diff --git a/src/ai/ai.cpp b/src/ai/ai.cpp index 4849cf2735..5e7330eb1c 100644 --- a/src/ai/ai.cpp +++ b/src/ai/ai.cpp @@ -1,5 +1,7 @@ /* $Id$ */ +/** @file ai.cpp Base for all AIs. */ + #include "../stdafx.h" #include "../openttd.h" #include "../variables.h" diff --git a/src/ai/ai.h b/src/ai/ai.h index 44c6fe78c2..430d6a5e8f 100644 --- a/src/ai/ai.h +++ b/src/ai/ai.h @@ -1,5 +1,7 @@ /* $Id$ */ +/** @file ai.h Base functions for all AIs. */ + #ifndef AI_H #define AI_H diff --git a/src/ai/default/default.cpp b/src/ai/default/default.cpp index 3a2d90c943..db9fcd1410 100644 --- a/src/ai/default/default.cpp +++ b/src/ai/default/default.cpp @@ -1,5 +1,7 @@ /* $Id$ */ +/** @file default.cpp The original AI. */ + #include "../../stdafx.h" #include "../../openttd.h" #include "../../aircraft.h" diff --git a/src/ai/default/default.h b/src/ai/default/default.h index bbe84770f1..b0a4163be6 100644 --- a/src/ai/default/default.h +++ b/src/ai/default/default.h @@ -1,5 +1,7 @@ /* $Id$ */ +/** @file default.h The original AI. */ + #ifndef DEFAULT_H #define DEFAULT_H diff --git a/src/ai/trolly/build.cpp b/src/ai/trolly/build.cpp index eb71540929..cbb448dc92 100644 --- a/src/ai/trolly/build.cpp +++ b/src/ai/trolly/build.cpp @@ -1,5 +1,7 @@ /* $Id$ */ +/** @file build.cpp Building support for the trolly AI. */ + #include "../../stdafx.h" #include "../../openttd.h" #include "../../debug.h" diff --git a/src/ai/trolly/pathfinder.cpp b/src/ai/trolly/pathfinder.cpp index e58c92a276..dbb43fc550 100644 --- a/src/ai/trolly/pathfinder.cpp +++ b/src/ai/trolly/pathfinder.cpp @@ -1,5 +1,7 @@ /* $Id$ */ +/** @file pathfinder.cpp Pathfinder support for the trolly AI. */ + #include "../../stdafx.h" #include "../../openttd.h" #include "../../bridge_map.h" diff --git a/src/ai/trolly/shared.cpp b/src/ai/trolly/shared.cpp index 7773934d3d..9f990b554f 100644 --- a/src/ai/trolly/shared.cpp +++ b/src/ai/trolly/shared.cpp @@ -1,5 +1,7 @@ /* $Id$ */ +/** @file shared.cpp Shared functions for the trolly AI. */ + #include "../../stdafx.h" #include "../../openttd.h" #include "../../debug.h" diff --git a/src/ai/trolly/trolly.cpp b/src/ai/trolly/trolly.cpp index 2a369cd03c..9672a9664a 100644 --- a/src/ai/trolly/trolly.cpp +++ b/src/ai/trolly/trolly.cpp @@ -1,6 +1,8 @@ /* $Id$ */ -/* +/** + * @file trolly.cpp Implementation of the trolly AI. + * * This AI was created as a direct reaction to the big demand for some good AIs * in OTTD. Too bad it never left alpha-stage, and it is considered dead in its * current form. diff --git a/src/ai/trolly/trolly.h b/src/ai/trolly/trolly.h index 352a627611..c25bcb538d 100644 --- a/src/ai/trolly/trolly.h +++ b/src/ai/trolly/trolly.h @@ -1,5 +1,7 @@ /* $Id$ */ +/** @file trolly.h Functions/defines related to the trolly AI. */ + #ifndef AI_TROLLY_H #define AI_TROLLY_H diff --git a/src/aircraft.h b/src/aircraft.h index cef1debd1e..ae0e14e49e 100644 --- a/src/aircraft.h +++ b/src/aircraft.h @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file aircraft.h */ +/** @file aircraft.h Base for aircraft. */ #ifndef AIRCRAFT_H #define AIRCRAFT_H diff --git a/src/aircraft_gui.cpp b/src/aircraft_gui.cpp index 595b7c94e3..2208d32eca 100644 --- a/src/aircraft_gui.cpp +++ b/src/aircraft_gui.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file aircraft_gui.cpp */ +/** @file aircraft_gui.cpp The GUI of aircraft. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/airport.cpp b/src/airport.cpp index 9d91a5d751..0e00f3d41e 100644 --- a/src/airport.cpp +++ b/src/airport.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file airport.cpp */ +/** @file airport.cpp Functions related to airports. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/airport_gui.cpp b/src/airport_gui.cpp index 5728380e85..1e5dbcb702 100644 --- a/src/airport_gui.cpp +++ b/src/airport_gui.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file airport_gui.cpp */ +/** @file airport_gui.cpp The GUI for airports. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/animated_tile_func.h b/src/animated_tile_func.h index 1128101d05..0fd3e9d68a 100644 --- a/src/animated_tile_func.h +++ b/src/animated_tile_func.h @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file animated_tile.h Tile animation! */ +/** @file animated_tile_func.h Tile animation! */ #ifndef ANIMATED_TILE_H #define ANIMATED_TILE_H diff --git a/src/articulated_vehicles.cpp b/src/articulated_vehicles.cpp index 1f949722c0..d84531e424 100644 --- a/src/articulated_vehicles.cpp +++ b/src/articulated_vehicles.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file articulated_vehicles.cpp */ +/** @file articulated_vehicles.cpp Implementation of articulated vehicles. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/articulated_vehicles.h b/src/articulated_vehicles.h index 74f4b3f8ea..abfe495b02 100644 --- a/src/articulated_vehicles.h +++ b/src/articulated_vehicles.h @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file articulated_vehicles.h */ +/** @file articulated_vehicles.h Functions related to articulated vehicles. */ #ifndef ARTICULATED_VEHICLES_H #define ARTICULATED_VEHICLES_H diff --git a/src/autoreplace_gui.cpp b/src/autoreplace_gui.cpp index a980d59c0c..0a0eaf8058 100644 --- a/src/autoreplace_gui.cpp +++ b/src/autoreplace_gui.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file autoreplace_gui.cpp */ +/** @file autoreplace_gui.cpp GUI for autoreplace handling. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/autoslope.h b/src/autoslope.h index 2b7909fb87..91b8512235 100644 --- a/src/autoslope.h +++ b/src/autoslope.h @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file autoslope.h */ +/** @file autoslope.h Functions related to autoslope. */ #ifndef AUTOSLOPE_H #define AUTOSLOPE_H diff --git a/src/aystar.cpp b/src/aystar.cpp index 99ca1b2076..05fb0a806d 100644 --- a/src/aystar.cpp +++ b/src/aystar.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file aystar.cpp */ +/** @file aystar.cpp Implementation of A*. */ /* * This file has the core function for AyStar diff --git a/src/blitter/32bpp_anim.cpp b/src/blitter/32bpp_anim.cpp index 924803be90..ccbc38af94 100644 --- a/src/blitter/32bpp_anim.cpp +++ b/src/blitter/32bpp_anim.cpp @@ -1,5 +1,7 @@ /* $Id$ */ +/** @file 32bpp_anim.cpp Implementation of the optimized 32 bpp blitter with animation support. */ + #include "../stdafx.h" #include "../core/alloc_func.hpp" #include "../gfx_func.h" diff --git a/src/blitter/32bpp_anim.hpp b/src/blitter/32bpp_anim.hpp index 255cca48b2..373253debf 100644 --- a/src/blitter/32bpp_anim.hpp +++ b/src/blitter/32bpp_anim.hpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file 32bpp_anim.hpp */ +/** @file 32bpp_anim.hpp A 32 bpp blitter with animation support. */ #ifndef BLITTER_32BPP_ANIM_HPP #define BLITTER_32BPP_ANIM_HPP diff --git a/src/blitter/32bpp_base.cpp b/src/blitter/32bpp_base.cpp index 0358ae5dcd..eddec74ff6 100644 --- a/src/blitter/32bpp_base.cpp +++ b/src/blitter/32bpp_base.cpp @@ -1,5 +1,7 @@ /* $Id$ */ +/** @file 32bpp_base.cpp Implementation of base for 32 bpp blitters. */ + #include "../stdafx.h" #include "../gfx_func.h" #include "32bpp_base.hpp" diff --git a/src/blitter/32bpp_base.hpp b/src/blitter/32bpp_base.hpp index 5a664cd0be..dca8728ad2 100644 --- a/src/blitter/32bpp_base.hpp +++ b/src/blitter/32bpp_base.hpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file 32bpp_base.hpp */ +/** @file 32bpp_base.hpp Base for all 32 bits blitters. */ #ifndef BLITTER_32BPP_BASE_HPP #define BLITTER_32BPP_BASE_HPP diff --git a/src/blitter/32bpp_optimized.cpp b/src/blitter/32bpp_optimized.cpp index f4be199260..c0958b0e97 100644 --- a/src/blitter/32bpp_optimized.cpp +++ b/src/blitter/32bpp_optimized.cpp @@ -1,5 +1,7 @@ /* $Id$ */ +/** @file 32bpp_optimized.cpp Implementation of the optimized 32 bpp blitter. */ + #include "../stdafx.h" #include "../zoom_func.h" #include "../gfx_func.h" diff --git a/src/blitter/32bpp_optimized.hpp b/src/blitter/32bpp_optimized.hpp index d437dcdab2..46c30ec252 100644 --- a/src/blitter/32bpp_optimized.hpp +++ b/src/blitter/32bpp_optimized.hpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file 32bpp_optimized.hpp */ +/** @file 32bpp_optimized.hpp Optimized 32 bpp blitter. */ #ifndef BLITTER_32BPP_OPTIMIZED_HPP #define BLITTER_32BPP_OPTIMIZED_HPP diff --git a/src/blitter/32bpp_simple.cpp b/src/blitter/32bpp_simple.cpp index b5fa3f06d8..0d60a72342 100644 --- a/src/blitter/32bpp_simple.cpp +++ b/src/blitter/32bpp_simple.cpp @@ -1,5 +1,7 @@ /* $Id$ */ +/** @file 32bpp_simple.cpp Implementation of the simple 32 bpp blitter. */ + #include "../stdafx.h" #include "../gfx_func.h" #include "../zoom_func.h" diff --git a/src/blitter/32bpp_simple.hpp b/src/blitter/32bpp_simple.hpp index 448b819bf9..5ca965b277 100644 --- a/src/blitter/32bpp_simple.hpp +++ b/src/blitter/32bpp_simple.hpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file 32bpp_simple.hpp */ +/** @file 32bpp_simple.hpp Simple 32 bpp blitter. */ #ifndef BLITTER_32BPP_SIMPLE_HPP #define BLITTER_32BPP_SIMPLE_HPP diff --git a/src/blitter/8bpp_base.cpp b/src/blitter/8bpp_base.cpp index 7b813f6e72..78bb90f5e2 100644 --- a/src/blitter/8bpp_base.cpp +++ b/src/blitter/8bpp_base.cpp @@ -1,5 +1,7 @@ /* $Id$ */ +/** @file 8bpp_base.cpp Implementation of the base for all 8 bpp blitters. */ + #include "../stdafx.h" #include "../gfx_func.h" #include "8bpp_base.hpp" diff --git a/src/blitter/8bpp_base.hpp b/src/blitter/8bpp_base.hpp index b437a080be..eecd6e139a 100644 --- a/src/blitter/8bpp_base.hpp +++ b/src/blitter/8bpp_base.hpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file 8bpp_base.hpp */ +/** @file 8bpp_base.hpp Base for all 8 bpp blitters. */ #ifndef BLITTER_8BPP_BASE_HPP #define BLITTER_8BPP_BASE_HPP diff --git a/src/blitter/8bpp_debug.cpp b/src/blitter/8bpp_debug.cpp index d084965a1d..3ce0600c36 100644 --- a/src/blitter/8bpp_debug.cpp +++ b/src/blitter/8bpp_debug.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file 8bpp_debug.cpp */ +/** @file 8bpp_debug.cpp Implementation of 8 bpp debug blitter. */ #include "../stdafx.h" #include "../zoom_func.h" diff --git a/src/blitter/8bpp_debug.hpp b/src/blitter/8bpp_debug.hpp index e140d0db52..688391bd0f 100644 --- a/src/blitter/8bpp_debug.hpp +++ b/src/blitter/8bpp_debug.hpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file 8bpp_debug.hpp */ +/** @file 8bpp_debug.hpp A 8 bpp blitter that uses random colours to show the drawn sprites. */ #ifndef BLITTER_8BPP_DEBUG_HPP #define BLITTER_8BPP_DEBUG_HPP diff --git a/src/blitter/8bpp_optimized.cpp b/src/blitter/8bpp_optimized.cpp index 7b71659751..a230b6015f 100644 --- a/src/blitter/8bpp_optimized.cpp +++ b/src/blitter/8bpp_optimized.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file 8bpp_optimized.cpp */ +/** @file 8bpp_optimized.cpp Implementation of the optimized 8 bpp blitter. */ #include "../stdafx.h" #include "../zoom_func.h" diff --git a/src/blitter/8bpp_optimized.hpp b/src/blitter/8bpp_optimized.hpp index 4dfe91604d..d377b522ab 100644 --- a/src/blitter/8bpp_optimized.hpp +++ b/src/blitter/8bpp_optimized.hpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file 8bpp_optimized.hpp */ +/** @file 8bpp_optimized.hpp An optimized 8 bpp blitter. */ #ifndef BLITTER_8BPP_OPTIMIZED_HPP #define BLITTER_8BPP_OPTIMIZED_HPP diff --git a/src/blitter/8bpp_simple.cpp b/src/blitter/8bpp_simple.cpp index 77698cb1c2..5bef7927f5 100644 --- a/src/blitter/8bpp_simple.cpp +++ b/src/blitter/8bpp_simple.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file 8bpp_simple.cpp */ +/** @file 8bpp_simple.cpp Implementation of the simple 8 bpp blitter. */ #include "../stdafx.h" #include "../zoom_func.h" diff --git a/src/blitter/8bpp_simple.hpp b/src/blitter/8bpp_simple.hpp index 9ab78db647..49278f9702 100644 --- a/src/blitter/8bpp_simple.hpp +++ b/src/blitter/8bpp_simple.hpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file 8bpp_simple.hpp */ +/** @file 8bpp_simple.hpp Simple (and slow) 8 bpp blitter. */ #ifndef BLITTER_8BPP_SIMPLE_HPP #define BLITTER_8BPP_SIMPLE_HPP diff --git a/src/blitter/base.hpp b/src/blitter/base.hpp index cefaaa29f1..6a4e4196ac 100644 --- a/src/blitter/base.hpp +++ b/src/blitter/base.hpp @@ -1,5 +1,7 @@ /* $Id$ */ +/** @file base.hpp Base for all blitters. */ + #ifndef BLITTER_BASE_HPP #define BLITTER_BASE_HPP diff --git a/src/blitter/factory.hpp b/src/blitter/factory.hpp index 6b4a71a72c..e991ed8d6e 100644 --- a/src/blitter/factory.hpp +++ b/src/blitter/factory.hpp @@ -1,5 +1,7 @@ /* $Id$ */ +/** @file factory.hpp Factory to 'query' all available blitters. */ + #ifndef BLITTER_FACTORY_HPP #define BLITTER_FACTORY_HPP diff --git a/src/blitter/null.hpp b/src/blitter/null.hpp index 3261555512..d9589bd51b 100644 --- a/src/blitter/null.hpp +++ b/src/blitter/null.hpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file null.hpp */ +/** @file null.hpp The blitter that doesn't blit. */ #ifndef BLITTER_NULL_HPP #define BLITTER_NULL_HPP diff --git a/src/bmp.cpp b/src/bmp.cpp index c5677fbd78..f28111c24d 100644 --- a/src/bmp.cpp +++ b/src/bmp.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file bmp.cpp */ +/** @file bmp.cpp Read and write support for bmps. */ #include "stdafx.h" #include "bmp.h" diff --git a/src/bmp.h b/src/bmp.h index daf02c28dc..a54bac5fd1 100644 --- a/src/bmp.h +++ b/src/bmp.h @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file bmp.h */ +/** @file bmp.h Read and write support for bmps. */ #ifndef BMP_H #define BMP_H diff --git a/src/build_vehicle_gui.cpp b/src/build_vehicle_gui.cpp index 3170377236..2361a6ddcd 100644 --- a/src/build_vehicle_gui.cpp +++ b/src/build_vehicle_gui.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file build_vehicle_gui.cpp */ +/** @file build_vehicle_gui.cpp GUI for building vehicles. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/callback_table.cpp b/src/callback_table.cpp index 16de09821a..24c65a8eb6 100644 --- a/src/callback_table.cpp +++ b/src/callback_table.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file callback_table.cpp */ +/** @file callback_table.cpp All command callbacks. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/callback_table.h b/src/callback_table.h index 1a8f1ef918..071bf9786d 100644 --- a/src/callback_table.h +++ b/src/callback_table.h @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file callback_table.h */ +/** @file callback_table.h Table with all command callbacks. */ #ifndef CALLBACK_TABLE_H #define CALLBACK_TABLE_H diff --git a/src/cargopacket.h b/src/cargopacket.h index 3718bd1c8c..2964f05855 100644 --- a/src/cargopacket.h +++ b/src/cargopacket.h @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file cargopacket.h */ +/** @file cargopacket.h Base class for cargo packets. */ #ifndef CARGOPACKET_H #define CARGOPACKET_H diff --git a/src/cargotype.cpp b/src/cargotype.cpp index 2bc7928b9d..7f9cd956b8 100644 --- a/src/cargotype.cpp +++ b/src/cargotype.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file cargotype.cpp */ +/** @file cargotype.cpp Implementation of cargos. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/cargotype.h b/src/cargotype.h index 51bd2fd64c..a117fd6130 100644 --- a/src/cargotype.h +++ b/src/cargotype.h @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file cargotype.h */ +/** @file cargotype.h Types/functions related to cargos. */ #ifndef CARGOTYPE_H #define CARGOTYPE_H diff --git a/src/cheat.cpp b/src/cheat.cpp index 693f8a5fc4..f0b41d4303 100644 --- a/src/cheat.cpp +++ b/src/cheat.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file misc.cpp */ +/** @file cheat.cpp Handling (loading/saving/initializing) of cheats. */ #include "stdafx.h" #include "saveload.h" diff --git a/src/cheat_gui.cpp b/src/cheat_gui.cpp index 24e8bd0e4c..578ae7ef5b 100644 --- a/src/cheat_gui.cpp +++ b/src/cheat_gui.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file misc_gui.cpp */ +/** @file cheat_gui.cpp GUI related to cheating. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/clear_cmd.cpp b/src/clear_cmd.cpp index 02c2b65722..ff972db1fa 100644 --- a/src/clear_cmd.cpp +++ b/src/clear_cmd.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file clear_cmd.cpp */ +/** @file clear_cmd.cpp Commands related to clear tiles. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/cmd_helper.h b/src/cmd_helper.h index 6573915d53..88097d935d 100644 --- a/src/cmd_helper.h +++ b/src/cmd_helper.h @@ -1,5 +1,7 @@ /* $Id$ */ +/** @file cmd_helper.h Helper functions to extract data from command parameters. */ + #ifndef CMD_HELPER_H #define CMD_HELPER_H diff --git a/src/command.cpp b/src/command.cpp index 26c380cecf..2f9cc7d9fc 100644 --- a/src/command.cpp +++ b/src/command.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file command.cpp */ +/** @file command.cpp Handling of commands. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/console.cpp b/src/console.cpp index c1bb056769..96b3099977 100644 --- a/src/console.cpp +++ b/src/console.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file console.cpp */ +/** @file console.cpp Handling of the in-game console. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/console.h b/src/console.h index 30f1c30d9c..4c57ad5327 100644 --- a/src/console.h +++ b/src/console.h @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file console.h */ +/** @file console.h In-game console. */ #ifndef CONSOLE_H #define CONSOLE_H diff --git a/src/console_cmds.cpp b/src/console_cmds.cpp index 47e6d92122..8c0b89b723 100644 --- a/src/console_cmds.cpp +++ b/src/console_cmds.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file console_cmds.cpp */ +/** @file console_cmds.cpp Implementation of the console hooks. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/core/alloc_func.cpp b/src/core/alloc_func.cpp index f399aadf84..028335d761 100644 --- a/src/core/alloc_func.cpp +++ b/src/core/alloc_func.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file alloc_func.cpp functions to 'handle' memory allocation errors */ +/** @file alloc_func.cpp Functions to 'handle' memory allocation errors */ #include "../stdafx.h" #include "alloc_func.hpp" diff --git a/src/core/alloc_type.hpp b/src/core/alloc_type.hpp index 872558fb3d..1710e9a4da 100644 --- a/src/core/alloc_type.hpp +++ b/src/core/alloc_type.hpp @@ -1,4 +1,3 @@ - /* $Id$ */ /** @file alloc_type.hpp Helper types related to the allocation of memory */ diff --git a/src/core/bitmath_func.cpp b/src/core/bitmath_func.cpp index 614caa53fb..1b8662386e 100644 --- a/src/core/bitmath_func.cpp +++ b/src/core/bitmath_func.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file bitmath_func.cpp */ +/** @file bitmath_func.cpp Functions related to bit mathematics. */ #include "../stdafx.h" #include "bitmath_func.hpp" diff --git a/src/core/bitmath_func.hpp b/src/core/bitmath_func.hpp index 9042e6a7ec..775ae83386 100644 --- a/src/core/bitmath_func.hpp +++ b/src/core/bitmath_func.hpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file bitmath_func.hpp */ +/** @file bitmath_func.hpp Functions related to bit mathematics. */ #ifndef BITMATH_FUNC_HPP #define BITMATH_FUNC_HPP diff --git a/src/core/endian_func.hpp b/src/core/endian_func.hpp index 4e2e948d50..71b81059c6 100644 --- a/src/core/endian_func.hpp +++ b/src/core/endian_func.hpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file endian_func.hpp */ +/** @file endian_func.hpp Function to handling different endian machines. */ #ifndef ENDIAN_FUNC_H #define ENDIAN_FUNC_H diff --git a/src/core/random_func.cpp b/src/core/random_func.cpp index d51e59eeb8..c2ff9d49eb 100644 --- a/src/core/random_func.cpp +++ b/src/core/random_func.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file random_func.cpp */ +/** @file random_func.cpp Implementation of the pseudo random generator. */ #include "../stdafx.h" #include "random_func.hpp" diff --git a/src/core/random_func.hpp b/src/core/random_func.hpp index a301b5b3bc..cd273cb087 100644 --- a/src/core/random_func.hpp +++ b/src/core/random_func.hpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file random_func.hpp */ +/** @file random_func.hpp Pseudo random number generator. */ #ifndef RANDOM_FUNC_HPP #define RANDOM_FUNC_HPP diff --git a/src/currency.cpp b/src/currency.cpp index d732bcbfbd..816dbe7c43 100644 --- a/src/currency.cpp +++ b/src/currency.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file currency.cpp **/ +/** @file currency.cpp Support for different currencies. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/currency.h b/src/currency.h index cd967f603d..08b839a728 100644 --- a/src/currency.h +++ b/src/currency.h @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file currency.h */ +/** @file currency.h Functions to handle different currencies. */ #ifndef CURRENCY_H #define CURRENCY_H diff --git a/src/date.cpp b/src/date.cpp index fd9478513b..ce8b993432 100644 --- a/src/date.cpp +++ b/src/date.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file date.cpp */ +/** @file date.cpp Handling of dates in our native format and transforming them to something human readable. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/debug.cpp b/src/debug.cpp index aefa0a64b7..9dbf2642ce 100644 --- a/src/debug.cpp +++ b/src/debug.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file debug.cpp */ +/** @file debug.cpp Handling of printing debug messages. */ #include "stdafx.h" #include diff --git a/src/debug.h b/src/debug.h index 15f9f8c315..936d7f6830 100644 --- a/src/debug.h +++ b/src/debug.h @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file debug.h */ +/** @file debug.h Functions related to debugging. */ #ifndef DEBUG_H #define DEBUG_H diff --git a/src/dedicated.cpp b/src/dedicated.cpp index 8acf58022c..95b2a186a6 100644 --- a/src/dedicated.cpp +++ b/src/dedicated.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file dedicated.cpp */ +/** @file dedicated.cpp Forking support for dedicated servers. */ #include "stdafx.h" diff --git a/src/depot.cpp b/src/depot.cpp index 9475366d01..8b9abe06ad 100644 --- a/src/depot.cpp +++ b/src/depot.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file depot.cpp */ +/** @file depot.cpp Handling of depots. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/depot_base.h b/src/depot_base.h index e1c9e2168d..35d35e392b 100644 --- a/src/depot_base.h +++ b/src/depot_base.h @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file depot.h Base for all depots (except hangars) */ +/** @file depot_base.h Base for all depots (except hangars) */ #ifndef DEPOT_BASE_H #define DEPOT_BASE_H diff --git a/src/depot_gui.cpp b/src/depot_gui.cpp index fcd4adebc0..376acf0eac 100644 --- a/src/depot_gui.cpp +++ b/src/depot_gui.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file depot_gui.cpp */ +/** @file depot_gui.cpp The GUI for depots. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/dock_gui.cpp b/src/dock_gui.cpp index bc75b7fb31..44b66b1251 100644 --- a/src/dock_gui.cpp +++ b/src/dock_gui.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file dock_gui.cpp */ +/** @file dock_gui.cpp GUI to create amazing water objects. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/driver.cpp b/src/driver.cpp index 487be75d5b..a71f21cc7b 100644 --- a/src/driver.cpp +++ b/src/driver.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file driver.cpp */ +/** @file driver.cpp Base for all driver handling. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/driver.h b/src/driver.h index e78dfaf5b6..6b8d857d3e 100644 --- a/src/driver.h +++ b/src/driver.h @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file driver.h */ +/** @file driver.h Base for all drivers (video, sound, music, etc). */ #ifndef DRIVER_H #define DRIVER_H diff --git a/src/dummy_land.cpp b/src/dummy_land.cpp index 28cf2a2714..f426fed826 100644 --- a/src/dummy_land.cpp +++ b/src/dummy_land.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file dummy_land.cpp */ +/** @file dummy_land.cpp Handling of void (or dummy) tiles. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/economy.cpp b/src/economy.cpp index 2c7369b4ee..5ff83ad07a 100644 --- a/src/economy.cpp +++ b/src/economy.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file economy.cpp */ +/** @file economy.cpp Handling of the economy. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/effectvehicle.cpp b/src/effectvehicle.cpp index 4b600ea833..877e7fa3ea 100644 --- a/src/effectvehicle.cpp +++ b/src/effectvehicle.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file vehicle.cpp */ +/** @file effectvehicle.cpp Implementation of everything generic to vehicles. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/effectvehicle_func.h b/src/effectvehicle_func.h index 4e0dead970..46b8c14603 100644 --- a/src/effectvehicle_func.h +++ b/src/effectvehicle_func.h @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file effectvehicle.h Functions related to effect vehicles. */ +/** @file effectvehicle_func.h Functions related to effect vehicles. */ #ifndef EFFECTVEHICLE_FUNC_H #define EFFECTVEHICLE_FUNC_H diff --git a/src/elrail.cpp b/src/elrail.cpp index 6e776ea0ac..1db2471a75 100644 --- a/src/elrail.cpp +++ b/src/elrail.cpp @@ -1,4 +1,5 @@ /* $Id$ */ + /** @file elrail.cpp * This file deals with displaying wires and pylons for electric railways. *

Basics

diff --git a/src/engine.cpp b/src/engine.cpp index c721e31a1d..3d9df73f3a 100644 --- a/src/engine.cpp +++ b/src/engine.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file engine.cpp */ +/** @file engine.cpp Base for all engine handling. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/engine_func.h b/src/engine_func.h index a5cc164539..56108e1b50 100644 --- a/src/engine_func.h +++ b/src/engine_func.h @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file engine_func.h */ +/** @file engine_func.h Functions related to engines. */ #ifndef ENGINE_H #define ENGINE_H diff --git a/src/engine_gui.cpp b/src/engine_gui.cpp index 9e1d3c80a9..f6d15e3ef9 100644 --- a/src/engine_gui.cpp +++ b/src/engine_gui.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file engine_gui.cpp */ +/** @file engine_gui.cpp GUI to show engine related information. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/fiber.hpp b/src/fiber.hpp index 3ea776d5c3..e67dc4e9e9 100644 --- a/src/fiber.hpp +++ b/src/fiber.hpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file fiber.hpp */ +/** @file fiber.hpp Base for all fiber related classes. */ #ifndef FIBER_HPP #define FIBER_HPP diff --git a/src/fontcache.cpp b/src/fontcache.cpp index 14c735c02f..0135c25671 100644 --- a/src/fontcache.cpp +++ b/src/fontcache.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file fontcache.cpp */ +/** @file fontcache.cpp Cache for characters from fonts. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/fontcache.h b/src/fontcache.h index 8df1953186..14181a400c 100644 --- a/src/fontcache.h +++ b/src/fontcache.h @@ -1,5 +1,7 @@ /* $Id$ */ +/** @file fontcache.h Functions to read fonts from files and cache them. */ + #ifndef FONTCACHE_H #define FONTCACHE_H diff --git a/src/functions.h b/src/functions.h index bdbdc072da..55dcddacb9 100644 --- a/src/functions.h +++ b/src/functions.h @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file functions.h */ +/** @file functions.h Some generic functions that actually shouldn't be here. */ #ifndef FUNCTIONS_H #define FUNCTIONS_H diff --git a/src/genworld.cpp b/src/genworld.cpp index ad121ca700..25c1f8face 100644 --- a/src/genworld.cpp +++ b/src/genworld.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file genworld.cpp */ +/** @file genworld.cpp Functions to generate a map. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/genworld.h b/src/genworld.h index 1fc357d1c4..9cd09a7017 100644 --- a/src/genworld.h +++ b/src/genworld.h @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file genworld.h */ +/** @file genworld.h Functions related to world/map generation. */ #ifndef GENWORLD_H #define GENWORLD_H diff --git a/src/genworld_gui.cpp b/src/genworld_gui.cpp index 65ae872870..0d5f007046 100644 --- a/src/genworld_gui.cpp +++ b/src/genworld_gui.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file genworld_gui.cpp */ +/** @file genworld_gui.cpp GUI to configure and show progress during map generation. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/gfx.cpp b/src/gfx.cpp index af77f3d455..acfaa907c2 100644 --- a/src/gfx.cpp +++ b/src/gfx.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file gfx.cpp */ +/** @file gfx.cpp Handling of drawing text and other gfx related stuff. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/gfxinit.cpp b/src/gfxinit.cpp index 2bd2623852..c0350185d1 100644 --- a/src/gfxinit.cpp +++ b/src/gfxinit.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file gfxinit.cpp */ +/** @file gfxinit.cpp Initializing of the (GRF) graphics. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/gfxinit.h b/src/gfxinit.h index 2ebeac69fe..37def45980 100644 --- a/src/gfxinit.h +++ b/src/gfxinit.h @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file gfxinit.h */ +/** @file gfxinit.h Functions related to the graphics initialization. */ #ifndef GFXINIT_H #define GFXINIT_H diff --git a/src/graph_gui.cpp b/src/graph_gui.cpp index 45c31a1c61..ee3c4dfaa9 100644 --- a/src/graph_gui.cpp +++ b/src/graph_gui.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file graph_gui.cpp */ +/** @file graph_gui.cpp GUI that shows performance graphs. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/group.h b/src/group.h index 850a3c5deb..39712c4ad0 100644 --- a/src/group.h +++ b/src/group.h @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file group.h */ +/** @file group.h Base class from groups. */ #ifndef GROUP_H #define GROUP_H diff --git a/src/group_gui.cpp b/src/group_gui.cpp index 967b66f9f0..1d961b4da2 100644 --- a/src/group_gui.cpp +++ b/src/group_gui.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file group_gui.cpp */ +/** @file group_gui.cpp GUI for the group window. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/gui.h b/src/gui.h index afee0f3ac6..e82f34addb 100644 --- a/src/gui.h +++ b/src/gui.h @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file gui.h */ +/** @file gui.h GUI functions that shouldn't be here. */ #ifndef GUI_H #define GUI_H diff --git a/src/heightmap.cpp b/src/heightmap.cpp index c04ebd83da..a42ebe324d 100644 --- a/src/heightmap.cpp +++ b/src/heightmap.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file heightmap.cpp */ +/** @file heightmap.cpp Creating of maps from heightmaps. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/heightmap.h b/src/heightmap.h index 5cf66e7cec..1bbe197d91 100644 --- a/src/heightmap.h +++ b/src/heightmap.h @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file heightmap.h */ +/** @file heightmap.h Functions related to creating heightmaps from files. */ #ifndef HEIGHTMAP_H #define HEIGHTMAP_H diff --git a/src/helpers.cpp b/src/helpers.cpp index 4f55cc2725..af8dd4fbe8 100644 --- a/src/helpers.cpp +++ b/src/helpers.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file helpers.cpp */ +/** @file helpers.cpp Some not-so-generic helper functions. */ #include "stdafx.h" diff --git a/src/industry.h b/src/industry.h index 497cb57442..142f164fe3 100644 --- a/src/industry.h +++ b/src/industry.h @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file industry.h */ +/** @file industry.h Base of all industries. */ #ifndef INDUSTRY_H #define INDUSTRY_H diff --git a/src/industry_cmd.cpp b/src/industry_cmd.cpp index 80228c7fd9..ea233a2304 100644 --- a/src/industry_cmd.cpp +++ b/src/industry_cmd.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file industry_cmd.cpp */ +/** @file industry_cmd.cpp Handling of industry tiles. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/industry_gui.cpp b/src/industry_gui.cpp index 34e989be13..9e281e7d8d 100644 --- a/src/industry_gui.cpp +++ b/src/industry_gui.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file industry_gui.cpp */ +/** @file industry_gui.cpp GUIs related to industries. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/intro_gui.cpp b/src/intro_gui.cpp index e141b3f578..1acdfff6ec 100644 --- a/src/intro_gui.cpp +++ b/src/intro_gui.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file intro_gui.cpp */ +/** @file intro_gui.cpp The main menu GUI. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/landscape.cpp b/src/landscape.cpp index 95c9edb28e..3cbdaee98f 100644 --- a/src/landscape.cpp +++ b/src/landscape.cpp @@ -1,5 +1,7 @@ /* $Id$ */ +/** @file landscape.cpp Functions related to the landscape (slopes etc.). */ + #include "stdafx.h" #include "openttd.h" #include "bridge_map.h" diff --git a/src/landscape.h b/src/landscape.h index 00fe99706f..4e2db77357 100644 --- a/src/landscape.h +++ b/src/landscape.h @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file landscape.h */ +/** @file landscape.h Functions related to OTTD's landscape. */ #ifndef LANDSCAPE_H #define LANDSCAPE_H diff --git a/src/livery.h b/src/livery.h index 8aa4f2e448..a5f6674c40 100644 --- a/src/livery.h +++ b/src/livery.h @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file livery.h */ +/** @file livery.h Functions/types related to livery colours. */ #ifndef LIVERY_H #define LIVERY_H diff --git a/src/main_gui.cpp b/src/main_gui.cpp index bf8ba3b7c6..c006087d1d 100644 --- a/src/main_gui.cpp +++ b/src/main_gui.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file main_gui.cpp */ +/** @file main_gui.cpp Handling of the main viewport. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/map.cpp b/src/map.cpp index 76cd384d44..82a25f34c3 100644 --- a/src/map.cpp +++ b/src/map.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file map.cpp */ +/** @file map.cpp Base functions related to the map and distances on them. */ #include "stdafx.h" #include "debug.h" diff --git a/src/map_func.h b/src/map_func.h index 9e2a5d70e9..b9933674e8 100644 --- a/src/map_func.h +++ b/src/map_func.h @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file map_func.h */ +/** @file map_func.h Functions related to maps. */ #ifndef MAP_FUNC_H #define MAP_FUNC_H diff --git a/src/md5.cpp b/src/md5.cpp index 01e8638732..6e8580fa7a 100644 --- a/src/md5.cpp +++ b/src/md5.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file md5.cpp */ +/** @file md5.cpp Creating MD5 checksums of files. */ /* Copyright (C) 1999, 2000, 2002 Aladdin Enterprises. All rights reserved. diff --git a/src/md5.h b/src/md5.h index 67ddcc6a53..a3c4a6d9fa 100644 --- a/src/md5.h +++ b/src/md5.h @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file md5.h */ +/** @file md5.h Functions to create MD5 checksums. */ /* Copyright (C) 1999, 2002 Aladdin Enterprises. All rights reserved. diff --git a/src/minilzo.cpp b/src/minilzo.cpp index 68e0bb0f81..7025261537 100644 --- a/src/minilzo.cpp +++ b/src/minilzo.cpp @@ -1,39 +1,38 @@ /* $Id$ */ -/* @file minilzo.cpp -- mini subset of the LZO real-time data compression library - - This file is part of the LZO real-time data compression library. - - Copyright (C) 2002 Markus Franz Xaver Johannes Oberhumer - Copyright (C) 2001 Markus Franz Xaver Johannes Oberhumer - Copyright (C) 2000 Markus Franz Xaver Johannes Oberhumer - Copyright (C) 1999 Markus Franz Xaver Johannes Oberhumer - Copyright (C) 1998 Markus Franz Xaver Johannes Oberhumer - Copyright (C) 1997 Markus Franz Xaver Johannes Oberhumer - Copyright (C) 1996 Markus Franz Xaver Johannes Oberhumer - All Rights Reserved. - - The LZO library is free software; you can redistribute it and/or - modify it under the terms of the GNU General Public License as - published by the Free Software Foundation; either version 2 of - the License, or (at your option) any later version. - - The LZO library is distributed in the hope that it will be useful, - but WITHOUT ANY WARRANTY; without even the implied warranty of - MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the - GNU General Public License for more details. - - You should have received a copy of the GNU General Public License - along with the LZO library; see the file COPYING. - If not, write to the Free Software Foundation, Inc., - 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. - - Markus F.X.J. Oberhumer - - http://www.oberhumer.com/opensource/lzo/ - */ - -/* +/** + * @file minilzo.cpp -- mini subset of the LZO real-time data compression library + * + * This file is part of the LZO real-time data compression library. + * + * Copyright (C) 2002 Markus Franz Xaver Johannes Oberhumer + * Copyright (C) 2001 Markus Franz Xaver Johannes Oberhumer + * Copyright (C) 2000 Markus Franz Xaver Johannes Oberhumer + * Copyright (C) 1999 Markus Franz Xaver Johannes Oberhumer + * Copyright (C) 1998 Markus Franz Xaver Johannes Oberhumer + * Copyright (C) 1997 Markus Franz Xaver Johannes Oberhumer + * Copyright (C) 1996 Markus Franz Xaver Johannes Oberhumer + * All Rights Reserved. + * + * The LZO library is free software; you can redistribute it and/or + * modify it under the terms of the GNU General Public License as + * published by the Free Software Foundation; either version 2 of + * the License, or (at your option) any later version. + * + * The LZO library is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU General Public License for more details. + * + * You should have received a copy of the GNU General Public License + * along with the LZO library; see the file COPYING. + * If not, write to the Free Software Foundation, Inc., + * 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. + * + * Markus F.X.J. Oberhumer + * + * http://www.oberhumer.com/opensource/lzo/ + * * NOTE: * the full LZO package can be found at * http://www.oberhumer.com/opensource/lzo/ diff --git a/src/minilzo.h b/src/minilzo.h index 505249e946..f8dfe0a56a 100644 --- a/src/minilzo.h +++ b/src/minilzo.h @@ -1,45 +1,43 @@ /* $Id$ */ -/* @file minilzo.h -- mini subset of the LZO real-time data compression library - - This file is part of the LZO real-time data compression library. - - Copyright (C) 2002 Markus Franz Xaver Johannes Oberhumer - Copyright (C) 2001 Markus Franz Xaver Johannes Oberhumer - Copyright (C) 2000 Markus Franz Xaver Johannes Oberhumer - Copyright (C) 1999 Markus Franz Xaver Johannes Oberhumer - Copyright (C) 1998 Markus Franz Xaver Johannes Oberhumer - Copyright (C) 1997 Markus Franz Xaver Johannes Oberhumer - Copyright (C) 1996 Markus Franz Xaver Johannes Oberhumer - All Rights Reserved. - - The LZO library is free software; you can redistribute it and/or - modify it under the terms of the GNU General Public License as - published by the Free Software Foundation; either version 2 of - the License, or (at your option) any later version. - - The LZO library is distributed in the hope that it will be useful, - but WITHOUT ANY WARRANTY; without even the implied warranty of - MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the - GNU General Public License for more details. - - You should have received a copy of the GNU General Public License - along with the LZO library; see the file COPYING. - If not, write to the Free Software Foundation, Inc., - 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. - - Markus F.X.J. Oberhumer - - http://www.oberhumer.com/opensource/lzo/ - */ - -/* +/** + * @file minilzo.h Mini subset of the LZO real-time data compression library + * + * This file is part of the LZO real-time data compression library. + * + * Copyright (C) 2002 Markus Franz Xaver Johannes Oberhumer + * Copyright (C) 2001 Markus Franz Xaver Johannes Oberhumer + * Copyright (C) 2000 Markus Franz Xaver Johannes Oberhumer + * Copyright (C) 1999 Markus Franz Xaver Johannes Oberhumer + * Copyright (C) 1998 Markus Franz Xaver Johannes Oberhumer + * Copyright (C) 1997 Markus Franz Xaver Johannes Oberhumer + * Copyright (C) 1996 Markus Franz Xaver Johannes Oberhumer + * All Rights Reserved. + * + * The LZO library is free software; you can redistribute it and/or + * modify it under the terms of the GNU General Public License as + * published by the Free Software Foundation; either version 2 of + * the License, or (at your option) any later version. + * + * The LZO library is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU General Public License for more details. + * + * You should have received a copy of the GNU General Public License + * along with the LZO library; see the file COPYING. + * If not, write to the Free Software Foundation, Inc., + * 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. + * + * Markus F.X.J. Oberhumer + * + * http://www.oberhumer.com/opensource/lzo/ + * * NOTE: * the full LZO package can be found at * http://www.oberhumer.com/opensource/lzo/ */ - #ifndef MINILZO_H #define MINILZO_H diff --git a/src/misc.cpp b/src/misc.cpp index 7963520bc8..047737eca4 100644 --- a/src/misc.cpp +++ b/src/misc.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file misc.cpp */ +/** @file misc.cpp Misc functions that shouldn't be here. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/misc/array.hpp b/src/misc/array.hpp index a88b6cbe9b..b5ec1e9ffb 100644 --- a/src/misc/array.hpp +++ b/src/misc/array.hpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file array.hpp */ +/** @file array.hpp Array without an explicit maximum size. */ #ifndef ARRAY_HPP #define ARRAY_HPP diff --git a/src/misc/binaryheap.hpp b/src/misc/binaryheap.hpp index 78ebdc47fc..8b55badf91 100644 --- a/src/misc/binaryheap.hpp +++ b/src/misc/binaryheap.hpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file binaryheap.hpp */ +/** @file binaryheap.hpp Binary heap implementation. */ #ifndef BINARYHEAP_HPP #define BINARYHEAP_HPP diff --git a/src/misc/blob.hpp b/src/misc/blob.hpp index c485e92072..441c8a027b 100644 --- a/src/misc/blob.hpp +++ b/src/misc/blob.hpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file blob.hpp */ +/** @file blob.hpp Support for storing random binary data. */ #ifndef BLOB_HPP #define BLOB_HPP diff --git a/src/misc/countedobj.cpp b/src/misc/countedobj.cpp index 116fa31609..2de944c650 100644 --- a/src/misc/countedobj.cpp +++ b/src/misc/countedobj.cpp @@ -1,5 +1,7 @@ /* $Id$ */ +/** @file countedobj.cpp Support for reference counted objects. */ + #include "../stdafx.h" #include "countedptr.hpp" diff --git a/src/misc/crc32.hpp b/src/misc/crc32.hpp index 71f7ff03fe..1d2f86dcdb 100644 --- a/src/misc/crc32.hpp +++ b/src/misc/crc32.hpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file crc32.hpp */ +/** @file crc32.hpp Cyclic reduncancy check support. */ #ifndef CRC32_HPP #define CRC32_HPP diff --git a/src/misc/dbg_helpers.cpp b/src/misc/dbg_helpers.cpp index a07c5ce60a..c019ce5de3 100644 --- a/src/misc/dbg_helpers.cpp +++ b/src/misc/dbg_helpers.cpp @@ -1,6 +1,7 @@ /* $Id$ */ -/** @file dbg_helpers.cpp */ +/** @file dbg_helpers.cpp Helpers for outputting debug information. */ + #include "../stdafx.h" #include "../openttd.h" #include "../direction_type.h" diff --git a/src/misc/dbg_helpers.h b/src/misc/dbg_helpers.h index 65bf08a5c2..83aa6c2945 100644 --- a/src/misc/dbg_helpers.h +++ b/src/misc/dbg_helpers.h @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file dbg_helpers.h */ +/** @file dbg_helpers.h Functions to be used for debug printings. */ #ifndef DBG_HELPERS #define DBG_HELPERS diff --git a/src/misc/fixedsizearray.hpp b/src/misc/fixedsizearray.hpp index d0a987e1a7..10eb4eaa1e 100644 --- a/src/misc/fixedsizearray.hpp +++ b/src/misc/fixedsizearray.hpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file fixedsizearray.hpp */ +/** @file fixedsizearray.hpp A fixed size array that doesn't create items until needed. */ #ifndef FIXEDSIZEARRAY_HPP #define FIXEDSIZEARRAY_HPP diff --git a/src/misc/hashtable.hpp b/src/misc/hashtable.hpp index fad44114df..7b93b6cd80 100644 --- a/src/misc/hashtable.hpp +++ b/src/misc/hashtable.hpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file hashtable.hpp */ +/** @file hashtable.hpp Hash table support. */ #ifndef HASHTABLE_HPP #define HASHTABLE_HPP diff --git a/src/misc/smallvec.h b/src/misc/smallvec.h index 35e90be97a..d57f296882 100644 --- a/src/misc/smallvec.h +++ b/src/misc/smallvec.h @@ -1,6 +1,6 @@ /* $Id$ */ -/* @file smallvec.h */ +/** @file smallvec.h Simple vector class that allows allocating an item without the need to copy data needlessly. */ #ifndef SMALLVEC_H #define SMALLVEC_H diff --git a/src/misc/str.hpp b/src/misc/str.hpp index e1138616af..93e60d4417 100644 --- a/src/misc/str.hpp +++ b/src/misc/str.hpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file str.hpp */ +/** @file str.hpp String formating? */ #ifndef STR_HPP #define STR_HPP diff --git a/src/misc/strapi.hpp b/src/misc/strapi.hpp index 48cfb0f8c4..53e0dd9e53 100644 --- a/src/misc/strapi.hpp +++ b/src/misc/strapi.hpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file strapi.hpp */ +/** @file strapi.hpp More string formatting? */ #ifndef STRAPI_HPP #define STRAPI_HPP diff --git a/src/misc_cmd.cpp b/src/misc_cmd.cpp index 21cc5f598f..84579e113a 100644 --- a/src/misc_cmd.cpp +++ b/src/misc_cmd.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file misc_cmd.cpp */ +/** @file misc_cmd.cpp Some misc functions that are better fitted in other files, but never got moved there... */ #include "stdafx.h" #include "openttd.h" diff --git a/src/misc_gui.cpp b/src/misc_gui.cpp index 8be0d45fb8..875de065b7 100644 --- a/src/misc_gui.cpp +++ b/src/misc_gui.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file misc_gui.cpp */ +/** @file misc_gui.cpp GUIs for a number of misc windows. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/mixer.cpp b/src/mixer.cpp index e76af957e2..3b6557cde6 100644 --- a/src/mixer.cpp +++ b/src/mixer.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file mixer.cpp*/ +/** @file mixer.cpp Mixing of sound samples. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/mixer.h b/src/mixer.h index 7b14f83cff..289cb19a7f 100644 --- a/src/mixer.h +++ b/src/mixer.h @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file mixer.h */ +/** @file mixer.h Functions to mix sound samples. */ #ifndef MIXER_H #define MIXER_H diff --git a/src/music.cpp b/src/music.cpp index ac10097bad..e24cc97be9 100644 --- a/src/music.cpp +++ b/src/music.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file music.cpp */ +/** @file music.cpp The songs that OpenTTD knows. */ #include "stdafx.h" #include "music.h" diff --git a/src/music.h b/src/music.h index a7a4c388a8..22726105de 100644 --- a/src/music.h +++ b/src/music.h @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file music.h */ +/** @file music.h Base for the music handling. */ #ifndef MUSIC_H #define MUSIC_H diff --git a/src/music/bemidi.cpp b/src/music/bemidi.cpp index ab5634cca7..41bd4ee4f8 100644 --- a/src/music/bemidi.cpp +++ b/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" diff --git a/src/music/bemidi.h b/src/music/bemidi.h index 096249c247..6911597384 100644 --- a/src/music/bemidi.h +++ b/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 diff --git a/src/music/dmusic.cpp b/src/music/dmusic.cpp index a29af52a8f..4c4707257c 100644 --- a/src/music/dmusic.cpp +++ b/src/music/dmusic.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file dmusic.cpp */ +/** @file dmusic.cpp Playing music via DirectMusic. */ #ifdef WIN32_ENABLE_DIRECTMUSIC_SUPPORT diff --git a/src/music/dmusic.h b/src/music/dmusic.h index b04e42d9f4..ea16ecb386 100644 --- a/src/music/dmusic.h +++ b/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 diff --git a/src/music/extmidi.cpp b/src/music/extmidi.cpp index af33bdb0ea..a4c5bfb005 100644 --- a/src/music/extmidi.cpp +++ b/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" diff --git a/src/music/extmidi.h b/src/music/extmidi.h index d5fa2ba2f2..b5af27722e 100644 --- a/src/music/extmidi.h +++ b/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 diff --git a/src/music/libtimidity.cpp b/src/music/libtimidity.cpp index 2457881fd2..ad8fd83907 100644 --- a/src/music/libtimidity.cpp +++ b/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" diff --git a/src/music/libtimidity.h b/src/music/libtimidity.h index 965a195737..43b8ee0520 100644 --- a/src/music/libtimidity.h +++ b/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 diff --git a/src/music/music_driver.hpp b/src/music/music_driver.hpp index a8b6ab479a..c4cc6bc3f2 100644 --- a/src/music/music_driver.hpp +++ b/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 diff --git a/src/music/null_m.cpp b/src/music/null_m.cpp index 063ad2e10a..51cd04b26c 100644 --- a/src/music/null_m.cpp +++ b/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" diff --git a/src/music/null_m.h b/src/music/null_m.h index fc5c2bb097..bced36cf3f 100644 --- a/src/music/null_m.h +++ b/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 diff --git a/src/music/os2_m.cpp b/src/music/os2_m.cpp index 04add6e95c..4461f003fe 100644 --- a/src/music/os2_m.cpp +++ b/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" diff --git a/src/music/os2_m.h b/src/music/os2_m.h index 3ba1b5de60..76c0800a32 100644 --- a/src/music/os2_m.h +++ b/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 diff --git a/src/music/qtmidi.h b/src/music/qtmidi.h index 1106b1508b..3eeedebd63 100644 --- a/src/music/qtmidi.h +++ b/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 diff --git a/src/music/win32_m.cpp b/src/music/win32_m.cpp index 8ad9649778..ef2c826b36 100644 --- a/src/music/win32_m.cpp +++ b/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 diff --git a/src/music/win32_m.h b/src/music/win32_m.h index 9d66847381..1fc2f8225d 100644 --- a/src/music/win32_m.h +++ b/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 diff --git a/src/music_gui.cpp b/src/music_gui.cpp index e048d91535..cbb402cc51 100644 --- a/src/music_gui.cpp +++ b/src/music_gui.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file music_gui.cpp */ +/** @file music_gui.cpp GUI for the music playback. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/namegen.cpp b/src/namegen.cpp index 4fc3707670..cd6cba2ead 100644 --- a/src/namegen.cpp +++ b/src/namegen.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file namegen.cpp */ +/** @file namegen.cpp Town name generators. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/namegen_func.h b/src/namegen_func.h index 6fdb9400ad..0ecb156686 100644 --- a/src/namegen_func.h +++ b/src/namegen_func.h @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file namegen.h Town name generator stuff. */ +/** @file namegen_func.h Town name generator stuff. */ #ifndef NAMEGEN_H #define NAMEGEN_H diff --git a/src/network/network.cpp b/src/network/network.cpp index a73337ae67..9d596ae5ba 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 fbe2a31ccc..d3bf3d3e12 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 65eb3e31b6..02608bc38d 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 1778bc8fe5..11dd26b93b 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 a968b3114e..ede255ba96 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 2034de5b9e..32ed82a8e1 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 83ce100217..31ec691717 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 36313b5eef..fdfe1f870b 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 34597b4bbb..20fb528f8d 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 f44d361332..753cce2067 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 51bc762333..e75b2b001a 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 aea76f33eb..07f9cf29ab 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 f62f3c016e..4071ddc0fd 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 diff --git a/src/newgrf.cpp b/src/newgrf.cpp index 9bd55f104c..d48974807f 100644 --- a/src/newgrf.cpp +++ b/src/newgrf.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file newgrf.cpp */ +/** @file newgrf.cpp Base of all NewGRF support. */ #include "stdafx.h" diff --git a/src/newgrf.h b/src/newgrf.h index 4bfc38f4ef..c25baaeaf8 100644 --- a/src/newgrf.h +++ b/src/newgrf.h @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file newgrf.h */ +/** @file newgrf.h Base for the NewGRF implementation. */ #ifndef NEWGRF_H #define NEWGRF_H diff --git a/src/newgrf_callbacks.h b/src/newgrf_callbacks.h index 8e5817cb47..2bae20e0e8 100644 --- a/src/newgrf_callbacks.h +++ b/src/newgrf_callbacks.h @@ -1,12 +1,10 @@ /* $Id$ */ -/** @file newgrf_callbacks.h - */ +/** @file newgrf_callbacks.h Callbacks that NewGRFs could implement. */ #ifndef NEWGRF_CALLBACKS_H #define NEWGRF_CALLBACKS_H - /** * List of implemented NewGRF callbacks. * Most of these callbacks are only triggered when the corresponding diff --git a/src/newgrf_canal.cpp b/src/newgrf_canal.cpp index 50c60e5247..70507dc117 100644 --- a/src/newgrf_canal.cpp +++ b/src/newgrf_canal.cpp @@ -1,5 +1,7 @@ /* $Id$ */ +/** @file newgrf_canal.cpp Implementation of NewGRF canals. */ + #include "stdafx.h" #include "openttd.h" #include "variables.h" diff --git a/src/newgrf_canal.h b/src/newgrf_canal.h index 03e7cdff87..14813159ef 100644 --- a/src/newgrf_canal.h +++ b/src/newgrf_canal.h @@ -1,5 +1,7 @@ /* $Id$ */ +/** @file newgrf_canal.h Handling of NewGRF canals. */ + #ifndef NEWGRF_CANAL_H #define NEWGRF_CANAL_H diff --git a/src/newgrf_cargo.cpp b/src/newgrf_cargo.cpp index 67630ee6d0..790c0b3e89 100644 --- a/src/newgrf_cargo.cpp +++ b/src/newgrf_cargo.cpp @@ -1,5 +1,7 @@ /* $Id$ */ +/** @file newgrf_cargo.cpp Implementation of NewGRF cargoes. */ + #include "stdafx.h" #include "openttd.h" #include "debug.h" diff --git a/src/newgrf_cargo.h b/src/newgrf_cargo.h index 168e6861e2..eee0e96029 100644 --- a/src/newgrf_cargo.h +++ b/src/newgrf_cargo.h @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file newgrf_cargo.h */ +/** @file newgrf_cargo.h Cargo support for NewGRFs. */ #ifndef NEWGRF_CARGO_H #define NEWGRF_CARGO_H diff --git a/src/newgrf_config.cpp b/src/newgrf_config.cpp index b1ce866011..a0bf437aa1 100644 --- a/src/newgrf_config.cpp +++ b/src/newgrf_config.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file newgrf_config.cpp */ +/** @file newgrf_config.cpp Finding NewGRFs and configuring them. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/newgrf_config.h b/src/newgrf_config.h index 5396e6268d..45138d471b 100644 --- a/src/newgrf_config.h +++ b/src/newgrf_config.h @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file newgrf_config.h */ +/** @file newgrf_config.h Functions to find and configure NewGRFs. */ #ifndef NEWGRF_CONFIG_H #define NEWGRF_CONFIG_H diff --git a/src/newgrf_engine.cpp b/src/newgrf_engine.cpp index 454ee0a25d..a6438eca49 100644 --- a/src/newgrf_engine.cpp +++ b/src/newgrf_engine.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file newgrf_engine.cpp */ +/** @file newgrf_engine.cpp NewGRF handling of engines. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/newgrf_engine.h b/src/newgrf_engine.h index 80c2992309..6beb6b0da8 100644 --- a/src/newgrf_engine.h +++ b/src/newgrf_engine.h @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file newgrf_engine.h */ +/** @file newgrf_engine.h Functions for NewGRF engines. */ #ifndef NEWGRF_ENGINE_H #define NEWGRF_ENGINE_H diff --git a/src/newgrf_generic.cpp b/src/newgrf_generic.cpp index 682ecdb331..0b8b81882b 100644 --- a/src/newgrf_generic.cpp +++ b/src/newgrf_generic.cpp @@ -1,5 +1,7 @@ /* $Id$ */ +/** @file newgrf_generic.cpp Handling of generic feature callbacks. */ + #include "stdafx.h" #include "openttd.h" #include "variables.h" diff --git a/src/newgrf_generic.h b/src/newgrf_generic.h index 0c24f88fcd..81c2ee5c03 100644 --- a/src/newgrf_generic.h +++ b/src/newgrf_generic.h @@ -1,5 +1,7 @@ /* $Id$ */ +/** @file newgrf_generic.h Functions related to generic callbacks. */ + #ifndef NEWGRF_GENERIC_H #define NEWGRF_GENERIC_H diff --git a/src/newgrf_gui.cpp b/src/newgrf_gui.cpp index 7c44be08e7..3438a2ad88 100644 --- a/src/newgrf_gui.cpp +++ b/src/newgrf_gui.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file newgrf_gui.cpp */ +/** @file newgrf_gui.cpp GUI to change NewGRF settings. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/newgrf_house.cpp b/src/newgrf_house.cpp index 604bb36609..4ece1f1ac6 100644 --- a/src/newgrf_house.cpp +++ b/src/newgrf_house.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file newgrf_house.cpp */ +/** @file newgrf_house.cpp Implementation of NewGRF houses. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/newgrf_house.h b/src/newgrf_house.h index 089f771fcd..9a6f32d018 100644 --- a/src/newgrf_house.h +++ b/src/newgrf_house.h @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file newgrf_house.h */ +/** @file newgrf_house.h Functions related to NewGRF houses. */ #ifndef NEWGRF_HOUSE_H #define NEWGRF_HOUSE_H diff --git a/src/newgrf_industries.cpp b/src/newgrf_industries.cpp index 8aa65e4536..942c504b7c 100644 --- a/src/newgrf_industries.cpp +++ b/src/newgrf_industries.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file newgrf_industries.cpp */ +/** @file newgrf_industries.cpp Handling of NewGRF industries. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/newgrf_industries.h b/src/newgrf_industries.h index 9d532fa583..4635981412 100644 --- a/src/newgrf_industries.h +++ b/src/newgrf_industries.h @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file newgrf_industries.h */ +/** @file newgrf_industries.h Functions for NewGRF industries. */ #ifndef NEWGRF_INDUSTRIES_H #define NEWGRF_INDUSTRIES_H diff --git a/src/newgrf_industrytiles.cpp b/src/newgrf_industrytiles.cpp index 093aeef0b8..cf77736e6d 100644 --- a/src/newgrf_industrytiles.cpp +++ b/src/newgrf_industrytiles.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file newgrf_industrytiles.cpp */ +/** @file newgrf_industrytiles.cpp NewGRF handling of industry tiles. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/newgrf_industrytiles.h b/src/newgrf_industrytiles.h index b7394f2841..72834aa99d 100644 --- a/src/newgrf_industrytiles.h +++ b/src/newgrf_industrytiles.h @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file newgrf_industrytiles.h */ +/** @file newgrf_industrytiles.h NewGRF handling of industry tiles. */ #ifndef NEWGRF_INDUSTRYTILES_H #define NEWGRF_INDUSTRYTILES_H diff --git a/src/newgrf_sound.cpp b/src/newgrf_sound.cpp index 078e77b261..bc36bfd8a8 100644 --- a/src/newgrf_sound.cpp +++ b/src/newgrf_sound.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file newgrf_sound.cpp */ +/** @file newgrf_sound.cpp Handling NewGRF provided sounds. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/newgrf_sound.h b/src/newgrf_sound.h index 794cee77fe..43d5f96919 100644 --- a/src/newgrf_sound.h +++ b/src/newgrf_sound.h @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file newgrf_sound.h */ +/** @file newgrf_sound.h Functions related to NewGRF provided sounds. */ #ifndef NEWGRF_SOUND_H #define NEWGRF_SOUND_H diff --git a/src/newgrf_spritegroup.cpp b/src/newgrf_spritegroup.cpp index 989ee20347..91b583639f 100644 --- a/src/newgrf_spritegroup.cpp +++ b/src/newgrf_spritegroup.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file newgrf_spritegroup.cpp */ +/** @file newgrf_spritegroup.cpp Handling of primarily NewGRF action 2. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/newgrf_spritegroup.h b/src/newgrf_spritegroup.h index fe8ef405be..2b2f3c60e1 100644 --- a/src/newgrf_spritegroup.h +++ b/src/newgrf_spritegroup.h @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file newgrf_spritegroup.h */ +/** @file newgrf_spritegroup.h Action 2 handling. */ #ifndef NEWGRF_SPRITEGROUP_H #define NEWGRF_SPRITEGROUP_H diff --git a/src/newgrf_town.cpp b/src/newgrf_town.cpp index a15203fb74..8010cedf79 100644 --- a/src/newgrf_town.cpp +++ b/src/newgrf_town.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file newgrf_town.cpp */ +/** @file newgrf_town.cpp Implementation of the town part of NewGRF houses. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/newgrf_town.h b/src/newgrf_town.h index ec53fcc9a9..878770c84c 100644 --- a/src/newgrf_town.h +++ b/src/newgrf_town.h @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file newgrf_town.h */ +/** @file newgrf_town.h Functions to handle the town part of NewGRF towns. */ #ifndef NEWGRF_TOWN_H #define NEWGRF_TOWN_H diff --git a/src/newgrf_townname.h b/src/newgrf_townname.h index d1fdb429eb..eeb77f645a 100644 --- a/src/newgrf_townname.h +++ b/src/newgrf_townname.h @@ -1,13 +1,14 @@ /* $Id$ */ -#ifndef NEWGRF_TOWNNAME_H -#define NEWGRF_TOWNNAME_H - -#include "strings_type.h" /** @file newgrf_townname.h * Header of Action 0F "universal holder" structure and functions */ +#ifndef NEWGRF_TOWNNAME_H +#define NEWGRF_TOWNNAME_H + +#include "strings_type.h" + struct NamePart { byte prob; ///< The relative probablity of the following name to appear in the bottom 7 bits. union { diff --git a/src/news_gui.cpp b/src/news_gui.cpp index 92f0ecf12c..7fbb4b1476 100644 --- a/src/news_gui.cpp +++ b/src/news_gui.cpp @@ -1,5 +1,6 @@ /* $Id$ */ +/** @file news_gui.cpp GUI functions related to news messages. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/npf.cpp b/src/npf.cpp index adbb4228a0..8a8d4a9ea7 100644 --- a/src/npf.cpp +++ b/src/npf.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file npf.cpp */ +/** @file npf.cpp Implementation of the NPF pathfinder. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/npf.h b/src/npf.h index ca4580d143..36a444b4fd 100644 --- a/src/npf.h +++ b/src/npf.h @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file npf.h */ +/** @file npf.h New A* pathfinder. */ #ifndef NPF_H #define NPF_H diff --git a/src/oldloader.cpp b/src/oldloader.cpp index 363b6b352c..d69bccc0ab 100644 --- a/src/oldloader.cpp +++ b/src/oldloader.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file oldloader.cpp */ +/** @file oldloader.cpp Loading of old TTD(patch) savegames. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/oldpool.cpp b/src/oldpool.cpp index f7455efe93..856bfdd17a 100644 --- a/src/oldpool.cpp +++ b/src/oldpool.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file oldpool.cpp */ +/** @file oldpool.cpp Implementation of the old pool. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/oldpool.h b/src/oldpool.h index 1581cfc98b..d66a3a5768 100644 --- a/src/oldpool.h +++ b/src/oldpool.h @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file oldpool.h */ +/** @file oldpool.h Base for the old pool. */ #ifndef OLDPOOL_H #define OLDPOOL_H diff --git a/src/oldpool_func.h b/src/oldpool_func.h index 2c98013545..4397d8443b 100644 --- a/src/oldpool_func.h +++ b/src/oldpool_func.h @@ -1,6 +1,9 @@ /* $Id$ */ +/** @file oldpool_func.h Functions related to the old pool. */ + #ifndef OLDPOOL_FUNC_H +#define OLDPOOL_FUNC_H #include "oldpool.h" diff --git a/src/openttd.cpp b/src/openttd.cpp index 2511c28803..577a2945a9 100644 --- a/src/openttd.cpp +++ b/src/openttd.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file openttd.cpp */ +/** @file openttd.cpp Functions related to starting OpenTTD. */ #include "stdafx.h" diff --git a/src/openttd.h b/src/openttd.h index 1ee6bebebc..3265bfb0cd 100644 --- a/src/openttd.h +++ b/src/openttd.h @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file openttd.h */ +/** @file openttd.h Some generic types. */ #ifndef OPENTTD_H #define OPENTTD_H diff --git a/src/order_base.h b/src/order_base.h index f1661042f4..39c6f18262 100644 --- a/src/order_base.h +++ b/src/order_base.h @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file order_base.h */ +/** @file order_base.h Base class for orders. */ #ifndef ORDER_BASE_H #define ORDER_BASE_H diff --git a/src/order_cmd.cpp b/src/order_cmd.cpp index 4a951065a0..36f804386e 100644 --- a/src/order_cmd.cpp +++ b/src/order_cmd.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file order_cmd.cpp */ +/** @file order_cmd.cpp Handling of orders. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/order_gui.cpp b/src/order_gui.cpp index 8a953d0297..e85c14229c 100644 --- a/src/order_gui.cpp +++ b/src/order_gui.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file order_gui.cpp */ +/** @file order_gui.cpp GUI related to orders. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/os/macosx/G5_detector.cpp b/src/os/macosx/G5_detector.cpp index b4831c772b..00c46e859a 100644 --- a/src/os/macosx/G5_detector.cpp +++ b/src/os/macosx/G5_detector.cpp @@ -1,5 +1,7 @@ /* $Id$ */ +/** @file G5_detector.cpp Detection for G5 machines (PowerPC). */ + #include #include #include diff --git a/src/os/macosx/macos.h b/src/os/macosx/macos.h index dc2637acc7..0dc11c233a 100644 --- a/src/os/macosx/macos.h +++ b/src/os/macosx/macos.h @@ -1,5 +1,7 @@ /* $Id$ */ +/** @file macos.h Functions related to MacOS support. */ + #ifndef MACOS_H #define MACOS_H diff --git a/src/os/macosx/osx_stdafx.h b/src/os/macosx/osx_stdafx.h index 3de85799ed..ef33b3c9d9 100644 --- a/src/os/macosx/osx_stdafx.h +++ b/src/os/macosx/osx_stdafx.h @@ -1,5 +1,7 @@ /* $Id$ */ +/** @file osx_stdafx.h OSX is different on some places. */ + #ifndef MACOS_STDAFX_H #define MACOS_STDAFX_H diff --git a/src/os/macosx/splash.cpp b/src/os/macosx/splash.cpp index f644b5d0ec..6e60b12ca1 100644 --- a/src/os/macosx/splash.cpp +++ b/src/os/macosx/splash.cpp @@ -1,5 +1,7 @@ /* $Id$ */ +/** @file splash.cpp Splash screen support for OSX. */ + #include "../../stdafx.h" #include "../../openttd.h" #include "../../variables.h" diff --git a/src/os/macosx/splash.h b/src/os/macosx/splash.h index c8ea58c696..35aba54f82 100644 --- a/src/os/macosx/splash.h +++ b/src/os/macosx/splash.h @@ -1,5 +1,7 @@ /* $Id$ */ +/** @file splash.h Functions to support splash screens for OSX. */ + #ifndef SPLASH_H #define SPLASH_H diff --git a/src/os2.cpp b/src/os2.cpp index f0ebb92918..3d1c4df64a 100644 --- a/src/os2.cpp +++ b/src/os2.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file os2.cpp */ +/** @file os2.cpp OS2 related OS support. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/os_timer.cpp b/src/os_timer.cpp index ca0b279b42..11a5631a0c 100644 --- a/src/os_timer.cpp +++ b/src/os_timer.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file os_timer.cpp */ +/** @file os_timer.cpp OS/compiler dependant real time tick sampling. */ #include "stdafx.h" diff --git a/src/pathfind.cpp b/src/pathfind.cpp index 09a38a37d5..d26f0e0418 100644 --- a/src/pathfind.cpp +++ b/src/pathfind.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file pathfind.cpp */ +/** @file pathfind.cpp Implementation of the oldest supported pathfinder. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/pathfind.h b/src/pathfind.h index 11f9bff90b..c6528c377a 100644 --- a/src/pathfind.h +++ b/src/pathfind.h @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file pathfind.h */ +/** @file pathfind.h The oldest pathfinder that's supported. */ #ifndef PATHFIND_H #define PATHFIND_H diff --git a/src/player_gui.cpp b/src/player_gui.cpp index b6aed6bab0..76670fbec8 100644 --- a/src/player_gui.cpp +++ b/src/player_gui.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file player_gui.cpp */ +/** @file player_gui.cpp Player related GUIs. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/players.cpp b/src/players.cpp index 188a6b9e91..b66626cafc 100644 --- a/src/players.cpp +++ b/src/players.cpp @@ -1,7 +1,7 @@ /* $Id$ */ -/** @file players.cpp - */ +/** @file players.cpp Handling of players. */ + #include "stdafx.h" #include "openttd.h" #include "engine_func.h" diff --git a/src/queue.cpp b/src/queue.cpp index ebd3a37efb..c1c6dcb6d6 100644 --- a/src/queue.cpp +++ b/src/queue.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file queue.cpp */ +/** @file queue.cpp Implementation of the Queue/Hash. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/queue.h b/src/queue.h index 44c6c2e93e..7caecf7dba 100644 --- a/src/queue.h +++ b/src/queue.h @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file queue.h */ +/** @file queue.h Simple Queue/Hash implementations. */ #ifndef QUEUE_H #define QUEUE_H diff --git a/src/rail.cpp b/src/rail.cpp index bae773a91d..fc21f5dfe6 100644 --- a/src/rail.cpp +++ b/src/rail.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file rail.cpp */ +/** @file rail.cpp Implementation of rail specific functions. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/rail.h b/src/rail.h index 85c648baac..07ccb5204d 100644 --- a/src/rail.h +++ b/src/rail.h @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file rail.h */ +/** @file rail.h Rail specific functions. */ #ifndef RAIL_H #define RAIL_H diff --git a/src/rail_cmd.cpp b/src/rail_cmd.cpp index 692412630c..991751e9cf 100644 --- a/src/rail_cmd.cpp +++ b/src/rail_cmd.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file rail_cmd.cpp */ +/** @file rail_cmd.cpp Handling of rail tiles. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/road.cpp b/src/road.cpp index c0ebde9ed5..3e99f656f7 100644 --- a/src/road.cpp +++ b/src/road.cpp @@ -1,5 +1,7 @@ /* $Id$ */ +/** @file road.cpp Generic road related functions. */ + #include "stdafx.h" #include "openttd.h" #include "rail_map.h" diff --git a/src/road_cmd.cpp b/src/road_cmd.cpp index 0ff958e863..01b4146611 100644 --- a/src/road_cmd.cpp +++ b/src/road_cmd.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file road_cmd.cpp */ +/** @file road_cmd.cpp Commands related to road tiles. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/road_cmd.h b/src/road_cmd.h index c5d98daf2d..6597bb1b01 100644 --- a/src/road_cmd.h +++ b/src/road_cmd.h @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file road_cmd.h */ +/** @file road_cmd.h Road related functions. */ #ifndef ROAD_CMD_H #define ROAD_CMD_H diff --git a/src/road_gui.cpp b/src/road_gui.cpp index 8872f8530f..05a7fd55f6 100644 --- a/src/road_gui.cpp +++ b/src/road_gui.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file road_gui.cpp */ +/** @file road_gui.cpp GUI for building roads. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/road_map.cpp b/src/road_map.cpp index 1663987c71..b0d6d60a2c 100644 --- a/src/road_map.cpp +++ b/src/road_map.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file road_map.cpp */ +/** @file road_map.cpp Complex road accessors. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/road_map.h b/src/road_map.h index c7423380a3..305a1ab250 100644 --- a/src/road_map.h +++ b/src/road_map.h @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file road_map.h */ +/** @file road_map.h Map accessors for roads. */ #ifndef ROAD_MAP_H #define ROAD_MAP_H diff --git a/src/roadveh_cmd.cpp b/src/roadveh_cmd.cpp index 6b112101a3..f5b52a6fc0 100644 --- a/src/roadveh_cmd.cpp +++ b/src/roadveh_cmd.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file roadveh_cmd.cpp */ +/** @file roadveh_cmd.cpp Handling of road vehicles. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/roadveh_gui.cpp b/src/roadveh_gui.cpp index 53859aa58a..7796b78890 100644 --- a/src/roadveh_gui.cpp +++ b/src/roadveh_gui.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file roadveh_gui.cpp */ +/** @file roadveh_gui.cpp GUI for road vehicles. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/saveload.h b/src/saveload.h index c55a1df517..68fa4d2f8e 100644 --- a/src/saveload.h +++ b/src/saveload.h @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file saveload.h */ +/** @file saveload.h Functions/types related to saving and loading games. */ #ifndef SAVELOAD_H #define SAVELOAD_H diff --git a/src/screenshot.cpp b/src/screenshot.cpp index 68b9bc2770..49fe7894b7 100644 --- a/src/screenshot.cpp +++ b/src/screenshot.cpp @@ -1,5 +1,7 @@ /* $Id$ */ +/** @file screenshot.cpp The creation of screenshots! */ + #include "stdafx.h" #include "openttd.h" #include "debug.h" diff --git a/src/screenshot.h b/src/screenshot.h index 3084726258..e69174ea8d 100644 --- a/src/screenshot.h +++ b/src/screenshot.h @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file screenshot.h */ +/** @file screenshot.h Functions to make screenshots. */ #ifndef SCREENSHOT_H #define SCREENSHOT_H diff --git a/src/sdl.cpp b/src/sdl.cpp index 071a472af1..200828743a 100644 --- a/src/sdl.cpp +++ b/src/sdl.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file sdl.cpp */ +/** @file sdl.cpp Implementation of SDL support. */ #include "stdafx.h" diff --git a/src/sdl.h b/src/sdl.h index d7f4658f9b..ca62dfce30 100644 --- a/src/sdl.h +++ b/src/sdl.h @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file sdl.h */ +/** @file sdl.h SDL support. */ #ifndef SDL_H #define SDL_H diff --git a/src/settings_gui.cpp b/src/settings_gui.cpp index 777d15d19c..fa829ce67f 100644 --- a/src/settings_gui.cpp +++ b/src/settings_gui.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file settings_gui.cpp */ +/** @file settings_gui.cpp GUI for settings. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/ship.h b/src/ship.h index 35b2d7a931..79ab4c156f 100644 --- a/src/ship.h +++ b/src/ship.h @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file ship.h */ +/** @file ship.h Base for ships. */ #ifndef SHIP_H #define SHIP_H diff --git a/src/ship_cmd.cpp b/src/ship_cmd.cpp index 7fe3418a29..31d76e17d2 100644 --- a/src/ship_cmd.cpp +++ b/src/ship_cmd.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file ship_cmd.cpp */ +/** @file ship_cmd.cpp Handling of ships. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/ship_gui.cpp b/src/ship_gui.cpp index 2629e96ed2..52689f5753 100644 --- a/src/ship_gui.cpp +++ b/src/ship_gui.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file ship_gui.cpp */ +/** @file ship_gui.cpp GUI for ships. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/signs.cpp b/src/signs.cpp index 93ab460f00..c067f16192 100644 --- a/src/signs.cpp +++ b/src/signs.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file signs.cpp */ +/** @file signs.cpp Handling of signs. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/signs_gui.cpp b/src/signs_gui.cpp index f0cea0edab..f4cf33070d 100644 --- a/src/signs_gui.cpp +++ b/src/signs_gui.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file signs_gui.cpp */ +/** @file signs_gui.cpp The GUI for signs. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/smallmap_gui.cpp b/src/smallmap_gui.cpp index b4e70ac4ca..e2c8a70c0b 100644 --- a/src/smallmap_gui.cpp +++ b/src/smallmap_gui.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file smallmap_gui.cpp */ +/** @file smallmap_gui.cpp GUI that shows a small map of the world with metadata like owner or height. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/sound.cpp b/src/sound.cpp index a9c0cb8015..74663cff71 100644 --- a/src/sound.cpp +++ b/src/sound.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file sound.cpp */ +/** @file sound.cpp Handling of playing sounds. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/sound/cocoa_s.cpp b/src/sound/cocoa_s.cpp index 5642c36a09..9921cb0cfc 100644 --- a/src/sound/cocoa_s.cpp +++ b/src/sound/cocoa_s.cpp @@ -1,5 +1,7 @@ /* $Id$ */ +/** @file cocoa_s.cpp Sound driver for cocoa. */ + /***************************************************************************** * Cocoa sound driver * * Known things left to do: * diff --git a/src/sound/cocoa_s.h b/src/sound/cocoa_s.h index 9ec6ac5cba..079132c2d3 100644 --- a/src/sound/cocoa_s.h +++ b/src/sound/cocoa_s.h @@ -1,5 +1,7 @@ /* $Id$ */ +/** @file cocoa_s.h Base for Cocoa sound handling. */ + #ifndef SOUND_COCOA_H #define SOUND_COCOA_H diff --git a/src/sound/null_s.cpp b/src/sound/null_s.cpp index c8fe22ca3d..03277ac8b2 100644 --- a/src/sound/null_s.cpp +++ b/src/sound/null_s.cpp @@ -1,5 +1,7 @@ /* $Id$ */ +/** @file null_s.cpp The sound driver that doesn't produce sound. */ + #include "../stdafx.h" #include "null_s.h" diff --git a/src/sound/null_s.h b/src/sound/null_s.h index 27b8d8980c..49581fc187 100644 --- a/src/sound/null_s.h +++ b/src/sound/null_s.h @@ -1,5 +1,7 @@ /* $Id$ */ +/** @file null_s.h Base for the sound of silence. */ + #ifndef SOUND_NULL_H #define SOUND_NULL_H diff --git a/src/sound/sdl_s.cpp b/src/sound/sdl_s.cpp index f9f40d4e32..753bce7647 100644 --- a/src/sound/sdl_s.cpp +++ b/src/sound/sdl_s.cpp @@ -1,5 +1,7 @@ /* $Id$ */ +/** @file sdl_s.cpp Playing sound via SDL. */ + #ifdef WITH_SDL #include "../stdafx.h" diff --git a/src/sound/sdl_s.h b/src/sound/sdl_s.h index 83edccc995..e897f83061 100644 --- a/src/sound/sdl_s.h +++ b/src/sound/sdl_s.h @@ -1,5 +1,7 @@ /* $Id$ */ +/** @file sdl_s.h Base fo playing sound via SDL. */ + #ifndef SOUND_SDL_H #define SOUND_SDL_H diff --git a/src/sound/sound_driver.hpp b/src/sound/sound_driver.hpp index 55cc20be82..8f3f08579a 100644 --- a/src/sound/sound_driver.hpp +++ b/src/sound/sound_driver.hpp @@ -1,5 +1,7 @@ /* $Id$ */ +/** @file sound_driver.hpp Base for all sound drivers. */ + #ifndef SOUND_SOUND_DRIVER_HPP #define SOUND_SOUND_DRIVER_HPP diff --git a/src/sound/win32_s.cpp b/src/sound/win32_s.cpp index 386c6f4a5e..66a7fde03e 100644 --- a/src/sound/win32_s.cpp +++ b/src/sound/win32_s.cpp @@ -1,5 +1,7 @@ /* $Id$ */ +/** @file win32_s.cpp Handling of sound for Windows. */ + #include "../stdafx.h" #include "../openttd.h" #include "../driver.h" diff --git a/src/sound/win32_s.h b/src/sound/win32_s.h index 8fbd8b0c1c..71859af90a 100644 --- a/src/sound/win32_s.h +++ b/src/sound/win32_s.h @@ -1,5 +1,7 @@ /* $Id$ */ +/** @file win32_s.h Base for Windows sound handling. */ + #ifndef SOUND_WIN32_H #define SOUND_WIN32_H diff --git a/src/sprite.h b/src/sprite.h index 11054c6a44..b996280d8f 100644 --- a/src/sprite.h +++ b/src/sprite.h @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file sprite.h */ +/** @file sprite.h Base for drawing complex sprites. */ #ifndef SPRITE_H #define SPRITE_H diff --git a/src/spritecache.cpp b/src/spritecache.cpp index b4b3c57f0e..1fdbc4f814 100644 --- a/src/spritecache.cpp +++ b/src/spritecache.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file spritecache.cpp */ +/** @file spritecache.cpp Caching of sprites. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/spritecache.h b/src/spritecache.h index 946efd6ca1..65cc3b95e3 100644 --- a/src/spritecache.h +++ b/src/spritecache.h @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file spritecache.h */ +/** @file spritecache.h Functions to cache sprites in memory. */ #ifndef SPRITECACHE_H #define SPRITECACHE_H diff --git a/src/spriteloader/grf.cpp b/src/spriteloader/grf.cpp index bbc9d3f8f7..4fcad53861 100644 --- a/src/spriteloader/grf.cpp +++ b/src/spriteloader/grf.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file grf.cpp */ +/** @file grf.cpp Reading graphics data from (New)GRF files. */ #include "../stdafx.h" #include "../gfx_func.h" diff --git a/src/spriteloader/grf.hpp b/src/spriteloader/grf.hpp index 65b5f62339..f1e68aaa11 100644 --- a/src/spriteloader/grf.hpp +++ b/src/spriteloader/grf.hpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file grf.hpp */ +/** @file grf.hpp Base for reading sprites from (New)GRFs. */ #ifndef SPRITELOADER_GRF_HPP #define SPRITELOADER_GRF_HPP diff --git a/src/spriteloader/png.cpp b/src/spriteloader/png.cpp index 1041be7d5f..495b1b5fb7 100644 --- a/src/spriteloader/png.cpp +++ b/src/spriteloader/png.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file png.cpp */ +/** @file png.cpp Reading sprites from png files. */ #ifdef WITH_PNG diff --git a/src/spriteloader/png.hpp b/src/spriteloader/png.hpp index 7d821dc714..314e25e894 100644 --- a/src/spriteloader/png.hpp +++ b/src/spriteloader/png.hpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file png.hpp */ +/** @file png.hpp Base for reading files from PNG. */ #ifndef SPRITELOADER_PNG_HPP #define SPRITELOADER_PNG_HPP diff --git a/src/spriteloader/spriteloader.hpp b/src/spriteloader/spriteloader.hpp index 09ad505a88..6e107811ac 100644 --- a/src/spriteloader/spriteloader.hpp +++ b/src/spriteloader/spriteloader.hpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file spriteloader.hpp */ +/** @file spriteloader.hpp Base for loading sprites. */ #ifndef SPRITELOADER_HPP #define SPRITELOADER_HPP diff --git a/src/station.cpp b/src/station.cpp index f0c7c36941..8922a1fe3b 100644 --- a/src/station.cpp +++ b/src/station.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file station.cpp */ +/** @file station.cpp Implementation of the station base class. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/station_cmd.cpp b/src/station_cmd.cpp index 08c67e0de3..a2bd618d2b 100644 --- a/src/station_cmd.cpp +++ b/src/station_cmd.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file station_cmd.cpp */ +/** @file station_cmd.cpp Handling of station tiles. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/station_gui.cpp b/src/station_gui.cpp index c1345e5c11..9c3d9d42a1 100644 --- a/src/station_gui.cpp +++ b/src/station_gui.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file station_gui.cpp */ +/** @file station_gui.cpp The GUI for stations. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/station_map.h b/src/station_map.h index 0c255a9425..ad7e050787 100644 --- a/src/station_map.h +++ b/src/station_map.h @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file station_map.h */ +/** @file station_map.h Maps accessors for stations. */ #ifndef STATION_MAP_H #define STATION_MAP_H diff --git a/src/statusbar_gui.cpp b/src/statusbar_gui.cpp index 62c077f6bb..0ae38c8033 100644 --- a/src/statusbar_gui.cpp +++ b/src/statusbar_gui.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file main_gui.cpp */ +/** @file statusbar_gui.cpp The GUI for the bottom status bar. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/stdafx.h b/src/stdafx.h index 17bbb3ca1c..43a1694fbc 100644 --- a/src/stdafx.h +++ b/src/stdafx.h @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file stdafx.h */ +/** @file stdafx.h Definition of base types and functions in a cross-platform compatible way. */ #ifndef STDAFX_H #define STDAFX_H diff --git a/src/strgen/strgen.cpp b/src/strgen/strgen.cpp index e4a034a4e1..3057a88f04 100644 --- a/src/strgen/strgen.cpp +++ b/src/strgen/strgen.cpp @@ -1,5 +1,7 @@ /* $Id$ */ +/** @file strgen.cpp Tool to create computer readable (stand-alone) translation files. */ + #include "../stdafx.h" #include "../core/alloc_func.hpp" #include "../core/endian_func.hpp" diff --git a/src/string.cpp b/src/string.cpp index 37fbd89427..041fa8e450 100644 --- a/src/string.cpp +++ b/src/string.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file string.cpp */ +/** @file string.cpp Handling of C-type strings (char*). */ #include "stdafx.h" #include "openttd.h" diff --git a/src/strings.cpp b/src/strings.cpp index ab2494808c..06681ea00b 100644 --- a/src/strings.cpp +++ b/src/strings.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file strings.cpp */ +/** @file strings.cpp Handling of translated strings. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/subsidy_gui.cpp b/src/subsidy_gui.cpp index 9d54fc5635..7c88ef68ad 100644 --- a/src/subsidy_gui.cpp +++ b/src/subsidy_gui.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file subsidy_gui.cpp */ +/** @file subsidy_gui.cpp GUI for subsidies. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/table/ai_rail.h b/src/table/ai_rail.h index c95ccfb6fe..5649637c1c 100644 --- a/src/table/ai_rail.h +++ b/src/table/ai_rail.h @@ -1,5 +1,7 @@ /* $Id$ */ +/** @file ai_rail.h Tables that the default AI uses to build tracks/stations. */ + struct AiDefaultBlockData { byte mode; DiagDirection attr; diff --git a/src/table/autorail.h b/src/table/autorail.h index f80b500c8b..9e858c10b9 100644 --- a/src/table/autorail.h +++ b/src/table/autorail.h @@ -1,5 +1,7 @@ /* $Id$ */ +/** @file autorail.h Highlight/sprite information for autorail. */ + /* Rail selection types (directions): * / \ / \ / \ / \ / \ / \ * / /\ /\ \ /===\ / \ /| \ / |\ diff --git a/src/table/build_industry.h b/src/table/build_industry.h index 64b01899fc..ff2e000ae0 100644 --- a/src/table/build_industry.h +++ b/src/table/build_industry.h @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file build_industry.h */ +/** @file build_industry.h Tables with default industry layouts and behaviours. */ #ifndef BUILD_INDUSTRY_H #define BUILD_INDUSTRY_H diff --git a/src/table/cargo_const.h b/src/table/cargo_const.h index 6c24716f56..8467cb7309 100644 --- a/src/table/cargo_const.h +++ b/src/table/cargo_const.h @@ -1,6 +1,6 @@ /* $Id$ */ -/* Table of all default cargo types */ +/** @file cargo_const.h Table of all default cargo types */ #define MK(bt, label, c, e, f, g, h, fr, te, ks1, ks2, ks3, ks4, ks5, l, m) \ {bt, label, 0, c, c, e, f, {g, h}, fr, te, 0, 0, ks1, ks2, ks3, ks4, ks5, l, m, NULL} diff --git a/src/table/clear_land.h b/src/table/clear_land.h index 581c868551..cd2658798d 100644 --- a/src/table/clear_land.h +++ b/src/table/clear_land.h @@ -1,5 +1,7 @@ /* $Id$ */ +/** @file clear_land.h Tables with sprites for clear land and fences. */ + static const SpriteID _landscape_clear_sprites[8] = { 0xFA0, 0xFB3, diff --git a/src/table/control_codes.h b/src/table/control_codes.h index 1af7befd7b..d889ba1933 100644 --- a/src/table/control_codes.h +++ b/src/table/control_codes.h @@ -1,11 +1,14 @@ /* $Id$ */ +/** @file control_codes.h Control codes that are embedded in the translation strings. */ + #ifndef CONTROL_CODES_H #define CONTROL_CODES_H -/* List of string control codes used for string formatting, displaying, and - * by strgen to generate the language files. */ - +/** + * List of string control codes used for string formatting, displaying, and + * by strgen to generate the language files. + */ enum StringControlCode { SCC_CONTROL_START = 0xE000, SCC_CONTROL_END = 0xE1FF, diff --git a/src/table/elrail_data.h b/src/table/elrail_data.h index f929f6a9a8..f9682aca5e 100644 --- a/src/table/elrail_data.h +++ b/src/table/elrail_data.h @@ -1,4 +1,5 @@ /* $Id$ */ + /** @file elrail_data.h Stores all the data for overhead wire and pylon drawing. * @see elrail.c */ diff --git a/src/table/engines.h b/src/table/engines.h index 8d892972aa..d8db147dd8 100644 --- a/src/table/engines.h +++ b/src/table/engines.h @@ -1,12 +1,12 @@ /* $Id$ */ -#ifndef ENGINES_H -#define ENGINES_H - /** @file table/engines.h * This file contains all the data for vehicles */ +#ifndef ENGINES_H +#define ENGINES_H + enum { RC_W = 0xFF, ///< Running cost price index (out of range) of wagons RC_S = 0x2A, ///< Running cost price index of steam diff --git a/src/table/files.h b/src/table/files.h index eeaab5c448..8381672cad 100644 --- a/src/table/files.h +++ b/src/table/files.h @@ -1,5 +1,7 @@ /* $Id$ */ +/** @file files.h MD5 checksum information and names of the original and extra data files. */ + /* MD5 sums of graphics files diff --git a/src/table/genland.h b/src/table/genland.h index 4007f8db39..179cc0346b 100644 --- a/src/table/genland.h +++ b/src/table/genland.h @@ -1,5 +1,7 @@ /* $Id$ */ +/** @file genland.h Table used to generate deserts and/or rain forests. */ + #define M(x, y) {x, y} static const TileIndexDiffC _make_desert_or_rainforest_data[] = { diff --git a/src/table/industry_land.h b/src/table/industry_land.h index 1f41101faa..d688cf3e2f 100644 --- a/src/table/industry_land.h +++ b/src/table/industry_land.h @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file industry_land.h */ +/** @file industry_land.h Information about the behaviour of the default industry tiles. */ /** * This is used to gather some data about animation diff --git a/src/table/landscape_sprite.h b/src/table/landscape_sprite.h index 1665720a3b..e5f3d8ed23 100644 --- a/src/table/landscape_sprite.h +++ b/src/table/landscape_sprite.h @@ -1,5 +1,7 @@ /* $Id$ */ +/** @file landscape_sprite.h Offsets of sprites to replace for non-temperate landscapes. */ + enum { END = 0xFFFF }; diff --git a/src/table/palettes.h b/src/table/palettes.h index d1bff7cb60..51e5dc5714 100644 --- a/src/table/palettes.h +++ b/src/table/palettes.h @@ -1,5 +1,7 @@ /* $Id$ */ +/** @file palettes.h The colour translation of the GRF palettes. */ + #define M(r, g, b) { r, g, b } static const Colour _palettes[][256] = { /* palette 1 (TTD Windows) */ diff --git a/src/table/road_land.h b/src/table/road_land.h index 4ce0c20fb6..5a221a6cbd 100644 --- a/src/table/road_land.h +++ b/src/table/road_land.h @@ -1,5 +1,7 @@ /* $Id$ */ +/** @file road_land.h Sprite constructs for road depots. */ + #define TILE_SEQ_LINE(img, pal, dx, dy, sx, sy) { dx, dy, 0, sx, sy, 20, {img, pal} }, #define TILE_SEQ_END() { 0, 0, 0, 0, 0, 0, {0, 0} } diff --git a/src/table/sprites.h b/src/table/sprites.h index cc2cb6af74..115ed663d6 100644 --- a/src/table/sprites.h +++ b/src/table/sprites.h @@ -1,8 +1,5 @@ /* $Id$ */ -#ifndef SPRITES_H -#define SPRITES_H - /** @file sprites.h * This file contails all sprite-related enums and defines. These consist mainly of * the sprite numbers and a bunch of masks and macros to handle sprites and to get @@ -32,6 +29,9 @@ * @todo Split the "Sprites" enum into smaller chunks and document them */ +#ifndef SPRITES_H +#define SPRITES_H + #include "../gfx_type.h" enum Sprites { diff --git a/src/table/station_land.h b/src/table/station_land.h index f02990f8d8..249b6f4824 100644 --- a/src/table/station_land.h +++ b/src/table/station_land.h @@ -1,5 +1,7 @@ /* $Id$ */ +/** @file station_land.h Sprites to use and how to display them for station tiles. */ + #define TILE_SEQ_LINE(dx, dy, dz, sx, sy, sz, img) { dx, dy, dz, sx, sy, sz, {img, PAL_NONE} }, #define TILE_SEQ_LINE_PAL(dx, dy, dz, sx, sy, sz, img, pal) { dx, dy, dz, sx, sy, sz, {img, pal} }, #define TILE_SEQ_END() { (byte)0x80, 0, 0, 0, 0, 0, {0, 0} } diff --git a/src/table/town_land.h b/src/table/town_land.h index 89d7d30a1f..3c1980dd8c 100644 --- a/src/table/town_land.h +++ b/src/table/town_land.h @@ -1,7 +1,6 @@ /* $Id$ */ -/** @file town_land.h */ - +/** @file town_land.h Sprites to use and how to display them for town tiles. */ /** Writes the data into the Town Tile Drawing Struct * @param s1 The first sprite of the building, mostly the ground sprite diff --git a/src/table/track_land.h b/src/table/track_land.h index 3f4a00fb99..b27c09d1a4 100644 --- a/src/table/track_land.h +++ b/src/table/track_land.h @@ -1,5 +1,7 @@ /* $Id$ */ +/** @file track_land.h Sprites to use and how to display them for train depot/waypoint tiles. */ + #define TILE_SEQ_LINE(img, dx, dy, sx, sy) { dx, dy, 0, sx, sy, 23, {img, PAL_NONE} }, #define TILE_SEQ_END() { (byte)0x80, 0, 0, 0, 0, 0, {0, 0} } diff --git a/src/table/train_cmd.h b/src/table/train_cmd.h index 1bf8e70c83..63f9a292a6 100644 --- a/src/table/train_cmd.h +++ b/src/table/train_cmd.h @@ -1,5 +1,7 @@ /* $Id$ */ +/** @file train_cmd.h Sprites to use for trains. */ + static const SpriteID _engine_sprite_base[] = { 0x0B59, 0x0B61, 0x0B69, 0x0BE1, 0x0B71, 0x0B75, 0x0B7D, 0x0B7D, 0x0B85, 0x0B85, 0x0B8D, 0x0B8D, 0x0BC9, 0x0BD1, 0x0BD9, 0x0BE9, diff --git a/src/table/tree_land.h b/src/table/tree_land.h index e775c9384c..3e6ea50601 100644 --- a/src/table/tree_land.h +++ b/src/table/tree_land.h @@ -1,5 +1,7 @@ /* $Id$ */ +/** @file tree_land.h Sprites to use and how to display them for tree tiles. */ + #ifndef TREE_LAND_H #define TREE_LAND_H diff --git a/src/table/unicode.h b/src/table/unicode.h index d6ed30f7bc..cec329b9c1 100644 --- a/src/table/unicode.h +++ b/src/table/unicode.h @@ -1,5 +1,6 @@ /* $Id$ */ +/** @file unicode.h Character mapping for using Unicode characters in OTTD. */ struct DefaultUnicodeMapping { WChar code; ///< Unicode value diff --git a/src/table/unmovable_land.h b/src/table/unmovable_land.h index e7a97cb896..063a89f843 100644 --- a/src/table/unmovable_land.h +++ b/src/table/unmovable_land.h @@ -1,5 +1,6 @@ /* $Id$ */ +/** @file unmovable_land.h Sprites to use and how to display them for unmovable tiles. */ static const DrawTileSeqStruct _draw_tile_transmitterlighthouse_data[] = { { 7, 7, 0, 2, 2, 70, {SPR_UNMOVABLE_TRANSMITTER, PAL_NONE}}, diff --git a/src/table/water_land.h b/src/table/water_land.h index c6de3c9c8c..3a5c01f276 100644 --- a/src/table/water_land.h +++ b/src/table/water_land.h @@ -1,5 +1,7 @@ /* $Id$ */ +/** @file water_land.h Sprites to use and how to display them for water tiles (depots/shiplifts). */ + struct WaterDrawTileStruct { byte delta_x; byte delta_y; diff --git a/src/terraform_gui.cpp b/src/terraform_gui.cpp index a215bd475d..76da96c3cb 100644 --- a/src/terraform_gui.cpp +++ b/src/terraform_gui.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file terraform_gui.cpp */ +/** @file terraform_gui.cpp GUI related to terraforming the map. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/texteff.cpp b/src/texteff.cpp index d93f4a6cc1..61eabd4a14 100644 --- a/src/texteff.cpp +++ b/src/texteff.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file texteff.cpp */ +/** @file texteff.cpp Handling of text effects. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/texteff.hpp b/src/texteff.hpp index 4911d43f40..36692a49a7 100644 --- a/src/texteff.hpp +++ b/src/texteff.hpp @@ -1,5 +1,7 @@ /* $Id$ */ +/** @file texteff.hpp Functions related to text effects. */ + #ifndef TEXTEFF_HPP #define TEXTEFF_HPP diff --git a/src/tgp.h b/src/tgp.h index dd2ea8f8f6..fa19d6e171 100644 --- a/src/tgp.h +++ b/src/tgp.h @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file tgp.h */ +/** @file tgp.h Functions for the Perlin noise enhanced map generator. */ #ifndef TGP_H #define TGP_H diff --git a/src/thread.h b/src/thread.h index 2b12b45826..a1fd4d8d54 100644 --- a/src/thread.h +++ b/src/thread.h @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file thread.h */ +/** @file thread.h Base of all threads. */ #ifndef THREAD_H #define THREAD_H diff --git a/src/tile_map.cpp b/src/tile_map.cpp index 0661e76049..f6cb0adefe 100644 --- a/src/tile_map.cpp +++ b/src/tile_map.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file tile_map.cpp */ +/** @file tile_map.cpp Global tile accessors. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/timetable.h b/src/timetable.h index 1e0f57fa9e..d5d5268e20 100644 --- a/src/timetable.h +++ b/src/timetable.h @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file timetable.h */ +/** @file timetable.h Functions related to time tabling. */ #ifndef TIMETABLE_H #define TIMETABLE_H diff --git a/src/timetable_cmd.cpp b/src/timetable_cmd.cpp index 4d463fb605..bbf5294298 100644 --- a/src/timetable_cmd.cpp +++ b/src/timetable_cmd.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file timetable_cmd.cpp */ +/** @file timetable_cmd.cpp Commands related to time tabling. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/timetable_gui.cpp b/src/timetable_gui.cpp index 86d30f8b9c..d7eaa8024e 100644 --- a/src/timetable_gui.cpp +++ b/src/timetable_gui.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file timetable_gui.cpp */ +/** @file timetable_gui.cpp GUI for time tabling. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/town.h b/src/town.h index ab49775d35..0b09522561 100644 --- a/src/town.h +++ b/src/town.h @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file town.h */ +/** @file town.h Base of the town class. */ #ifndef TOWN_H #define TOWN_H diff --git a/src/town_cmd.cpp b/src/town_cmd.cpp index bd297ac2df..1b65f3e8f5 100644 --- a/src/town_cmd.cpp +++ b/src/town_cmd.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file town_cmd.cpp */ +/** @file town_cmd.cpp Handling of town tiles. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/town_gui.cpp b/src/town_gui.cpp index 3937e9917b..f805bd1ac5 100644 --- a/src/town_gui.cpp +++ b/src/town_gui.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file town_gui.cpp */ +/** @file town_gui.cpp GUI for towns. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/train.h b/src/train.h index 7086aedda2..c78ab61676 100644 --- a/src/train.h +++ b/src/train.h @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file train.h */ +/** @file train.h Base for the train class. */ #ifndef TRAIN_H #define TRAIN_H diff --git a/src/train_cmd.cpp b/src/train_cmd.cpp index b3391af373..41844cae33 100644 --- a/src/train_cmd.cpp +++ b/src/train_cmd.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file train_cmd.cpp */ +/** @file train_cmd.cpp Handling of trains. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/train_gui.cpp b/src/train_gui.cpp index c78ca9475b..5e40583b79 100644 --- a/src/train_gui.cpp +++ b/src/train_gui.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file train_gui.cpp */ +/** @file train_gui.cpp GUI for trains. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/transparency.h b/src/transparency.h index 35d8cbde73..efac5bfea9 100644 --- a/src/transparency.h +++ b/src/transparency.h @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file transparency.h */ +/** @file transparency.h Functions related to transparency. */ #ifndef TRANSPARENCY_H #define TRANSPARENCY_H diff --git a/src/transparency_gui.cpp b/src/transparency_gui.cpp index a88e9fa1bd..b0e9da16fd 100644 --- a/src/transparency_gui.cpp +++ b/src/transparency_gui.cpp @@ -1,5 +1,7 @@ /* $Id$ */ +/** @file transparency_gui.cpp The transparency GUI. */ + #include "stdafx.h" #include "openttd.h" #include "gui.h" diff --git a/src/transparency_gui.h b/src/transparency_gui.h index 8ecb03a73e..1b0b3ec5bc 100644 --- a/src/transparency_gui.h +++ b/src/transparency_gui.h @@ -1,5 +1,7 @@ /* $Id$ */ +/** @file transparency_gui.h GUI functions related to transparency. */ + #ifndef TRANSPARENCY_GUI_H #define TRANSPARENCY_GUI_H diff --git a/src/tree_cmd.cpp b/src/tree_cmd.cpp index 93bca61826..0c7c8e9e07 100644 --- a/src/tree_cmd.cpp +++ b/src/tree_cmd.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file tree_cmd.cpp */ +/** @file tree_cmd.cpp Handling of tree tiles. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/tree_map.h b/src/tree_map.h index f0fd354b4f..fd3d601949 100644 --- a/src/tree_map.h +++ b/src/tree_map.h @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file tree_map.h */ +/** @file tree_map.h Map accessors for tree tiles. */ #ifndef TREE_MAP_H #define TREE_MAP_H diff --git a/src/tunnel_map.cpp b/src/tunnel_map.cpp index 57ab9a6ec8..648f233a86 100644 --- a/src/tunnel_map.cpp +++ b/src/tunnel_map.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file tunnel_map.cpp */ +/** @file tunnel_map.cpp Map accessors for tunnels. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/tunnel_map.h b/src/tunnel_map.h index 8cbd10a7d2..c3362765b1 100644 --- a/src/tunnel_map.h +++ b/src/tunnel_map.h @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file tunnel_map.h */ +/** @file tunnel_map.h Map accessors for tunnels. */ #ifndef TUNNEL_MAP_H #define TUNNEL_MAP_H diff --git a/src/unix.cpp b/src/unix.cpp index 8daca5f9f8..c272c2c403 100644 --- a/src/unix.cpp +++ b/src/unix.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file unix.cpp */ +/** @file unix.cpp Implementation of Unix specific file handling. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/unmovable.h b/src/unmovable.h index 133f6546f9..a1db817236 100644 --- a/src/unmovable.h +++ b/src/unmovable.h @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file unmovable.h */ +/** @file unmovable.h Functions related to unmovable objects. */ #ifndef UNMOVABLE_H #define UNMOVABLE_H diff --git a/src/unmovable_cmd.cpp b/src/unmovable_cmd.cpp index 5ddb76b78b..32a368f2b6 100644 --- a/src/unmovable_cmd.cpp +++ b/src/unmovable_cmd.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file unmovable_cmd.cpp */ +/** @file unmovable_cmd.cpp Handling of unmovable tiles. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/unmovable_map.h b/src/unmovable_map.h index 0f6283cb70..8c2b55d091 100644 --- a/src/unmovable_map.h +++ b/src/unmovable_map.h @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file unmovable_map.h */ +/** @file unmovable_map.h Map accessors for unmovable tiles. */ #ifndef UNMOVABLE_MAP_H #define UNMOVABLE_MAP_H diff --git a/src/variables.h b/src/variables.h index d3a8981d86..3091fefc29 100644 --- a/src/variables.h +++ b/src/variables.h @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file variables.h */ +/** @file variables.h Messing file that will cease to exist some time in the future. */ #ifndef VARIABLES_H #define VARIABLES_H diff --git a/src/vehicle.cpp b/src/vehicle.cpp index 8b32aa4dee..c624f97b68 100644 --- a/src/vehicle.cpp +++ b/src/vehicle.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file vehicle.cpp */ +/** @file vehicle.cpp Base implementations of all vehicles. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/vehicle_func.h b/src/vehicle_func.h index b9d59f3194..371adc1c73 100644 --- a/src/vehicle_func.h +++ b/src/vehicle_func.h @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file vehicle.h Functions related to vehicles. */ +/** @file vehicle_func.h Functions related to vehicles. */ #ifndef VEHICLE_FUNC_H #define VEHICLE_FUNC_H diff --git a/src/vehicle_gui.cpp b/src/vehicle_gui.cpp index 71e3071e5c..a99c8cf162 100644 --- a/src/vehicle_gui.cpp +++ b/src/vehicle_gui.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file vehicle_gui.cpp */ +/** @file vehicle_gui.cpp The base GUI for all vehicles. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/vehicle_gui.h b/src/vehicle_gui.h index a642640693..1fe4cd8c98 100644 --- a/src/vehicle_gui.h +++ b/src/vehicle_gui.h @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file vehicle_gui.h */ +/** @file vehicle_gui.h Functions related to the vehicle's GUIs. */ #ifndef VEHICLE_GUI_H #define VEHICLE_GUI_H diff --git a/src/video/cocoa/cocoa_keys.h b/src/video/cocoa/cocoa_keys.h index 1e69c14254..579cd1f451 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 10c408f0a2..cfc63147d0 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 8389d48743..523bb403dd 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 434a3c041f..731b7a7239 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 cc488af11d..f8258950df 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 e32a88536c..c45a5a46c8 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 de9bbbfa49..a9a13411c3 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 ab56f99c3e..5b7758e263 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 2cd81154ea..7a165ec17f 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 eb78408f47..35d6984557 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 223772d754..4f001dff65 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 diff --git a/src/viewport.cpp b/src/viewport.cpp index 56c3678c7b..a741a83a7f 100644 --- a/src/viewport.cpp +++ b/src/viewport.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file viewport.cpp +/** @file viewport.cpp Handling of all viewports. * * \verbatim * The in-game coordinate system looks like this * diff --git a/src/void_map.h b/src/void_map.h index df650cfcb5..47d6ee5fc0 100644 --- a/src/void_map.h +++ b/src/void_map.h @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file void_map.h */ +/** @file void_map.h Map accessors for void tiles. */ #ifndef VOID_MAP_H #define VOID_MAP_H diff --git a/src/water_cmd.cpp b/src/water_cmd.cpp index 912b7c99b0..ddbf185ffd 100644 --- a/src/water_cmd.cpp +++ b/src/water_cmd.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file water_cmd.cpp */ +/** @file water_cmd.cpp Handling of water tiles. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/water_map.h b/src/water_map.h index bf1935701f..94e8053428 100644 --- a/src/water_map.h +++ b/src/water_map.h @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file water_map.h */ +/** @file water_map.h Map accessors for water tiles. */ #ifndef WATER_MAP_H #define WATER_MAP_H diff --git a/src/waypoint.cpp b/src/waypoint.cpp index 2a0e98eb68..99e099c079 100644 --- a/src/waypoint.cpp +++ b/src/waypoint.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file waypoint.cpp */ +/** @file waypoint.cpp Handling of waypoints. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/waypoint.h b/src/waypoint.h index be259e6308..a6ba958ae1 100644 --- a/src/waypoint.h +++ b/src/waypoint.h @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file waypoint.h */ +/** @file waypoint.h Base of waypoints. */ #ifndef WAYPOINT_H #define WAYPOINT_H diff --git a/src/widget.cpp b/src/widget.cpp index ae70a2e315..9d6bba9140 100644 --- a/src/widget.cpp +++ b/src/widget.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file widget.cpp */ +/** @file widget.cpp Handling of the default/simple widgets. */ #include "stdafx.h" #include "openttd.h" diff --git a/src/widgets/dropdown.cpp b/src/widgets/dropdown.cpp index 6bf7358b8d..ea2d3a5f50 100644 --- a/src/widgets/dropdown.cpp +++ b/src/widgets/dropdown.cpp @@ -1,5 +1,7 @@ /* $Id$ */ +/** @file dropdown.cpp Implementation of the dropdown widget. */ + #include "../stdafx.h" #include "../openttd.h" #include "../strings_type.h" diff --git a/src/widgets/dropdown_func.h b/src/widgets/dropdown_func.h index ac0e0a9068..03cb52d0c2 100644 --- a/src/widgets/dropdown_func.h +++ b/src/widgets/dropdown_func.h @@ -1,5 +1,7 @@ /* $Id$ */ +/** @file dropdown_func.h Functions related to the drop down widget. */ + #ifndef WIDGETS_DROPDOWN_FUNC_H #define WIDGETS_DROPDOWN_FUNC_H diff --git a/src/widgets/dropdown_type.h b/src/widgets/dropdown_type.h index a93cbb360b..3cdb48f87b 100644 --- a/src/widgets/dropdown_type.h +++ b/src/widgets/dropdown_type.h @@ -1,5 +1,7 @@ /* $Id$ */ +/** @file dropdown_type.h Types related to the drop down widget. */ + #ifndef WIDGETS_DROPDOWN_TYPE_H #define WIDGETS_DROPDOWN_TYPE_H diff --git a/src/window.cpp b/src/window.cpp index 5975422759..8737ba1e80 100644 --- a/src/window.cpp +++ b/src/window.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file window.cpp windowing system, widgets and events */ +/** @file window.cpp Windowing system, widgets and events */ #include "stdafx.h" #include diff --git a/src/yapf/nodelist.hpp b/src/yapf/nodelist.hpp index a174d69d83..ede2169f8a 100644 --- a/src/yapf/nodelist.hpp +++ b/src/yapf/nodelist.hpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file nodelist.hpp */ +/** @file nodelist.hpp List of nodes used for the A-star pathfinder. */ #ifndef NODELIST_HPP #define NODELIST_HPP diff --git a/src/yapf/yapf.h b/src/yapf/yapf.h index f11ef2a40d..a4c435fcf7 100644 --- a/src/yapf/yapf.h +++ b/src/yapf/yapf.h @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file yapf.h */ +/** @file yapf.h Entry point for OpenTTD to YAPF. */ #ifndef YAPF_H #define YAPF_H diff --git a/src/yapf/yapf.hpp b/src/yapf/yapf.hpp index 82ee7bfa6c..bdd975e8cf 100644 --- a/src/yapf/yapf.hpp +++ b/src/yapf/yapf.hpp @@ -1,5 +1,7 @@ /* $Id$ */ +/** @file yapf.hpp Base includes/functions for YAPF. */ + #ifndef YAPF_HPP #define YAPF_HPP diff --git a/src/yapf/yapf_base.hpp b/src/yapf/yapf_base.hpp index 1e8ea89730..f83ecbb209 100644 --- a/src/yapf/yapf_base.hpp +++ b/src/yapf/yapf_base.hpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file yapf_base.hpp */ +/** @file yapf_base.hpp Base classes for YAPF. */ #ifndef YAPF_BASE_HPP #define YAPF_BASE_HPP diff --git a/src/yapf/yapf_common.hpp b/src/yapf/yapf_common.hpp index b507ceb9e3..b13d76fe5f 100644 --- a/src/yapf/yapf_common.hpp +++ b/src/yapf/yapf_common.hpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file yapf_common.hpp */ +/** @file yapf_common.hpp Commonly used classes for YAPF. */ #ifndef YAPF_COMMON_HPP #define YAPF_COMMON_HPP diff --git a/src/yapf/yapf_costbase.hpp b/src/yapf/yapf_costbase.hpp index 6aef7fbd00..f48e5bade4 100644 --- a/src/yapf/yapf_costbase.hpp +++ b/src/yapf/yapf_costbase.hpp @@ -1,5 +1,7 @@ /* $Id$ */ +/** @file yapf_costbase.hpp Handling of cost determination. */ + #ifndef YAPF_COSTBASE_HPP #define YAPF_COSTBASE_HPP diff --git a/src/yapf/yapf_costcache.hpp b/src/yapf/yapf_costcache.hpp index 24e7e2dbde..964e638c37 100644 --- a/src/yapf/yapf_costcache.hpp +++ b/src/yapf/yapf_costcache.hpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file yapf_costcache.hpp */ +/** @file yapf_costcache.hpp Caching of segment costs. */ #ifndef YAPF_COSTCACHE_HPP #define YAPF_COSTCACHE_HPP diff --git a/src/yapf/yapf_costrail.hpp b/src/yapf/yapf_costrail.hpp index 5756f04672..eaba2fe80f 100644 --- a/src/yapf/yapf_costrail.hpp +++ b/src/yapf/yapf_costrail.hpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file yapf_costrail.hpp */ +/** @file yapf_costrail.hpp Cost determination for rails. */ #ifndef YAPF_COSTRAIL_HPP #define YAPF_COSTRAIL_HPP diff --git a/src/yapf/yapf_destrail.hpp b/src/yapf/yapf_destrail.hpp index fab8400d12..b648642cfa 100644 --- a/src/yapf/yapf_destrail.hpp +++ b/src/yapf/yapf_destrail.hpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file yapf_destrail.hpp */ +/** @file yapf_destrail.hpp Determining the destination for rail vehicles. */ #ifndef YAPF_DESTRAIL_HPP #define YAPF_DESTRAIL_HPP diff --git a/src/yapf/yapf_node.hpp b/src/yapf/yapf_node.hpp index 305e848a73..5857e3a7db 100644 --- a/src/yapf/yapf_node.hpp +++ b/src/yapf/yapf_node.hpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file yapf_node.hpp */ +/** @file yapf_node.hpp Node in the pathfinder's graph. */ #ifndef YAPF_NODE_HPP #define YAPF_NODE_HPP diff --git a/src/yapf/yapf_node_rail.hpp b/src/yapf/yapf_node_rail.hpp index 3d112888d9..9745ff38d0 100644 --- a/src/yapf/yapf_node_rail.hpp +++ b/src/yapf/yapf_node_rail.hpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file yapf_node_rail.hpp */ +/** @file yapf_node_rail.hpp Node tailored for rail pathfinding. */ #ifndef YAPF_NODE_RAIL_HPP #define YAPF_NODE_RAIL_HPP diff --git a/src/yapf/yapf_node_road.hpp b/src/yapf/yapf_node_road.hpp index ff4856c8d4..8d6fd2978a 100644 --- a/src/yapf/yapf_node_road.hpp +++ b/src/yapf/yapf_node_road.hpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file yapf_node_road.hpp */ +/** @file yapf_node_road.hpp Node tailored for road pathfinding. */ #ifndef YAPF_NODE_ROAD_HPP #define YAPF_NODE_ROAD_HPP diff --git a/src/yapf/yapf_rail.cpp b/src/yapf/yapf_rail.cpp index 159c097d4f..ffbb1a2c14 100644 --- a/src/yapf/yapf_rail.cpp +++ b/src/yapf/yapf_rail.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file yapf_rail.cpp */ +/** @file yapf_rail.cpp The rail pathfinding. */ #include "../stdafx.h" diff --git a/src/yapf/yapf_road.cpp b/src/yapf/yapf_road.cpp index ce032eacda..a0ea6864fd 100644 --- a/src/yapf/yapf_road.cpp +++ b/src/yapf/yapf_road.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file yapf_road.cpp */ +/** @file yapf_road.cpp The road pathfinding. */ #include "../stdafx.h" #include "../depot_base.h" diff --git a/src/yapf/yapf_settings.h b/src/yapf/yapf_settings.h index 0d840721df..18f7947b88 100644 --- a/src/yapf/yapf_settings.h +++ b/src/yapf/yapf_settings.h @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file yapf_settings.h */ +/** @file yapf_settings.h Penalty settings for YAPF. */ #if !defined(YAPF_SETTINGS_H) || defined(YS_DEF) diff --git a/src/yapf/yapf_ship.cpp b/src/yapf/yapf_ship.cpp index 7a58a765a0..9a6f571236 100644 --- a/src/yapf/yapf_ship.cpp +++ b/src/yapf/yapf_ship.cpp @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file yapf_ship.cpp */ +/** @file yapf_ship.cpp Implementation of YAPF for ships. */ #include "../stdafx.h" diff --git a/src/zoom_func.h b/src/zoom_func.h index c6cc51861c..1c3c9c9b32 100644 --- a/src/zoom_func.h +++ b/src/zoom_func.h @@ -1,6 +1,6 @@ /* $Id$ */ -/** @file zoom_func.h */ +/** @file zoom_func.h Functions related to zooming. */ #ifndef ZOOM_FUNC_H #define ZOOM_FUNC_H