doxygen: fixup and tag intern/ghost.

2011-02-25 11:28:33 +00:00
parent 09e8a8222c
commit b15161a2d3
79 changed files with 383 additions and 145 deletions
--- a/intern/ghost/GHOST_IEvent.h
+++ b/intern/ghost/GHOST_IEvent.h
@@ -25,8 +25,9 @@
 *
 * ***** END GPL LICENSE BLOCK *****
 */
-/**
- * @file	GHOST_IEvent.h
+
+/** \file ghost/GHOST_IEvent.h
+ *  \ingroup GHOST
 * Declaration of GHOST_IEvent interface class.
 */

--- a/intern/ghost/GHOST_IEventConsumer.h
+++ b/intern/ghost/GHOST_IEventConsumer.h
@@ -25,8 +25,9 @@
 *
 * ***** END GPL LICENSE BLOCK *****
 */
-/**
- * @file	GHOST_IEventConsumer.h
+
+/** \file ghost/GHOST_IEventConsumer.h
+ *  \ingroup GHOST
 * Declaration of GHOST_IEventConsumer interface class.
 */

--- a/intern/ghost/GHOST_ISystem.h
+++ b/intern/ghost/GHOST_ISystem.h
@@ -26,8 +26,8 @@
 * ***** END GPL LICENSE BLOCK *****
 */

-/*! \ingroup GHOST
- * \file	GHOST_ISystem.h
+/** \file ghost/GHOST_ISystem.h
+ *  \ingroup GHOST
 * %Main interface file for C++ Api with declaration of GHOST_ISystem interface
 * class.
 * Contains the doxygen documentation main page.
--- a/intern/ghost/GHOST_ISystemPaths.h
+++ b/intern/ghost/GHOST_ISystemPaths.h
@@ -25,6 +25,11 @@
 *
 * ***** END GPL LICENSE BLOCK *****
 */
+
+/** \file ghost/GHOST_ISystemPaths.h
+ *  \ingroup GHOST
+ */
+
 #ifndef _GHOST_ISYSTEMPATHS_H_
 #define _GHOST_ISYSTEMPATHS_H_

--- a/intern/ghost/GHOST_ITimerTask.h
+++ b/intern/ghost/GHOST_ITimerTask.h
@@ -25,8 +25,9 @@
 *
 * ***** END GPL LICENSE BLOCK *****
 */
-/**
- * @file	GHOST_ITimerTask.h
+
+/** \file ghost/GHOST_ITimerTask.h
+ *  \ingroup GHOST
 * Declaration of GHOST_ITimerTask interface class.
 */

--- a/intern/ghost/GHOST_IWindow.h
+++ b/intern/ghost/GHOST_IWindow.h
@@ -25,8 +25,9 @@
 *
 * ***** END GPL LICENSE BLOCK *****
 */
-/**
- * @file	GHOST_IWindow.h
+
+/** \file ghost/GHOST_IWindow.h
+ *  \ingroup GHOST
 * Declaration of GHOST_IWindow interface class.
 */

--- a/intern/ghost/GHOST_Path-api.h
+++ b/intern/ghost/GHOST_Path-api.h
@@ -27,6 +27,11 @@
 * ***** END GPL LICENSE BLOCK *****
 */

+/** \file ghost/GHOST_Path-api.h
+ *  \ingroup GHOST
+ */
+
+
 #ifndef	GHOST_PATH_API_H
 #define GHOST_PATH_API_H

--- a/intern/ghost/GHOST_Rect.h
+++ b/intern/ghost/GHOST_Rect.h
@@ -25,9 +25,10 @@
 *
 * ***** END GPL LICENSE BLOCK *****
 */
-/**
- * @file	GHOST_Rect.h
- * Declaration of GHOST_Rect rectangle class.
+
+/** \file ghost/intern/GHOST_Debug.h
+ *  \ingroup GHOST
+ * Macro's used in GHOST debug target.
 */

 #ifndef _H_GHOST_Rect
--- a/intern/ghost/GHOST_Types.h
+++ b/intern/ghost/GHOST_Types.h
@@ -26,6 +26,11 @@
 * ***** END GPL LICENSE BLOCK *****
 */

+/** \file ghost/GHOST_Types.h
+ *  \ingroup GHOST
+ */
+
+
 #ifndef _GHOST_TYPES_H_
 #define _GHOST_TYPES_H_

--- a/intern/ghost/intern/GHOST_Buttons.cpp
+++ b/intern/ghost/intern/GHOST_Buttons.cpp
@@ -1,4 +1,4 @@
-/**
+/*
 * $Id$
 * ***** BEGIN GPL LICENSE BLOCK *****
 *
@@ -26,6 +26,11 @@
 * ***** END GPL LICENSE BLOCK *****
 */

+/** \file ghost/intern/GHOST_Buttons.cpp
+ *  \ingroup GHOST
+ */
+
+
 #include "GHOST_Buttons.h"


--- a/intern/ghost/intern/GHOST_Buttons.h
+++ b/intern/ghost/intern/GHOST_Buttons.h
@@ -1,4 +1,4 @@
-/**
+/*
 * $Id$
 * ***** BEGIN GPL LICENSE BLOCK *****
 *
@@ -25,8 +25,9 @@
 *
 * ***** END GPL LICENSE BLOCK *****
 */
-/**
- * @file	GHOST_Buttons.h
+
+/** \file ghost/intern/GHOST_Buttons.h
+ *  \ingroup GHOST
 * Declaration of GHOST_Buttons struct.
 */

--- a/intern/ghost/intern/GHOST_C-api.cpp
+++ b/intern/ghost/intern/GHOST_C-api.cpp
@@ -26,6 +26,11 @@
 * ***** END GPL LICENSE BLOCK *****
 */

