Document the fact that urllib2 spans multiple modules with new names in Python

3.0.

diff --git a/Doc/library/urllib2.rst b/Doc/library/urllib2.rst
index ff664f5d4cec2c42c46fd379b151f0f719e442de..6cab787dd9dd02c49a2fcb497ba86c61fd85b86b 100644 (file)
--- a/Doc/library/urllib2.rst
+++ b/Doc/library/urllib2.rst
@@ -7,6 +7,13 @@
 .. sectionauthor:: Moshe Zadka <moshez@users.sourceforge.net>
 
 
+.. note::
+   The :mod:`urllib2` module has been split across several modules in
+   Python 3.0 named :mod:`urllib.request` and :mod:`urllib.error`.
+   The :term:`2to3` tool will automatically adapt imports when converting
+   your sources to 3.0.
+
+
 The :mod:`urllib2` module defines functions and classes which help in opening
 URLs (mostly HTTP) in a complex world --- basic and digest authentication,
 redirections, cookies and more.

diff --git a/Misc/NEWS b/Misc/NEWS
index 638051f8f0afb8c1d0354000942eaf70501bdea4..8d83e6b76be62b550bc506d8ee504d2972a2889e 100644 (file)
--- a/Misc/NEWS
+++ b/Misc/NEWS
@@ -87,6 +87,16 @@ Build
 - Issue #3215: Build sqlite3 as sqlite3.dll, not sqlite3.pyd.
 
 
+Documentation
+-------------
+
+- Document that urllib2 is split across multiple modules and renamed in
+  Python 3.0.
+
+- Document that urllib is split across multiple modules and renamed in
+  Python 3.0.
+
+
 What's New in Python 2.6 beta 1?
 ================================