tinkered around with some more docs

src/cart.cpp

@@ -18,6 +18,9 @@
  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  */
 
+/// \file
+/// \brief This file contains all code for coordinating the mapping in of the address space external to the NES.
+
 #include <string.h>
 #include <stdlib.h>
 #include <stdio.h>
@@ -32,12 +35,6 @@
 
 #include "general.h"
 
-/*
-   This file contains all code for coordinating the mapping in of the
-   address space external to the NES.
-   It's also (ab)used by the NSF code.
-*/
-
 uint8 *Page[32],*VPage[8];
 uint8 **VPageR=VPage;
 uint8 *VPageG[8];

src/config.cpp

@@ -1,5 +1,5 @@
 /// \file
-/// \brief A poorly documented file.
+/// \brief Contains methods related to the build configuration
 
 #include <string.h>
 #include <stdio.h>

src/filter.cpp

@@ -1,3 +1,6 @@
+/// \file
+/// \brief Sound filtering code
+
 #include <math.h>
 #include <stdio.h>
 #include "types.h"

src/md5.cpp

@@ -1,15 +1,12 @@
-/*
- * RFC 1321 compliant MD5 implementation,
- * by Christophe Devine <devine@cr0.net>;
- * this program is licensed under the GPL.
- */
+/// \file
+/// brief RFC 1321 compliant MD5 implementation,
+/// RFC 1321 compliant MD5 implementation,
+/// by Christophe Devine <devine@cr0.net>;
+/// this program is licensed under the GPL.
 
-/* Modified October 3, 2003, to remove testing code, and add
-   include of "types.h".
- 
-   Added simple MD5 to ASCII string conversion function.
-   -Xodnizel
-*/
+//Modified October 3, 2003, to remove testing code, and add include of "types.h".
+//Added simple MD5 to ASCII string conversion function.
+// -Xodnizel   
 
 #include <string.h>
 #include "types.h"

src/memory.cpp

@@ -18,13 +18,16 @@
  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  */
 
-#include <stdlib.h>
+/// \file
+/// \brief memory management services provided by FCEU core
 
+#include <stdlib.h>
 #include "types.h"
 #include "fceu.h"
 #include "memory.h"
 #include "general.h"
 
+///allocates the specified number of bytes. exits process if this fails
 void *FCEU_gmalloc(uint32 size)
 {
  void *ret;
@@ -37,6 +40,7 @@ void *FCEU_gmalloc(uint32 size)
  return ret;
 }
 
+///allocates the specified number of bytes. returns null if this fails
 void *FCEU_malloc(uint32 size)
 {
  void *ret;
@@ -49,52 +53,14 @@ void *FCEU_malloc(uint32 size)
  return ret;
 }
 
-void FCEU_free(void *ptr)    // Might do something with this and FCEU_malloc later...
-{
- free(ptr);
-}
-
+///frees memory allocated with FCEU_gmalloc
 void FCEU_gfree(void *ptr)
 {
  free(ptr);
 }
 
-void FASTAPASS(3) FCEU_memmove(void *d, void *s, uint32 l)
+///frees memory allocated with FCEU_malloc
+void FCEU_free(void *ptr)    // Might do something with this and FCEU_malloc later...
 {
- uint32 x;
- int t;
-
- /* Type really doesn't matter. */
- t=(int)d;
- t|=(int)s;
- t|=(int)l;
-
- if(t&3)    // Not 4-byte aligned and/or length is not a multiple of 4.
- {
-  uint8 *tmpd, *tmps;  
-
-  tmpd = (uint8*)d; //mbg merge 7/17/06 added cast
-  tmps = (uint8*)s; //mbg merge 7/17/06 added cast
-
-  for(x=l;x;x--)  // This could be optimized further, though(more tests could be performed).
-  {
-   *tmpd=*tmps;
-   tmpd++;
-   tmps++;
-  }
- }
- else
- {
-  uint32 *tmpd, *tmps;
-
-  tmpd = (uint32*)d; //mbg merge 7/17/06 added cast
-  tmps = (uint32*)s; //mbg merge 7/17/06 added cast
-
-  for(x=l>>2;x;x--)
-  {
-   *tmpd=*tmps;
-   tmpd++;
-   tmps++;
-  }
- }
-}
+ free(ptr);
+}

src/nsf.cpp

@@ -18,6 +18,9 @@
  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  */
 
+/// \file
+/// \brief implements a built-in NSF player.  This is a perk--not a part of the emu core
+
 #include <stdio.h>
 #include <stdlib.h>
 #include <string.h>