33****************************
44
55:Author: A.M. Kuchling, Guido van Rossum
6-
7- .. |release | replace :: 0.0
8-
9- .. % $Id: whatsnew26.tex 55506 2007-05-22 07:43:29Z neal.norwitz $
10- .. % Rules for maintenance:
11- .. %
12- .. % * Anyone can add text to this document. Do not spend very much time
13- .. % on the wording of your changes, because your text will probably
14- .. % get rewritten to some degree.
15- .. %
16- .. % * The maintainer will go through Misc/NEWS periodically and add
17- .. % changes; it's therefore more important to add your changes to
18- .. % Misc/NEWS than to this file.
19- .. %
20- .. % * This is not a complete list of every single change; completeness
21- .. % is the purpose of Misc/NEWS. Some changes I consider too small
22- .. % or esoteric to include. If such a change is added to the text,
23- .. % I'll just remove it. (This is another reason you shouldn't spend
24- .. % too much time on writing your addition.)
25- .. %
26- .. % * If you want to draw your new text to the attention of the
27- .. % maintainer, add 'XXX' to the beginning of the paragraph or
28- .. % section.
29- .. %
30- .. % * It's OK to just add a fragmentary note about a change. For
31- .. % example: "XXX Describe the transmogrify() function added to the
32- .. % socket module." The maintainer will research the change and
33- .. % write the necessary text.
34- .. %
35- .. % * You can comment out your additions if you like, but it's not
36- .. % necessary (especially when a final release is some months away).
37- .. %
38- .. % * Credit the author of a patch or bugfix. Just the name is
39- .. % sufficient; the e-mail address isn't necessary.
40- .. %
41- .. % * It's helpful to add the bug/patch number as a comment:
42- .. %
43- .. % % Patch 12345
44- .. % XXX Describe the transmogrify() function added to the socket
45- .. % module.
46- .. % (Contributed by P.Y. Developer.)
47- .. %
48- .. % This saves the maintainer the effort of going through the SVN log
49- .. % when researching a change.
6+ :Release: 0.1
7+
8+ .. Rules for maintenance:
9+
10+ * Anyone can add text to this document. Do not spend very much time
11+ on the wording of your changes, because your text will probably
12+ get rewritten to some degree.
13+
14+ * The maintainer will go through Misc/NEWS periodically and add
15+ changes; it's therefore more important to add your changes to
16+ Misc/NEWS than to this file.
17+
18+ * This is not a complete list of every single change; completeness
19+ is the purpose of Misc/NEWS. Some changes I consider too small
20+ or esoteric to include. If such a change is added to the text,
21+ I'll just remove it. (This is another reason you shouldn't spend
22+ too much time on writing your addition.)
23+
24+ * If you want to draw your new text to the attention of the
25+ maintainer, add 'XXX' to the beginning of the paragraph or
26+ section.
27+
28+ * It's OK to just add a fragmentary note about a change. For
29+ example: "XXX Describe the transmogrify() function added to the
30+ socket module." The maintainer will research the change and
31+ write the necessary text.
32+
33+ * You can comment out your additions if you like, but it's not
34+ necessary (especially when a final release is some months away).
35+
36+ * Credit the author of a patch or bugfix. Just the name is
37+ sufficient; the e-mail address isn't necessary.
38+
39+ * It's helpful to add the bug/patch number as a comment:
40+
41+ % Patch 12345
42+ XXX Describe the transmogrify() function added to the socket
43+ module.
44+ (Contributed by P.Y. Developer.)
45+
46+ This saves the maintainer the effort of going through the SVN log
47+ when researching a change.
5048
5149 This article explains the new features in Python 3.0, comparing to 2.6
5250(or in some cases 2.5, since 2.6 isn't released yet).
@@ -59,15 +57,15 @@ full details, you should refer to the documentation for Python 3.0. If
5957you want to understand the complete implementation and design
6058rationale, refer to the PEP for a particular new feature.
6159
62- .. % Compare with previous release in 2 - 3 sentences here.
63- .. % add hyperlink when the documentation becomes available online.
60+ .. Compare with previous release in 2 - 3 sentences here.
61+ .. add hyperlink when the documentation becomes available online.
6462
65- .. % ======================================================================
66- .. % Large, PEP-level features and changes should be described here.
67- .. % Should there be a new section here for 3k migration?
68- .. % Or perhaps a more general section describing module changes/deprecation?
69- .. % sets module deprecated
70- .. % ======================================================================
63+ .. ======================================================================
64+ .. Large, PEP-level features and changes should be described here.
65+ .. Should there be a new section here for 3k migration?
66+ .. Or perhaps a more general section describing module changes/deprecation?
67+ .. sets module deprecated
68+ .. ======================================================================
7169
7270
7371 Common Stumbling Blocks
@@ -128,7 +126,7 @@ changes to rarely used features.)
128126Strings and Bytes
129127=================
130128
131- * There is only on string type; its name is ``str `` but its behavior
129+ * There is only one string type; its name is ``str `` but its behavior
132130 and implementation are more like ``unicode `` in 2.x.
133131
134132* PEP 358: There is a new type, ``bytes ``, to represent binary data
@@ -177,12 +175,12 @@ Exception Stuff
177175===============
178176
179177* PEP 352: Exceptions must derive from BaseException. This is the
180- root of the exception hierarchy; only Exception,
178+ root of the exception hierarchy.
181179
182180* StandardException was removed (already in 2.6).
183181
184- * Dropping sequence behavior and ``.message `` attribute of exception
185- instances.
182+ * Dropping sequence behavior (slicing!) and ``.message `` attribute of
183+ exception instances.
186184
187185* PEP 3109: Raising exceptions. You must now use ``raise
188186 Exception(args) `` instead of ``raise Exception, args ``.
@@ -232,13 +230,13 @@ language and built-in functions.
232230
233231* ``__getslice__() `` and friends killed. The syntax ``a[i:j] `` now
234232 translates to ``a.__getitem__(slice(i, j)) `` (or ``__setitem__ ``
235- or ``__delitem ``, depending on context).
233+ or ``__delitem__ ``, depending on context).
236234
237235* PEP 3102: Keyword-only arguments. Named parameters occurring after
238236 ``*args `` in the parameter list *must * be specified using keyword
239- syntax in the call. You can also use ``* `` in the parameter list to
240- indicate that you don't accept a variable-length argument list, but
241- you do have keyword-only arguments.
237+ syntax in the call. You can also use a bare ``* `` in the parameter
238+ list to indicate that you don't accept a variable-length argument
239+ list, but you do have keyword-only arguments.
242240
243241* PEP 3104: ``nonlocal `` statement. Using ``nonlocal x `` you can now
244242 assign directly to a variable in an outer (but non-global) scope.
@@ -259,16 +257,17 @@ language and built-in functions.
259257 ``def foo(a, (b, c)): ... ``. Use ``def foo(a, b_c): b, c = b_c ``
260258 instead.
261259
262- * PEP 3114: ``.next() `` renamed to ``.__next__() ``.
260+ * PEP 3114: ``.next() `` renamed to ``.__next__() ``, new builtin
261+ ``next() `` to call the ``__next__() `` method on an object.
263262
264263* PEP 3127: New octal literals; binary literals and ``bin() ``.
265264 Instead of ``0666 ``, you write ``0o666 ``. The oct() function is
266265 modified accordingly. Also, ``0b1010 `` equals 10, and ``bin(10) ``
267- returns ``"0b1010" ``.
266+ returns ``"0b1010" ``. `` 0666 `` is now a `` SyntaxError ``.
268267
269268* PEP 3132: Extended Iterable Unpacking. You can now write things
270269 like ``a, b, *rest = some_sequence ``. And even ``*rest, a =
271- stuff ``. The ``rest `` variable is always a list; the right-hand
270+ stuff ``. The ``rest `` object is always a list; the right-hand
272271 side may be any iterable.
273272
274273* PEP 3135: New ``super() ``. You can now invoke ``super() `` without
@@ -281,15 +280,15 @@ language and built-in functions.
281280 ``.uppercase ``) are gone. Use ``string.ascii_letters ``
282281 etc. instead.
283282
284- * Removed: apply(), callable(), coerce(), execfile(), file() ,
285- reduce(), reload().
283+ * Removed: `` apply() ``, `` callable() ``, `` coerce() ``, `` execfile() `` ,
284+ `` file() ``, `` reduce() ``, `` reload() `` .
286285
287286* Removed: ``dict.has_key() ``.
288287
289288* ``exec `` is now a function.
290289
291290
292- .. % ======================================================================
291+ .. ======================================================================
293292
294293
295294 Optimizations
@@ -301,7 +300,7 @@ The net result of the 3.0 generalizations is that Python 3.0 runs the
301300pystone benchmark around 25% slower than Python 2.5. There's room for
302301improvement!
303302
304- .. % ======================================================================
303+ .. ======================================================================
305304
306305
307306 New, Improved, and Deprecated Modules
@@ -316,10 +315,10 @@ through the CVS logs for all the details.
316315* The ``cPickle `` module is gone. Use ``pickle `` instead. Eventually
317316 we'll have a transparent accelerator module.
318317
319- .. % ======================================================================
320- .. % whole new modules get described in \ subsections here
318+ .. ======================================================================
319+ .. whole new modules get described in subsections here
321320
322- .. % ======================================================================
321+ .. ======================================================================
323322
324323
325324 Build and C API Changes
@@ -331,17 +330,17 @@ Changes to Python's build process and to the C API include:
331330
332331* PEP 3121: Extension Module Initialization & Finalization.
333332
334- * PEP 3123: Making PyObject_HEAD conform to standard C.
333+ * PEP 3123: Making `` PyObject_HEAD `` conform to standard C.
335334
336- .. % ======================================================================
335+ .. ======================================================================
337336
338337
339338 Port-Specific Changes
340339---------------------
341340
342341Platform-specific changes go here.
343342
344- .. % ======================================================================
343+ .. ======================================================================
345344
346345
347346 .. _section-other :
@@ -358,7 +357,7 @@ Some of the more notable changes are:
358357
359358* Details go here.
360359
361- .. % ======================================================================
360+ .. ======================================================================
362361
363362
364363 Porting to Python 3.0
@@ -369,7 +368,7 @@ changes to your code:
369368
370369* Everything is all in the details!
371370
372- .. % ======================================================================
371+ .. ======================================================================
373372
374373
375374 .. _acks :
@@ -379,5 +378,5 @@ Acknowledgements
379378
380379The author would like to thank the following people for offering
381380suggestions, corrections and assistance with various drafts of this
382- article: .
381+ article: Georg Brandl .
383382
0 commit comments