Commit Graph

452 Commits

Author SHA1 Message Date
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
Fred Drake ce5619e8a1 Update: Older versions of Python crashed when calling repr()
(including the implied call using back-ticks) of a recursive object,
but this is no longer the case.
Reported by Manus Hand via email.
2002-11-13 15:32:34 +00:00
Raymond Hettinger 0da7f39a7c Closes SF bug #634069 reporting the docs on the ** operator were out
of date and did not reflect the current CPython implementation.
2002-11-08 05:30:23 +00:00
Fred Drake 79713fd9c6 Relocate an index entry so named anchors are not generated in a section head.
Closes SF bug #546579.
2002-10-24 19:57:37 +00:00
Fred Drake 78eb200758 Added cross-references to related material on exceptions.
Closes SF bug #217195.

Make sure section numbers wrap together with the preceeding word
("section").
2002-10-18 15:20:32 +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
Fred Drake 30be5768d2 Make sure section numbers wrap together with the preceeding word
("section").
2002-10-18 15:03:42 +00:00
Raymond Hettinger 463bfafd24 Clarify deprecation of the floor div operator, modulo operator,
and divmod() function for complex numbers.

Closes SF Bug 621708: Unclear deprecation.
2002-10-11 21:08:02 +00:00
Martin v. Löwis 36a4d8c20e Remove mentionings of DOS. 2002-10-10 18:24:54 +00:00
Fred Drake 74653820e3 Modified presentation of the grammar for calls to be easier to read
for both HTML and typeset renderings.  Corresponds to revision
1.53.4.8 on the r22-maint branch.
2002-10-07 16:28:38 +00:00
Fred Drake 5ec22f2d7b Another try at clarifying what goes into and comes out of Unicode objects.
Document the indices() method of slice objects.
2002-09-24 21:09:13 +00:00
Fred Drake 3e930ba55f Another try at clarifying what goes into and comes out of Unicode objects. 2002-09-24 21:08:37 +00:00
Raymond Hettinger a0e4d6ceaf Clarified that the footnote applies to versions 1.5 and after instead of
just version 1.5.  Closes SF bug 577793.
2002-09-08 21:10:54 +00:00
Martin v. Löwis f62a89b1e0 Ignore encoding declarations inside strings. Fixes #603509. 2002-09-03 11:52:44 +00:00
Skip Montanaro ee113f08f8 add warning about exception messages 2002-08-28 01:14:57 +00:00
Raymond Hettinger 83dcf5a290 Apply character{} markup. 2002-08-07 16:53:17 +00:00
Fred Drake f7aa164d7a Fix up some more markup problems. 2002-08-07 13:24:09 +00:00
Raymond Hettinger d9fdb51df6 Document handling of raw-unicode-escapes. Closes SF bug 587087. 2002-08-06 22:36:26 +00:00
Fred Drake 31f3db39f3 Fix the markup so it doesn't break formatting. 2002-08-06 21:36:06 +00:00
Martin v. Löwis 00f1e3f5a5 Patch #534304: Implement phase 1 of PEP 263. 2002-08-04 17:29:52 +00:00
Michael W. Hudson f0d777c56b A few days ago, Guido said (in the thread "[Python-Dev] Python
version of PySlice_GetIndicesEx"):

> OK.  Michael, if you want to check in indices(), go ahead.

Then I did what was needed, but didn't check it in.  Here it is.
2002-07-19 15:47:06 +00:00
Fred Drake 292724d989 Fix various typos reported to python-docs. 2002-06-26 21:52:26 +00:00
Raymond Hettinger 04e7e0c60f Close bug 417930 by clarifying augmented assignment docs 2002-06-25 13:36:41 +00:00
Raymond Hettinger 7fd9ced4ca Minor English grammar correction 2002-06-25 04:04:14 +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
Fred Drake e08c9dbffc Simplify the production for argument list, making sure that it
actually allows all the legal syntax, and nothing else.  Previously,
it did not allow a call like func(arg, **dictionary).
This closes (again!) SF bug #493243.
2002-06-20 14:23:15 +00:00
Raymond Hettinger 10cbe8dcbc SF 563530 added missing methods for emulating numeric types 2002-06-20 06:12:37 +00:00
Fred Drake a23b5739bb Add a note about "as" not being a keyword, though it has special meaning
when used as part of the import statement.

Note that both "as" and "None" becoming keywords in the future.

Closes SF bug #553262.
2002-06-18 19:17:14 +00:00
Fred Drake 074712112b Played contortionist games with the argument_list production so it
might be easier to understand.
This relates to SF bug #493243, which will be closed.
2002-06-18 18:42:01 +00:00
Michael W. Hudson 495afea36e Typo. 2002-06-17 12:51:57 +00:00
Michael W. Hudson 5efaf7eac8 This is my nearly two year old patch
[ 400998 ] experimental support for extended slicing on lists

somewhat spruced up and better tested than it was when I wrote it.

Includes docs & tests.  The whatsnew section needs expanding, and arrays
should support extended slices -- later.
2002-06-11 10:55:12 +00:00
Fred Drake 293dd4b77b Fix up Guido's markup. 2002-06-04 16:25:57 +00:00
Guido van Rossum 92cf95f45b Addressed SF bug 421973 (finally).
Rewrote the subsection on coercion rules (and made it a proper
subsection, with a label).  The new section is much less precise,
because precise rules would be too hard to give (== I don't know what
they are any more :-).  OTOH, the new section gives much more
up-to-date information.

Also noted that __coerce__ may return NotImplemented, with the same
meaning as None.

I beg Fred forgiveness: my use of \code{} is probably naive.  Please
fix this and other markup nits.  An index entry would be nice.

This could be a 2.2 bugfix candidate, if we bother about old docs
(Fred?)
2002-06-03 19:06:41 +00:00
Raymond Hettinger 6cf09f0792 Patch 543387. Document deprecation of complex %, //,and divmod(). 2002-05-21 18:19:49 +00:00
Raymond Hettinger 94153096f5 Closes SF patch: 552468.
Type class unification invalidated the statement:  x.__getitem__[i] is not equivalent to x[i].
2002-05-12 03:09:25 +00:00
Fred Drake af93c4c8d9 Added a missing "|" in the grammar productions used in the reference manual
(reported by François Pinard).
Added some missing "_" characters in the same cluster of productions.
Added missing floor division operator in m_expr production, and mention
floor division in the relevant portion of the text.
2002-04-30 02:18:51 +00:00