dc62aeca4c
Add a new looping idiom
2003-11-07 01:30:58 +00:00
8ed69e3389
SF #829941 , update tutorial, built-in types can be base classes since 2.2
2003-10-25 14:15:54 +00:00
f12f32421f
Don't make promises about about the visibility of the induction variable.
2003-10-21 18:42:21 +00:00
95cf84a4f3
Patch #821093 : Fix various typos.
2003-10-19 07:32:24 +00:00
984920bbad
Make the embedded hyperlinks work.
2003-09-28 19:03:36 +00:00
43b5e40795
* Fix markup.
...
* Fix entry order:
- >>> before ...
- __slots__ in the S section (like __future__ is in the F section)
Need to test the repaired(?) link to Guido's webpage.
Still needs to have the module reference links made relative to
the module directory instead of the tut directory. That will
require Fred's magic touch.
2003-09-27 20:19:02 +00:00
d4a1419f53
Lots of markup corrections. Some are minor, but others are not: the
...
contents of an \item should not be enclosed in a group!
2003-09-27 18:59:43 +00:00
5a25aa6c4a
Fix spelling and add markup.
2003-09-27 05:42:14 +00:00
40d4bc5934
Add a glossary to the tutorial. Also generate an index. At the moment this
...
mostly only references glossary entries.
2003-09-24 16:53:02 +00:00
757dedc1a3
first cut at a glossary
2003-09-24 16:51:23 +00:00
16434b5e25
Fix whitespace in example
2003-09-24 03:58:56 +00:00
f5c87c4d99
- added many links into the library reference
...
- removed use of the string module
- fixed some broken markup
2003-09-11 06:06:26 +00:00
626d472edd
- add several links into the library reference
...
- update a couple of URLs to point to more recent portions of
python.org
2003-09-11 04:28:13 +00:00
57d71289a1
SF patch #797868 : Tutorial, sec. 5.1.4 could contain an extra example
...
(Revised from the original patch contributed by Michal Pasternak.)
Also, make a couple minor fixups elsewhere.
2003-08-30 23:21:32 +00:00
c2a5cb2327
Fix typo.
...
Thou shalt not count to two unless proceeding to the number three.
2003-08-23 03:49:08 +00:00
236ffba400
Adjust some horizontal indentation to be consistent with the style used
...
throughout the documentation.
2003-08-16 06:30:47 +00:00
90b182c16c
Don't introduce map(None, ...) in the tutorial. In practice, zip() is
...
usually preferred.
2003-08-14 22:57:46 +00:00
c7a26562f9
SF patch#786531 'the the' typo. Contributed by George Yoshida
2003-08-12 00:01:17 +00:00
0eec08794c
Explain argument unpacking
2003-08-08 23:32:46 +00:00
b233e54409
Nits.
2003-07-15 23:16:01 +00:00
6122d0267f
SF patch #726751 : Clarify docs for except target assignment
...
Brett found that the tutorial didn't really explain what was happening
with exception targets. Hopefully, this sheds some light on the subject.
2003-07-12 01:05:37 +00:00
fa6cce1fdd
Minor fixups and added sections for iterators and generators.
2003-07-11 18:58:11 +00:00
dfda8d79ee
- explain about making Python scripts executable on Unix in more
...
detail
- fix minor markup nit
2003-07-07 21:00:29 +00:00
8ee006097f
SF #751062 : Tutorial: remove string exceptions, add parnassus, #posts
...
(Contributed by Gerritt Holl)
* Remove the last mentions of string exceptions
* Reference a third-party repository of programs
* Minor clarification of comp.lang.py posting volumes
2003-07-01 06:19:34 +00:00
ccd615c1a7
SF bug #762990 : Awful Grammar in Python Tutorial
...
Fixed a nit.
2003-06-30 04:27:31 +00:00
32a5e878d7
minor wordsmithing
2003-06-29 16:01:51 +00:00
ded8e740df
Correct markup errors that prevented formatting.
2003-06-28 11:50:34 +00:00
7928f388c4
Explain source encodings. Fixes #683486 .
2003-06-28 08:11:55 +00:00
2664cbbeba
Remove heading from orphan section.
2003-06-20 14:27:27 +00:00
3a8fbe7eec
Include "instances of most classes" in a warning about mutable objects
...
as default values of function/method parameters.
2003-06-18 17:14:29 +00:00
6bab183d4e
Markup nits.
2003-05-20 15:28:58 +00:00
a02469f969
More message updates and minor fixes.
2003-05-07 17:49:36 +00:00
a2f84ceda5
Update traceback message
2003-05-07 17:11:15 +00:00
45a9c93236
add missing parens - verified w/ interpreter - sorry to dismiss your comment
...
Fred
2003-05-07 16:01:43 +00:00
b4f12424a5
replace most uses of `...` by repr(...), noting that `...` is discouraged,
...
but convenient in interactive sessions.
2003-05-07 15:29:12 +00:00
03e929e7e0
Fix some markup nits.
2003-04-22 14:30:53 +00:00
a70b19147f
Adding new built-in function sum, with docs and tests.
2003-04-22 08:12:33 +00:00
60de2e837f
SF bug #699237 : Tutorial uses omitted slice indices before explaining them
...
Moved up the explanation of slice default arguments.
2003-03-12 04:46:52 +00:00
46d3dc37e4
- New function sys.exc_clear() clears the current exception. This is
...
rarely needed, but can sometimes be useful to release objects
referenced by the traceback held in sys.exc_info()[2]. (SF patch
#693195.) Thanks to Kevin Jacobs!
2003-03-01 03:20:41 +00:00
d0c7137c8b
Chapter titles that get split over multiple lines in the typeset
...
formats can't have whitespace after the last non-blank character (bug
in LaTeX?); fix up a couple of instances of this.
Update an email address.
2002-10-28 19:28:22 +00:00
7fbd01262c
Clarify packages in tutorial. Closes SF bug #616211 .
2002-10-26 03:13:57 +00:00
55803bca98
Describe __path__ along with the rest of the package description.
...
Closes SF bug #626554 .
2002-10-22 21:00:44 +00:00
36a4d8c20e
Remove mentionings of DOS.
2002-10-10 18:24:54 +00:00
44c42b9cf3
Added a tutorial note and example regarding the scope of loop variables
...
in a list comprehension. Includes a justification and a comparision
to regular for-loops.
Closes SF bug 605047.
2002-09-06 18:06:04 +00:00
a6e16a86c4
Replace all cases of "while 1" with "while True".
...
Though slightly slower, has better clarity and teaching value.
2002-08-21 04:54:00 +00:00
dd32a91cc0
This is my patch
...
[ 587993 ] SET_LINENO killer
Remove SET_LINENO. Tracing is now supported by inspecting co_lnotab.
Many sundry changes to document and adapt to this change.
2002-08-15 14:59:02 +00:00
5c08a99b77
Remove a broken example of extreme backward compatibility; it is
...
simply not relevant any more.
Closes SF bug #595032 .
2002-08-14 15:26:18 +00:00
ae7ef57cba
GvR pointed out that only enclosing function bodies are part of nested scopes.
2002-08-07 20:20:52 +00:00
861bb02448
Describe nested scopes in the tutorial. Closes SF bug 500704.
2002-08-07 16:09:48 +00:00
33fd5f7e02
Fix typo reported to python-docs.
2002-06-26 21:25:15 +00:00
07dc91800f
Close bug 480337: Dict used before dicts explained. Added explanation
...
and examples of the dict() constructor.
2002-06-25 15:13:18 +00:00
7951f60f45
Fix spacing in loop example
2002-06-25 03:17:03 +00:00
55ad7f84a4
Completely revise markup for the list of list methods; the new markup matches
...
the semantics and presentation used in the library reference.
Added an explanation of the use of [...] to denote optional arguments, since
this is the only use of this in a signature line.
Closes SF bug #567127 .
2002-06-11 02:56:17 +00:00
d68f5171eb
As discussed on python-dev, add a mechanism to indicate features
...
that are in the process of deprecation (PendingDeprecationWarning).
Docs could be improved.
2002-05-29 15:54:55 +00:00
e7bd876f9d
Message for NameError has changed
2002-05-02 14:31:55 +00:00
38f71973e5
Documentation for the enumerate() function/type.
...
This closes SF patch #547162 .
2002-04-26 20:29:44 +00:00
6cb64f9e46
"Shortcut" should be "short-circuit".
...
This closes SF bug #526277 .
2002-03-08 00:54:43 +00:00
c26467d53f
Revise cheeseshop example so that the order of the keyword output is
...
completely determined by the example; dict insertion order and the string
hash algorithm no longer affect the output.
This fixes SF bug #509281 .
2002-01-29 14:53:30 +00:00
23d45f4744
Fix up some examples in the tutorial so we don't contradict our own
...
advice on docstrings.
This fixes SF bug #495601 .
2001-12-20 23:54:56 +00:00
ecd8157a2c
Include a warning that scripts should not have the same name as standard
...
modules, or the module cannot be properly imported. (Based on a suggestion
sent to python-docs.)
Update the displayed dir() of the sys and __builtin__ module with Python 2.2.
2001-12-04 19:47:46 +00:00
6016dbecca
Talk about str() in the discussion of string representations of values, and
...
give examples for which str() and repr() yield different results.
This closes SF bug #485446 .
2001-12-04 19:20:43 +00:00
fcf94681ed
Update lambda description to reflect nested scopes. This was noted by
...
Andrew Koenig.
2001-12-03 21:47:37 +00:00
1da50f6c6e
Add a scalar product to the example list comprehensions based on a suggestion
...
sent to python-docs.
2001-12-03 18:54:33 +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
a815916472
Fix thinko in a comment about seeking with a file object.
...
Reported by Francesco Trentini.
2001-10-16 03:25:00 +00:00
13af42822c
Exceptions in interactive examlpes did not always include the indication of
...
the source file using "in ?".
Added a description of the bare "raise" statement.
Added more description and examples for user-defined exceptions; this
is part of a response to SF bug #443559 .
2001-09-21 21:10:05 +00:00
ba5c41d4c5
Clarified the interaction between string literals and continuation lines.
...
Fixes bug reported as SF bug #453728 .
2001-09-06 18:41:15 +00:00
8b09f4985c
Make the examples for "Default Argument Values" more presentable and
...
less hostile to newbie use at the interactive prompt.
This is in response to SF bug #458654 .
2001-09-06 18:21:30 +00:00
d3ba10f4b5
Clarify the prompt in an example.
...
This closes SF bug #450633 .
2001-08-14 19:55:42 +00:00
20c94913de
Minor re-wording in the exaplantion of sequence comparisons.
...
This closes SF bug #445749 .
2001-08-01 17:17:13 +00:00
01815526e0
Add a more substantial example startup file for the interactive shell;
...
sample startup script provided by Itamar Shtull-Trauring.
This closes SF patch #410890 .
Add some logical markup where it was missing.
2001-07-18 19:21:12 +00:00
17f690f96b
Minor changes to match the style guide.
2001-07-14 02:14:42 +00:00
ed51494666
Fix up a few style nits -- avoid "e.g." and "i.e." -- these make
...
translation more difficult, as well as reading the English more
difficult for non-native speakers.
2001-07-06 17:28:39 +00:00
88e66254f9
Use the more conventional "self" as the name of the self parameter in an
...
example. It actually confused a reader.
2001-06-29 17:50:57 +00:00
d5df09cfb6
Update to include the license information in a less annoying place.
2001-06-20 21:37:34 +00:00
fa9e273442
Clarification in the fp appendix suggested on c.l.py by Michael Chermside.
...
Also replaced a *star* style emphasis in the Representation Error section
with an \emph{} thingie.
2001-06-17 21:57:17 +00:00
7bc50714fe
Fix the attributions for the new floating point text.
2001-06-08 17:09:01 +00:00
8c27d99941
Added credits in the right places.
2001-06-08 16:28:53 +00:00
417d667dd9
Text from Tim & Guido discussing floating point arithmetic and what users
...
need to understand about the binary & decimal fp, so that representation
weirdness is documented somewhere. This makes it easier to repond to "bug"
reports caused by user confusion & ignorance of the issues.
This closes SF patch #426208 .
2001-06-08 16:24:58 +00:00
bd695a716d
Changed all the examples with ugly platform-dependent float output to use
...
numbers that display nicely after repr(). From much doctest experience
with the same trick, I believe people find examples with simple fractions
easier to understand too: they can usually check the results in their
head, and so feel confident about what they're seeing. Not even I get a
warm feeling from a result that looks like 70330.345024097141 ...
2001-05-22 06:54:14 +00:00
8b0b8409ae
Update output to reflect additional precision produced by the repr() of
...
floating point numbers in an interactive example.
Added comment to help explain control flow in the example code showing
how to check if a number is prime.
This closes SF bugs 419434 and 424552.
2001-05-21 16:55:39 +00:00
9188b2194a
Correct two floating-point representations printed by the interpreter in
...
interactive examples. Error noted by Dinu Gherman.
2001-04-25 21:03:20 +00:00
0c14961872
Update to reflect the new string repr -- \n instead of \012. This is the
...
only documentation file that appears to be affected by the change!
2001-04-12 04:26:24 +00:00
5d6e402e0c
Based on a comment by Konrad Hinsen on python-list:
...
Change "EOF" to "end-of-file", on the premise that it is easier for
new programmers to understand (at least a little).
This does not attempt to explain "file or device attached to standard
input."
2001-04-11 04:38:34 +00:00
979d041b6f
Make reference to the Library Reference in the "What Now?" chapter a
...
hyperlink.
Fix two English usage errors caught by Jan Wells: Changed "subsequence"
to "sub-sequence" in two places, and avoid improper use of "hopefully" in
the first paragraph of the "What Now?" chapter.
2001-04-03 17:41:56 +00:00
1b0b2a4df2
Add some LaTeX magic so that Latin-1 characters do not get so badly
...
trashed.
2001-03-13 17:56:08 +00:00
67fdaa4883
Correct typos in Ping's email address.
...
Remove premature use of negative indexes in string operation examples;
negative indexes have not been explained at that point, and the use of
negative indexes are not necessary for the examples.
2001-03-06 07:19:34 +00:00
162c6a637a
Reflect change in traceback format:
...
"innermost last" --> "most recent call last"
2001-02-14 03:20:18 +00:00
5401996638
Update to properly explain that the default Unicode encoding is ASCII, &c.
2001-02-13 22:20:22 +00:00
fa004ad36c
Show '\011', '\012', and '\015' as '\t', '\n', '\r' in strings.
...
Switch from octal escapes to hex escapes for other nonprintable characters.
2001-01-24 17:19:08 +00:00
0fe5af9b4d
Clarify comments about returning None using a return without an expression;
...
this is not hard to explain!
Closes SF bug #129345 .
2001-01-19 22:34:59 +00:00
cc97f8c609
Fix up an awkward sentence, pointed out by Chris Ryland <cpr@emsoftware.com>.
2001-01-01 20:33:06 +00:00
4a6f1df48c
Fix broken backslashes in Unicode strings section.
...
This closes bug #123730 .
2000-11-29 06:03:45 +00:00
657ebef2ae
Partial fix for SF bug 123730: extra backslash in tutorial.
2000-11-29 05:51:59 +00:00
c113465a49
SF non-bug 123520: fleshed out the tutorial's lambda example a little more.
2000-11-27 06:38:04 +00:00
0ac000cd54
Updates to reflect pending changes to the XML conversion process.
2000-11-22 16:42:37 +00:00
bce920129c
Typo: shorted --> shorter
...
This closes bug #117706 .
2000-10-25 23:22:54 +00:00
860106ae90
Update the display of some floating point values at the interactive prompt
...
to reflect current behavior.
This closes SourceForge bug #117305 .
Made a reference to the library reference a hyperlink.
Fixed some minor markup nits.
2000-10-20 03:03:18 +00:00
31b761e326
Spelling: internalization --> internationalization
...
Fixed displays of the interactive prompt in running text.
These close SourceForge bug #115658 .
Also:
Updated discussion of tuple unpacking to reflect the general ability
to unpack any sequence type. Explained that it is possible to create
tuples which contain mutable values, and noted in the dictionary
section that such tuples cannot be used as keys.
Noted that .pyc and .pyo files can be run directly when provided as
the script parameter to the interpreter, and slightly clarified
comments about using modules with only the byte compiled code.
Removed some XXX comments that are no longer relevant.
Removed commented-out paragraph about __private names being experimental.
Adjusted markup for consistency in some places.
2000-09-29 15:17:36 +00:00
343ad7a572
Correct some bitrot; some things have become inaccurate in the tutorial.
...
<file>.readlines() does not call <file>.readline() internally anymore,
and the sizehint parameter should be mentioned briefly.
Some displays of floating point numbers needed to be updated due to the
change in the repr() of floats (from 1.6).
Both issues were noted by Aahz <aahz@panix.com>.
2000-09-22 04:12:27 +00:00
Raymond Hettinger
Neal Norwitz
Martin v. Löwis
Fred Drake
Skip Montanaro
Neil Schemenauer
Alex Martelli
Guido van Rossum
Michael W. Hudson
Andrew M. Kuchling
Tim Peters
Ka-Ping Yee