From 6fa570762c21aacbfdd5ef4ed0a9cfa7f027da14 Mon Sep 17 00:00:00 2001
From: belugas <belugas@openttd.org>
Date: Thu, 19 Jun 2008 20:04:24 +0000
Subject: [PATCH] (svn r13588) -Documentation: Document the function
 PopupMainPlayerToolbMenu.  Makes it a bit clearer, don't you think?

---
 src/toolbar_gui.cpp | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/src/toolbar_gui.cpp b/src/toolbar_gui.cpp
index 90a11e92df..a4b4b58875 100644
--- a/src/toolbar_gui.cpp
+++ b/src/toolbar_gui.cpp
@@ -1611,6 +1611,11 @@ static const Widget _player_menu_widgets[] = {
 { WIDGETS_END},
 };
 
+/** Shows the list of players appearing under the buttons that are linked to options for
+ * multiple players.
+ * @param parent Window who triggered that action.  It's the toolbar, in fact
+ * @param main_button widget which has been used
+ * @param gray bit-mapping of the items that will need to be grayed out once displayed */
 static void PopupMainPlayerToolbMenu(Window *parent, int main_button, int gray)
 {
 	parent->LowerWidget(main_button);