+/** \file ghost/intern/GHOST_C-api.cpp
+ *  \ingroup GHOST
+ */
+
+
 /*

 * GHOST_C-Api.cpp
--- a/intern/ghost/intern/GHOST_CallbackEventConsumer.cpp
+++ b/intern/ghost/intern/GHOST_CallbackEventConsumer.cpp
@@ -1,4 +1,4 @@
-/**
+/*
 * $Id$
 * ***** BEGIN GPL LICENSE BLOCK *****
 *
@@ -26,6 +26,11 @@
 * ***** END GPL LICENSE BLOCK *****
 */

+/** \file ghost/intern/GHOST_CallbackEventConsumer.cpp
+ *  \ingroup GHOST
+ */
+
+
 /**

 * $Id$
--- a/intern/ghost/intern/GHOST_CallbackEventConsumer.h
+++ b/intern/ghost/intern/GHOST_CallbackEventConsumer.h
@@ -1,4 +1,4 @@
-/**
+/*
 * $Id$
 * ***** BEGIN GPL LICENSE BLOCK *****
 *
@@ -25,8 +25,9 @@
 *
 * ***** END GPL LICENSE BLOCK *****
 */
-/**
- * @file	GHOST_CallbackEventConsumer.h
+
+/** \file ghost/intern/GHOST_CallbackEventConsumer.h
+ *  \ingroup GHOST
 * Declaration of GHOST_CallbackEventConsumer class.
 */

--- a/intern/ghost/intern/GHOST_Debug.h
+++ b/intern/ghost/intern/GHOST_Debug.h
@@ -1,4 +1,4 @@
-/**
+/*
 * $Id$
 * ***** BEGIN GPL LICENSE BLOCK *****
 *
@@ -26,8 +26,8 @@
 * ***** END GPL LICENSE BLOCK *****
 */

-/**
- * @file	GHOST_Debug.h
+/** \file ghost/intern/GHOST_Debug.h
+ *  \ingroup GHOST
 * Macro's used in GHOST debug target.
 */

--- a/intern/ghost/intern/GHOST_DisplayManager.cpp
+++ b/intern/ghost/intern/GHOST_DisplayManager.cpp
@@ -1,4 +1,4 @@
-/**
+/*
 * $Id$
 * ***** BEGIN GPL LICENSE BLOCK *****
 *
@@ -26,6 +26,11 @@
 * ***** END GPL LICENSE BLOCK *****
 */

+/** \file ghost/intern/GHOST_DisplayManager.cpp
+ *  \ingroup GHOST
+ */
+
+
 /**
 * Copyright (C) 2001 NaN Technologies B.V.
 * @author	Maarten Gribnau
--- a/intern/ghost/intern/GHOST_DisplayManager.h
+++ b/intern/ghost/intern/GHOST_DisplayManager.h
@@ -1,4 +1,4 @@
-/**
+/*
 * $Id$
 * ***** BEGIN GPL LICENSE BLOCK *****
 *
@@ -25,8 +25,9 @@
 *
 * ***** END GPL LICENSE BLOCK *****
 */
-/**
- * @file	GHOST_DisplayManager.h
+
+/** \file ghost/intern/GHOST_DisplayManager.h
+ *  \ingroup GHOST
 * Declaration of GHOST_DisplayManager class.
 */

--- a/intern/ghost/intern/GHOST_DisplayManagerCarbon.cpp
+++ b/intern/ghost/intern/GHOST_DisplayManagerCarbon.cpp
@@ -1,4 +1,4 @@
-/**
+/*
 * $Id$
 * ***** BEGIN GPL LICENSE BLOCK *****
 *
@@ -26,6 +26,11 @@
 * ***** END GPL LICENSE BLOCK *****
 */

+/** \file ghost/intern/GHOST_DisplayManagerCarbon.cpp
+ *  \ingroup GHOST
+ */
+
+
 /**

 * $Id$
--- a/intern/ghost/intern/GHOST_DisplayManagerCarbon.h
+++ b/intern/ghost/intern/GHOST_DisplayManagerCarbon.h
@@ -1,4 +1,4 @@
-/**
+/*
 * $Id$
 * ***** BEGIN GPL LICENSE BLOCK *****
 *
@@ -25,8 +25,9 @@
 *
 * ***** END GPL LICENSE BLOCK *****
 */
-/**
- * @file	GHOST_DisplayManagerCarbon.h
+
+/** \file ghost/intern/GHOST_DisplayManagerCarbon.h
+ *  \ingroup GHOST
 * Declaration of GHOST_DisplayManagerCarbon class.
 */

--- a/intern/ghost/intern/GHOST_DisplayManagerCocoa.h
+++ b/intern/ghost/intern/GHOST_DisplayManagerCocoa.h
@@ -1,4 +1,4 @@
-/**
+/*
 * $Id$
 * ***** BEGIN GPL LICENSE BLOCK *****
 *
@@ -25,8 +25,9 @@
 *
 * ***** END GPL LICENSE BLOCK *****
 */
-/**
- * @file	GHOST_DisplayManagerCocoa.h
+
+/** \file ghost/intern/GHOST_DisplayManagerCocoa.h
+ *  \ingroup GHOST
 * Declaration of GHOST_DisplayManagerCocoa class.
 */

--- a/intern/ghost/intern/GHOST_DisplayManagerWin32.cpp
+++ b/intern/ghost/intern/GHOST_DisplayManagerWin32.cpp
@@ -1,4 +1,4 @@
-/**
+/*
 * $Id$
 * ***** BEGIN GPL LICENSE BLOCK *****
 *
@@ -26,6 +26,11 @@
 * ***** END GPL LICENSE BLOCK *****
 */

+/** \file ghost/intern/GHOST_DisplayManagerWin32.cpp
+ *  \ingroup GHOST
+ */
+
+
 /**

 * $Id$
--- a/intern/ghost/intern/GHOST_DisplayManagerWin32.h
+++ b/intern/ghost/intern/GHOST_DisplayManagerWin32.h
@@ -1,4 +1,4 @@
-/**
+/*
 * $Id$
 * ***** BEGIN GPL LICENSE BLOCK *****
 *
@@ -25,8 +25,9 @@
 *
 * ***** END GPL LICENSE BLOCK *****
 */
