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
Jeremy Hylton
2c84fc8a7d
Note that assignments to __debug__ are illegal
2001-03-23 14:34:06 +00:00
Fred Drake
859eb62108
Do not refer to "sub-modules" since that is not a defined term.
2001-03-06 07:34:00 +00:00
Jeremy Hylton
10f8ba4fc6
Remove note about the compiler not checking for two kinds of illegal
...
imports. It checks for them now.
2001-01-30 01:25:15 +00:00
Fred Drake
d68442b164
Lots of minor fixes, many suggested by Detlef Lannert
...
<lannert@uni-duesseldorf.de>.
2000-09-21 22:01:36 +00:00
Fred Drake
31f5550fbe
Thomas Wouters <thomas@xs4all.net>:
...
Reference manual docs for augmented assignment.
This closes SourceForge patch #101418 .
2000-09-12 20:32:18 +00:00
Barry Warsaw
33f785fc1e
Document "print >> None"
2000-08-29 04:57:34 +00:00
Barry Warsaw
8c0a242289
PEP 214, Extended print Statement, has been accepted by the BDFL.
...
Document the extended print form. Fred, please double check the
markup!
2000-08-21 15:45:16 +00:00
Thomas Wouters
8bad612881
Disallow "import mod.submod as m", because the result is ambiguous. Does it
...
load mod.submod as m, or mod as m ? Both can be achieved differently, and
unambiguously. Also attempt to document this restriction (editor
appreciated!)
Note that this is an artificial check during compile, because incorporating
this in the grammar is hard, and then adjusting the compiler to do the right
thing with the right nodes is harder.
2000-08-19 20:55:02 +00:00
Thomas Wouters
5215225ea1
Apply SF patch #101135 , adding 'import module as m' and 'from module import
...
name as n'. By doing some twists and turns, "as" is not a reserved word.
There is a slight change in semantics for 'from module import name' (it will
now honour the 'global' keyword) but only in cases that are explicitly
undocumented.
2000-08-17 22:55:00 +00:00
Thomas Wouters
f9b526dbfd
More of Rob W. W. Hooft's spelling fixes. The only ones left now are the
...
distutils patches, which I'll leave to the distutils maintainers.
Tip: review the patch like this:
grep "^[\!+-] " <patchfile>
To get a quick and easy way to review the actual changes. Most of the
changes are single-line ones, anyway.
2000-07-16 19:05:38 +00:00
Fred Drake
191a28218f
Typo: "This table table" -> "This table is"
...
Noted by Nicholas Spies <ns11@voicenet.com>.
2000-07-06 00:50:42 +00:00
Greg Ward
38c28e379c
Added a note to the section on 'exec' about the need for a trailing newline
...
in certain circumstances. (Apparently, this is a CPython problem.)
2000-04-27 18:32:02 +00:00
Fred Drake
011f6fca31
Typo: "Otherwose" --> "Otherwise" (reported by Joakim Sernbrant
...
<joakim.sernbrant@front.se>).
Misc. small fixes to the logical markup.
1999-04-14 12:52:14 +00:00
Guido van Rossum
b1f97d6765
Suggestion by Tim Peters clarifying what "before global" means.
...
(Also added an XXX comment requesting clarification of module
initialization -- TBD later.)
1998-12-21 18:57:36 +00:00
Fred Drake
2b3730e284
Minor adjustments to a few index entries.
1998-11-25 17:40:00 +00:00
Fred Drake
d4c3352288
Fix encoding of \n in a couple of places (reported by Lorenzo
...
M. Catucci <lorenzo@argon.roma2.infn.it>).
1998-10-01 20:39:47 +00:00
Guido van Rossum
f5a80a4a88
Describe what happens when ``raise C, x'' is called where C is a class
...
and x is not an instance of C (nor of a class derived of C).
1998-08-25 14:45:41 +00:00
Fred Drake
1a0b872665
At least mark the URL to the Packages essay using \url.
1998-08-07 17:40:20 +00:00
Fred Drake
61c7728cc9
Make sure all chapters, sections, and subsections have a \label to give them
...
semantic file names in the HTML. No more node#.html files!
1998-07-28 19:34:22 +00:00
Fred Drake
246837d0f5
Fix markup of an \indexiii --> only two parameters were given.
1998-07-24 20:28:22 +00:00
Guido van Rossum
56c2013d15
Changes copied from the FrameMaker version. Also documented some
...
previously undocumented features.
Packages and the import mechanism in general are still left
undocumented.
1998-07-24 18:25:38 +00:00
Guido van Rossum
5f574aace9
Added back the description of the exec statement. It appears that I
...
accidentally cut it out when removing the access statement! Added a
paragraph on __builtins__ and other possible manipulations of the key
space of the dictionaries. Added some index entries.
1998-07-06 13:18:39 +00:00
Fred Drake
dde91f000a
Fix a bogus \code@...@ to be \code{...}.
...
Normalize some other markup.
1998-05-06 20:59:46 +00:00
Fred Drake
f666917ab7
The Python Reference Manual.
1998-05-06 19:52:49 +00:00