Index: modules/path/path.module
===================================================================
RCS file: /cvs/drupal/drupal/modules/path/path.module,v
retrieving revision 1.149
diff -u -p -r1.149 path.module
--- modules/path/path.module	12 Oct 2008 04:30:06 -0000	1.149
+++ modules/path/path.module	31 Oct 2008 12:58:46 -0000
@@ -76,7 +76,9 @@ function path_admin_delete($pid = 0) {
 }
 
 /**
- * Set an aliased path for a given Drupal path, preventing duplicates.
+ * Set an aliased path for a given Drupal path, preventing duplicate aliases.
+ * It is possible for the source path to have more than one alias path.
+ * However, for SEO reasons you should maintain only one path.
  */
 function path_set_alias($path = NULL, $alias = NULL, $pid = NULL, $language = '') {
   $path = urldecode($path);