-/**
- * @file	GHOST_DisplayManagerWin32.h
+
+/** \file ghost/intern/GHOST_DisplayManagerWin32.h
+ *  \ingroup GHOST
 * Declaration of GHOST_DisplayManagerWin32 class.
 */

--- a/intern/ghost/intern/GHOST_DisplayManagerX11.cpp
+++ b/intern/ghost/intern/GHOST_DisplayManagerX11.cpp
@@ -1,4 +1,4 @@
-/**
+/*
 * $Id$
 * ***** BEGIN GPL LICENSE BLOCK *****
 *
@@ -26,6 +26,11 @@
 * ***** END GPL LICENSE BLOCK *****
 */

+/** \file ghost/intern/GHOST_DisplayManagerX11.cpp
+ *  \ingroup GHOST
+ */
+
+
 #include "GHOST_DisplayManagerX11.h"
 #include "GHOST_SystemX11.h"

--- a/intern/ghost/intern/GHOST_DisplayManagerX11.h
+++ b/intern/ghost/intern/GHOST_DisplayManagerX11.h
@@ -1,4 +1,4 @@
-/**
+/*
 * $Id$
 * ***** BEGIN GPL LICENSE BLOCK *****
 *
@@ -25,8 +25,9 @@
 *
 * ***** END GPL LICENSE BLOCK *****
 */
-/**
- * @file	GHOST_DisplayManagerX11.h
+
+/** \file ghost/intern/GHOST_DisplayManagerX11.h
+ *  \ingroup GHOST
 * Declaration of GHOST_DisplayManagerX11 class.
 */

--- a/intern/ghost/intern/GHOST_DropTargetWin32.cpp
+++ b/intern/ghost/intern/GHOST_DropTargetWin32.cpp
@@ -1,4 +1,4 @@
-/**
+/*
 * $Id$
 * ***** BEGIN GPL LICENSE BLOCK *****
 *
@@ -25,6 +25,11 @@
 *
 * ***** END GPL LICENSE BLOCK *****
 */
+
+/** \file ghost/intern/GHOST_DropTargetWin32.cpp
+ *  \ingroup GHOST
+ */
+
 
 #include "GHOST_Debug.h"
 #include "GHOST_DropTargetWin32.h"
--- a/intern/ghost/intern/GHOST_DropTargetWin32.h
+++ b/intern/ghost/intern/GHOST_DropTargetWin32.h
@@ -1,4 +1,4 @@
-/**
+/*
 * $Id$
 * ***** BEGIN GPL LICENSE BLOCK *****
 *
@@ -25,6 +25,11 @@
 *
 * ***** END GPL LICENSE BLOCK *****
 */
+
+/** \file ghost/intern/GHOST_DropTargetWin32.h
+ *  \ingroup GHOST
+ */
+
 #ifndef _GHOST_DROP_TARGET_WIN32_H_
 #define _GHOST_DROP_TARGET_WIN32_H_

--- a/intern/ghost/intern/GHOST_Event.h
+++ b/intern/ghost/intern/GHOST_Event.h
@@ -1,4 +1,4 @@
-/**
+/*
 * $Id$
 * ***** BEGIN GPL LICENSE BLOCK *****
 *
@@ -25,8 +25,9 @@
 *
 * ***** END GPL LICENSE BLOCK *****
 */
-/**
- * @file	GHOST_Event.h
+
+/** \file ghost/intern/GHOST_Event.h
+ *  \ingroup GHOST
 * Declaration of GHOST_Event class.
 */

--- a/intern/ghost/intern/GHOST_EventButton.h
+++ b/intern/ghost/intern/GHOST_EventButton.h
@@ -1,4 +1,4 @@
-/**
+/*
 * $Id$
 * ***** BEGIN GPL LICENSE BLOCK *****
 *
@@ -25,8 +25,9 @@
 *
 * ***** END GPL LICENSE BLOCK *****
 */
-/**
- * @file	GHOST_EventButton.h
+
+/** \file ghost/intern/GHOST_EventButton.h
+ *  \ingroup GHOST
 * Declaration of GHOST_EventButton class.
 */

--- a/intern/ghost/intern/GHOST_EventCursor.h
+++ b/intern/ghost/intern/GHOST_EventCursor.h
@@ -1,4 +1,4 @@
-/**
+/*
 * $Id$
 * ***** BEGIN GPL LICENSE BLOCK *****
 *
@@ -25,8 +25,9 @@
 *
 * ***** END GPL LICENSE BLOCK *****
 */
-/**
- * @file	GHOST_EventCursor.h
+
+/** \file ghost/intern/GHOST_EventCursor.h
+ *  \ingroup GHOST
 * Declaration of GHOST_EventCursor class.
 */

--- a/intern/ghost/intern/GHOST_EventDragnDrop.h
+++ b/intern/ghost/intern/GHOST_EventDragnDrop.h
@@ -1,4 +1,4 @@
-/**
+/*
 * $Id$
 * ***** BEGIN GPL LICENSE BLOCK *****
 *
@@ -26,6 +26,11 @@
 * ***** END GPL LICENSE BLOCK *****
 */

+/** \file ghost/intern/GHOST_EventDragnDrop.h
+ *  \ingroup GHOST
+ */
+
+
 #ifndef _GHOST_EVENT_DRAGNDROP_H_
 #define _GHOST_EVENT_DRAGNDROP_H_

--- a/intern/ghost/intern/GHOST_EventKey.h
+++ b/intern/ghost/intern/GHOST_EventKey.h
@@ -1,4 +1,4 @@
-/**
+/*
 * $Id$
 * ***** BEGIN GPL LICENSE BLOCK *****
 *
@@ -25,8 +25,9 @@
 *
 * ***** END GPL LICENSE BLOCK *****
 */
