Index: pathauto.admin.inc
===================================================================
RCS file: /cvs/drupal-contrib/contributions/modules/pathauto/pathauto.admin.inc,v
retrieving revision 1.6
diff -u -p -r1.6 pathauto.admin.inc
--- pathauto.admin.inc	20 May 2008 18:09:08 -0000	1.6
+++ pathauto.admin.inc	24 May 2008 09:44:08 -0000
@@ -291,7 +291,7 @@ function pathauto_admin_settings() {
 }
 
 /**
- * Helper function to see if they are using all -raw tokens available
+ * Helper function to see if they are using all -raw tokens available.
  *
  * @param $pattern
  *   TODO: What does this do?
@@ -299,7 +299,8 @@ function pathauto_admin_settings() {
  *   A flag indicating the class of substitution tokens to use.
  * @return
  *   A status flag, telling whether there is an error or not.
- * @see function token_get_list for more information on the $type parameter.
+ * @see token_get_list()
+ *   For more information on the $type parameter.
  */
 function _pathauto_check_pattern($pattern, $type) {
   // Hold items we've warned about so we only warn once per token
Index: pathauto.inc
===================================================================
RCS file: /cvs/drupal-contrib/contributions/modules/pathauto/pathauto.inc,v
retrieving revision 1.38
diff -u -p -r1.38 pathauto.inc
--- pathauto.inc	20 May 2008 18:09:08 -0000	1.38
+++ pathauto.inc	24 May 2008 09:44:09 -0000
@@ -3,7 +3,7 @@
 
 /**
  * @file
- * Miscellaneous functions for Pathauto
+ * Miscellaneous functions for Pathauto.
  *
  * @ingroup pathauto
  */
@@ -461,7 +461,7 @@ function pathauto_clean_token_values($fu
 
 /**
  * Returns an array of arrays for punctuation values.
- * 
+ *
  * Returns an array of arrays for punctuation values keyed by a name, including
  * the value and a textual description.
  * Can and should be expanded to include "all" non text punctuation values.
Index: pathauto.module
===================================================================
RCS file: /cvs/drupal-contrib/contributions/modules/pathauto/pathauto.module,v
retrieving revision 1.110
diff -u -p -r1.110 pathauto.module
--- pathauto.module	20 May 2008 18:09:08 -0000	1.110
+++ pathauto.module	24 May 2008 09:44:09 -0000
@@ -88,7 +88,7 @@ function _pathauto_include() {
 }
 
 /**
- * Implementation of hook_token_values() for Pathauto specific tokens
+ * Implementation of hook_token_values() for Pathauto specific tokens.
  */
 function pathauto_token_values($type, $object = NULL) {
   if (module_exists('taxonomy')) {
@@ -151,7 +151,7 @@ function pathauto_token_values($type, $o
 }
 
 /**
- * Implementation of hook_token_list() for Pathauto specific tokens
+ * Implementation of hook_token_list() for Pathauto specific tokens.
  */
 function pathauto_token_list($type = 'all') {
   $tokens = array();
@@ -177,6 +177,8 @@ function pathauto_token_list($type = 'al
 
 /**
  * TODO: What does this do? One-line description.
+ *
+ * Optional TODO: What does this do? More in-depth description.
  */
 function pathauto_path_alias_types() {
   $objects = array('user/' => t('users'), 'node/' => t('content'));
@@ -369,7 +371,7 @@ function pathauto_taxonomy($op, $type, $
 // User related functions.
 
 /**
- * Implementation of hook_user() for users, trackers, and blogs
+ * Implementation of hook_user() for users, trackers, and blogs.
  */
 function pathauto_user($op, &$edit, &$user, $category = FALSE) {
   _pathauto_include();
Index: pathauto_taxonomy.inc
===================================================================
RCS file: /cvs/drupal-contrib/contributions/modules/pathauto/pathauto_taxonomy.inc,v
retrieving revision 1.36
diff -u -p -r1.36 pathauto_taxonomy.inc
--- pathauto_taxonomy.inc	24 May 2008 08:58:58 -0000	1.36
+++ pathauto_taxonomy.inc	24 May 2008 09:44:09 -0000
@@ -1,8 +1,15 @@
 <?php
 // $Id: pathauto_taxonomy.inc,v 1.36 2008/05/24 08:58:58 freso Exp $
 
-/*
- * Implementation of hook_pathauto() for taxonomy module
+/**
+ * @file
+ * Taxonomy hooked into Pathauto. (TODO: Better description!)
+ *
+ * @ingroup pathauto
+ */
+
+/**
+ * Implementation of hook_pathauto() for taxonomy module.
  */
 function taxonomy_pathauto($op) {
   switch ($op) {
@@ -44,7 +51,7 @@ function taxonomy_pathauto($op) {
 }
 
 /**
- * Generate aliases for all categories without aliases
+ * Generate aliases for all categories without aliases.
  */
 function taxonomy_pathauto_bulkupdate() {
   // From all node types, only attempt to update those with patterns
@@ -90,9 +97,10 @@ function taxonomy_pathauto_bulkupdate() 
 }
 
 /**
- * Function to create aliases for taxonomy objects
+ * Function to create aliases for taxonomy objects.
  *
- * @param object $category a taxonomy object
+ * @param object $category
+ *   A taxonomy object.
  */
 function _taxonomy_pathauto_alias($category, $op) {
   $count = 0;
@@ -117,8 +125,8 @@ function _taxonomy_pathauto_alias($categ
 }
 
 
-/*
- * Implementation of hook_pathauto() for forum module
+/**
+ * Implementation of hook_pathauto() for forum module.
  */
 function forum_pathauto($op) {
   switch ($op) {
@@ -148,7 +156,7 @@ function forum_pathauto($op) {
 
 
 /**
- * Generate aliases for all forums and forum containers without aliases
+ * Generate aliases for all forums and forum containers without aliases.
  */
 function forum_pathauto_bulkupdate() {
   $forum_vid = variable_get('forum_nav_vocabulary', '');