Žiga Seilnacht
c64ad484a9
Patch #1489771 : update syntax rules in Python Reference Manual.
...
Python 2.5 added support for explicit relative import statements and
yield expressions, which were missing in the manual.
Also fix grammar productions that used the names from the Grammar file,
markup that broke the generated grammar.txt, and wrap some lines that
broke the pdf output. Will backport.
2007-03-24 14:24:26 +00:00
George Yoshida
6fffa5e865
- markup fix
...
- add clarifying words
2006-05-20 15:36:19 +00:00
Fred Drake
2de7a35e9a
one more place to avoid extra markup
2006-05-03 02:27:40 +00:00
Fred Drake
f25fa6ddb9
avoid ugly markup based on the unfortunate conversions of ">>" and "<<" to
...
guillemets; no need for magic here
2006-05-03 02:04:40 +00:00
Phillip J. Eby
1a9fac0937
Yield is now allowed in try-finally, so update docs accordingly
2006-03-25 00:46:43 +00:00
Fredrik Lundh
5a49fae1ab
SF patch #1421726
...
fixed typo in language reference
2006-02-02 21:58:55 +00:00
Neal Norwitz
c0d11250af
Make close brace a paren to match open.
2005-10-04 03:43:43 +00:00
Neal Norwitz
19f6b86955
Armin caught this mistake in bug #973103 .
2005-10-04 03:37:29 +00:00
Raymond Hettinger
bee0d467a1
Correct docs for empty raise when no exception is active.
2005-10-03 16:39:51 +00:00
Fred Drake
b6e1c11004
note that the return and yield statements cannot be used at the top level in
...
exec statements; people coming from certain other languages seem to be
confused by this on a regular basis
2005-09-07 05:17:07 +00:00
Raymond Hettinger
b56b494bea
SF bug #1190451 : 6.9 First sentence is confusing
...
* Fixed incorrect wording: expression->exception
* Noted the specific exception reported by "raise" when the is nothing
to re-raise.
* Eliminated several instances of "e.g." as recommended in the style guide.
2005-04-28 07:18:47 +00:00
Raymond Hettinger
68804315e0
SF Patch #1093896 : miscellaneous doc typos
2005-01-01 00:28:46 +00:00
Johannes Gijsbers
f4a70f35b0
Patch #1080684 : typo repair. Thanks George Yoshida!
...
- Doc/lib/libbase64.tex
s/algorith/algorithm
- Doc/lib/libpickle.tex
s/interchangable/interchangeable
- Doc/lib/libxmlrpclib.tex
s/{_cmp__}/{__cmp__}
leading underscore needs to be double, not single.
- Doc/ref/ref6.tex
0/1 => False/True
2004-12-12 16:52:40 +00:00
Fred Drake
2269d86598
Fix SF bug #1061770 : Manual typesets bit-shift operators as guillemet
2004-11-11 06:14:05 +00:00
Anthony Baxter
1a4ddaecc7
SF patch #1007189 , multi-line imports, for instance:
...
"from blah import (foo, bar
baz, bongo)"
2004-08-31 10:07:13 +00:00
Raymond Hettinger
70fcdb8be0
Document general mappings for the locals argument for exec and execfile().
2004-08-03 05:17:58 +00:00
Fred Drake
7a700b873b
clean up indexing for None, NotImplemented
...
closes SF bug #820344
2004-01-01 05:43:53 +00:00
Walter Dörwald
f0dfc7ac5c
Fix a bunch of typos in documentation, docstrings and comments.
...
(From SF patch #810751 )
2003-10-20 14:01:56 +00:00
Fred Drake
d51ce7de97
Indexing is a mess; try to get the link targets closer to the relevant
...
text. There needs to be a better way.
2003-07-15 22:03:00 +00:00
Fred Drake
b3be52eaf4
Try to clean up some indexing relevant to the import statement.
...
Pertains to SF bug #518989 .
2003-07-15 21:37:58 +00:00
Raymond Hettinger
96a8233b64
SF patch #751038 fixing SF bug#750092: exec doesn't need newline
...
Patch contributed by Steven Taschuk.
2003-06-18 01:32:24 +00:00
Neal Norwitz
847207acff
SF bug #719367 , string exceptions are deprecated
...
Remove references to string based exceptions in the doc.
2003-05-29 02:17:23 +00:00
Jeremy Hylton
8bea5dc879
Move future statement here from appendix a.
2003-05-21 21:43:00 +00:00
Fred Drake
007fadd59d
Fix symbol in grammar; this should fix some hyperlinking in the HTML
...
version.
2003-03-31 14:53:03 +00:00
Fred Drake
8bd62afca9
Fix typo reported to python-docs.
2003-01-25 03:47:35 +00:00
Raymond Hettinger
e701dcbabd
SF patch #634866 : Alex Martelli's corrections to the ref manual.
...
Backport candidate. All but one or two of these changes
are applicable to 2.2.2.
2003-01-19 13:08:18 +00:00
Martin v. Löwis
13dd9d9978
Patch #662454 : import a.b as c is ok, fixes #660811 .
2003-01-16 11:30:08 +00:00
Raymond Hettinger
1772f17666
SF bug #661848 and #631055 : Clarify use of __all__.
2003-01-06 12:54:54 +00:00
Fred Drake
27cae1f7c5
Revise the __all__ index entry a touch.
2002-12-07 16:00:00 +00:00
Raymond Hettinger
f9229d98ae
Add __all__ to Reference Manual index.
...
Closes SF 643227.
2002-12-07 09:39:15 +00:00
Fred Drake
e7097e0b1c
Added cross-references to related material on exceptions.
...
Closes SF bug #217195 .
2002-10-18 15:18:18 +00:00
Raymond Hettinger
04e7e0c60f
Close bug 417930 by clarifying augmented assignment docs
2002-06-25 13:36:41 +00:00
Fred Drake
81932e234b
Try to improve the explanation of the "raise" statement and how its arguments
...
are interpreted.
This closes SF bug #532467 .
2002-06-20 20:55:29 +00:00
Michael W. Hudson
495afea36e
Typo.
2002-06-17 12:51:57 +00:00
Jeremy Hylton
f3255c8540
Reword explanation of global statement since an undeclared global is a
...
free variable and is subject to those rules.
2002-04-01 21:25:32 +00:00
Jeremy Hylton
f0c1f1badb
Note the sole case in which the ban on "from ... import *" within a
...
function is enforced.
2002-04-01 21:19:44 +00:00
Jeremy Hylton
15b68976da
Remove the following restriction:
...
Names bound by import statements may not occur in global
statements in the same scope.
Why not?
2002-04-01 21:18:02 +00:00
Jeremy Hylton
d09ed68aeb
Note that it is illegal to delete a cell variable.
...
Note that deleteing an unbound local will raise a NameError.
2002-04-01 21:15:14 +00:00
Fred Drake
5381588073
Revise the markup related to the grammar productions to increase the
...
level of predictability. This is not really "good" markup, but is arguably
better than we had before.
This closes SF bug #523117 .
2002-03-15 23:21:37 +00:00
Fred Drake
08d752cf28
Update to use the notice environment so a multi-paragraph note can be
...
appropriately marked.
2001-12-14 22:55:14 +00:00
Fred Drake
8d0645cb84
Add a note about yield requiring a __future__ directive.
2001-12-12 06:06:43 +00:00
Fred Drake
3a8e59ebe1
Clean up a sad sentence in the yield description.
2001-12-11 21:58:35 +00:00
Fred Drake
e31e9cebc0
Document generators and the yield statement, avoiding implementation details.
2001-12-11 21:10:08 +00:00
Fred Drake
c2f496a138
Add a note to the description of the interaction between the softspace
...
attribute of file objects, the print statement, and other file operations.
This closes SF bug #484857 .
Fix minor markup nits.
2001-12-05 05:46:25 +00:00
Fred Drake
08fd51509c
When describing "import *", add a level of indirection between "*" and the
...
set of names imported (the "public names"), adding a definition of "public
names" that describes the use of __all__.
This closes SF bug #473986 .
Flesh out the vague reference to __import__().
2001-10-24 19:50:31 +00:00
Fred Drake
cb4638a278
Change the grammar productions to use the new productionlist environment;
...
this supports a hyperlinked version of the grammar that can make tracking
down details and definitions a little easier.
2001-07-06 22:49:53 +00:00
Fred Drake
be9d10edbb
Remove some bogus trailing whitespace.
2001-06-23 06:16:52 +00:00
Fred Drake
93852ef3c8
Fix minor markup nits.
2001-06-23 06:06:52 +00:00
Fred Drake
2829f1cf99
Fix a very minor (but annoying when looking for things!) markup nit.
2001-06-23 05:27:20 +00:00
Fred Drake
62effc1127
Work around the conversion of ">>" and "<<" to guillemets. Reported by Ping.
2001-04-13 15:55:25 +00:00