-/**
- * @file	GHOST_EventKey.h
+
+/** \file ghost/intern/GHOST_EventKey.h
+ *  \ingroup GHOST
 * Declaration of GHOST_EventKey class.
 */

--- a/intern/ghost/intern/GHOST_EventManager.cpp
+++ b/intern/ghost/intern/GHOST_EventManager.cpp
@@ -1,4 +1,4 @@
-/**
+/*
 * $Id$
 * ***** BEGIN GPL LICENSE BLOCK *****
 *
@@ -26,6 +26,11 @@
 * ***** END GPL LICENSE BLOCK *****
 */

+/** \file ghost/intern/GHOST_EventManager.cpp
+ *  \ingroup GHOST
+ */
+
+
 /**

 * $Id$
--- a/intern/ghost/intern/GHOST_EventManager.h
+++ b/intern/ghost/intern/GHOST_EventManager.h
@@ -1,4 +1,4 @@
-/**
+/*
 * $Id$
 * ***** BEGIN GPL LICENSE BLOCK *****
 *
@@ -25,8 +25,9 @@
 *
 * ***** END GPL LICENSE BLOCK *****
 */
-/**
- * @file	GHOST_EventManager.h
+
+/** \file ghost/intern/GHOST_EventManager.h
+ *  \ingroup GHOST
 * Declaration of GHOST_EventManager class.
 */

--- a/intern/ghost/intern/GHOST_EventNDOF.h
+++ b/intern/ghost/intern/GHOST_EventNDOF.h
@@ -19,6 +19,11 @@
 *
 * ***** END GPL LICENSE BLOCK *****
 */
+
+/** \file ghost/intern/GHOST_EventNDOF.h
+ *  \ingroup GHOST
+ */
+
 

 #ifndef _GHOST_EVENT_NDOF_H_
--- a/intern/ghost/intern/GHOST_EventPrinter.cpp
+++ b/intern/ghost/intern/GHOST_EventPrinter.cpp
@@ -1,4 +1,4 @@
-/**
+/*
 * $Id$
 * ***** BEGIN GPL LICENSE BLOCK *****
 *
@@ -25,8 +25,9 @@
 *
 * ***** END GPL LICENSE BLOCK *****
 */
-/**
- * @file	GHOST_EventPrinter.h
+
+/** \file ghost/intern/GHOST_EventPrinter.cpp
+ *  \ingroup GHOST
 * Declaration of GHOST_EventPrinter class.
 */

--- a/intern/ghost/intern/GHOST_EventPrinter.h
+++ b/intern/ghost/intern/GHOST_EventPrinter.h
@@ -1,4 +1,4 @@
-/**
+/*
 * $Id$
 * ***** BEGIN GPL LICENSE BLOCK *****
 *
@@ -25,8 +25,9 @@
 *
 * ***** END GPL LICENSE BLOCK *****
 */
-/**
- * @file	GHOST_EventPrinter.h
+
+/** \file ghost/intern/GHOST_EventPrinter.h
+ *  \ingroup GHOST
 * Declaration of GHOST_EventPrinter class.
 */

--- a/intern/ghost/intern/GHOST_EventString.h
+++ b/intern/ghost/intern/GHOST_EventString.h
@@ -1,4 +1,4 @@
-/**
+/*
 * $Id$
 * ***** BEGIN GPL LICENSE BLOCK *****
 *
@@ -25,8 +25,9 @@
 *
 * ***** END GPL LICENSE BLOCK *****
 */
-/**
- * @file	GHOST_EventString.h
+
+/** \file ghost/intern/GHOST_EventString.h
+ *  \ingroup GHOST
 * Declaration of GHOST_EventString class.
 */

--- a/intern/ghost/intern/GHOST_EventTrackpad.h
+++ b/intern/ghost/intern/GHOST_EventTrackpad.h
@@ -1,4 +1,4 @@
-/**
+/*
 * $Id$
 * ***** BEGIN GPL LICENSE BLOCK *****
 *
@@ -26,8 +26,9 @@
 *
 * ***** END GPL LICENSE BLOCK *****
 */
-/**
- * @file	GHOST_EventTrackpad.h
+
+/** \file ghost/intern/GHOST_EventTrackpad.h
+ *  \ingroup GHOST
 * Declaration of GHOST_EventTrackpad class.
 */

--- a/intern/ghost/intern/GHOST_EventWheel.h
+++ b/intern/ghost/intern/GHOST_EventWheel.h
@@ -1,4 +1,4 @@
-/**
+/*
 * $Id$
 * ***** BEGIN GPL LICENSE BLOCK *****
 *
@@ -25,8 +25,9 @@
 *
 * ***** END GPL LICENSE BLOCK *****
 */
-/**
- * @file	GHOST_EventWheel.h
+
+/** \file ghost/intern/GHOST_EventWheel.h
+ *  \ingroup GHOSTeel.h
 * Declaration of GHOST_EventWheel class.
 */

--- a/intern/ghost/intern/GHOST_ISystem.cpp
+++ b/intern/ghost/intern/GHOST_ISystem.cpp
@@ -1,4 +1,4 @@
-/**
+/*
 * $Id$
 * ***** BEGIN GPL LICENSE BLOCK *****
 *
@@ -26,6 +26,11 @@
 * ***** END GPL LICENSE BLOCK *****
 */

+/** \file ghost/intern/GHOST_ISystem.cpp
+ *  \ingroup GHOST
+ */
+
+
 /**

 * $Id$
--- a/intern/ghost/intern/GHOST_ISystemPaths.cpp
+++ b/intern/ghost/intern/GHOST_ISystemPaths.cpp
@@ -1,4 +1,4 @@
-/**
+/*
 * $Id$
 * ***** BEGIN GPL LICENSE BLOCK *****
 *
@@ -26,6 +26,11 @@
 * ***** END GPL LICENSE BLOCK *****
 */

