From 2224c9b515b2e63b7268221905772770352e5425 Mon Sep 17 00:00:00 2001
From: alberth <alberth@openttd.org>
Date: Sun, 30 May 2010 13:16:51 +0000
Subject: (svn r19910) -Doc: Doxygen additions.

---
 src/settings.cpp | 20 ++++++++++++++++++++
 src/window.cpp   |  4 ++--
 2 files changed, 22 insertions(+), 2 deletions(-)

diff --git a/src/settings.cpp b/src/settings.cpp
index 71bdf9e2b..b60675e5a 100644
--- a/src/settings.cpp
+++ b/src/settings.cpp
@@ -1464,6 +1464,10 @@ void SaveToConfig()
 	delete ini;
 }
 
+/**
+ * Get the list of known NewGrf presets.
+ * @param list[inout] Pointer to list for storing the preset names.
+ */
 void GetGRFPresetList(GRFPresetList *list)
 {
 	list->Clear();
@@ -1479,6 +1483,12 @@ void GetGRFPresetList(GRFPresetList *list)
 	delete ini;
 }
 
+/**
+ * Load a NewGRF configuration by preset-name.
+ * @param config_name Name of the preset.
+ * @return NewGRF configuration.
+ * @see GetGRFPresetList
+ */
 GRFConfig *LoadGRFPresetFromConfig(const char *config_name)
 {
 	char *section = (char*)alloca(strlen(config_name) + 8);
@@ -1491,6 +1501,12 @@ GRFConfig *LoadGRFPresetFromConfig(const char *config_name)
 	return config;
 }
 
+/**
+ * Save a NewGRF configuration with a preset name.
+ * @param config_name Name of the preset.
+ * @param config      NewGRF configuration to save.
+ * @see GetGRFPresetList
+ */
 void SaveGRFPresetToConfig(const char *config_name, GRFConfig *config)
 {
 	char *section = (char*)alloca(strlen(config_name) + 8);
@@ -1502,6 +1518,10 @@ void SaveGRFPresetToConfig(const char *config_name, GRFConfig *config)
 	delete ini;
 }
 
+/**
+ * Delete a NewGRF configuration by preset name.
+ * @param config_name Name of the preset.
+ */
 void DeleteGRFPresetFromConfig(const char *config_name)
 {
 	char *section = (char*)alloca(strlen(config_name) + 8);
diff --git a/src/window.cpp b/src/window.cpp
index 421b37a81..4f147a670 100644
--- a/src/window.cpp
+++ b/src/window.cpp
@@ -56,8 +56,8 @@ int _scrollbar_start_pos;
 int _scrollbar_size;
 byte _scroller_click_timeout;
 
-bool _scrolling_scrollbar;
-bool _scrolling_viewport;
+bool _scrolling_scrollbar; ///< A scrollbar is being scrolled with the mouse.
+bool _scrolling_viewport;  ///< A viewport is being scrolled with the mouse.
 
 SpecialMouseMode _special_mouse_mode; ///< Mode of the mouse.
 
-- 
cgit v1.2.3-54-g00ecf