f955412130
* Doc/ref/ref5.tex
...
Fixed minor bug preventing documentation compilation.
2002-11-26 18:14:35 +00:00
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
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
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
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
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
e7097e0b1c
Added cross-references to related material on exceptions.
...
Closes SF bug #217195 .
2002-10-18 15:18:18 +00:00
30be5768d2
Make sure section numbers wrap together with the preceeding word
...
("section").
2002-10-18 15:03:42 +00:00
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
36a4d8c20e
Remove mentionings of DOS.
2002-10-10 18:24:54 +00:00
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
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
3e930ba55f
Another try at clarifying what goes into and comes out of Unicode objects.
2002-09-24 21:08:37 +00:00
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
f62a89b1e0
Ignore encoding declarations inside strings. Fixes #603509 .
2002-09-03 11:52:44 +00:00
ee113f08f8
add warning about exception messages
2002-08-28 01:14:57 +00:00
83dcf5a290
Apply character{} markup.
2002-08-07 16:53:17 +00:00
f7aa164d7a
Fix up some more markup problems.
2002-08-07 13:24:09 +00:00
d9fdb51df6
Document handling of raw-unicode-escapes. Closes SF bug 587087.
2002-08-06 22:36:26 +00:00
31f3db39f3
Fix the markup so it doesn't break formatting.
2002-08-06 21:36:06 +00:00
00f1e3f5a5
Patch #534304 : Implement phase 1 of PEP 263.
2002-08-04 17:29:52 +00:00
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
292724d989
Fix various typos reported to python-docs.
2002-06-26 21:52:26 +00:00
04e7e0c60f
Close bug 417930 by clarifying augmented assignment docs
2002-06-25 13:36:41 +00:00
7fd9ced4ca
Minor English grammar correction
2002-06-25 04:04:14 +00:00
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
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
10cbe8dcbc
SF 563530 added missing methods for emulating numeric types
2002-06-20 06:12:37 +00:00
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
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
495afea36e
Typo.
2002-06-17 12:51:57 +00:00
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
293dd4b77b
Fix up Guido's markup.
2002-06-04 16:25:57 +00:00
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
6cf09f0792
Patch 543387. Document deprecation of complex %, //,and divmod().
2002-05-21 18:19:49 +00:00
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
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
ed9e453eb7
Minor change to an index entry.
2002-04-23 20:04:46 +00:00
70b3831697
Adjust markup to worm around tool limitations; the "m" in "model" was being
...
dropped in the HTML formatted version.
Reported by Mike Coleman.
2002-04-17 03:41:50 +00:00
c0a02c084b
Remove repeated index entry; adds nothing different.
...
Closes SF bug #518985 .
2002-04-16 02:03:05 +00:00
2a519f8fe6
Document __unicode__. Fixes #541245 .
2002-04-11 12:39:35 +00:00
fd867719bc
Fix typo: coverted --> converted. Reported by Francois Pinard.
2002-04-09 14:39:10 +00:00
77f6a65eb0
Add the 'bool' type and its values 'False' and 'True', as described in
...
PEP 285. Everything described in the PEP is here, and there is even
some documentation. I had to fix 12 unit tests; all but one of these
were printing Boolean outcomes that changed from 0/1 to False/True.
(The exception is test_unicode.py, which did a type(x) == type(y)
style comparison. I could've fixed that with a single line using
issubtype(x, type(y)), but instead chose to be explicit about those
places where a bool is expected.
Still to do: perhaps more documentation; change standard library
modules to return False/True from predicates.
2002-04-03 22:41:51 +00:00
88955cbe1f
Change reference to execframes to naming.
2002-04-01 21:34:28 +00:00
e604875b81
Restore a minimal definition of execution frame, since other parts of
...
the manual refer to it.
XXX Not sure that it belongs in this section, or that the concept is
particularly important for writing documentation. Perhaps references
to the frame should be removed entirely.
2002-04-01 21:33:55 +00:00
1824b59e89
Update programmer's note on nested functions.
2002-04-01 21:30:15 +00:00
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
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
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
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
2225add242
Given lambda its own section, instead of burying it in boolean operators.
2002-04-01 21:05:21 +00:00
53ed917d3a
Update / simplify Identifiers section for nested scopes.
...
How do I create a cross reference to section 4.1?
2002-04-01 20:52:24 +00:00
e7d5773ed0
Update docs for nested scopes.
...
Replace section 4.1 with section A.3.
The new section 4.1 is titled "Naming and binding." It includes the
text of section A.3 augmented with some of the detailed text from the
old section 4.1.
The \dfn, \index stuff is probably wrong, but I tried.
Also update other parts of appendix A to mention that nested scopes
and generators are standard features.
2002-04-01 20:38:01 +00:00
8392f36579
Update documentation of code objects.
...
Split the description of co_flags into two paragraphs. The first
describes the flags that are used for non-future purposes, where
CO_GENERATOR was added. The second describes __future__'s use of
co_flags and mentions the only one currently meaningful,
CO_FUTURE_DIVISION.
2002-04-01 18:53:36 +00:00
26c49b66bb
Small fixes for description of function attributes.
...
func_closure is a readonly attribute.
Add \ttindex{} for func_closure.
Remove discussion of func_closure specific to 2.1.
2002-04-01 17:58:39 +00:00
f6eafc3fe1
Fix up unescaped tilde; reported by several people.
2002-03-18 16:47:14 +00:00
83d14c12a6
Markup error: braces not properly marked in dictionary display
...
grammer productions.
Fixes SF bug #520959 .
2002-03-16 06:35:54 +00:00
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
216cbca195
Typo: thsi -> this. Closes SF bug #521450 .
2002-02-22 15:40:23 +00:00
aae728f292
Fix typo reported by François Pinard.
2002-01-21 16:09:18 +00:00
687bde9433
Added some missing index entries, noted by L. Peter Deutsch.
...
This should be included in Python 2.2.1.
2001-12-27 18:38:10 +00:00
08d752cf28
Update to use the notice environment so a multi-paragraph note can be
...
appropriately marked.
2001-12-14 22:55:14 +00:00
591dd8f620
Update information about __del__() & reference cycles for CPython.
...
This partially fixes SF bug #492619 .
Fix a typo & use the new notice environment instead of (ab)using the \note
and \warning macros.
2001-12-14 22:52:41 +00:00
b062cb22d0
Work around the problem of spaces after a "}" being dropped by LaTeX2HTML if
...
they were represented by newlines in the document source.
Partially fixes SF bug #493243 .
2001-12-14 16:57:31 +00:00
850d3980ab
Fix for
...
[ #429329 ] actual-parameters *arg, **kws not doc'd
2001-12-12 11:56:33 +00:00
8d0645cb84
Add a note about yield requiring a __future__ directive.
2001-12-12 06:06:43 +00:00
3a8e59ebe1
Clean up a sad sentence in the yield description.
2001-12-11 21:58:35 +00:00
e31e9cebc0
Document generators and the yield statement, avoiding implementation details.
2001-12-11 21:10:08 +00:00
1d3e6c15ce
Fix whitespace in example of bad indentation: a comment indicated that one
...
line was not indented at all, so the example is no longer indented at all.
All of the errors being shown remain.
Typo: characteru --> character
2001-12-11 17:46:38 +00:00
f9d580346b
Add change notes where im_class is discussed, since the exact meaning changes
...
with Python 2.2.
2001-12-07 23:13:53 +00:00
b62f0e1a7b
Correct the description of im_class. (Fred, this is changed in 2.2.
...
Should this be labeled as changed? How?)
2001-12-07 22:03:18 +00:00
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
4ed6be7107
Import the keyword module instead of relying on our own list of
...
reserved words. No longer need to import string.
2001-12-04 20:39:36 +00:00
41c6719fe4
Put the keywords back in alphabetical order. Apparently somebody
...
didn't use reswords.py, as the comment clearly states. :-(
2001-12-04 20:38:44 +00:00
3570551d6f
Remove most references to __members__ and __methods__, leaving only one pair
...
of references that now state that these attributes have been removed,
directing the reader to the dir() function.
This closes SF bug #456420 .
2001-12-03 17:32:27 +00:00
c37b65ee10
Clean up some markup cruft. A number of the macros that take no
...
parameters (like \UNIX) are commonly entered using an empty group to
separate the markup from a following inter-word space; this is not
needed when the next character is punctuation, or the markup is the
last thing in the enclosing group. These cases were marked
inconsistently; the empty group is now *only* used when needed.
2001-11-28 07:26:15 +00:00
1336e99054
Fred observes that the typo was not the only problem with this sentence.
2001-11-14 21:38:13 +00:00
4a98f70a09
typo
2001-11-14 21:32:27 +00:00
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
0aa811c527
Use the \note and \warning macros where appropriate.
2001-10-20 04:24:09 +00:00
316141b333
Fix typo reported by Michael Soulier.
2001-10-18 15:22:23 +00:00
1350c07de3
Removed stray backslash (a typo -- my fault).
2001-10-01 20:25:26 +00:00
20524dbf36
The description of dictionary comparison was out of date. Rather than
...
try to explain the complex general scheme we actually use now, I decided
to spell out only what equality means (which is easy to explain and
intuitive), leaving the other outcomes unspecified beyond consistency.
2001-10-01 20:22:45 +00:00
73921b0eec
Refer to the objects which define __len__(), __*item__(), and __iter__()
...
as container objects rather than as mapping objects (in the index entries).
Change the section heading and intro sentence to be a little more general,
since that's how things have actually evolved.
2001-10-01 16:32:13 +00:00
18d8d5a708
Fix minor usage and consistency nits.
2001-09-18 17:58:20 +00:00
ed5a7ca5ee
Work around a LaTeX2HTML bug that caused the "m" in "mutable" to be dropped
...
in one place.
2001-09-10 15:16:08 +00:00
d507dab91f
SF patch #455966 : Allow leading 0 in float/imag literals.
...
Consequences for Jython still unknown (but raised on Jython-Dev).
2001-08-30 20:51:59 +00:00
53da317801
Docs for the PEP 264 changes.
2001-08-27 20:02:17 +00:00
c0cf726d8c
Add material about the "r" and "u" prefixes for string literals; should
...
be reviewed for clarity.
Work around a bogosity in the HTML version of the escape sequences table
conversion.
2001-08-14 21:43:31 +00:00
3e2aca48bd
Add information about __floordiv__() and __truediv__() methods for
...
implementing numeric objects in Python.
2001-08-14 20:28:08 +00:00
a7d608d1cf
"Thin" version of floor division docs: add // to the list of operators
...
and //= to the list of other delimiter tokens.
I'll work on it again when it's not so late...
2001-08-08 05:37:21 +00:00
8dd6ffd0ec
User-defined methods *can* contain things other than user-defined functions
...
as the callable, so use more flexible language.
2001-08-02 21:34:53 +00:00
044bb4d22a
Explain that __init__() methods do not get to return values.
2001-08-02 15:53:05 +00:00
9079164bdf
Removed unnecessary section "Unicode literals"; all the discussion is
...
already present in the "String literals" section, including comments on
the "u" prefix and the additional escape sequences used for Unicode.
This relates to SF bug #442526 .
2001-07-20 15:33:23 +00:00
0825dc2427
Fix typo in description of raw strings: "value" --> "valid"
...
This closes SF bug #443059 .
2001-07-20 14:32:28 +00:00
6e5e1d924c
Minor change to match the style guide.
2001-07-14 02:12:27 +00:00
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
e7e03cd0cf
Fix typo
2001-06-23 16:26:44 +00:00
be9d10edbb
Remove some bogus trailing whitespace.
2001-06-23 06:16:52 +00:00
93852ef3c8
Fix minor markup nits.
2001-06-23 06:06:52 +00:00
deda9f3420
Use a named reference to another chapter instead of hard coding the
...
chapter number. This also makes the reference a hyperlink in the HTML
version.
2001-06-23 06:06:21 +00:00
2829f1cf99
Fix a very minor (but annoying when looking for things!) markup nit.
2001-06-23 05:27:20 +00:00
f5eae668a8
Add "yeild" to the list of keywords.
...
Fix a very minor (but annoying when looking for things!) markup nit.
2001-06-23 05:26:52 +00:00
d5df09cfb6
Update to include the license information in a less annoying place.
2001-06-20 21:37:34 +00:00
88382696f4
Update a "Programmer's note" about lambda forms and scoping to reflect
...
the availability of nested scoping in Python 2.1 and 2.2.
2001-06-05 02:17:02 +00:00
597bc1d46f
Bring the notes on the relationship between __cmp__(), __eq__(), and
...
__hash__() up to date (re: use of objects which define these methods
as dictionary keys).
This closes SF bug #427698 .
2001-05-29 16:02:35 +00:00
b9879e1020
Fix typo reported in SF bug #427783 .
2001-05-29 15:44:27 +00:00
b3384d3555
Make sure we include all of Python's numeric types in the data model
...
description, so that the introduction of complex is not a surprise.
This closes SF bug #423429 .
2001-05-14 16:04:22 +00:00
7c116d7acb
Fix typo reported by David Goodger. This closes SF patch #422383 .
2001-05-10 15:09:36 +00:00
b8ac0096b2
Fix the operator precedence table: exponentiation binds tighter than
...
negation.
This closes SF bug #421999 .
2001-05-09 16:51:49 +00:00
0dbb4fba4c
Implement, test and document "key in dict" and "key not in dict".
...
I know some people don't like this -- if it's really controversial,
I'll take it out again. (If it's only Alex Martelli who doesn't like
it, that doesn't count as "real controversial" though. :-)
That's why this is a separate checkin from the iterators stuff I'm
about to check in next.
2001-04-20 16:50:40 +00:00
62effc1127
Work around the conversion of ">>" and "<<" to guillemets. Reported by Ping.
2001-04-13 15:55:25 +00:00
fb8ffe6b5e
Work around the conversion of ">>" and "<<" to guillemets. Reported by Ping.
...
Wrap some long lines and fix some markup nits.
2001-04-13 15:54:41 +00:00
24e7a29292
Work around the conversion of ">>" and "<<" to guillemets. Reported by
...
Ping on the Doc-SIG mailing list.
2001-04-12 12:37:03 +00:00
e2645775d1
Typo: "ariables" --> "variables"
...
This fixes SF bug #411118 .
2001-03-28 16:55:53 +00:00
aa90adcfb9
Add nested scopes spec to appendix.
...
Add new opcodes LOAD_CLOSURE, LOAD_DEREF, STORE_DEREF, MAKE_CLOSURE to
docs for dis module.
Add docs for new function and code members in Sec. 3 of ref manual.
They're present regardless of whether nested scopes are used.
Remove description of default argument hack from Sec. 7 of the ref
manual and refer the reader to the appendix.
2001-03-23 17:23:50 +00:00
a9d0450f72
No quotes around the "future" in the first use of the term "future
...
statement".
2001-03-23 16:47:11 +00:00
557c1ae150
Include the futures appendix.
2001-03-23 16:21:15 +00:00
39778b705d
Revise the markup so that this formats and uses markup consistently with
...
the rest of the documentation.
2001-03-23 16:20:46 +00:00
324cc6ee0e
Add some initial text for the appendix on future statements and nested scopes.
2001-03-23 15:29:54 +00:00
2c84fc8a7d
Note that assignments to __debug__ are illegal
2001-03-23 14:34:06 +00:00
e702481d38
Revert to ver 1.22, which was the version before the nested scopes
...
docs were introduced. This loses a few small changes, but Fred says
that's okay.
2001-03-23 14:05:16 +00:00
859eb62108
Do not refer to "sub-modules" since that is not a defined term.
2001-03-06 07:34:00 +00:00
ac79e95167
Re-word the explanation of the in/not in operators for increased content
...
and clarity.
Add a footnote to the information on the possibility of shadowing builtins
with locals & module globals.
2001-03-06 07:32:11 +00:00
7a5e80e801
Updates to describe function attributes.
2001-02-27 03:36:30 +00:00
230d17d0d1
Sequence indexes are non-negative, not natural (0 is not a natural number).
...
Reported by Daniel May <mayds@ecn.purdue.edu>.
De-tabified everywhere.
2001-02-22 21:28:04 +00:00
7530208d8b
Feeble attempt to repair obsolete info about hex escapes.
2001-02-14 04:03:51 +00:00
667c9e46ca
Minor markup adjustments.
...
Move some index entries next to what they are referring to for better
"targetting".
2001-02-02 02:43:18 +00:00
3faa52ecc4
Allow 'continue' inside 'try' clause
...
SF patch 102989 by Thomas Wouters
2001-02-01 22:48:12 +00:00
c2e35e6f37
Remove spurious "\end{description}" that caused formatting to fail.
2001-02-01 15:37:56 +00:00
0eb107068a
update section 4.1 to describe nested scopes
2001-02-01 03:50:59 +00:00
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
2f4453af6a
Typo: coplete --> complete
...
This closes SF bug #129759 .
2001-01-26 15:27:35 +00:00
c8e8281fb6
Updated note about collection of cyclic garbage, based on comments from
...
Chris Ryland.
2001-01-22 17:46:18 +00:00
ab782dd6cc
Document rich comparisons.
2001-01-18 15:17:06 +00:00
34bafcc079
Fix a variety of minor nits and typos caught by Chris Ryland
...
<cpr@emsoftware.com>.
2001-01-14 02:57:14 +00:00
347a62505c
Steve Holden <sholden@holdenweb.com>:
...
Clarify the handling of characters following backslashes in raw strings.
2001-01-09 21:38:16 +00:00
445f832060
__rcmp__() description: Changed to indicate that this is no longer
...
supported as of Python 2.1. We still need to
have an entry for this since it is reasonable
for users to want to understand existing code.
This closes SF bug #122715 .
2001-01-04 15:11:48 +00:00
48c2eb9165
Document the NotImplemented object.
2001-01-04 01:25:50 +00:00
2cba0f641f
Improve description of else clause of the try/except/else statement.
...
This closes (again!) bug #127098 .
2001-01-02 19:22:48 +00:00
8e2b6b5cc7
Change documentation of 'else' clause of 'try/except' to make clear that it
...
doesn't get triggered by 'return', 'break' or 'continue'. If the
'try-inside-continue' patch does not get accepted before next release, the
'or continue' should be removed ;P
Closes SF patch #103045 and SF bug #127098 .
2000-12-31 22:52:59 +00:00
68abe832b9
Fix typo
2000-12-19 14:09:21 +00:00
dea764d7f1
Updated string literals description to encompass Unicode literals and the
...
additional escape sequences defined for Unicode.
This closes bug #117158 .
2000-12-19 04:52:03 +00:00
035f7e88c8
Clarify __repr__ and __str__.
2000-12-19 04:18:13 +00:00
dc90cc2b15
Additional docs for __iadd__ and family, closing SF bug #117178 and SF patch
...
#102169 .
2000-12-11 23:11:51 +00:00
2a22200ab4
Adjust explanation of operator precedence summary -- exponentiation groups
...
from right to left!
Closes bug #125391 .
2000-12-11 22:39:24 +00:00
c3b18d7ca8
Fix error noted by Gerrit Holl (old; had been buried in my INBOX):
...
sequence repitition works just fine with long integers now, so we
should not say that only plain integers are allowed.
2000-12-07 04:54:02 +00:00
0c47559352
Added a note that objects which emulate built-in types should only
...
implement as many of the relevant methods as make sense for the particular
information being modelled.
2000-12-07 04:49:34 +00:00
0ac000cd54
Updates to reflect pending changes to the XML conversion process.
2000-11-22 16:42:37 +00:00
2ed27d3189
Note that readframes() returns data in linear format, even if the original
...
is encoded in u-LAW format. Based on suggestion from Anthony Baxter
<anthony_baxter@users.sourceforge.net>.
This closes bug #122273 .
2000-11-17 19:05:12 +00:00
f89259786a
Denis S. Otkidach <ods@users.sourceforge.net>:
...
Show how code can be written to handle __getslice__ & friends in a way that
is compatible with pre-2.0 versions of Python while still working with the
"new" way of handling slicing.
Additional explanation added by Fred Drake.
This closes SourceForge patch #101388 .
2000-09-21 22:27:16 +00:00
d68442b164
Lots of minor fixes, many suggested by Detlef Lannert
...
<lannert@uni-duesseldorf.de>.
2000-09-21 22:01:36 +00:00
31575ce817
Note that __getitem__() may receive a slice object as the index;
...
reported by Detlef Lannert <lannert@uni-duesseldorf.de>.
2000-09-21 05:28:26 +00:00
8d27f898b2
Moshe Zadka <mzadka@geocities.com>:
...
Document the __contains__() method.
(Patch slightly modified by FLD.)
This closes SourceForge patch #101387 .
2000-09-19 18:21:25 +00:00
1156f62348
Many small clarifications, including many suggested by email.
2000-09-19 18:10:05 +00:00
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
b655939d69
add index entries for list comprehensions
2000-09-11 16:31:55 +00:00
33f785fc1e
Document "print >> None"
2000-08-29 04:57:34 +00:00
12bba852a9
Rough and incomplete documentation on augmented assignment, which follows
...
shortly. Markup also needs checking.
2000-08-24 20:06:04 +00:00
323fe5df6a
fix list comprehension discussion to use \keyword macro instead of simply
...
quoting keywords.
2000-08-23 17:03:34 +00:00
46dfa5f4ed
require list comprehensions to start with a for clause
2000-08-22 02:43:07 +00:00
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
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
a00738259f
Adjust the way __getslice__() is marked as deprecated; this will also
...
stand out more.
2000-08-18 02:42:14 +00:00
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
1d75a79c00
Apply SF patch #101029 : call __getitem__ with a proper slice object if there
...
is no __getslice__ available. Also does the same for C extension types.
Includes rudimentary documentation (it could use a cross reference to the
section on slice objects, I couldn't figure out how to do that) and a test
suite for all Python __hooks__ I could think of, including the new
behaviour.
2000-08-17 22:37:32 +00:00
d341579178
Fix error made in applying Thomas's patch.
2000-08-15 18:44:10 +00:00
a1e214a1ed
Thomas Wouters <thomas@xs4all.net>:
...
Update the grammar to reflect the most recent changes to list
comprehensions.
2000-08-15 17:54:49 +00:00
803d6e5451
list comprehensions. see
...
http://sourceforge.net/patch/?func=detailpatch&patch_id=100654&group_id=5470
for details.
2000-08-12 18:09:51 +00:00
3d83fc3ab1
Change as suggested by Peter Funk <pf@artcom-gmbh.de>:
...
Create a hyperlink between the language reference and documentation for
the built in functions.
2000-07-31 20:08:23 +00:00
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
91826ed2a9
Improve the descriptions of expected exceptions for __getitem__(),
...
__setitem__(), and __delitem__(). Based on related comments from
Barry Warsaw.
2000-07-13 04:57:58 +00:00
7399b9e6e4
Moshe Zadka <mzadka@geocities.com>:
...
Update the "in" / "not in" description to accomodate the current use
of the __contains__() discipline. This patch also incorporates
suggestions from Marc-Andre Lemburg <mal@lemburg.com>, minor markup
revisions from Fred Drake, and some rewording of the first affected
paragraph (also from Fred).
Closes SourceForge patch #100831 .
2000-07-11 19:43:47 +00:00
191a28218f
Typo: "This table table" -> "This table is"
...
Noted by Nicholas Spies <ns11@voicenet.com>.
2000-07-06 00:50:42 +00:00
35c09f2e51
Revise the description of when functions retrieved from class instances
...
are and are not turned into bound methods; some confusion was noted by
Andrew Dalke.
In particular, it has to be noted that functions located on the class
instance are not turned into any sort of method, only those which are
found via the underlying class.
2000-06-28 20:15:47 +00:00
e57a11441e
Fix markup error that hid a tilde character; reported long ago by
...
Carl Feynman <carlf@abinitio.com>.
2000-06-15 20:07:25 +00:00
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
c009d198db
Removed some extraneous and confusing parenthesized expressions.
...
Noted by Skip Montanaro <skip@mojam.com>.
2000-04-25 21:09:10 +00:00
8b3ce9e099
But don't do the funny \UNICODE macro; we're trying to get away from
...
those markups! <with-mixed-feelings>
2000-04-06 14:00:14 +00:00
f0aff8e759
Patch from Marc-Andre Lemburg <mal@lemburg.com>:
...
Added Unicode type to the language reference.
2000-04-06 13:57:21 +00:00
e15956b465
Merged changes from the 1.5.2p2 release.
2000-04-03 04:51:13 +00:00
e15eb35fd0
Use \citetitle as appropriate.
1999-11-10 16:13:25 +00:00
a24f7b759a
Use \programopt in one place.
1999-11-09 17:03:45 +00:00
4c2533fe3c
Added sentence "All exceptions must have an executable block."; from
...
Dan Wolfe <wolfeman@apple.com>.
1999-08-24 22:14:01 +00:00
c35367e439
Change an {\em ...} to \var{...} and a {\bf ...} to \program{...} (the
...
new markup makes sense in context).
These allow the SGML/XML conversion updates to work, & should not have
still been in there anyway.
1999-07-29 13:56:41 +00:00
431f0ce547
Small nits around some of the index entries.
...
When refering to chapters, use \ref, don't hardcode the chapter
number.
1999-05-13 18:38:11 +00:00
b894370f6a
Fixed some index entries.
...
In the __coerce__ description, None should be returned if the
conversion is *impossible*, not *possible*. Reported by Robert Kern
<kernr@ncifcrf.gov>.
1999-05-10 13:43:22 +00:00
1ea7c75687
Reflect recent patch for float % and divmod() by Tim Peters. Content
...
updates by Tim Peters, markup by FLD.
1999-05-06 14:46:35 +00:00
d09120b5b9
Added index entries for operator precedence; suggestion from Randall
...
Hopper <rhh@vislab.epa.gov>.
1999-04-29 16:43:42 +00:00
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
b55ce1e8b6
Fixed latex2html weirdness with footnotes.
1999-04-05 21:32:52 +00:00
39fc1bc329
Added note about __builtin__._ to section dicussing classes of
...
reserved names, just to avoid confusion on the part of users.
1999-03-05 18:30:21 +00:00
8cdee961bf
Dictionaries are created using the "{...}" notation, not the "..."
...
notation. Problem reported by Magnus L. Hetland <mlh@idt.ntnu.no>.
1999-02-23 18:50:38 +00:00
264bd59221
1. Clarify that immutability isn't entirely the same as unchangeable
...
value (because of immutable containers containing mutable objects).
2. Document that func_code, func_defaults and func_doc / __doc__ are
now writable.
1999-02-23 16:40:55 +00:00
c411fa6861
Revised description of blank line handling for the interpreter, based
...
on a comment from /F.
1999-02-22 14:32:18 +00:00
99cd5735f0
Minor markup nits.
1999-02-12 20:40:09 +00:00
15988fdbbb
Documented __complex__(), made sure all the discipline names hit the
...
index.
1999-02-12 18:14:57 +00:00
ae3e574170
"numberic" --> "numeric", two places
1999-01-28 23:21:49 +00:00
4856d01797
Removed a lot of unnecessary comment markers which cause unexplained
...
numbers to appear in the HTML version of the manual.
1999-01-12 04:15:20 +00:00
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
Gustavo Niemeyer
Tim Peters
Fred Drake
Raymond Hettinger
Martin v. Löwis
Skip Montanaro
Michael W. Hudson
Guido van Rossum
Jeremy Hylton
Andrew M. Kuchling
Barry Warsaw
Neil Schemenauer
Thomas Wouters
Greg Ward