[Python-3000-checkins] r67522 - python/branches/py3k/Doc/whatsnew/3.0.rst

[andrew.kuchling]

Author: andrew.kuchling
Date: Thu Dec 4 16:07:14 2008
New Revision: 67522

Log:
Wording change (flaunt -> disobey); markup fixes. The largest edit is to the paragraph on relative imports; please review. (Backport candidate)

Modified:
python/branches/py3k/Doc/whatsnew/3.0.rst

Modified: python/branches/py3k/Doc/whatsnew/3.0.rst
==============================================================================
--- python/branches/py3k/Doc/whatsnew/3.0.rst (original)
+++ python/branches/py3k/Doc/whatsnew/3.0.rst Thu Dec 4 16:07:14 2008
@@ -456,10 +456,11 @@
* The :keyword:`from` *module* :keyword:`import` ``*`` syntax is only
allowed at the module level, no longer inside functions.

-* The only acceptable syntax for relative imports is :keyword:`from`
- ``.``[*module*] :keyword:`import` *name*; :keyword:`import` forms
- not starting with ``.`` are always interpreted as absolute imports.
- (:pep:`0328`)
+* The only acceptable syntaxes for relative imports are :keyword:`from`
+ ``.`` :keyword:`import` *name* or
+ :keyword:`from` ``.module`` :keyword:`import` *name*.
+ :keyword:`import` forms not starting with ``.`` are always
+ interpreted as absolute imports. (:pep:`0328`)

* Classic classes are gone.

@@ -559,8 +560,8 @@
release schedule. However, the package is alive and well,
externally maintained at http://www.jcea.es/programacion/pybsddb.htm.

-* Some modules were renamed because their old name flaunted
- :pep:`0008`, or for various other reasons:
+* Some modules were renamed because their old name disobeyed
+ :pep:`0008`, or for various other reasons. Here's the list:

======================= =======================
Old Name New Name
@@ -607,7 +608,7 @@
really care about :mod:`tkinter`. Also note that as of Python
2.6, the functionality of :mod:`turtle` has been greatly enhanced.

- * :mod:`urllib` (:mod:`urllib`, :mod:`urllib`2, :mod:`urlparse`,
+ * :mod:`urllib` (:mod:`urllib`, :mod:`urllib2`, :mod:`urlparse`,
:mod:`robotparse`).

* :mod:`xmlrpc` (:mod:`xmlrpclib`, :mod:`DocXMLRPCServer`,
@@ -649,7 +650,7 @@
* :data:`string.letters` and its friends (:data:`string.lowercase` and
:data:`string.uppercase`) are gone. Use
:data:`string.ascii_letters` etc. instead. (The reason for the
- removal is that :data:string.letters` and friends had
+ removal is that :data:`string.letters` and friends had
locale-specific behavior, which is a bad idea for such
attractively-named global "constants".)

@@ -702,8 +703,8 @@
:attr:`__traceback__` attribute (see below).

* :pep:`3110`: Catching exceptions. You must now use
- *:keyword:`except` SomeException* :keyword:`as` *variable* instead
- *of :keyword:`except` *SomeException*, variable*. Moreover, the
+ :keyword:`except` *SomeException* :keyword:`as` *variable* instead
+ of :keyword:`except` *SomeException*, variable*. Moreover, the
*variable* is explicitly deleted when the :keyword:`except` block
is left.

[Guido van Rossum]

Reviewed. I've chosen to fix the markup problem for relative/absolute
imports differently, see r67548.

On Thu, Dec 4, 2008 at 7:07 AM, andrew. kuchling

Post by andrew.kuchling
Author: andrew.kuchling
Date: Thu Dec 4 16:07:14 2008
New Revision: 67522
Wording change (flaunt -> disobey); markup fixes. The largest edit is to the paragraph on relative imports; please review. (Backport candidate)
python/branches/py3k/Doc/whatsnew/3.0.rst
Modified: python/branches/py3k/Doc/whatsnew/3.0.rst
==============================================================================
--- python/branches/py3k/Doc/whatsnew/3.0.rst (original)
+++ python/branches/py3k/Doc/whatsnew/3.0.rst Thu Dec 4 16:07:14 2008
@@ -456,10 +456,11 @@
* The :keyword:`from` *module* :keyword:`import` ``*`` syntax is only
allowed at the module level, no longer inside functions.
-* The only acceptable syntax for relative imports is :keyword:`from`
- ``.``[*module*] :keyword:`import` *name*; :keyword:`import` forms
- not starting with ``.`` are always interpreted as absolute imports.
- (:pep:`0328`)
+* The only acceptable syntaxes for relative imports are :keyword:`from`
+ ``.`` :keyword:`import` *name* or
+ :keyword:`from` ``.module`` :keyword:`import` *name*.
+ :keyword:`import` forms not starting with ``.`` are always
+ interpreted as absolute imports. (:pep:`0328`)
* Classic classes are gone.
@@ -559,8 +560,8 @@
release schedule. However, the package is alive and well,
externally maintained at http://www.jcea.es/programacion/pybsddb.htm.
-* Some modules were renamed because their old name flaunted
+* Some modules were renamed because their old name disobeyed
======================= =======================
Old Name New Name
@@ -607,7 +608,7 @@
really care about :mod:`tkinter`. Also note that as of Python
2.6, the functionality of :mod:`turtle` has been greatly enhanced.
- * :mod:`urllib` (:mod:`urllib`, :mod:`urllib`2, :mod:`urlparse`,
+ * :mod:`urllib` (:mod:`urllib`, :mod:`urllib2`, :mod:`urlparse`,
:mod:`robotparse`).
* :mod:`xmlrpc` (:mod:`xmlrpclib`, :mod:`DocXMLRPCServer`,
@@ -649,7 +650,7 @@
* :data:`string.letters` and its friends (:data:`string.lowercase` and
:data:`string.uppercase`) are gone. Use
:data:`string.ascii_letters` etc. instead. (The reason for the
- removal is that :data:string.letters` and friends had
+ removal is that :data:`string.letters` and friends had
locale-specific behavior, which is a bad idea for such
attractively-named global "constants".)
@@ -702,8 +703,8 @@
:attr:`__traceback__` attribute (see below).
* :pep:`3110`: Catching exceptions. You must now use
- *:keyword:`except` SomeException* :keyword:`as` *variable* instead
- *of :keyword:`except` *SomeException*, variable*. Moreover, the
+ :keyword:`except` *SomeException* :keyword:`as` *variable* instead
+ of :keyword:`except` *SomeException*, variable*. Moreover, the
*variable* is explicitly deleted when the :keyword:`except` block
is left.
_______________________________________________
Python-3000-checkins mailing list
Python-3000-checkins at python.org
http://mail.python.org/mailman/listinfo/python-3000-checkins