Removed those extra CVS tag lines in the header files of ghost (now I know what

Gilles meant) and added some extra doxygen tags I had lying around.
Removed the cocoa file since it was rubbish.
Maarten

intern/ghost/GHOST_C-api.h

@@ -28,6 +28,11 @@
  *
  * ***** END GPL/BL DUAL LICENSE BLOCK *****
  */
+/**
+ * @file	GHOST_C-api.h
+ * GHOST C-API function and type declarations.
+ * The C-API wraps the C++ objects with the 
+ */
 
 #ifndef	GHOST_C_API_H
 #define GHOST_C_API_H
@@ -38,6 +43,12 @@
 extern "C" { 
 #endif
 
+/**
+ * Creates a "handle" for a C++ GHOST object.
+ * A handle is just an opaque pointer to an empty struct.
+ * In the API the pointer is casted to the actual C++ class.
+ * @param	name	Name of the handle to create.
+ */
 #define GHOST_DECLARE_HANDLE(name) typedef struct name##__ { int unused; } *name
 
 GHOST_DECLARE_HANDLE(GHOST_SystemHandle);