summaryrefslogtreecommitdiff
path: root/src
diff options
context:
space:
mode:
authorfrosch <frosch@openttd.org>2012-08-18 11:37:23 +0000
committerfrosch <frosch@openttd.org>2012-08-18 11:37:23 +0000
commit0f0f027379181bf35b3e0b9ae6900cd3b0d82574 (patch)
tree75d275e3019091273187c70ab61014cbae4a2fc4 /src
parent9215192d342b6829fe2b6f402f6a2c36e8137997 (diff)
downloadopenttd-0f0f027379181bf35b3e0b9ae6900cd3b0d82574.tar.xz
(svn r24480) -Doc: Doxygenize ChooseShipTrack().
Diffstat (limited to 'src')
-rw-r--r--src/ship_cmd.cpp10
1 files changed, 7 insertions, 3 deletions
diff --git a/src/ship_cmd.cpp b/src/ship_cmd.cpp
index ed43cf7d2..06a4b7390 100644
--- a/src/ship_cmd.cpp
+++ b/src/ship_cmd.cpp
@@ -384,9 +384,13 @@ static void ShipArrivesAt(const Vehicle *v, Station *st)
/**
- * returns the track to choose on the next tile, or -1 when it's better to
- * reverse. The tile given is the tile we are about to enter, enterdir is the
- * direction in which we are entering the tile
+ * Runs the pathfinder to choose a track to continue along.
+ *
+ * @param v Ship to navigate
+ * @param tile Tile, the ship is about to enter
+ * @param enterdir Direction of entering
+ * @param tracks Available track choices on \a tile
+ * @return Track to choose, or INVALID_TRACK when to reverse.
*/
static Track ChooseShipTrack(Ship *v, TileIndex tile, DiagDirection enterdir, TrackBits tracks)
{