summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--src/ground_vehicle.hpp14
1 files changed, 7 insertions, 7 deletions
diff --git a/src/ground_vehicle.hpp b/src/ground_vehicle.hpp
index d71eb7334..5033bef75 100644
--- a/src/ground_vehicle.hpp
+++ b/src/ground_vehicle.hpp
@@ -22,20 +22,20 @@ enum AccelStatus {
};
/**
- * Cached values.
+ * Cached, frequently calculated values.
* All of these values except cached_slope_resistance are set only for the first part of a vehicle.
*/
struct GroundVehicleCache {
/* Cached acceleration values, recalculated when the cargo on a vehicle changes (in addition to the conditions below) */
- uint32 cached_weight; ///< Total weight of the consist.
+ uint32 cached_weight; ///< Total weight of the consist (valid only for the first engine).
uint32 cached_slope_resistance; ///< Resistance caused by weight when this vehicle part is at a slope.
- uint32 cached_max_te; ///< Maximum tractive effort of consist.
- uint16 cached_axle_resistance; ///< Resistance caused by the axles of the vehicle.
+ uint32 cached_max_te; ///< Maximum tractive effort of consist (valid only for the first engine).
+ uint16 cached_axle_resistance; ///< Resistance caused by the axles of the vehicle (valid only for the first engine).
/* Cached acceleration values, recalculated on load and each time a vehicle is added to/removed from the consist. */
- uint16 cached_max_track_speed; ///< Maximum consist speed limited by track type.
- uint32 cached_power; ///< Total power of the consist.
- uint32 cached_air_drag; ///< Air drag coefficient of the vehicle.
+ uint16 cached_max_track_speed; ///< Maximum consist speed limited by track type (valid only for the first engine).
+ uint32 cached_power; ///< Total power of the consist (valid only for the first engine).
+ uint32 cached_air_drag; ///< Air drag coefficient of the vehicle (valid only for the first engine).
};
/** Ground vehicle flags. */