+/** \file ghost/intern/GHOST_ISystemPaths.cpp
+ *  \ingroup GHOST
+ */
+
+
 /**

 * $Id$
--- a/intern/ghost/intern/GHOST_ModifierKeys.cpp
+++ b/intern/ghost/intern/GHOST_ModifierKeys.cpp
@@ -1,4 +1,4 @@
-/**
+/*
 * $Id$
 * ***** BEGIN GPL LICENSE BLOCK *****
 *
@@ -26,6 +26,11 @@
 * ***** END GPL LICENSE BLOCK *****
 */

+/** \file ghost/intern/GHOST_ModifierKeys.cpp
+ *  \ingroup GHOST
+ */
+
+
 /**

 * $Id$
--- a/intern/ghost/intern/GHOST_ModifierKeys.h
+++ b/intern/ghost/intern/GHOST_ModifierKeys.h
@@ -1,4 +1,4 @@
-/**
+/*
 * $Id$
 * ***** BEGIN GPL LICENSE BLOCK *****
 *
@@ -25,8 +25,9 @@
 *
 * ***** END GPL LICENSE BLOCK *****
 */
-/**
- * @file	GHOST_ModifierKeys.h
+
+/** \file ghost/intern/GHOST_ModifierKeys.h
+ *  \ingroup GHOST
 * Declaration of GHOST_ModifierKeys struct.
 */

--- a/intern/ghost/intern/GHOST_NDOFManager.cpp
+++ b/intern/ghost/intern/GHOST_NDOFManager.cpp
@@ -20,6 +20,11 @@
 * ***** END GPL LICENSE BLOCK *****
 */

+/** \file ghost/intern/GHOST_NDOFManager.cpp
+ *  \ingroup GHOST
+ */
+
+
 #include <stdio.h> /* just for printf */

 #include "GHOST_NDOFManager.h"
--- a/intern/ghost/intern/GHOST_NDOFManager.h
+++ b/intern/ghost/intern/GHOST_NDOFManager.h
@@ -19,6 +19,11 @@
 *
 * ***** END GPL LICENSE BLOCK *****
 */
+
+/** \file ghost/intern/GHOST_NDOFManager.h
+ *  \ingroup GHOST
+ */
+
 
 #ifndef _GHOST_NDOFMANAGER_H_
 #define _GHOST_NDOFMANAGER_H_
--- a/intern/ghost/intern/GHOST_Path-api.cpp
+++ b/intern/ghost/intern/GHOST_Path-api.cpp
@@ -1,4 +1,4 @@
-/**
+/*
 * $Id$
 *
 * ***** BEGIN GPL LICENSE BLOCK *****
@@ -27,6 +27,11 @@
 * ***** END GPL LICENSE BLOCK *****
 */

+/** \file ghost/intern/GHOST_Path-api.cpp
+ *  \ingroup GHOST
+ */
+
+
 #include "intern/GHOST_Debug.h"
 #include "GHOST_Types.h"
 #include "GHOST_Path-api.h"
--- a/intern/ghost/intern/GHOST_Rect.cpp
+++ b/intern/ghost/intern/GHOST_Rect.cpp
@@ -1,4 +1,4 @@
-/**
+/*
 * $Id$
 * ***** BEGIN GPL LICENSE BLOCK *****
 *
@@ -26,6 +26,11 @@
 * ***** END GPL LICENSE BLOCK *****
 */

+/** \file ghost/intern/GHOST_Rect.cpp
+ *  \ingroup GHOST
+ */
+
+
 #include "GHOST_Rect.h"


--- a/intern/ghost/intern/GHOST_System.cpp
+++ b/intern/ghost/intern/GHOST_System.cpp
@@ -1,4 +1,4 @@
-/**
+/*
 * $Id$
 * ***** BEGIN GPL LICENSE BLOCK *****
 *
@@ -26,6 +26,11 @@
 * ***** END GPL LICENSE BLOCK *****
 */

+/** \file ghost/intern/GHOST_System.cpp
+ *  \ingroup GHOST
+ */
+
+
 /**

 * $Id$
--- a/intern/ghost/intern/GHOST_System.h
+++ b/intern/ghost/intern/GHOST_System.h
@@ -1,4 +1,4 @@
-/**
+/*
 * $Id$
 * ***** BEGIN GPL LICENSE BLOCK *****
 *
@@ -25,8 +25,9 @@
 *
 * ***** END GPL LICENSE BLOCK *****
 */
-/**
- * @file	GHOST_System.h
+
+/** \file ghost/intern/GHOST_System.h
+ *  \ingroup GHOST
 * Declaration of GHOST_System class.
 */

--- a/intern/ghost/intern/GHOST_SystemCarbon.cpp
+++ b/intern/ghost/intern/GHOST_SystemCarbon.cpp
@@ -1,4 +1,4 @@
-/**
+/*
 * $Id$
 * ***** BEGIN GPL LICENSE BLOCK *****
 *
@@ -26,6 +26,11 @@
 * ***** END GPL LICENSE BLOCK *****
 */

+/** \file ghost/intern/GHOST_SystemCarbon.cpp
+ *  \ingroup GHOST
+ */
+
+
 /**

 * $Id$
--- a/intern/ghost/intern/GHOST_SystemCarbon.h
+++ b/intern/ghost/intern/GHOST_SystemCarbon.h
@@ -1,4 +1,4 @@
-/**
+/*
 * $Id$
 * ***** BEGIN GPL LICENSE BLOCK *****
 *
@@ -25,8 +25,9 @@
 *
 * ***** END GPL LICENSE BLOCK *****
 */
-/**
- * @file	GHOST_SystemCarbon.h
+
+/** \file ghost/intern/GHOST_SystemCarbon.h
+ *  \ingroup GHOST
 * Declaration of GHOST_SystemCarbon class.
 */

