summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorplanetmaker <planetmaker@openttd.org>2012-10-09 20:59:29 +0000
committerplanetmaker <planetmaker@openttd.org>2012-10-09 20:59:29 +0000
commite0529d486100ac37edb7a5a9ec2f8b2f5783ed78 (patch)
tree7ef9d90d3a9c443029ed776ed902ce300e6fc300
parent60335b7b79976d91a28720b2d4e71484e3eabb74 (diff)
downloadopenttd-e0529d486100ac37edb7a5a9ec2f8b2f5783ed78.tar.xz
(svn r24582) -Fix (r24581): Order distances are not supposed to be compared to map distances
-rw-r--r--src/script/api/script_engine.hpp6
-rw-r--r--src/script/api/script_order.hpp6
-rw-r--r--src/script/api/script_vehicle.hpp6
3 files changed, 12 insertions, 6 deletions
diff --git a/src/script/api/script_engine.hpp b/src/script/api/script_engine.hpp
index 1fef5d612..cd790cbf9 100644
--- a/src/script/api/script_engine.hpp
+++ b/src/script/api/script_engine.hpp
@@ -257,8 +257,10 @@ public:
* Get the maximum allowed distance between two orders for an engine.
* @param engine_id The engine to get the max distance for.
* @pre IsValidEngine(engine_id).
- * @return The square of the maximum distance between two orders for
- * the engine or 0 if the distance is unlimited.
+ * @return The maximum distance between two orders for the engine
+ * or 0 if the distance is unlimited.
+ * @note The unit of the order distances is unspecified and should
+ * not be compared with map distances
* @see ScriptOrder::GetOrderDistance
*/
static uint GetMaximumOrderDistance(EngineID engine_id);
diff --git a/src/script/api/script_order.hpp b/src/script/api/script_order.hpp
index cf925a128..da732490b 100644
--- a/src/script/api/script_order.hpp
+++ b/src/script/api/script_order.hpp
@@ -588,8 +588,10 @@ public:
* @param vehicle_type The vehicle type to get the distance for.
* @param origin_tile Origin, can be any tile or a tile of a specific station.
* @param dest_tile Destination, ca be any tile or a tile of a specific station.
- * @return The square of the distance between the origin and the
- * destination for a vehicle of the given vehicle type.
+ * @return The distance between the origin and the destination for a
+ * vehicle of the given vehicle type.
+ * @note The unit of the order distances is unspecified and should
+ * not be compared with map distances
* @see ScriptEngine::GetMaximumOrderDistance and ScriptVehicle::GetMaximumOrderDistance
*/
static uint GetOrderDistance(ScriptVehicle::VehicleType vehicle_type, TileIndex origin_tile, TileIndex dest_tile);
diff --git a/src/script/api/script_vehicle.hpp b/src/script/api/script_vehicle.hpp
index de7c01603..fb5378e1a 100644
--- a/src/script/api/script_vehicle.hpp
+++ b/src/script/api/script_vehicle.hpp
@@ -551,8 +551,10 @@ public:
* Get the maximum allowed distance between two orders for a vehicle.
* @param vehicle_id The vehicle to get the distance for.
* @pre IsValidVehicle(vehicle_id).
- * @return The square of the maximum distance between two orders for
- * this vehicle or 0 if the distance is unlimited.
+ * @return The maximum distance between two orders for this vehicle
+ * or 0 if the distance is unlimited.
+ * @note The unit of the order distances is unspecified and should
+ * not be compared with map distances
* @see ScriptOrder::GetOrderDistance
*/
static uint GetMaximumOrderDistance(VehicleID vehicle_id);