From 1cebabcfff5a6ca0e19cca383de5930beee11bef Mon Sep 17 00:00:00 2001
From: BC Ko <gobcko@gmail.com>
Date: Sat, 28 Aug 2021 16:38:59 -0700
Subject: [PATCH] documentation cleanup: control

---
 Source/control.cpp | 15 ---------------
 Source/control.h   | 19 +++++++++++++++++++
 2 files changed, 19 insertions(+), 15 deletions(-)

diff --git a/Source/control.cpp b/Source/control.cpp
index d10de8c5d..11fae8b00 100644
--- a/Source/control.cpp
+++ b/Source/control.cpp
@@ -1033,10 +1033,6 @@ void DrawCtrlBtns(const Surface &out)
 	}
 }
 
-/**
- * Draws the "Speed Book": the rows of known spells for quick-setting a spell that
- * show up when you click the spell slot at the control panel.
- */
 void DoSpeedBook()
 {
 	spselflag = true;
@@ -1091,9 +1087,6 @@ void DoSpeedBook()
 	SetCursorPos({ x, y });
 }
 
-/**
- * Checks if the mouse cursor is within any of the panel buttons and flag it if so.
- */
 void DoPanBtn()
 {
 	for (int i = 0; i < PanelButtonIndex; i++) {
@@ -1152,10 +1145,6 @@ void DoAutoMap()
 	}
 }
 
-/**
- * Checks the mouse cursor position within the control panel and sets information
- * strings if needed.
- */
 void CheckPanelInfo()
 {
 	panelflag = false;
@@ -1244,10 +1233,6 @@ void CheckPanelInfo()
 	}
 }
 
-/**
- * Check if the mouse is within a control panel button that's flagged.
- * Takes apropiate action if so.
- */
 void CheckBtnUp()
 {
 	bool gamemenuOff = true;
diff --git a/Source/control.h b/Source/control.h
index 8b2c7cec4..3795f8874 100644
--- a/Source/control.h
+++ b/Source/control.h
@@ -121,11 +121,30 @@ void DrawCtrlPan(const Surface &out);
  */
 void DrawCtrlBtns(const Surface &out);
 
+/**
+ * Draws the "Speed Book": the rows of known spells for quick-setting a spell that
+ * show up when you click the spell slot at the control panel.
+ */
 void DoSpeedBook();
+
+/**
+ * Checks if the mouse cursor is within any of the panel buttons and flag it if so.
+ */
 void DoPanBtn();
+
 void control_check_btn_press();
 void DoAutoMap();
+
+/**
+ * Checks the mouse cursor position within the control panel and sets information
+ * strings if needed.
+ */
 void CheckPanelInfo();
+
+/**
+ * Check if the mouse is within a control panel button that's flagged.
+ * Takes apropiate action if so.
+ */
 void CheckBtnUp();
 void FreeControlPan();