--- a/intern/ghost/intern/GHOST_SystemCocoa.h
+++ b/intern/ghost/intern/GHOST_SystemCocoa.h
@@ -1,4 +1,4 @@
-/**
+/*
 * $Id$
 * ***** BEGIN GPL LICENSE BLOCK *****
 *
@@ -26,8 +26,9 @@
 *
 * ***** END GPL LICENSE BLOCK *****
 */
-/**
- * @file	GHOST_SystemCocoa.h
+
+/** \file ghost/intern/GHOST_SystemCocoa.h
+ *  \ingroup GHOST
 * Declaration of GHOST_SystemCocoa class.
 */

--- a/intern/ghost/intern/GHOST_SystemPaths.h
+++ b/intern/ghost/intern/GHOST_SystemPaths.h
@@ -1,4 +1,4 @@
-/**
+/*
 * $Id$
 *
 * ***** BEGIN GPL LICENSE BLOCK *****
@@ -25,6 +25,11 @@
 *
 * ***** END GPL LICENSE BLOCK *****
 */
+
+/** \file ghost/intern/GHOST_SystemPaths.h
+ *  \ingroup GHOST
+ */
+
 #ifndef _GHOST_SYSTEMPATHS_H_
 #define _GHOST_SYSTEMPATHS_H_

--- a/intern/ghost/intern/GHOST_SystemPathsCarbon.cpp
+++ b/intern/ghost/intern/GHOST_SystemPathsCarbon.cpp
@@ -1,4 +1,4 @@
-/**
+/*
 * $Id$
 *
 * ***** BEGIN GPL LICENSE BLOCK *****
@@ -26,6 +26,11 @@
 * ***** END GPL LICENSE BLOCK *****
 */

+/** \file ghost/intern/GHOST_SystemPathsCarbon.cpp
+ *  \ingroup GHOST
+ */
+
+
 #include <Carbon/Carbon.h>
 #include <ApplicationServices/ApplicationServices.h>
 #include "GHOST_SystemPathsCarbon.h"
--- a/intern/ghost/intern/GHOST_SystemPathsCarbon.h
+++ b/intern/ghost/intern/GHOST_SystemPathsCarbon.h
@@ -1,4 +1,4 @@
-/**
+/*
 * $Id$
 *
 * ***** BEGIN GPL LICENSE BLOCK *****
@@ -26,6 +26,11 @@
 * ***** END GPL LICENSE BLOCK *****
 */

+/** \file ghost/intern/GHOST_SystemPathsCarbon.h
+ *  \ingroup GHOST
+ */
+
+
 #ifndef _GHOST_SYSTEM_PATHS_CARBON_H_
 #define _GHOST_SYSTEM_PATHS_CARBON_H_

--- a/intern/ghost/intern/GHOST_SystemPathsCocoa.h
+++ b/intern/ghost/intern/GHOST_SystemPathsCocoa.h
@@ -1,4 +1,4 @@
-/**
+/*
 * $Id$
 *
 * ***** BEGIN GPL LICENSE BLOCK *****
@@ -26,6 +26,11 @@
 * ***** END GPL LICENSE BLOCK *****
 */

+/** \file ghost/intern/GHOST_SystemPathsCocoa.h
+ *  \ingroup GHOST
+ */
+
+
 #ifndef _GHOST_SYSTEM_PATHS_COCOA_H_
 #define _GHOST_SYSTEM_PATHS_COCOA_H_

--- a/intern/ghost/intern/GHOST_SystemPathsWin32.cpp
+++ b/intern/ghost/intern/GHOST_SystemPathsWin32.cpp
@@ -1,4 +1,4 @@
-/**
+/*
 * $Id$
 * ***** BEGIN GPL LICENSE BLOCK *****
 *
@@ -25,6 +25,11 @@
 * ***** END GPL LICENSE BLOCK *****
 */

+/** \file ghost/intern/GHOST_SystemPathsWin32.cpp
+ *  \ingroup GHOST
+ */
+
+
 #include "GHOST_SystemPathsWin32.h"

 #define WIN32_LEAN_AND_MEAN
--- a/intern/ghost/intern/GHOST_SystemPathsWin32.h
+++ b/intern/ghost/intern/GHOST_SystemPathsWin32.h
@@ -1,4 +1,4 @@
-/**
+/*
 * $Id$
 * ***** BEGIN GPL LICENSE BLOCK *****
 *
@@ -26,6 +26,11 @@
 * ***** END GPL LICENSE BLOCK *****
 */

+/** \file ghost/intern/GHOST_SystemPathsWin32.h
+ *  \ingroup GHOST
+ */
+
+
 #ifndef _GHOST_SYSTEM_PATHS_WIN32_H_
 #define _GHOST_SYSTEM_PATHS_WIN32_H_

--- a/intern/ghost/intern/GHOST_SystemPathsX11.cpp
+++ b/intern/ghost/intern/GHOST_SystemPathsX11.cpp
@@ -1,4 +1,4 @@
-/**
+/*
 * $Id$
 *
 * ***** BEGIN GPL LICENSE BLOCK *****
@@ -26,6 +26,11 @@
 * ***** END GPL LICENSE BLOCK *****
 */

+/** \file ghost/intern/GHOST_SystemPathsX11.cpp
+ *  \ingroup GHOST
+ */
+
+
 #include "GHOST_SystemPathsX11.h"

 #include "GHOST_Debug.h"
--- a/intern/ghost/intern/GHOST_SystemPathsX11.h
+++ b/intern/ghost/intern/GHOST_SystemPathsX11.h
@@ -1,4 +1,4 @@
-/**
+/*
 * $Id$
 *
 * ***** BEGIN GPL LICENSE BLOCK *****
@@ -26,6 +26,11 @@
 * ***** END GPL LICENSE BLOCK *****
 */

+/** \file ghost/intern/GHOST_SystemPathsX11.h
+ *  \ingroup GHOST
+ */
+
+
 #ifndef _GHOST_SYSTEM_PATHS_X11_H_
 #define _GHOST_SYSTEM_PATHS_X11_H_

