(svn r5006) Added comments where doxygen generated warnings to test if it can help.

1 files changed, 1 insertions, 0 deletions

diff --git a/yapf/yapf_rail.cpp b/yapf/yapf_rail.cpp
index 08ee143ed..67d3d781f 100644
--- a/yapf/yapf_rail.cpp
+++ b/yapf/yapf_rail.cpp
@@ -260,6 +260,7 @@ bool YapfFindNearestRailDepotTwoWay(Vehicle *v, int max_distance, int reverse_pe
 	return ret;
 }
 
+/** if any track changes, this counter is incremented - that will invalidate segment cost cache */
 int CSegmentCostCacheBase::s_rail_change_counter = 0;
 
 void YapfNotifyTrackLayoutChange(TileIndex tile, Track track) {CSegmentCostCacheBase::NotifyTrackLayoutChange(tile, track);}