Index: includes/common.inc
===================================================================
RCS file: /cvs/drupal/drupal/includes/common.inc,v
retrieving revision 1.925
diff -u -r1.925 common.inc
--- includes/common.inc	18 Jun 2009 21:19:01 -0000	1.925
+++ includes/common.inc	20 Jun 2009 19:23:06 -0000
@@ -2123,6 +2123,9 @@
  *   The Drupal path being linked to, such as "admin/content/node". Can be an
  *   external or internal URL.
  *     - If you provide the full URL, it will be considered an external URL.
+ *       NOTE: If the URL contains an ampersand (e.g. http://example.com/test1&test2) 
+ *       you must encode it yourself because l can not distinguish between the ampersand
+ *       being part of the URL or if it separates GET parameters.
  *     - If you provide only the path (e.g. "admin/content/node"), it is
  *       considered an internal link. In this case, it must be a system URL
  *       as the url() function will generate the alias.
