Index: Lib/urlparse.py
===================================================================
--- Lib/urlparse.py	(revision 79985)
+++ Lib/urlparse.py	(working copy)
@@ -1,7 +1,27 @@
 """Parse (absolute and relative) URLs.
 
-See RFC 1808: "Relative Uniform Resource Locators", by R. Fielding,
-UC Irvine, June 1995.
+urlparse module is based upon the following RFC specifications.
+
+RFC 3986 (STD66): "Uniform Resource Identifiers" by T. Berners-Lee, R. Fielding
+and L.  Masinter, January 2005
+
+RFC2396:  Uniform Resource Identifiers (URI): Generic Syntax by T. Berners-Lee,
+R. Fielding, and L. Masinter, August 1998.
+
+RFC2368: The mailto URL scheme, by P.Hoffman , L Masinter, J. Zwinski, July 1998.
+
+RFC 1808: "Relative Uniform Resource Locators", by R. Fielding, UC Irvine, June
+1995.
+
+RFC1738: "Uniform Resource Locators (URL)" by T. Berners-Lee, L. Masinter, M.
+McCahill, December 1994
+
+RFC 3986 is considered the current standard and any changes to urlparse module
+should conform to this.  urlparse module is not entirely compliant with this.
+The defacto scenarios of parsing are considered sometimes and for backward
+compatiblity purposes, older RFC uses of parsing are retained. The testcases in
+test_urlparse.py provides a good indicator of parsing behavior.
+
 """
 
 __all__ = ["urlparse", "urlunparse", "urljoin", "urldefrag",