added some trivial comments

--HG--
extra : convert_revision : svn%3A39bc706e-5318-0410-9160-8a85361fbb7c/trunk%40167

core/sm_globals.h

@@ -1,6 +1,10 @@
 #ifndef _INCLUDE_SOURCEMOD_GLOBALS_H_
 #define _INCLUDE_SOURCEMOD_GLOBALS_H_
 
+/**
+ * @file Contains global headers that most files in SourceMod will need.
+ */
+
 #include <sp_vm_types.h>
 #include <sp_vm_api.h>
 #include "sm_platform.h"

core/sm_platform.h

@@ -1,6 +1,10 @@
 #ifndef _INCLUDE_SOURCEMOD_PLATFORM_H_
 #define _INCLUDE_SOURCEMOD_PLATFORM_H_
 
+/**
+ * @file Contains platform-specific macros for abstraction.
+ */
+
 #if defined WIN32 || defined WIN64
 #define PLATFORM_WINDOWS
 #if !defined WIN32_LEAN_AND_MEAN

core/sm_version.h

@@ -1,6 +1,10 @@
 #ifndef _INCLUDE_SOURCEMOD_VERSION_H_
 #define _INCLUDE_SOURCEMOD_VERSION_H_
 
+/**
+ * @file Contains SourceMod version information.
+ */
+
 #define SOURCEMOD_VERSION	"0.0.0.0"
 #define SOURCEMOD_V_MAJOR	0
 #define SOURCEMOD_V_MINOR	0

core/sourcemm_api.h

@@ -3,6 +3,10 @@
 
 #include <ISmmPlugin.h>
 
+/**
+ * @file Contains wrappers around required Metamod:Source API exports
+ */
+
 class SourceMod_Core : public ISmmPlugin
 {
 public:

core/sourcemod.h

@@ -3,6 +3,10 @@
 
 #include "sm_globals.h"
 
+/**
+ * @brief Implements SourceMod's global overall management, API, and logic
+ */
+
 class SourceModBase
 {
 public: