From a91553efeb0e2beaf942fc3f7db30868ac8c6afa Mon Sep 17 00:00:00 2001
From: Paul Gilbert
Date: Sun, 17 Jun 2012 09:09:18 +1000
Subject: TONY: Cleaned up the @defgroup comments

---
 engines/tony/custom.cpp       | 3 ++-
 engines/tony/globals.h        | 6 ++++--
 engines/tony/mpal/expr.cpp    | 5 +++++
 engines/tony/mpal/loadmpc.cpp | 3 +++
 engines/tony/mpal/mpal.cpp    | 3 +++
 engines/tony/mpal/mpal.h      | 6 +++++-
 6 files changed, 22 insertions(+), 4 deletions(-)

(limited to 'engines')

diff --git a/engines/tony/custom.cpp b/engines/tony/custom.cpp
index 375b405400..6e057cf031 100644
--- a/engines/tony/custom.cpp
+++ b/engines/tony/custom.cpp
@@ -131,7 +131,7 @@ void LoadChangedHotspot(Common::InSaveFile *f) {
 
 
 /**
- * @defgroup Classes required for custom functions
+ * Classes required for custom functions
  *
  * Tony (To Move him)     -> You can do MPAL through the animation? I really think so
  *
@@ -139,6 +139,7 @@ void LoadChangedHotspot(Common::InSaveFile *f) {
  * ChangeLocation -> theEngine.ChangeLocation()
  * AddInventory -> theEngine.AddInventory()
 */
+
 void MCharResetCodes(void) {
 	for (int i = 0; i < 10; i++)
 		GLOBALS._mCharacter[i]._item = GLOBALS._loc->getItemFromCode(GLOBALS._mCharacter[i]._code);
diff --git a/engines/tony/globals.h b/engines/tony/globals.h
index 33ed36751a..098a98025e 100644
--- a/engines/tony/globals.h
+++ b/engines/tony/globals.h
@@ -253,8 +253,8 @@ public:
 
 	/**
 	 * @defgroup MPAL variables
-	 *
-	*/
+	 */
+	//@{
 	uint32                  _mpalError;
 	LPITEMIRQFUNCTION       _lpiifCustom;
 	LPLPCUSTOMFUNCTION      _lplpFunctions;
@@ -292,6 +292,8 @@ public:
 	uint32                  _nExecutingDialog;
 	uint32                  _nExecutingChoice;
 	uint32                  _nSelectedChoice;
+
+	//@}
 };
 
 } // End of namespace Tony
diff --git a/engines/tony/mpal/expr.cpp b/engines/tony/mpal/expr.cpp
index 52751120f6..c2fadd63df 100644
--- a/engines/tony/mpal/expr.cpp
+++ b/engines/tony/mpal/expr.cpp
@@ -42,6 +42,7 @@ namespace MPAL {
 /**
  * @defgroup Mathamatical operations
  */
+//@{
 
 #define OP_MUL     ((1  << 4) | 0)
 #define OP_DIV     ((1  << 4) | 1)
@@ -73,9 +74,12 @@ enum ExprListTypes {
 	ELT_PARENTH2 = 4
 };
 
+//@}
+
 /**
  * @defgroup Structures
  */
+//@{
 
 /**
  * Mathamatical framework to manage operations
@@ -96,6 +100,7 @@ typedef struct {
 } EXPRESSION;
 typedef EXPRESSION *LPEXPRESSION;
 
+//@}
 
 /**
  * Duplicate a mathematical expression.
diff --git a/engines/tony/mpal/loadmpc.cpp b/engines/tony/mpal/loadmpc.cpp
index 6ed4545d67..b589827a5a 100644
--- a/engines/tony/mpal/loadmpc.cpp
+++ b/engines/tony/mpal/loadmpc.cpp
@@ -517,6 +517,7 @@ static const byte *ParseLocation(const byte *lpBuf, LPMPALLOCATION lpmlLocation)
 /**
  * @defgroup Exported functions
  */
+//@{
 
 /**
  * Reads and interprets the MPC file, and create structures for various directives 
@@ -796,6 +797,8 @@ void FreeMpc() {
 	}
 }
 
+//@}
+
 } // end of namespace MPAL
 
 } // end of namespace Tony
diff --git a/engines/tony/mpal/mpal.cpp b/engines/tony/mpal/mpal.cpp
index 3b98acea59..72d8d3045c 100644
--- a/engines/tony/mpal/mpal.cpp
+++ b/engines/tony/mpal/mpal.cpp
@@ -1395,6 +1395,7 @@ bool doSelection(uint32 i, uint32 dwData) {
 /**
  * @defgroup Exported functions
  */
+//@{
 
 /**
  * Initialises the MPAL library and opens the .MPC file, which will be used for all queries.
@@ -2918,6 +2919,8 @@ void mpalDumpDialogs(void) {
 	unlockDialogs();
 }
 
+//@}
+
 } // end of namespace MPAL
 
 } // end of namespace Tony
diff --git a/engines/tony/mpal/mpal.h b/engines/tony/mpal/mpal.h
index 9ea0c40bbc..1ec96c97d0 100644
--- a/engines/tony/mpal/mpal.h
+++ b/engines/tony/mpal/mpal.h
@@ -187,6 +187,7 @@ typedef LPITEMIRQFUNCTION* LPLPITEMIRQFUNCTION;
  *
  * The following are defines used for simplifying calling the mpalQuery variants
  */
+//@{
 
 /**
  * Gets the current version of MPAL
@@ -386,11 +387,12 @@ typedef LPITEMIRQFUNCTION* LPLPITEMIRQFUNCTION;
 #define mpalQueryDoDialog(nDialog,nGroup)               \
         mpalQueryDWORD(MPQ_DO_DIALOG, (uint32)(nDialog),(uint32)(nGroup))
 
+//@}
 
 /**
  * @defgroup Functions exported to the main game
  */
-
+//@{
 
 /**
  * Initializes the MPAL library, and opens an .MPC file, which will be 'used for all queries
@@ -526,6 +528,8 @@ void lockVar(void);
  */
 void unlockVar(void);
 
+//@}
+
 } // end of namespace MPAL
 
 } // end of namespace Tony
-- 
cgit v1.2.3