diff -ru freeciv-/server/gotohand.h freeciv/server/gotohand.h
--- freeciv-/server/gotohand.h	Thu Oct  4 22:09:29 2001
+++ freeciv/server/gotohand.h	Sun Nov 25 20:57:29 2001
@@ -37,13 +37,21 @@
 int calculate_move_cost(struct unit *punit, int dest_x, int dest_y);
 int air_can_move_between(int moves, int src_x, int src_y,
 			 int dest_x, int dest_y, struct player *pplayer);
+int goto_is_sane(struct unit *punit, int x, int y, int omni);
 
-/* all other functions are internal */
-
+/*
+ * Maximal distance of our targets in tiles. It prevents us to move too far
+ * away, when we want something - we will simply ignore anything outside this
+ * range.
+ *
+ * When comparing it to warmap costs, don't forget to multiply it by move_rate
+ * of the unit. If you don't care about particular unit or its move_rate, use
+ * SINGLE_MOVE instead. (should we make most of those unit-dependent?)
+ *
+ * Frequently used multiplied by 2, however bigger multipliers don't make much
+ * sense.
+ */
 #define THRESHOLD 12
-
-
-int goto_is_sane(struct unit *punit, int x, int y, int omni);
 
 struct move_cost_map {
   unsigned char *cost[MAP_MAX_WIDTH];