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

[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
<python-3000-checkins at python.org> wrote:
> 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.
>
> _______________________________________________
> Python-3000-checkins mailing list
> Python-3000-checkins at python.org
> http://mail.python.org/mailman/listinfo/python-3000-checkins
>



-- 
--Guido van Rossum (home page: http://www.python.org/~guido/)