Index: favorites.module
===================================================================
--- favorites.module	(revision 386)
+++ favorites.module	(working copy)
@@ -1,11 +1,22 @@
 <?php
 
+// $Id$
+
+/**
+ * @file
+ * Favorites module for tracking bookmarks on a site.
+ *
+ * The favorites module allows users to
+ */
+
+
 /*
  * Implementation of hook_perm().
  */
 function favorites_perm() {
   return array('manage own favorites', 'manage all favorites');
 }
+
 /*
  * Implementation of hook_menu().
  */
@@ -20,7 +31,12 @@
   return $items;
 }
 
-function favorite_load($fid) {
+/**
+ * Helper function to load a favorite.
+ *
+ * @param int $fid
+ * @return object of the data in the favorites table.
+ */function favorite_load($fid) {
   return db_fetch_object(db_query("SELECT * FROM {favorites} WHERE fid = %d", $fid));
 }
 
@@ -33,6 +49,7 @@
     ),
   );
 }
+
 /*
  * Deletes a favorite.
  */
@@ -53,11 +70,11 @@
   //The query string contains the redirection page.
   drupal_goto();
 }
+
 /*
  * Implementation of hook_block().
- * 
+ *
  */
-
 function favorites_block($op = 'list', $delta = 0, $edit = array()) {
   if ($op == 'list') {
     $blocks[0]['info'] = t('User Favorites block');
@@ -70,7 +87,7 @@
         if (user_access('manage own favorites')) {
           return favorites_user_block();
         }
-        
+
     }
   }
 }
@@ -145,7 +162,7 @@
     '#value' => $title,
   );
 
-  //Preserve the current path with query string. 
+  //Preserve the current path with query string.
   $destination = drupal_get_destination();
   $form['#redirect'] = array($_GET['q'], drupal_query_string_encode($_GET, array('q')));
 
Index: favorites.install
===================================================================
--- favorites.install	(revision 386)
+++ favorites.install	(working copy)
@@ -1,18 +1,24 @@
 <?php
 
+// $Id$
+
+/**
+ * @file
+ *  Install, update and uninstall functions for the Favorites module.
+ */
+
 /*
- * Implementation of hook_install. {
- * 
+ * Implementation of hook_install().
+ *
  */
-
 function favorites_install() {
   drupal_install_schema('favorites');
 }
+
 /*
- * Implementation of hook_schema.
- * 
+ * Implementation of hook_schema().
+ *
  */
-
 function favorites_schema() {
   $schema = array();
   $schema['favorites'] = array(
@@ -23,7 +29,7 @@
         'type' => 'serial',
         'unsigned' => TRUE,
         'not null' => TRUE,
-       ),
+      ),
       'uid' => array(
         'description' => "The user ID of the user who owns the favorite.",
         'type' => 'int',
@@ -57,7 +63,7 @@
     ),
     'primary key' => array('fid'),
     'unique keys' => array('fid' => array('fid')),
-    'indexes' => array('uid '=> array('uid')),
+    'indexes' => array('uid' => array('uid')),
   );
   return $schema;
 }
\ No newline at end of file