From d03994098be29bd48f3b715c533ffac3b1315eb0 Mon Sep 17 00:00:00 2001 From: rubidium Date: Tue, 6 May 2008 15:11:33 +0000 Subject: (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 6eb9d1232..6ece8dbcd 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 4849cf273..5e7330eb1 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 44c6fe78c..430d6a5e8 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 3a2d90c94..db9fcd141 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 bbe84770f..b0a4163be 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 eb7154092..cbb448dc9 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 e58c92a27..dbb43fc55 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 7773934d3..9f990b554 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 2a369cd03..9672a9664 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 352a62761..c25bcb538 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 cef1debd1..ae0e14e49 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 595b7c94e..2208d32ec 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 9d91a5d75..0e00f3d41 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 5728380e8..1e5dbcb70 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 1128101d0..0fd3e9d68 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 1f949722c..d84531e42 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 74f4b3f8e..abfe495b0 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 a980d59c0..0a0eaf805 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 2b7909fb8..91b851223 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 99ca1b207..05fb0a806 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 924803be9..ccbc38af9 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 255cca48b..373253deb 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 0358ae5dc..eddec74ff 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 5a664cd0b..dca8728ad 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 f4be19926..c0958b0e9 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 d437dcdab..46c30ec25 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 b5fa3f06d..0d60a7234 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 448b819bf..5ca965b27 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 7b813f6e7..78bb90f5e 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 b437a080b..eecd6e139 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 d084965a1..3ce0600c3 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 e140d0db5..688391bd0 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 7b7165975..a230b6015 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 4dfe91604..d377b522a 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 77698cb1c..5bef7927f 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 9ab78db64..49278f970 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 cefaaa29f..6a4e4196a 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 6b4a71a72..e991ed8d6 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 326155551..d9589bd51 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 c5677fbd7..f28111c24 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 daf02c28d..a54bac5fd 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 317037723..2361a6ddc 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 16de09821..24c65a8eb 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 1a8f1ef91..071bf9786 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 3718bd1c8..2964f0585 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 2bc7928b9..7f9cd956b 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 51bd2fd64..a117fd613 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 693f8a5fc..f0b41d430 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 24e8bd0e4..578ae7ef5 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 02c2b6572..ff972db1f 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 6573915d5..88097d935 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 26c380cec..2f9cc7d9f 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 c1bb05676..96b309997 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 30f1c30d9..4c57ad532 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 47e6d9212..8c0b89b72 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 f399aadf8..028335d76 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 872558fb3..1710e9a4d 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 614caa53f..1b8662386 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 9042e6a7e..775ae8338 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 4e2e948d5..71b81059c 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 d51e59eeb..c2ff9d49e 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 a301b5b3b..cd273cb08 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 d732bcbfb..816dbe7c4 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 cd967f603..08b839a72 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 fd9478513..ce8b99343 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 aefa0a64b..9dbf2642c 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 15f9f8c31..936d7f683 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 8acf58022..95b2a186a 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 9475366d0..8b9abe06a 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 e1c9e2168..35d35e392 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 fcd4adebc..376acf0ea 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 bc75b7fb3..44b66b125 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 487be75d5..a71f21cc7 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 e78dfaf5b..6b8d857d3 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 28cf2a271..f426fed82 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 2c7369b4e..5ff83ad07 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 4b600ea83..877e7fa3e 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 4e0dead97..46b8c1460 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 6e776ea0a..1db2471a7 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 c721e31a1..3d9df73f3 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 a5cc16453..56108e1b5 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 9e1d3c80a..f6d15e3ef 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 3ea776d5c..e67dc4e9e 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 14c735c02..0135c2567 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 8df195318..14181a400 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 bdbdc072d..55dcddacb 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 ad121ca70..25c1f8fac 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 1fc357d1c..9cd09a701 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 65ae87287..0d5f00704 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 af77f3d45..acfaa907c 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 2bd262385..c0350185d 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 2ebeac69f..37def4598 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 45c31a1c6..ee3c4dfaa 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 850a3c5de..39712c4ad 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 967b66f9f..1d961b4da 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 afee0f3ac..e82f34add 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 c04ebd83d..a42ebe324 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 5cf66e7ce..1bbe197d9 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 4f55cc272..af8dd4fbe 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 497cb5744..142f164fe 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 80228c7fd..ea233a230 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 34e989be1..9e281e7d8 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 e141b3f57..1acdfff6e 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 95c9edb28..3cbdaee98 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 00fe99706..4e2db7735 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 8aa4f2e44..a5f6674c4 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 bf8ba3b7c..c006087d1 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 76cd384d4..82a25f34c 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 9e2a5d70e..b9933674e 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 01e863873..6e8580fa7 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 67ddcc6a5..a3c4a6d9f 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 68e0bb0f8..702526153 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 505249e94..f8dfe0a56 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 7963520bc..047737eca 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 a88b6cbe9..b5ec1e9ff 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 78ebdc47f..8b55badf9 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 c485e9207..441c8a027 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 116fa3160..2de944c65 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 71f7ff03f..1d2f86dcd 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 a07c5ce60..c019ce5de 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 65bf08a5c..83aa6c294 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 d0a987e1a..10eb4eaa1 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 fad44114d..7b93b6cd8 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 35e90be97..d57f29688 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 e1138616a..93e60d441 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 48cfb0f8c..53e0dd9e5 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 21cc5f598..84579e113 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 8be0d45fb..875de065b 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 e76af957e..3b6557cde 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 7b14f83cf..289cb19a7 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 ac10097ba..e24cc97be 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 a7a4c388a..22726105d 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 ab5634cca..41bd4ee4f 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 096249c24..691159738 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 a29af52a8..4c4707257 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 b04e42d9f..ea16ecb38 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 af33bdb0e..a4c5bfb00 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 d5fa2ba2f..b5af27722 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 2457881fd..ad8fd8390 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 965a19573..43b8ee052 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 a8b6ab479..c4cc6bc3f 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 063ad2e10..51cd04b26 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 fc5c2bb09..bced36cf3 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 04add6e95..4461f003f 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 3ba1b5de6..76c0800a3 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 1106b1508..3eeedebd6 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 8ad964977..ef2c826b3 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 9d6684738..1fc2f8225 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 e048d9153..cbb402cc5 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 4fc370767..cd6cba2ea 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 6fdb9400a..0ecb15668 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 a73337ae6..9d596ae5b 100644 --- a/src/network/network.cpp +++ b/src/network/network.cpp @@ -1,5 +1,7 @@ /* $Id$ */ +/** @file network.cpp Base functions for networking support. */ + #include "../stdafx.h" #include "network_data.h" diff --git a/src/network/network.h b/src/network/network.h index fbe2a31cc..d3bf3d3e1 100644 --- a/src/network/network.h +++ b/src/network/network.h @@ -1,5 +1,7 @@ /* $Id$ */ +/** @file network.h Basic functions/variables used all over the place. */ + #ifndef NETWORK_H #define NETWORK_H diff --git a/src/network/network_client.cpp b/src/network/network_client.cpp index 65eb3e31b..02608bc38 100644 --- a/src/network/network_client.cpp +++ b/src/network/network_client.cpp @@ -1,5 +1,7 @@ /* $Id$ */ +/** @file network_client.cpp Client part of the network protocol. */ + #ifdef ENABLE_NETWORK #include "../stdafx.h" diff --git a/src/network/network_client.h b/src/network/network_client.h index 1778bc8fe..11dd26b93 100644 --- a/src/network/network_client.h +++ b/src/network/network_client.h @@ -1,5 +1,7 @@ /* $Id$ */ +/** @file network_client.h Client part of the network protocol. */ + #ifndef NETWORK_CLIENT_H #define NETWORK_CLIENT_H diff --git a/src/network/network_data.cpp b/src/network/network_data.cpp index a968b3114..ede255ba9 100644 --- a/src/network/network_data.cpp +++ b/src/network/network_data.cpp @@ -1,5 +1,7 @@ /* $Id$ */ +/** @file network_data.cpp Command handling over network connections. */ + #ifdef ENABLE_NETWORK #include "../stdafx.h" diff --git a/src/network/network_data.h b/src/network/network_data.h index 2034de5b9..32ed82a8e 100644 --- a/src/network/network_data.h +++ b/src/network/network_data.h @@ -1,5 +1,7 @@ /* $Id$ */ +/** @file network_data.h Internal functions. */ + #ifndef NETWORK_DATA_H #define NETWORK_DATA_H diff --git a/src/network/network_gamelist.h b/src/network/network_gamelist.h index 83ce10021..31ec69171 100644 --- a/src/network/network_gamelist.h +++ b/src/network/network_gamelist.h @@ -1,5 +1,7 @@ /* $Id$ */ +/** @file network_gamelist.h Handling of the list of games. */ + #ifndef NETWORK_GAMELIST_H #define NETWORK_GAMELIST_H diff --git a/src/network/network_gui.cpp b/src/network/network_gui.cpp index 36313b5ee..fdfe1f870 100644 --- a/src/network/network_gui.cpp +++ b/src/network/network_gui.cpp @@ -1,5 +1,7 @@ /* $Id$ */ +/** @file network_gui.cpp Implementation of the Network related GUIs. */ + #ifdef ENABLE_NETWORK #include "../stdafx.h" #include "../openttd.h" diff --git a/src/network/network_gui.h b/src/network/network_gui.h index 34597b4bb..20fb528f8 100644 --- a/src/network/network_gui.h +++ b/src/network/network_gui.h @@ -1,5 +1,7 @@ /* $Id$ */ +/** @file network_gui.h GUIs related to networking. */ + #ifndef NETWORK_GUI_H #define NETWORK_GUI_H diff --git a/src/network/network_internal.h b/src/network/network_internal.h index f44d36133..753cce206 100644 --- a/src/network/network_internal.h +++ b/src/network/network_internal.h @@ -1,5 +1,7 @@ /* $Id$ */ +/** @file network_internal.h Variables and function used internally. */ + #ifndef NETWORK_INTERNAL_H #define NETWORK_INTERNAL_H diff --git a/src/network/network_server.cpp b/src/network/network_server.cpp index 51bc76233..e75b2b001 100644 --- a/src/network/network_server.cpp +++ b/src/network/network_server.cpp @@ -1,5 +1,7 @@ /* $Id$ */ +/** @file network_server.cpp Server part of the network protocol. */ + #ifdef ENABLE_NETWORK #include "../stdafx.h" diff --git a/src/network/network_server.h b/src/network/network_server.h index aea76f33e..07f9cf29a 100644 --- a/src/network/network_server.h +++ b/src/network/network_server.h @@ -1,5 +1,7 @@ /* $Id$ */ +/** @file network_server.h Server part of the network protocol. */ + #ifndef NETWORK_SERVER_H #define NETWORK_SERVER_H diff --git a/src/network/network_udp.h b/src/network/network_udp.h index f62f3c016..4071ddc0f 100644 --- a/src/network/network_udp.h +++ b/src/network/network_udp.h @@ -1,5 +1,7 @@ /* $Id$ */ +/** @file network_udp.h Sending and receiving UDP messages. */ + #ifndef NETWORK_UDP_H #define NETWORK_UDP_H diff --git a/src/newgrf.cpp b/src/newgrf.cpp index 9bd55f104..d48974807 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 4bfc38f4e..c25baaeaf 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 8e5817cb4..2bae20e0e 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 50c60e524..70507dc11 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 03e7cdff8..14813159e 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 67630ee6d..790c0b3e8 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 168e6861e..eee0e9602 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 b1ce86601..a0bf437aa 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 5396e6268..45138d471 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 454ee0a25..a6438eca4 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 80c299230..6beb6b0da 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 682ecdb33..0b8b81882 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 0c24f88fc..81c2ee5c0 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 7c44be08e..3438a2ad8 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 604bb3660..4ece1f1ac 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 089f771fc..9a6f32d01 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 8aa65e453..942c504b7 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 9d532fa58..463598141 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 093aeef0b..cf77736e6 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 b7394f284..72834aa99 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 078e77b26..bc36bfd8a 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 794cee77f..43d5f9691 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 989ee2034..91b583639 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 fe8ef405b..2b2f3c60e 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 a15203fb7..8010cedf7 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 ec53fcc9a..878770c84 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 d1fdb429e..eeb77f645 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 92f0ecf12..7fbb4b147 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 adbb4228a..8a8d4a9ea 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 ca4580d14..36a444b4f 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 363b6b352..d69bccc0a 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 f7455efe9..856bfdd17 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 1581cfc98..d66a3a576 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 2c9801354..4397d8443 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 2511c2880..577a2945a 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 1ee6bebeb..3265bfb0c 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 f1661042f..39c6f1826 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 4a951065a..36f804386 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 8a953d029..e85c14229 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 b4831c772..00c46e859 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 dc2637acc..0dc11c233 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 3de85799e..ef33b3c9d 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 f644b5d0e..6e60b12ca 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 c8ea58c69..35aba54f8 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 f0ebb9291..3d1c4df64 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 ca0b279b4..11a5631a0 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 09a38a37d..d26f0e041 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 11f9bff90..c6528c377 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 b6aed6bab..76670fbec 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 188a6b9e9..b66626caf 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 ebd3a37ef..c1c6dcb6d 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 44c6c2e93..7caecf7db 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 bae773a91..fc21f5dfe 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 85c648baa..07ccb5204 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 692412630..991751e9c 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 c0ebde9ed..3e99f656f 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 0ff958e86..01b414661 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 c5d98daf2..6597bb1b0 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 8872f8530..05a7fd55f 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 1663987c7..b0d6d60a2 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 c7423380a..305a1ab25 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 6b112101a..f5b52a6fc 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 53859aa58..7796b7889 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 c55a1df51..68fa4d2f8 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 68b9bc277..49fe7894b 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 308472625..e69174ea8 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 071a472af..200828743 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 d7f4658f9..ca62dfce3 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 777d15d19..fa829ce67 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 35b2d7a93..79ab4c156 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 7fe3418a2..31d76e17d 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 2629e96ed..52689f575 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 93ab460f0..c067f1619 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 f0cea0eda..f4cf33070 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 b4e70ac4c..e2c8a70c0 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 a9c0cb801..74663cff7 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 5642c36a0..9921cb0cf 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 9ec6ac5cb..079132c2d 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 c8fe22ca3..03277ac8b 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 27b8d8980..49581fc18 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 f9f40d4e3..753bce764 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 83edccc99..e897f8306 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 55cc20be8..8f3f08579 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 386c6f4a5..66a7fde03 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 8fbd8b0c1..71859af90 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 11054c6a4..b996280d8 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 b4b3c57f0..1fdbc4f81 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 946efd6ca..65cc3b95e 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 bbc9d3f8f..4fcad5386 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 65b5f6233..f1e68aaa1 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 1041be7d5..495b1b5fb 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 7d821dc71..314e25e89 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 09ad505a8..6e107811a 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 f0c7c3694..8922a1fe3 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 08c67e0de..a2bd618d2 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 c1345e5c1..9c3d9d42a 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 0c255a942..ad7e05078 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 62c077f6b..0ae38c803 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 17bbb3ca1..43a1694fb 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 e4a034a4e..3057a88f0 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 37fbd8942..041fa8e45 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 ab2494808..06681ea00 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 9d54fc563..7c88ef68a 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 c95ccfb6f..5649637c1 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 f80b500c8..9e858c10b 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 64b01899f..ff2e000ae 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 6c24716f5..8467cb730 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 581c86855..cd2658798 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 1af7befd7..d889ba193 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 f929f6a9a..f9682aca5 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 8d892972a..d8db147dd 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 eeaab5c44..8381672ca 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 4007f8db3..179cc0346 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 1f41101fa..d688cf3e2 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 1665720a3..e5f3d8ed2 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 d1bff7cb6..51e5dc571 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 4ce0c20fb..5a221a6cb 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 cc2cb6af7..115ed663d 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 f02990f8d..249b6f482 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 89d7d30a1..3c1980dd8 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 3f4a00fb9..b27c09d1a 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 1bf8e70c8..63f9a292a 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 e775c9384..3e6ea5060 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 d6ed30f7b..cec329b9c 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 e7a97cb89..063a89f84 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 c6de3c9c8..3a5c01f27 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 a215bd475..76da96c3c 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 d93f4a6cc..61eabd4a1 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 4911d43f4..36692a49a 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 dd2ea8f8f..fa19d6e17 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 2b12b4582..a1fd4d8d5 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 0661e7604..f6cb0adef 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 1e0f57fa9..d5d5268e2 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 4d463fb60..bbf529429 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 86d30f8b9..d7eaa8024 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 ab49775d3..0b0952256 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 bd297ac2d..1b65f3e8f 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 3937e9917..f805bd1ac 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 7086aedda..c78ab6167 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 b3391af37..41844cae3 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 c78ca9475..5e40583b7 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 35d8cbde7..efac5bfea 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 a88e9fa1b..b0e9da16f 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 8ecb03a73..1b0b3ec5b 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 93bca6182..0c7c8e9e0 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 f0fd354b4..fd3d60194 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 57ab9a6ec..648f233a8 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 8cbd10a7d..c3362765b 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 8daca5f9f..c272c2c40 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 133f6546f..a1db81723 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 5ddb76b78..32a368f2b 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 0f6283cb7..8c2b55d09 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 d3a8981d8..3091fefc2 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 8b32aa4de..c624f97b6 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 b9d59f319..371adc1c7 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 71e3071e5..a99c8cf16 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 a64264069..1fe4cd8c9 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 1e69c1425..579cd1f45 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 10c408f0a..cfc63147d 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 8389d4874..523bb403d 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 434a3c041..731b7a723 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 cc488af11..f8258950d 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 e32a88536..c45a5a46c 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 de9bbbfa4..a9a13411c 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 ab56f99c3..5b7758e26 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 2cd81154e..7a165ec17 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 eb78408f4..35d698455 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 223772d75..4f001dff6 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 56c3678c7..a741a83a7 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 df650cfcb..47d6ee5fc 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 912b7c99b..ddbf185ff 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 bf1935701..94e805342 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 2a0e98eb6..99e099c07 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 be259e630..a6ba958ae 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 ae70a2e31..9d6bba914 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 6bf7358b8..ea2d3a5f5 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 ac0e0a906..03cb52d0c 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 a93cbb360..3cdb48f87 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 597542275..8737ba1e8 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 a174d69d8..ede2169f8 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 f11ef2a40..a4c435fcf 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 82ee7bfa6..bdd975e8c 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 1e8ea8973..f83ecbb20 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 b507ceb9e..b13d76fe5 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 6aef7fbd0..f48e5bade 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 24e7e2dbd..964e638c3 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 5756f0467..eaba2fe80 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 fab8400d1..b648642cf 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 305e848a7..5857e3a7d 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 3d112888d..9745ff38d 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 ff4856c8d..8d6fd2978 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 159c097d4..ffbb1a2c1 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 ce032eacd..a0ea6864f 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 0d840721d..18f7947b8 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 7a58a765a..9a6f57123 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 c6cc51861..1c3c9c9b3 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 -- cgit v1.2.3-70-g09d2