(svn r4111) Fix/Remove some stale comments

6 files changed, 11 insertions, 21 deletions

diff --git a/npf.c b/npf.c
index 68d793186..4dc59f41a 100644
--- a/npf.c
+++ b/npf.c
@@ -542,7 +542,7 @@ static void NPFFollowTrack(AyStar* aystar, OpenListNode* current)
 		/* Find out the exit direction first */
 		if (IsRoadStationTile(src_tile)) {
 			exitdir = GetRoadStationDir(src_tile);
-		} else { /* Train or road depot. Direction is stored the same for both, in map5 */
+		} else { /* Train or road depot */
 			exitdir = GetDepotDirection(src_tile, type);
 		}
 
diff --git a/openttd.h b/openttd.h
index 335902340..6c41ee547 100644
--- a/openttd.h
+++ b/openttd.h
@@ -110,11 +110,10 @@ enum InitializeGameModes {
 
 typedef enum TransportTypes {
 	/* These constants are for now linked to the representation of bridges
-	 * and tunnels, so they can be used by GetTileTrackStatus_TunnelBridge
-	 * to compare against the map5 array. In an ideal world, these
-	 * constants would be used everywhere when accessing tunnels and
-	 * bridges. For now, you should just not change the values for road
-	 * and rail.
+	 * and tunnels, so they can be used by GetTileTrackStatus_TunnelBridge.
+	 * In an ideal world, these constants would be used everywhere when
+	 * accessing tunnels and bridges. For now, you should just not change
+	 * the values for road and rail.
 	 */
 	TRANSPORT_RAIL = 0,
 	TRANSPORT_ROAD = 1,
diff --git a/rail_cmd.c b/rail_cmd.c
index 8e4094d14..039acf9bd 100644
--- a/rail_cmd.c
+++ b/rail_cmd.c
@@ -38,16 +38,6 @@ const byte _track_sloped_sprites[14] = {
 
 void ShowTrainDepotWindow(TileIndex tile);
 
-/* Format of rail map5 byte.
- * 00 abcdef  => Normal rail
- * 01 abcdef  => Rail with signals
- * 10 ??????  => Unused
- * 11 ????dd  => Depot
- *
- * abcdef is a bitmask, which contains ones for all present tracks. Below the
- * value for each track is given.
- */
-
 /*         4
  *     ---------
  *    |\       /|
@@ -582,7 +572,7 @@ int32 CmdRemoveRailroadTrack(int x, int y, uint32 flags, uint32 p1, uint32 p2)
 /** Build a train depot
  * @param x,y position of the train depot
  * @param p1 rail type
- * @param p2 depot direction (0 through 3), where 0 is NE, 1 is SE, 2 is SW, 3 is NW
+ * @param p2 entrance direction (DiagDirection)
  *
  * @todo When checking for the tile slope,
  * distingush between "Flat land required" and "land sloped in wrong direction"
diff --git a/road_cmd.c b/road_cmd.c
index fcc7ecd7a..854c59cff 100644
--- a/road_cmd.c
+++ b/road_cmd.c
@@ -553,7 +553,7 @@ int32 CmdRemoveLongRoad(int x, int y, uint32 flags, uint32 p1, uint32 p2)
 
 /** Build a road depot.
  * @param x,y tile coordinates where the depot will be built
- * @param p1 depot direction (0 through 3), where 0 is NW, 1 is NE, etc.
+ * @param p1 entrance direction (DiagDirection)
  * @param p2 unused
  *
  * @todo When checking for the tile slope,
diff --git a/station.h b/station.h
index 9fe26fe70..2407ed25d 100644
--- a/station.h
+++ b/station.h
@@ -242,8 +242,9 @@ static inline bool IsBuoyTile(TileIndex tile)
 	return IsTileType(tile, MP_STATION) && _m[tile].m5 == 0x52;
 }
 
-/* Get's the direction the station exit points towards. Ie, returns 0 for a
- * station with the exit NE. */
+/**
+ * Get's the direction the road stop entrance points towards.
+ */
 static inline DiagDirection GetRoadStationDir(TileIndex tile)
 {
 	assert(IsRoadStationTile(tile));
diff --git a/station_cmd.c b/station_cmd.c
index 9cfccf055..b7069a445 100644
--- a/station_cmd.c
+++ b/station_cmd.c
@@ -1293,7 +1293,7 @@ static void FindRoadStationSpot(bool truck_station, Station* st, RoadStop*** cur
 
 /** Build a bus station
  * @param x,y coordinates to build bus station at
- * @param p1 busstop entrance direction (0 through 3), where 0 is NW, 1 is NE, etc.
+ * @param p1 entrance direction (DiagDirection)
  * @param p2 0 for Bus stops, 1 for truck stops
  */
 int32 CmdBuildRoadStop(int x, int y, uint32 flags, uint32 p1, uint32 p2)