Index: modules/path/path.api.php
===================================================================
RCS file: /cvs/drupal/drupal/modules/path/path.api.php,v
retrieving revision 1.1
diff -u -p -r1.1 path.api.php
--- modules/path/path.api.php	17 Oct 2009 00:52:36 -0000	1.1
+++ modules/path/path.api.php	3 Oct 2010 03:10:29 -0000
@@ -13,28 +13,34 @@
 
 
 /**
- * The path has been inserted.
+ * Allow modules to respond to a path being inserted.
  *
  * @param $path
- *   The path array.
+ *   The path that has been inserted.
+ *
+ * @see path_save()
  */
 function hook_path_insert($path) {
 }
 
 /**
- * The path has been updated.
+* Allow modules to respond to a path being updated.
  *
  * @param $path
- *   The path array.
+ *   The path thaat has been updated.
+ *
+ * @see path_save()
  */
 function hook_path_update($path) {
 }
 
 /**
- * The path has been deleted.
+* Allow modules to respond to a path being deleted.
  *
  * @param $path
- *   The path array.
+ *   The path that has been deleted.
+ *
+ * @see path_delete()
  */
 function hook_path_delete($path) {
 }