changeset 15275:3365a2ad0ef8 draft

(svn r19910) -Doc: Doxygen additions.
author alberth <alberth@openttd.org>
date Sun, 30 May 2010 13:16:51 +0000
parents e81d5697d8aa
children 04ac3a270667
files src/settings.cpp src/window.cpp
diffstat 2 files changed, 22 insertions(+), 2 deletions(-) [+]
line wrap: on
line diff
--- a/src/settings.cpp
+++ b/src/settings.cpp
@@ -1464,6 +1464,10 @@
 	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 @@
 	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 @@
 	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 @@
 	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);
--- a/src/window.cpp
+++ b/src/window.cpp
@@ -56,8 +56,8 @@
 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.