--- a/intern/ghost/intern/GHOST_SystemWin32.cpp
+++ b/intern/ghost/intern/GHOST_SystemWin32.cpp
@@ -1,4 +1,4 @@
-/**
+/*
 * $Id$
 * ***** BEGIN GPL LICENSE BLOCK *****
 *
@@ -26,6 +26,11 @@
 * ***** END GPL LICENSE BLOCK *****
 */

+/** \file ghost/intern/GHOST_SystemWin32.cpp
+ *  \ingroup GHOST
+ */
+
+
 /**

 * $Id$
--- a/intern/ghost/intern/GHOST_SystemWin32.h
+++ b/intern/ghost/intern/GHOST_SystemWin32.h
@@ -1,4 +1,4 @@
-/**
+/*
 * $Id$
 * ***** BEGIN GPL LICENSE BLOCK *****
 *
@@ -25,8 +25,9 @@
 *
 * ***** END GPL LICENSE BLOCK *****
 */
-/**
- * @file	GHOST_SystemWin32.h
+
+/** \file ghost/intern/GHOST_SystemWin32.h
+ *  \ingroup GHOST
 * Declaration of GHOST_SystemWin32 class.
 */

--- a/intern/ghost/intern/GHOST_SystemX11.cpp
+++ b/intern/ghost/intern/GHOST_SystemX11.cpp
@@ -1,4 +1,4 @@
-/**
+/*
 * $Id$
 * ***** BEGIN GPL LICENSE BLOCK *****
 *
@@ -29,6 +29,11 @@
 * ***** END GPL LICENSE BLOCK *****
 */

+/** \file ghost/intern/GHOST_SystemX11.cpp
+ *  \ingroup GHOST
+ */
+
+
 #include "GHOST_SystemX11.h"
 #include "GHOST_WindowX11.h"
 #include "GHOST_WindowManager.h"
--- a/intern/ghost/intern/GHOST_SystemX11.h
+++ b/intern/ghost/intern/GHOST_SystemX11.h
@@ -1,4 +1,4 @@
-/**
+/*
 * $Id$
 * ***** BEGIN GPL LICENSE BLOCK *****
 *
@@ -25,8 +25,9 @@
 *
 * ***** END GPL LICENSE BLOCK *****
 */
-/**
- * @file	GHOST_SystemX11.h
+
+/** \file ghost/intern/GHOST_SystemX11.h
+ *  \ingroup GHOST
 * Declaration of GHOST_SystemX11 class.
 */

@@ -181,7 +182,7 @@ public:
 	) const;

 	/**
-	 * @section
+	 * @section Interface Dirty
 	 * Flag a window as dirty. This will
 	 * generate a GHOST window update event on a call to processEvents() 
 	 */
--- a/intern/ghost/intern/GHOST_TaskbarWin32.h
+++ b/intern/ghost/intern/GHOST_TaskbarWin32.h
@@ -1,3 +1,6 @@
+/** \file ghost/intern/GHOST_TaskbarWin32.h
+ *  \ingroup GHOST
+ */
 #ifndef GHOST_TASKBARWIN32_H_
 #define GHOST_TASKBARWIN32_H_
 #ifndef WIN32
--- a/intern/ghost/intern/GHOST_TimerManager.cpp
+++ b/intern/ghost/intern/GHOST_TimerManager.cpp
@@ -1,4 +1,4 @@
-/**
+/*
 * $Id$
 * ***** BEGIN GPL LICENSE BLOCK *****
 *
@@ -26,6 +26,11 @@
 * ***** END GPL LICENSE BLOCK *****
 */

+/** \file ghost/intern/GHOST_TimerManager.cpp
+ *  \ingroup GHOST
+ */
+
+
 /**

 * $Id$
--- a/intern/ghost/intern/GHOST_TimerManager.h
+++ b/intern/ghost/intern/GHOST_TimerManager.h
@@ -1,4 +1,4 @@
-/**
+/*
 * $Id$
 * ***** BEGIN GPL LICENSE BLOCK *****
 *
@@ -25,8 +25,9 @@
 *
 * ***** END GPL LICENSE BLOCK *****
 */
-/**
- * @file	GHOST_TimerManager.h
+
+/** \file ghost/intern/GHOST_TimerManager.h
+ *  \ingroup GHOST
 * Declaration of GHOST_TimerManager class.
 */

--- a/intern/ghost/intern/GHOST_TimerTask.h
+++ b/intern/ghost/intern/GHOST_TimerTask.h
@@ -1,4 +1,4 @@
-/**
+/*
 * $Id$
 * ***** BEGIN GPL LICENSE BLOCK *****
 *
@@ -25,8 +25,9 @@
 *
 * ***** END GPL LICENSE BLOCK *****
 */
-/**
- * @file	GHOST_TimerTask.h
+
+/** \file ghost/intern/GHOST_TimerTask.h
+ *  \ingroup GHOST
 * Declaration of GHOST_TimerTask class.
 */

--- a/intern/ghost/intern/GHOST_Window.cpp
+++ b/intern/ghost/intern/GHOST_Window.cpp
@@ -1,4 +1,4 @@
-/**
+/*
 * $Id$
 * ***** BEGIN GPL LICENSE BLOCK *****
 *
@@ -26,6 +26,11 @@
 * ***** END GPL LICENSE BLOCK *****
 */

+/** \file ghost/intern/GHOST_Window.cpp
+ *  \ingroup GHOST
+ */
+
+
 /**
 * Copyright (C) 2001 NaN Technologies B.V.
 * @author	Maarten Gribnau
--- a/intern/ghost/intern/GHOST_Window.h
+++ b/intern/ghost/intern/GHOST_Window.h
@@ -1,4 +1,4 @@
-/**
+/*
 * $Id$
 * ***** BEGIN GPL LICENSE BLOCK *****
 *
@@ -25,8 +25,9 @@
 *
 * ***** END GPL LICENSE BLOCK *****
 */
