From 46ca8778b41836cc5e154c0ae6dc37eddb88655a Mon Sep 17 00:00:00 2001
From: terkhen <terkhen@openttd.org>
Date: Fri, 15 Oct 2010 19:05:17 +0000
Subject: [PATCH] (svn r20931) -Document: Waterways toolbar click functions.

---
 src/dock_gui.cpp | 33 ++++++++++++++++++++++++++++++++-
 1 file changed, 32 insertions(+), 1 deletion(-)

diff --git a/src/dock_gui.cpp b/src/dock_gui.cpp
index 7062a6456e..642a015583 100644
--- a/src/dock_gui.cpp
+++ b/src/dock_gui.cpp
@@ -111,46 +111,77 @@ enum DockToolbarWidgets {
 };
 
 
+/**
+  * Handle a click in the build canal widget.
+  * @param w #Window in which the widget was clicked.
+  */
 static void BuildDocksClick_Canal(Window *w)
 {
-
 	HandlePlacePushButton(w, DTW_CANAL, SPR_CURSOR_CANAL, HT_RECT, PlaceDocks_BuildCanal);
 }
 
+/**
+  * Handle a click in the build lock widget.
+  * @param w #Window in which the widget was clicked.
+  */
 static void BuildDocksClick_Lock(Window *w)
 {
 	HandlePlacePushButton(w, DTW_LOCK, SPR_CURSOR_LOCK, HT_RECT, PlaceDocks_BuildLock);
 }
 
+/**
+  * Handle a click in the demolish widget.
+  * @param w #Window in which the widget was clicked.
+  */
 static void BuildDocksClick_Demolish(Window *w)
 {
 	HandlePlacePushButton(w, DTW_DEMOLISH, ANIMCURSOR_DEMOLISH, HT_RECT, PlaceProc_DemolishArea);
 }
 
+/**
+  * Handle a click in the build ship depot widget.
+  * @param w #Window in which the widget was clicked.
+  */
 static void BuildDocksClick_Depot(Window *w)
 {
 	if (!CanBuildVehicleInfrastructure(VEH_SHIP)) return;
 	if (HandlePlacePushButton(w, DTW_DEPOT, SPR_CURSOR_SHIP_DEPOT, HT_RECT, PlaceDocks_Depot)) ShowBuildDocksDepotPicker(w);
 }
 
+/**
+  * Handle a click in the build dock widget.
+  * @param w #Window in which the widget was clicked.
+  */
 static void BuildDocksClick_Dock(Window *w)
 {
 	if (!CanBuildVehicleInfrastructure(VEH_SHIP)) return;
 	if (HandlePlacePushButton(w, DTW_STATION, SPR_CURSOR_DOCK, HT_SPECIAL, PlaceDocks_Dock)) ShowBuildDockStationPicker(w);
 }
 
+/**
+  * Handle a click in the build buoy widget.
+  * @param w #Window in which the widget was clicked.
+  */
 static void BuildDocksClick_Buoy(Window *w)
 {
 	if (!CanBuildVehicleInfrastructure(VEH_SHIP)) return;
 	HandlePlacePushButton(w, DTW_BUOY, SPR_CURSOR_BOUY, HT_RECT, PlaceDocks_Buoy);
 }
 
+/**
+  * Handle a click in the create river widget.
+  * @param w #Window in which the widget was clicked.
+  */
 static void BuildDocksClick_River(Window *w)
 {
 	if (_game_mode != GM_EDITOR) return;
 	HandlePlacePushButton(w, DTW_RIVER, SPR_CURSOR_RIVER, HT_RECT, PlaceDocks_BuildRiver);
 }
 
+/**
+  * Handle a click in the build aqueduct widget.
+  * @param w #Window in which the widget was clicked.
+  */
 static void BuildDocksClick_Aqueduct(Window *w)
 {
 	HandlePlacePushButton(w, DTW_BUILD_AQUEDUCT, SPR_CURSOR_AQUEDUCT, HT_RECT, PlaceDocks_Aqueduct);