(svn r24535) -Doc: Two additions, lots of small spelling fixes, and some Doxygen improvements.

8 files changed, 33 insertions, 27 deletions

diff --git a/src/engine.cpp b/src/engine.cpp
index 541c025dd..c84a3a686 100644
--- a/src/engine.cpp
+++ b/src/engine.cpp
@@ -900,6 +900,7 @@ static void NewVehicleAvailable(Engine *e)
 	if (e->type == VEH_SHIP) InvalidateWindowData(WC_BUILD_TOOLBAR, TRANSPORT_WATER);
 }
 
+/** Monthly update of the availability, reliability, and preview offers of the engines. */
 void EnginesMonthlyLoop()
 {
 	if (_cur_year < _year_engine_aging_stops) {
@@ -932,6 +933,11 @@ void EnginesMonthlyLoop()
 	}
 }
 
+/**
+ * Is \a name still free as name for an engine?
+ * @param name New name of an engine.
+ * @return \c false if the name is being used already, else \c true.
+ */
 static bool IsUniqueEngineName(const char *name)
 {
 	const Engine *e;
diff --git a/src/newgrf.cpp b/src/newgrf.cpp
index 0a5fb30a7..89e5a1c5a 100644
--- a/src/newgrf.cpp
+++ b/src/newgrf.cpp
@@ -58,7 +58,7 @@
  *
  * Contains portions of documentation by TTDPatch team.
  * Thanks especially to Josef Drexler for the documentation as well as a lot
- * of help at #tycoon. Also thanks to Michael Blunck for is GRF files which
+ * of help at #tycoon. Also thanks to Michael Blunck for his GRF files which
  * served as subject to the initial testing of this codec. */
 
 /** List of all loaded GRF files */
@@ -284,7 +284,7 @@ static const uint MAX_STATIONS = 256;
 
 /** Temporary engine data used when loading only */
 struct GRFTempEngineData {
-	/** Summary state of refitability properties */
+	/** Summary state of refittability properties */
 	enum Refittability {
 		UNSET    =  0,  ///< No properties assigned. Default refit masks shall be activated.
 		EMPTY,          ///< GRF defined vehicle as not-refittable. The vehicle shall only carry the default cargo.
@@ -1970,7 +1970,7 @@ static ChangeInfoResult CanalChangeInfo(uint id, int numinfo, int prop, ByteRead
 	ChangeInfoResult ret = CIR_SUCCESS;
 
 	if (id + numinfo > CF_END) {
-		grfmsg(1, "CanalChangeInfo: Canal feature %u is invalid, max %u, ignoreing", id + numinfo, CF_END);
+		grfmsg(1, "CanalChangeInfo: Canal feature %u is invalid, max %u, ignoring", id + numinfo, CF_END);
 		return CIR_INVALID_ID;
 	}
 
diff --git a/src/newgrf_industries.h b/src/newgrf_industries.h
index dc9b2e8ea..370dd97e2 100644
--- a/src/newgrf_industries.h
+++ b/src/newgrf_industries.h
@@ -24,7 +24,7 @@ enum IndustryTrigger {
 	INDUSTRY_TRIGGER_CARGO_DELIVERY   = 4,
 };
 
-/** From where is callback CBID_INDUSTRY_PROBABILITY been called */
+/** From where has callback #CBID_INDUSTRY_PROBABILITY been called */
 enum IndustryAvailabilityCallType {
 	IACT_MAPGENERATION,    ///< during random map generation
 	IACT_RANDOMCREATION,   ///< during creation of random ingame industry
diff --git a/src/script/api/script_text.hpp b/src/script/api/script_text.hpp
index cd2bca45f..43a6037ef 100644
--- a/src/script/api/script_text.hpp
+++ b/src/script/api/script_text.hpp
@@ -30,7 +30,7 @@ public:
 };
 
 /**
- * Interal used class to create a raw text in a Text object.
+ * Internally used class to create a raw text in a Text object.
  * @api -all
  */
 class RawText : public Text {
@@ -105,7 +105,7 @@ public:
 #else
 	/**
 	 * Set the parameter to a value.
-	 * @param parameter Which parameter t oset.
+	 * @param parameter Which parameter to set.
 	 * @param value The value of the parameter. Has to be string, integer or an instance of the class ScriptText.
 	 */
 	void SetParam(int parameter, Object value);
diff --git a/src/station_base.h b/src/station_base.h
index af403e11a..fe3b74b19 100644
--- a/src/station_base.h
+++ b/src/station_base.h
@@ -47,7 +47,7 @@ struct GoodsEntry {
 
 	byte acceptance_pickup; ///< Status of this cargo, see #GoodsEntryStatus.
 	byte days_since_pickup; ///< Number of days since the last pickup for this cargo (up to 255).
-	byte rating;            ///< Station rating for this cargo.
+	byte rating;            ///< %Station rating for this cargo.
 	byte last_speed;        ///< Maximum speed of the last vehicle that picked up this cargo (up to 255).
 	byte last_age;          ///< Age in years of the last vehicle that picked up this cargo.
 	byte amount_fract;      ///< Fractional part of the amount in the cargo list
@@ -59,7 +59,7 @@ struct Airport : public TileArea {
 	Airport() : TileArea(INVALID_TILE, 0, 0) {}
 
 	uint64 flags;       ///< stores which blocks on the airport are taken. was 16 bit earlier on, then 32
-	byte type;          ///< Type of this airport, @see AirportTypes.
+	byte type;          ///< Type of this airport, @see AirportTypes
 	byte layout;        ///< Airport layout number.
 	Direction rotation; ///< How this airport is rotated.
 
diff --git a/src/station_cmd.cpp b/src/station_cmd.cpp
index 0480d755a..f603c4e15 100644
--- a/src/station_cmd.cpp
+++ b/src/station_cmd.cpp
@@ -1618,7 +1618,7 @@ CommandCost RemoveRailStation(T *st, DoCommandFlag flags)
 
 /**
  * Remove a rail station
- * @param tile TileIndex been queried
+ * @param tile Tile of the station.
  * @param flags operation to perform
  * @return cost or failure of operation
  */
@@ -1639,7 +1639,7 @@ static CommandCost RemoveRailStation(TileIndex tile, DoCommandFlag flags)
 
 /**
  * Remove a rail waypoint
- * @param tile TileIndex been queried
+ * @param tile Tile of the waypoint.
  * @param flags operation to perform
  * @return cost or failure of operation
  */
@@ -1655,7 +1655,7 @@ static CommandCost RemoveRailWaypoint(TileIndex tile, DoCommandFlag flags)
 
 
 /**
- * @param truck_station Determines whether a stop is ROADSTOP_BUS or ROADSTOP_TRUCK
+ * @param truck_station Determines whether a stop is #ROADSTOP_BUS or #ROADSTOP_TRUCK
  * @param st The Station to do the whole procedure for
  * @return a pointer to where to link a new RoadStop*
  */
@@ -1695,12 +1695,12 @@ static CommandCost FindJoiningRoadStop(StationID existing_stop, StationID statio
  * @param tile Northernmost tile of the stop.
  * @param flags Operation to perform.
  * @param p1 bit 0..7: Width of the road stop.
- *           bit 8..15: Lenght of the road stop.
+ *           bit 8..15: Length of the road stop.
  * @param p2 bit 0: 0 For bus stops, 1 for truck stops.
  *           bit 1: 0 For normal stops, 1 for drive-through.
  *           bit 2..3: The roadtypes.
  *           bit 5: Allow stations directly adjacent to other stations.
- *           bit 6..7: Entrance direction (DiagDirection).
+ *           bit 6..7: Entrance direction (#DiagDirection).
  *           bit 16..31: Station ID to join (NEW_STATION if build new one).
  * @param text Unused.
  * @return The cost of this operation or an error.
@@ -1720,7 +1720,7 @@ CommandCost CmdBuildRoadStop(TileIndex tile, DoCommandFlag flags, uint32 p1, uin
 
 	/* Check if the requested road stop is too big */
 	if (width > _settings_game.station.station_spread || lenght > _settings_game.station.station_spread) return_cmd_error(STR_ERROR_STATION_TOO_SPREAD_OUT);
-	/* Check for incorrect width / lenght. */
+	/* Check for incorrect width / length. */
 	if (width == 0 || lenght == 0) return CMD_ERROR;
 	/* Check if the first tile and the last tile are valid */
 	if (!IsValidTile(tile) || TileAddWrap(tile, width - 1, lenght - 1) == INVALID_TILE) return CMD_ERROR;
diff --git a/src/tgp.cpp b/src/tgp.cpp
index b01ffbd6d..f8dd1f70c 100644
--- a/src/tgp.cpp
+++ b/src/tgp.cpp
@@ -53,7 +53,7 @@
  * using a simple (0, 0) to (X, Y), with a varying seed.
  *
  *
- * Other things i have had to do: mountainous wasnt mountainous enough, and
+ * Other things i have had to do: mountainous wasn't mountainous enough, and
  * since we only have 0..15 heights available, I add a second generated map
  * (with a modified seed), onto the original. This generally raises the
  * terrain, which then needs scaling back down. Overall effect is a general
@@ -62,8 +62,8 @@
  * However, the values on the top of mountains are then almost guaranteed to go
  * too high, so large flat plateaus appeared at height 15. To counter this, I
  * scale all heights above 12 to proportion up to 15. It still makes the
- * mountains have flatish tops, rather than craggy peaks, but at least they
- * arent smooth as glass.
+ * mountains have flattish tops, rather than craggy peaks, but at least they
+ * aren't smooth as glass.
  *
  *
  * For a full discussion of Perlin Noise, please visit:
@@ -81,12 +81,12 @@
  *
  * The following implementation uses optimized algorithm that should produce
  * the same quality result with much less computations, but more memory accesses.
- * The overal speedup should be 300% to 800% depending on CPU and memory speed.
+ * The overall speedup should be 300% to 800% depending on CPU and memory speed.
  *
  * I will try to explain it on the example below:
  *
- * Have a map of 4 x 4 tiles, our simplifiead noise generator produces only two
- * values -1 and +1, use 3 octaves with wave lenght 1, 2 and 4, with amplitudes
+ * Have a map of 4 x 4 tiles, our simplified noise generator produces only two
+ * values -1 and +1, use 3 octaves with wave length 1, 2 and 4, with amplitudes
  * 3, 2, 1. Original algorithm produces:
  *
  * h00 = lerp(lerp(-3, 3, 0/4), lerp(3, -3, 0/4), 0/4) + lerp(lerp(-2,  2, 0/2), lerp( 2, -2, 0/2), 0/2) + -1 = lerp(-3.0,  3.0, 0/4) + lerp(-2,  2, 0/2) + -1 = -3.0  + -2 + -1 = -6.0
@@ -290,7 +290,7 @@ static inline height_t RandomHeight(amplitude_t rMax)
  * One interpolation and noise round
  *
  * The heights on the map are generated in an iterative process.
- * We start off with a frequency of 1 (log_frequency == 0), and generate heights only for corners on the most coarsly mesh
+ * We start off with a frequency of 1 (log_frequency == 0), and generate heights only for corners on the most coarsely mesh
  * (i.e. only for x/y coordinates which are multiples of the minimum edge length).
  *
  * After this initial step the frequency is doubled (log_frequency incremented) each iteration to generate corners on the next finer mesh.
@@ -688,8 +688,8 @@ static double perlin_coast_noise_2D(const double x, const double y, const double
 /**
  * This routine sculpts in from the edge a random amount, again a Perlin
  * sequence, to avoid the rigid flat-edge slopes that were present before. The
- * Perlin noise map doesnt know where we are going to slice across, and so we
- * often cut straight through high terrain. the smoothing routine makes it
+ * Perlin noise map doesn't know where we are going to slice across, and so we
+ * often cut straight through high terrain. The smoothing routine makes it
  * legal, gradually increasing up from the edge to the original terrain height.
  * By cutting parts of this away, it gives a far more irregular edge to the
  * map-edge. Sometimes it works beautifully with the existing sea & lakes, and
diff --git a/src/vehicle.cpp b/src/vehicle.cpp
index be5cf0cdb..fce09cb4a 100644
--- a/src/vehicle.cpp
+++ b/src/vehicle.cpp
@@ -1633,10 +1633,10 @@ bool CanBuildVehicleInfrastructure(VehicleType type)
 
 /**
  * Determines the #LiveryScheme for a vehicle.
- * @param engine_type EngineID of the vehicle
- * @param parent_engine_type EngineID of the front vehicle. INVALID_VEHICLE if vehicle is at front itself.
- * @param v the vehicle. NULL if in purchase list etc.
- * @return livery scheme to use
+ * @param engine_type Engine of the vehicle.
+ * @param parent_engine_type Engine of the front vehicle, #INVALID_ENGINE if vehicle is at front itself.
+ * @param v the vehicle, \c NULL if in purchase list etc.
+ * @return livery scheme to use.
  */
 LiveryScheme GetEngineLiveryScheme(EngineID engine_type, EngineID parent_engine_type, const Vehicle *v)
 {