0
0
mirror of https://github.com/python/cpython.git synced 2024-12-01 11:15:56 +01:00
Commit Graph

226 Commits

Author SHA1 Message Date
Fred Drake
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
Fred Drake
e2645775d1 Typo: "ariables" --> "variables"
This fixes SF bug #411118.
2001-03-28 16:55:53 +00:00
Jeremy Hylton
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
Fred Drake
a9d0450f72 No quotes around the "future" in the first use of the term "future
statement".
2001-03-23 16:47:11 +00:00
Fred Drake
557c1ae150 Include the futures appendix. 2001-03-23 16:21:15 +00:00
Fred Drake
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
Jeremy Hylton
324cc6ee0e Add some initial text for the appendix on future statements and nested scopes. 2001-03-23 15:29:54 +00:00
Jeremy Hylton
2c84fc8a7d Note that assignments to __debug__ are illegal 2001-03-23 14:34:06 +00:00
Jeremy Hylton
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
Fred Drake
859eb62108 Do not refer to "sub-modules" since that is not a defined term. 2001-03-06 07:34:00 +00:00
Fred Drake
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
Barry Warsaw
7a5e80e801 Updates to describe function attributes. 2001-02-27 03:36:30 +00:00
Fred Drake
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
Tim Peters
7530208d8b Feeble attempt to repair obsolete info about hex escapes. 2001-02-14 04:03:51 +00:00
Fred Drake
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
Jeremy Hylton
3faa52ecc4 Allow 'continue' inside 'try' clause
SF patch 102989 by Thomas Wouters
2001-02-01 22:48:12 +00:00
Fred Drake
c2e35e6f37 Remove spurious "\end{description}" that caused formatting to fail. 2001-02-01 15:37:56 +00:00
Jeremy Hylton
0eb107068a update section 4.1 to describe nested scopes 2001-02-01 03:50:59 +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
2f4453af6a Typo: coplete --> complete
This closes SF bug #129759.
2001-01-26 15:27:35 +00:00
Fred Drake
c8e8281fb6 Updated note about collection of cyclic garbage, based on comments from
Chris Ryland.
2001-01-22 17:46:18 +00:00
Guido van Rossum
ab782dd6cc Document rich comparisons. 2001-01-18 15:17:06 +00:00
Fred Drake
34bafcc079 Fix a variety of minor nits and typos caught by Chris Ryland
<cpr@emsoftware.com>.
2001-01-14 02:57:14 +00:00
Fred Drake
347a62505c Steve Holden <sholden@holdenweb.com>:
Clarify the handling of characters following backslashes in raw strings.
2001-01-09 21:38:16 +00:00
Fred Drake
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
Neil Schemenauer
48c2eb9165 Document the NotImplemented object. 2001-01-04 01:25:50 +00:00
Fred Drake
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
Thomas Wouters
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
Andrew M. Kuchling
68abe832b9 Fix typo 2000-12-19 14:09:21 +00:00
Fred Drake
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
Guido van Rossum
035f7e88c8 Clarify __repr__ and __str__. 2000-12-19 04:18:13 +00:00
Thomas Wouters
dc90cc2b15 Additional docs for __iadd__ and family, closing SF bug #117178 and SF patch
#102169.
2000-12-11 23:11:51 +00:00
Fred Drake
2a22200ab4 Adjust explanation of operator precedence summary -- exponentiation groups
from right to left!

Closes bug #125391.
2000-12-11 22:39:24 +00:00
Fred Drake
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
Fred Drake
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
Fred Drake
0ac000cd54 Updates to reflect pending changes to the XML conversion process. 2000-11-22 16:42:37 +00:00
Fred Drake
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
Fred Drake
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
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
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
Fred Drake
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
Fred Drake
1156f62348 Many small clarifications, including many suggested by email. 2000-09-19 18:10:05 +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
Skip Montanaro
b655939d69 add index entries for list comprehensions 2000-09-11 16:31:55 +00:00
Barry Warsaw
33f785fc1e Document "print >> None" 2000-08-29 04:57:34 +00:00
Thomas Wouters
12bba852a9 Rough and incomplete documentation on augmented assignment, which follows
shortly. Markup also needs checking.
2000-08-24 20:06:04 +00:00
Skip Montanaro
323fe5df6a fix list comprehension discussion to use \keyword macro instead of simply
quoting keywords.
2000-08-23 17:03:34 +00:00
Skip Montanaro
46dfa5f4ed require list comprehensions to start with a for clause 2000-08-22 02:43:07 +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