From ed4f806f1dcff2e10d2fdfb687e6bcebe9a81af3 Mon Sep 17 00:00:00 2001 From: frosch Date: Sun, 1 Aug 2010 19:22:34 +0000 Subject: (svn r20283) -Codechange: Unify start of doygen comments. --- src/station_cmd.cpp | 48 ++++++++++++++++++++++++++++++++---------------- 1 file changed, 32 insertions(+), 16 deletions(-) (limited to 'src/station_cmd.cpp') diff --git a/src/station_cmd.cpp b/src/station_cmd.cpp index 55bedff47..fb2ab235a 100644 --- a/src/station_cmd.cpp +++ b/src/station_cmd.cpp @@ -432,7 +432,8 @@ void UpdateAllStationVirtCoords() } } -/** Get a mask of the cargo types that the station accepts. +/** + * Get a mask of the cargo types that the station accepts. * @param st Station to query * @return the expected mask */ @@ -446,7 +447,8 @@ static uint GetAcceptanceMask(const Station *st) return mask; } -/** Items contains the two cargo names that are to be accepted or rejected. +/** + * Items contains the two cargo names that are to be accepted or rejected. * msg is the string id of the message to display. */ static void ShowRejectOrAcceptNews(const Station *st, uint num_items, CargoID *cargo, StringID msg) @@ -549,7 +551,8 @@ CargoArray GetAcceptanceAroundTiles(TileIndex tile, int w, int h, int rad, uint3 return acceptance; } -/** Update the acceptance for a station. +/** + * Update the acceptance for a station. * @param st Station to update * @param show_msg controls whether to display a message that acceptance was changed. */ @@ -642,7 +645,8 @@ static void UpdateStationSignCoord(BaseStation *st) st->UpdateVirtCoord(); } -/** This is called right after a station was deleted. +/** + * This is called right after a station was deleted. * It checks if the whole station is free of substations, and if so, the station will be * deleted after a little while. * @param st Station @@ -659,7 +663,8 @@ static void DeleteStationIfEmpty(BaseStation *st) CommandCost ClearTile_Station(TileIndex tile, DoCommandFlag flags); -/** Checks if the given tile is buildable, flat and has a certain height. +/** + * Checks if the given tile is buildable, flat and has a certain height. * @param tile TileIndex to check. * @param invalid_dirs Prohibited directions for slopes (set of #DiagDirection). * @param allowed_z Height allowed for the tile. If allowed_z is negative, it will be set to the height of this tile. @@ -711,7 +716,8 @@ CommandCost CheckBuildableTile(TileIndex tile, uint invalid_dirs, int &allowed_z return cost; } -/** Tries to clear the given area. +/** + * Tries to clear the given area. * @param tile_area Area to check. * @param flags Operation to perform. * @return The cost in case of success, or an error code if it failed. @@ -734,7 +740,8 @@ CommandCost CheckFlatLand(TileArea tile_area, DoCommandFlag flags) return cost; } -/** Checks if a rail station can be built at the given area. +/** + * Checks if a rail station can be built at the given area. * @param tile_area Area to check. * @param flags Operation to perform. * @param invalid_dirs Prohibited directions (set of #DiagDirection). @@ -807,7 +814,8 @@ static CommandCost CheckFlatLandRailStation(TileArea tile_area, DoCommandFlag fl return cost; } -/** Checks if a road stop can be built at the given tile. +/** + * Checks if a road stop can be built at the given tile. * @param tile_area Area to check. * @param flags Operation to perform. * @param invalid_dirs Prohibited directions (set of DiagDirections). @@ -1461,7 +1469,8 @@ CommandCost RemoveFromRailBaseStation(TileArea ta, SmallVector &affected return total_cost; } -/** Remove a single tile from a rail station. +/** + * Remove a single tile from a rail station. * This allows for custom-built station with holes and weird layouts * @param start tile of station piece to remove * @param flags operation to perform @@ -1495,7 +1504,8 @@ CommandCost CmdRemoveFromRailStation(TileIndex start, DoCommandFlag flags, uint3 return ret; } -/** Remove a single tile from a waypoint. +/** + * Remove a single tile from a waypoint. * This allows for custom-built waypoint with holes and weird layouts * @param start tile of waypoint piece to remove * @param flags operation to perform @@ -1659,7 +1669,8 @@ static CommandCost FindJoiningRoadStop(StationID existing_stop, StationID statio return FindJoiningBaseStation(existing_stop, station_to_join, adjacent, ta, st); } -/** Build a bus or truck stop. +/** + * Build a bus or truck stop. * @param tile Northernmost tile of the stop. * @param flags Operation to perform. * @param p1 bit 0..7: Width of the road stop. @@ -1910,7 +1921,8 @@ static CommandCost RemoveRoadStop(TileIndex tile, DoCommandFlag flags) return CommandCost(EXPENSES_CONSTRUCTION, _price[is_truck ? PR_CLEAR_STATION_TRUCK : PR_CLEAR_STATION_BUS]); } -/** Remove bus or truck stops. +/** + * Remove bus or truck stops. * @param tile Northernmost tile of the removal area. * @param flags Operation to perform. * @param p1 bit 0..7: Width of the removal area. @@ -1990,7 +2002,8 @@ static uint GetMinimalAirportDistanceToTile(const AirportSpec *as, TileIndex tow return dx + dy; } -/** Get a possible noise reduction factor based on distance from town center. +/** + * Get a possible noise reduction factor based on distance from town center. * The further you get, the less noise you generate. * So all those folks at city council can now happily slee... work in their offices * @param as airport information @@ -2064,7 +2077,8 @@ void UpdateAirportsNoise() } } -/** Place an Airport. +/** + * Place an Airport. * @param tile tile where airport will be built * @param flags operation to perform * @param p1 @@ -2336,7 +2350,8 @@ static const TileIndexDiffC _dock_tileoffs_chkaround[] = { static const byte _dock_w_chk[4] = { 2, 1, 2, 1 }; static const byte _dock_h_chk[4] = { 1, 2, 1, 2 }; -/** Build a dock/haven. +/** + * Build a dock/haven. * @param tile tile where dock will be built * @param flags operation to perform * @param p1 (bit 0) - allow docks directly adjacent to other docks. @@ -3181,7 +3196,8 @@ static bool IsUniqueStationName(const char *name) return true; } -/** Rename a station +/** + * Rename a station * @param tile unused * @param flags operation to perform * @param p1 station ID that is to be renamed -- cgit v1.2.3-54-g00ecf