# HG changeset patch
# User KUDr <KUDr@openttd.org>
# Date 1148842889 0
# Node ID 46cf71da04719d9cce09e2f1ed27170ed080f8ea
# Parent  3b7bfba168d9d028722cc3aee3935dbc5662af1b
(svn r5006) Added comments where doxygen generated warnings to test if it can help.

diff --git a/yapf/yapf_common.cpp b/yapf/yapf_common.cpp
--- a/yapf/yapf_common.cpp
+++ b/yapf/yapf_common.cpp
@@ -8,6 +8,7 @@
 #include "yapf_costbase.hpp"
 #include "yapf_costcache.hpp"
 
+/** translate tileh to the bitset of up-hill trackdirs */
 const TrackdirBits CYapfCostBase::c_upwards_slopes[] = {
 	TRACKDIR_BIT_NONE                    , // no tileh
 	TRACKDIR_BIT_X_SW | TRACKDIR_BIT_Y_NW, // 1
diff --git a/yapf/yapf_rail.cpp b/yapf/yapf_rail.cpp
--- a/yapf/yapf_rail.cpp
+++ b/yapf/yapf_rail.cpp
@@ -260,6 +260,7 @@
 	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);}