(svn r20283) -Codechange: Unify start of doygen comments.

1 files changed, 22 insertions, 11 deletions

diff --git a/src/aircraft_cmd.cpp b/src/aircraft_cmd.cpp
index c39be771a..cb7e5ffcc 100644
--- a/src/aircraft_cmd.cpp
+++ b/src/aircraft_cmd.cpp
@@ -7,7 +7,8 @@
  * See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with OpenTTD. If not, see <http://www.gnu.org/licenses/>.
  */
 
-/** @file aircraft_cmd.cpp
+/**
+ * @file aircraft_cmd.cpp
  * This file deals with aircraft and airport movements functionalities */
 
 #include "stdafx.h"
@@ -70,7 +71,8 @@ void Aircraft::UpdateDeltaXY(Direction direction)
 }
 
 
-/** this maps the terminal to its corresponding state and block flag
+/**
+ * this maps the terminal to its corresponding state and block flag
  *  currently set for 10 terms, 4 helipads */
 static const byte _airport_terminal_state[] = {2, 3, 4, 5, 6, 7, 19, 20, 0, 0, 8, 9, 21, 22};
 static const byte _airport_terminal_flag[] =  {0, 1, 2, 3, 4, 5, 22, 23, 0, 0, 6, 7, 24, 25};
@@ -100,7 +102,8 @@ enum HelicopterRotorStates {
 	HRS_ROTOR_MOVING_3,
 };
 
-/** Find the nearest hangar to v
+/**
+ * Find the nearest hangar to v
  * INVALID_STATION is returned, if the company does not have any suitable
  * airports (like helipads only)
  * @param v vehicle looking for a hangar
@@ -137,7 +140,8 @@ static StationID FindNearestHangar(const Aircraft *v)
 }
 
 #if 0
-/** Check if given vehicle has a goto hangar in his orders
+/**
+ * Check if given vehicle has a goto hangar in his orders
  * @param v vehicle to inquiry
  * @return true if vehicle v has an airport in the schedule, that has a hangar */
 static bool HaveHangarInOrderList(Aircraft *v)
@@ -213,7 +217,8 @@ void DrawAircraftEngine(int left, int right, int preferred_x, int y, EngineID en
 	}
 }
 
-/** Get the size of the sprite of an aircraft sprite heading west (used for lists)
+/**
+ * Get the size of the sprite of an aircraft sprite heading west (used for lists)
  * @param engine The engine to get the sprite from
  * @param width The width of the sprite
  * @param height The height of the sprite
@@ -226,7 +231,8 @@ void GetAircraftSpriteSize(EngineID engine, uint &width, uint &height)
 	height = spr->height;
 }
 
-/** Build an aircraft.
+/**
+ * Build an aircraft.
  * @param tile tile of depot where aircraft is built
  * @param flags for command
  * @param p1 aircraft type being built (engine)
@@ -383,7 +389,8 @@ CommandCost CmdBuildAircraft(TileIndex tile, DoCommandFlag flags, uint32 p1, uin
 }
 
 
-/** Sell an aircraft.
+/**
+ * Sell an aircraft.
  * @param tile unused
  * @param flags for command type
  * @param p1 vehicle ID to be sold
@@ -431,7 +438,8 @@ bool Aircraft::FindClosestDepot(TileIndex *location, DestinationID *destination,
 	return true;
 }
 
-/** Send an aircraft to the hangar.
+/**
+ * Send an aircraft to the hangar.
  * @param tile unused
  * @param flags for command type
  * @param p1 vehicle ID to send to the hangar
@@ -456,7 +464,8 @@ CommandCost CmdSendAircraftToHangar(TileIndex tile, DoCommandFlag flags, uint32
 }
 
 
-/** Refits an aircraft to the specified cargo type.
+/**
+ * Refits an aircraft to the specified cargo type.
  * @param tile unused
  * @param flags for command type
  * @param p1 vehicle ID of the aircraft to refit
@@ -634,7 +643,8 @@ void SetAircraftPosition(Aircraft *v, int x, int y, int z)
 	}
 }
 
-/** Handle Aircraft specific tasks when a an Aircraft enters a hangar
+/**
+ * Handle Aircraft specific tasks when a an Aircraft enters a hangar
  * @param *v Vehicle that enters the hangar
  */
 void HandleAircraftEnterHangar(Aircraft *v)
@@ -1952,7 +1962,8 @@ bool Aircraft::Tick()
 }
 
 
-/** Returns aircraft's target station if v->target_airport
+/**
+ * Returns aircraft's target station if v->target_airport
  * is a valid station with airport.
  * @param v vehicle to get target airport for
  * @return pointer to target station, NULL if invalid