-/**
- * @file	GHOST_Window.h
+
+/** \file ghost/intern/GHOST_Window.h
+ *  \ingroup GHOST
 * Declaration of GHOST_Window class.
 */

--- a/intern/ghost/intern/GHOST_WindowCarbon.cpp
+++ b/intern/ghost/intern/GHOST_WindowCarbon.cpp
@@ -1,4 +1,4 @@
-/**
+/*
 * $Id$
 * ***** BEGIN GPL LICENSE BLOCK *****
 *
@@ -26,6 +26,11 @@
 * ***** END GPL LICENSE BLOCK *****
 */

+/** \file ghost/intern/GHOST_WindowCarbon.cpp
+ *  \ingroup GHOST
+ */
+
+
 /**

 * $Id$
--- a/intern/ghost/intern/GHOST_WindowCarbon.h
+++ b/intern/ghost/intern/GHOST_WindowCarbon.h
@@ -1,4 +1,4 @@
-/**
+/*
 * $Id$
 * ***** BEGIN GPL LICENSE BLOCK *****
 *
@@ -25,8 +25,9 @@
 *
 * ***** END GPL LICENSE BLOCK *****
 */
-/**
- * @file	GHOST_WindowCarbon.h
+
+/** \file ghost/intern/GHOST_WindowCarbon.h
+ *  \ingroup GHOST
 * Declaration of GHOST_WindowCarbon class.
 */

--- a/intern/ghost/intern/GHOST_WindowCocoa.h
+++ b/intern/ghost/intern/GHOST_WindowCocoa.h
@@ -1,4 +1,4 @@
-/**
+/*
 * $Id$
 * ***** BEGIN GPL LICENSE BLOCK *****
 *
@@ -25,8 +25,9 @@
 *
 * ***** END GPL LICENSE BLOCK *****
 */
-/**
- * @file	GHOST_WindowCocoa.h
+
+/** \file ghost/intern/GHOST_WindowCocoa.h
+ *  \ingroup GHOST
 * Declaration of GHOST_WindowCocoa class.
 */

--- a/intern/ghost/intern/GHOST_WindowManager.cpp
+++ b/intern/ghost/intern/GHOST_WindowManager.cpp
@@ -1,4 +1,4 @@
-/**
+/*
 * $Id$
 * ***** BEGIN GPL LICENSE BLOCK *****
 *
@@ -26,6 +26,11 @@
 * ***** END GPL LICENSE BLOCK *****
 */

+/** \file ghost/intern/GHOST_WindowManager.cpp
+ *  \ingroup GHOST
+ */
+
+
 /**

 * $Id$
--- a/intern/ghost/intern/GHOST_WindowManager.h
+++ b/intern/ghost/intern/GHOST_WindowManager.h
@@ -1,4 +1,4 @@
-/**
+/*
 * $Id$
 * ***** BEGIN GPL LICENSE BLOCK *****
 *
@@ -25,8 +25,9 @@
 *
 * ***** END GPL LICENSE BLOCK *****
 */
-/**
- * @file	GHOST_WindowManager.h
+
+/** \file ghost/intern/GHOST_WindowManager.h
+ *  \ingroup GHOST
 * Declaration of GHOST_WindowManager class.
 */

--- a/intern/ghost/intern/GHOST_WindowWin32.cpp
+++ b/intern/ghost/intern/GHOST_WindowWin32.cpp
@@ -1,4 +1,4 @@
-/**
+/*
 * $Id$
 * ***** BEGIN GPL LICENSE BLOCK *****
 *
@@ -26,6 +26,11 @@
 * ***** END GPL LICENSE BLOCK *****
 */

+/** \file ghost/intern/GHOST_WindowWin32.cpp
+ *  \ingroup GHOST
+ */
+
+
 /**

 * $Id$
--- a/intern/ghost/intern/GHOST_WindowWin32.h
+++ b/intern/ghost/intern/GHOST_WindowWin32.h
@@ -1,4 +1,4 @@
-/**
+/*
 * $Id$
 * ***** BEGIN GPL LICENSE BLOCK *****
 *
@@ -25,8 +25,9 @@
 *
 * ***** END GPL LICENSE BLOCK *****
 */
-/**
- * @file	GHOST_WindowWin32.h
+
+/** \file ghost/intern/GHOST_WindowWin32.h
+ *  \ingroup GHOST
 * Declaration of GHOST_WindowWin32 class.
 */

--- a/intern/ghost/intern/GHOST_WindowX11.cpp
+++ b/intern/ghost/intern/GHOST_WindowX11.cpp
@@ -1,4 +1,4 @@
-/**
+/*
 * $Id$
 * ***** BEGIN GPL LICENSE BLOCK *****
 *
@@ -26,6 +26,11 @@
 * ***** END GPL LICENSE BLOCK *****
 */

+/** \file ghost/intern/GHOST_WindowX11.cpp
+ *  \ingroup GHOST
+ */
+
+
 #include "GHOST_WindowX11.h"
 #include "GHOST_SystemX11.h"
 #include "STR_String.h"
--- a/intern/ghost/intern/GHOST_WindowX11.h
+++ b/intern/ghost/intern/GHOST_WindowX11.h
@@ -1,4 +1,4 @@
-/**
+/*
 * $Id$
 * ***** BEGIN GPL LICENSE BLOCK *****
 *
@@ -25,8 +25,9 @@
 *
 * ***** END GPL LICENSE BLOCK *****
 */
-/**
- * @file	GHOST_WindowX11.h
+
+/** \file ghost/intern/GHOST_WindowX11.h
+ *  \ingroup GHOST
 * Declaration of GHOST_WindowX11 class.
 */

@@ -170,8 +171,7 @@ public:
 	 ~GHOST_WindowX11();

 	/**
-	 * @section 
-	 * X11 system specific calls.
+	 * @section x11specific X11 system specific calls
 	 */

 	/**