Commit Graph

487 Commits

Author SHA1 Message Date
Raymond Hettinger bee0d467a1 Correct docs for empty raise when no exception is active. 2005-10-03 16:39:51 +00:00
Georg Brandl d430726b82 Better wording for integer ref entry. 2005-09-12 12:49:38 +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
Fred Drake b3dfc0ae5e - fix typo report by email, only 1.5 years late
- fix several consistency nits relating to \method{...()}
2005-09-07 04:57:56 +00:00
Georg Brandl 7da4edac28 Clarify what is meant with "whole numbers". 2005-09-04 18:30:19 +00:00
Georg Brandl 15ad935568 __new__ is a static method 2005-08-26 12:56:22 +00:00
Georg Brandl 8fc18a2010 bug [ 1261229 ] __new__ is class method 2005-08-25 21:56:45 +00:00
Georg Brandl 6cd5377c72 Empty sets and frozensets are also false. 2005-08-21 12:22:58 +00:00
Raymond Hettinger a30616a88d SF bug #1249837: container methods raise KeyError not IndexError
Minor clarification.
2005-08-21 11:26:14 +00:00
Georg Brandl b285974c00 Mention explicitly the False is considered false. 2005-08-21 09:41:21 +00:00
Fred Drake 21c825417f add information about alternate implementations, noting that documentation
for the implementation should be consulted
(thanks to Evelyn Mitchell for suggesting this)
2005-07-20 04:33:01 +00:00
Georg Brandl 1c330eb9eb Patch [ 1230615 ] Patch for (Doc) #1168746
Bug [ 1204734 ] incorrect description of __getattribute__
2005-07-02 10:27:31 +00:00
Neil Schemenauer c49322951f Fix grammar (it's -> its). 2005-06-18 17:54:13 +00:00
Andrew M. Kuchling 6a15c5d038 [Bug #1193001] Make the notation section use the same productionlist env. as other grammar rules 2005-06-02 13:50:19 +00:00
Michael W. Hudson 2f475a7bc8 Fix:
[ 1207501 ] Issue in grammar

We didn't define dotted_name in the pseudo-grammar in the reference
docs.  Backport candidate.
2005-05-26 07:58:22 +00:00
Fred Drake db22958f07 update documentation on what constitutes a line in a source file
(closes SF bug #1167922)
2005-05-25 05:29:17 +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 f21569e53d Fix typo. 2005-04-26 05:18:53 +00:00
Brett Cannon 629496b77c Add grammar change for allowing ``class B(): pass`` syntax. 2005-04-09 03:03:00 +00:00
Greg Ward ff564d3391 SF #1156412: document the __new__() static method
(merge from release24-maint branch).
2005-03-08 01:10:20 +00:00
Michael W. Hudson a2a9888f22 Updates to the exceptions documentation (this is my patch #1156102). 2005-03-04 14:33:32 +00:00
Fred Drake b184ae860e fix a bunch of spelling errors
(closes SF patch #1104868)
2005-01-19 03:39:17 +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
Fred Drake 5b00059110 minor markup nits; fix missing whitespace 2004-11-10 16:51:17 +00:00
Fred Drake 7fabaf8375 clarify discussion of iteration in the section on the "for" statement
(SF bug #829073)
2004-11-02 19:18:20 +00:00
Fred Drake 9a40851569 clarify trailing comma in function argument list
(SF bug #798652)
2004-11-02 18:57:33 +00:00
Johannes Gijsbers 7126976ee8 Patch #1042969: add closing brace for \token {generator_expression}. Thanks
George Yoshida!
2004-10-09 15:52:04 +00:00
Martin v. Löwis 266a436fe2 Remove claims that Python source code is ASCII. Fixes #1026038. 2004-09-14 07:52:22 +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
Martin v. Löwis ae075b6cb7 Patch #1011144: Correct regex for coding decls. 2004-08-18 13:25:05 +00:00
Michael W. Hudson 0ccff074cd This is Mark Russell's patch:
[ 1009560 ] Fix @decorator evaluation order

From the description:

Changes in this patch:

- Change Grammar/Grammar to require
newlines between adjacent decorators.

- Fix order of evaluation of decorators
in the C (compile.c) and python
(Lib/compiler/pycodegen.py) compilers

- Add better order of evaluation check
to test_decorators.py (test_eval_order)

- Update the decorator documentation in
the reference manual (improve description
of evaluation order and update syntax
description)

and the comment:

Used Brett's evaluation order (see
http://mail.python.org/pipermail/python-dev/2004-August/047835.html)

(I'm checking this in for Anthony who was having problems getting SF to
talk to him)
2004-08-17 17:29:16 +00:00
Raymond Hettinger 5c8d29cb13 SF patch #872326: generator expression implementation
(Contributed by Jiwon Seo.)

Add genexps to the reference manual.
2004-08-15 23:28:10 +00:00
Michael W. Hudson 5e897959db This is my patch
[ 1004703 ] Make func_name writable

plus fixing a couple of nits in the documentation changes spotted by MvL
and a Misc/NEWS entry.
2004-08-12 18:12:44 +00:00
Andrew M. Kuchling cbd81556bb [Bug #827209] Add footnote from Alex M. about listcomps leaking their index variables 2004-08-07 19:16:32 +00:00
Fred Drake 6bd8e842e4 update to reflect the new significance of the "@" character 2004-08-05 21:11:27 +00:00
Raymond Hettinger 70fcdb8be0 Document general mappings for the locals argument for exec and execfile(). 2004-08-03 05:17:58 +00:00
Anthony Baxter c2a5a63654 PEP-0318, @decorator-style. In Guido's words:
"@ seems the syntax that everybody can hate equally"
Implementation by Mark Russell, from SF #979728.
2004-08-02 06:10:11 +00:00
Tim Peters 3d7d372ce3 Whitespace normalization, via reindent.py. 2004-07-18 06:25:50 +00:00
Brett Cannon a031a0870d Add a missing space. 2004-06-29 04:14:02 +00:00
Martin v. Löwis 9c322fbe36 The expression list in inheritance is not optional. Fixes #960448.
Will backport to 2.3.
2004-06-02 12:59:59 +00:00
Martin v. Löwis 477c85631a Move grammar rule for lambda_form into section on lambdas. Fixes #964525. 2004-06-02 12:54:33 +00:00
Martin v. Löwis 13ff116ac7 Fix typo reported in #964592. Will backport to 2.3. 2004-06-02 12:48:20 +00:00
Fred Drake 67a521ef69 note that descriptor objects must be instances of new-style types
(closes SF bug #817742)
2004-05-06 12:44:29 +00:00
Raymond Hettinger 46a16f297f SF bug #940579: section 5.10: 'not' returns boolean, not int 2004-04-23 17:11:47 +00:00
Raymond Hettinger 3fd977964a Fix misspelled name. 2004-02-08 20:18:26 +00:00
Fred Drake 7a700b873b clean up indexing for None, NotImplemented
closes SF bug #820344
2004-01-01 05:43:53 +00:00
Fred Drake 1f84ed0d8a fix typo and join two paragraphs 2003-12-11 19:45:53 +00:00
Guido van Rossum 6c9e130524 - Removed FutureWarnings related to hex/oct literals and conversions
and left shifts.  (Thanks to Kalle Svensson for SF patch 849227.)
  This addresses most of the remaining semantic changes promised by
  PEP 237, except for repr() of a long, which still shows the trailing
  'L'.  The PEP appears to promise warnings for operations that
  changed semantics compared to Python 2.3, but this is not
  implemented; we've suffered through enough warnings related to
  hex/oct literals and I think it's best to be silent now.
2003-11-29 23:52:13 +00:00
Alex Martelli c516b0e47c clarified (in the 5.14 summary) that tests and comparisons all chain,
added a specific \ref to 5.9 in lieu of previous vague "see above".
(same as commit of Sun Nov 2 to the release23-maint branch)
2003-11-09 16:33:56 +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
Martin v. Löwis 95cf84a4f3 Patch #821093: Fix various typos. 2003-10-19 07:32:24 +00:00
Fred Drake 2348afd3f8 - update to reflect that base classes can be class types as well as
"classic" class objects
  [partially fixes SF bug #453684]

- add note that new-style classes can use descriptors to implement
  instance variables in different ways
2003-09-24 04:11:47 +00:00
Raymond Hettinger 92016dcc91 SF 810242. Fix doubled word errors. 2003-09-22 15:27:11 +00:00
Fred Drake 38f6b8845b Elaborate the explanation of different flavors of _* identifiers.
Fixes SF bug #520325.
2003-09-06 03:50:07 +00:00
Fred Drake c0678ffc60 - create a hyperlink for a section reference (also more robust in the
face of section re-ordering)
- fix minor markup nits for better presentation
2003-09-06 03:33:32 +00:00
Raymond Hettinger e41d4c8ec9 Added doubled word warnings. 2003-08-25 04:39:55 +00:00
Raymond Hettinger c7a26562f9 SF patch#786531 'the the' typo. Contributed by George Yoshida 2003-08-12 00:01:17 +00:00
Fred Drake a3788642a3 Fix representation of ^= operator in __ixor__() documentation.
Closes SF bug #776181.  Should be backported.
2003-07-23 15:18:03 +00:00
Raymond Hettinger 943277ecd3 Minor corrections. 2003-07-17 14:47:12 +00:00
Fred Drake ea690c4b25 - improve the description of how user-defined method
objects get made
  - improve the description of attribute retrieval from
    classes and class instances
  - add brief documentation of static method and
    class method objects.
2003-07-17 05:26:53 +00:00
Raymond Hettinger 4d6e8fe5d1 Clarify the lack of relationship between rich comparison operators.
Prompted by a discussion on comp.lang.python.
2003-07-16 19:40:23 +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
Fred Drake e37b4ed24e Discuss calling new-style types.
Closes SF bug #453683.
2003-07-15 20:45:16 +00:00
Raymond Hettinger 5918f8de67 Minor fixes to punctuation and grammar. 2003-06-29 04:53:23 +00:00
Fred Drake 25b5358cf2 Add definitions of the test and testlist symbols in the grammar so
there are no gaps in the definitions.
Closes SF bug #726150.
2003-06-27 17:12:43 +00:00
Raymond Hettinger df9eff061e * Markup nits for the Invoking Descriptors section
* Documented __slots__
* Documented __metaclass__

Shamelessly plagarized from Guido's tutorial.
2003-06-27 06:57:56 +00:00
Raymond Hettinger d0cda1dc9f SF patch #760792: "wo" in "word" now valid but not documented as such
Revised version of a contribution from Gerrit Holl.

Update the docs for the extended behavior of __contains__
2003-06-26 19:32:10 +00:00
Raymond Hettinger daa340418b * Fixed an unmatched parenthesis early in the text.
* Clarified the meaning of lexicographic sequence ordering as discussed on
  comp.lang.python:  http://groups.google.com/groups?th=e163c9f9ba114493
2003-06-26 17:41:40 +00:00
Fred Drake 4db3661e24 remove _ from label: LaTeX rejects this due to all the magic we use to
get the _ character to format like a normal character
2003-06-26 03:11:20 +00:00
Raymond Hettinger 03ec6d538a * Document how descriptors are invoked.
* Fix minor parenthesis matching errors in ref3.tex.
2003-06-25 18:29:36 +00:00
Martin v. Löwis 171be76bdd Patch #755683: Document that there might be a maximum indentation limit.
Fixes #700827
2003-06-21 13:40:02 +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
Brett Cannon 9e6fedd2ec Add explicit text for where an obindex call for generators was since obindex does not cause output of its argument. 2003-06-15 22:57:44 +00:00
Raymond Hettinger b268f03459 SF bug #749759: comparisons yield bool not int
Minor documentation fix.
2003-06-06 02:52:14 +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 a95d3b78c8 Oops. License is still an appendix. 2003-05-28 12:12:55 +00:00
Jeremy Hylton 2fb6124afd Appendix was removed. 2003-05-28 12:04:38 +00:00
Jeremy Hylton cf9c46719c *** empty log message *** 2003-05-28 11:51:11 +00:00
Jeremy Hylton 8bea5dc879 Move future statement here from appendix a. 2003-05-21 21:43:00 +00:00
Fred Drake 7af9f4dac3 Add a specific mention of the term "operator overloading" and add an
index entry.  Suggested to python-docs.
2003-05-12 13:50:11 +00:00
Neal Norwitz 4efd91713b Add a space after expression to be consistent 2003-04-10 21:51:29 +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 62364ffb80 - apply SF patch #700798: fixes and cleanups for descriptor info
- use a TeX "tie" to prevent word-wrapping in "section x.y"-like text
2003-03-20 18:17:16 +00:00
Michael W. Hudson 2ab1d08f90 I thought it was common practice to check things compiled before
checking them in?  Oh well, this fixes various obvious mistakes and
changes a subsubsubsection (which doesn't exist) into a subsubsection
(which does).  I'm not sure this matches the intent, but it seems to
read OK on a quick skim.
2003-03-05 14:20:58 +00:00
Guido van Rossum d41eea05f4 SF doc patch #692001, properties and __getattribute__. I added some
stuff, and changed 'property' to 'descriptor'.
2003-02-28 14:11:45 +00:00
Jeremy Hylton f9b0cc7df6 Document __module__. 2003-01-31 18:52:45 +00:00
Fred Drake 8bd62afca9 Fix typo reported to python-docs. 2003-01-25 03:47:35 +00:00
Raymond Hettinger f4ca5a2f45 Fix typo 2003-01-19 14:57:12 +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
Michael W. Hudson cfd3884882 This is Richie Hindle's patch
[ 643835 ] Set Next Statement for Python debuggers

with a few tweaks by me: adding an unsigned or two, mentioning that
not all jumps are allowed in the doc for pdb, adding a NEWS item and
a note to whatsnew, and AuCTeX doing something cosmetic to libpdb.tex.
2002-12-17 16:15:34 +00:00
Gustavo Niemeyer 78429a6aa6 Fixing bug
[#448679] Left to right

* Python/compile.c
  (com_dictmaker): Reordered evaluation of dictionaries to follow strict
  LTR evaluation.

* Lib/compiler/pycodegen.py
  (CodeGenerator.visitDict): Reordered evaluation of dictionaries to
  follow strict LTR evaluation.

* Doc/ref/ref5.tex
  Documented the general LTR evaluation order idea.

* Misc/NEWS
  Documented change in evaluation order of dictionaries.
2002-12-16 13:54:02 +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
Gustavo Niemeyer f955412130 * Doc/ref/ref5.tex
Fixed minor bug preventing documentation compilation.
2002-11-26 18:14:35 +00:00
Tim Peters 5b21df4a5c Repaired inaccuracies in the % docs. In particular, we don't (and can't)
guarantee abs(x%y) < abs(y) in all cases when a float is involved.
math.fmod() should, though, so noted that too.

Bugfix candidate.  Someone should check the LaTeX here first, though.
2002-11-24 20:23:04 +00:00