Raymond Hettinger
081483cd42
Fix markup and nits.
2004-07-08 09:33:00 +00:00
Tim Peters
74979664d0
Typo repair.
2004-07-07 02:32:36 +00:00
Fred Drake
1b89656d70
add omitted markup
2004-07-01 14:26:31 +00:00
Raymond Hettinger
68a37ac841
* Fix typos.
...
* Format an example so that the identation is more obvious.
* Add a section on the decimal module to the Brief Tour Part II.
2004-07-01 12:56:54 +00:00
Raymond Hettinger
d348193ff2
Add genexps to the glossary.
2004-06-07 21:52:47 +00:00
Fred Drake
22ec5c3639
if we must argue over the/they, we can just remove the unecessary word
2004-06-03 17:19:25 +00:00
Raymond Hettinger
2d1a2aa117
Fix typo: the-->they
2004-06-03 14:13:04 +00:00
Raymond Hettinger
e148595504
Fixup spacing in an example.
2004-05-31 22:53:25 +00:00
Raymond Hettinger
4ccf336e56
Fill-in the introductory paragraph for the library tour.
2004-05-26 13:57:54 +00:00
Raymond Hettinger
846865bba6
Add a further tour of the standard library.
2004-05-26 13:52:59 +00:00
Raymond Hettinger
a8aebcedf9
Follow official recommendation for domain names in examples.
2004-05-25 16:08:28 +00:00
Raymond Hettinger
170a62221c
Add more docs for generator expressions.
...
* Put in a brief, example driven tutorial entry.
* Use better examples in whatsnew24.tex.
2004-05-19 19:45:19 +00:00
Martin v. Löwis
f1f0560832
Patch #940026 : Explain "in" when it is first used.
...
Backported to 2.3.
2004-05-06 01:35:45 +00:00
Andrew M. Kuchling
aeaec8d4aa
fix typo
2004-03-29 01:19:54 +00:00
Raymond Hettinger
f13c024002
Insert missing pronoun
2004-03-28 22:44:09 +00:00
Skip Montanaro
dbb407808a
- add entry for complex number
...
- fix a couple typos
- refine definitions for "interpreted" and "coercion" based upon updates on
the python glossary wiki
2004-03-27 18:23:11 +00:00
Raymond Hettinger
707483fdef
Update timeit example to reflect current performance.
2004-03-26 07:56:23 +00:00
Andrew M. Kuchling
cbddabfd85
Remove 'now'
2004-03-21 22:12:45 +00:00
Fred Drake
f0ae4272b4
fix English usage error reported by Ken Fuchs
2004-02-24 16:13:36 +00:00
Fred Drake
e6ed33a6b3
fix minor markup error: \code{for} --> \keyword{for}
2004-02-12 14:35:18 +00:00
Raymond Hettinger
b1e5b50531
SF 895560: minor typo
2004-02-12 09:50:42 +00:00
Fred Drake
42713109d9
use consistent email address for Tim
2003-12-30 16:15:35 +00:00
Raymond Hettinger
a95e87a488
Guido grants a Christmas wish:
...
sorted() becomes a regular function instead of a classmethod.
2003-12-17 21:38:26 +00:00
Raymond Hettinger
b7a10d1bc5
Incorporate suggestions from Aahz.
2003-12-06 20:12:00 +00:00
Raymond Hettinger
f62444ab16
Fix links and typos.
2003-12-05 07:53:50 +00:00
Raymond Hettinger
ec3402f287
Fix typo
2003-12-05 06:39:54 +00:00
Raymond Hettinger
8850c8785f
Fix link
2003-12-03 22:33:13 +00:00
Raymond Hettinger
8772d4e4c3
Add a standard library tour
2003-12-03 22:23:46 +00:00
Walter Dörwald
7bafa9f340
Fix typo. (From SF bug #853064 )
2003-12-03 10:34:57 +00:00
Raymond Hettinger
25695282a5
Convert a 0/1 to False/True.
2003-12-02 07:38:30 +00:00
Raymond Hettinger
d4462300db
Nits from a review of the documentation update.
2003-11-26 17:52:45 +00:00
Raymond Hettinger
65674b80fc
Documentation for set objects.
2003-11-18 17:50:34 +00:00
Raymond Hettinger
dc62aeca4c
Add a new looping idiom
2003-11-07 01:30:58 +00:00
Neal Norwitz
8ed69e3389
SF #829941 , update tutorial, built-in types can be base classes since 2.2
2003-10-25 14:15:54 +00:00
Raymond Hettinger
f12f32421f
Don't make promises about about the visibility of the induction variable.
2003-10-21 18:42:21 +00:00
Martin v. Löwis
95cf84a4f3
Patch #821093 : Fix various typos.
2003-10-19 07:32:24 +00:00
Fred Drake
984920bbad
Make the embedded hyperlinks work.
2003-09-28 19:03:36 +00:00
Raymond Hettinger
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
Fred Drake
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
Raymond Hettinger
5a25aa6c4a
Fix spelling and add markup.
2003-09-27 05:42:14 +00:00
Skip Montanaro
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
Skip Montanaro
757dedc1a3
first cut at a glossary
2003-09-24 16:51:23 +00:00
Raymond Hettinger
16434b5e25
Fix whitespace in example
2003-09-24 03:58:56 +00:00
Fred Drake
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
Fred Drake
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
Raymond Hettinger
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
Raymond Hettinger
c2a5cb2327
Fix typo.
...
Thou shalt not count to two unless proceeding to the number three.
2003-08-23 03:49:08 +00:00
Fred Drake
236ffba400
Adjust some horizontal indentation to be consistent with the style used
...
throughout the documentation.
2003-08-16 06:30:47 +00:00
Neil Schemenauer
90b182c16c
Don't introduce map(None, ...) in the tutorial. In practice, zip() is
...
usually preferred.
2003-08-14 22:57:46 +00:00
Raymond Hettinger
c7a26562f9
SF patch#786531 'the the' typo. Contributed by George Yoshida
2003-08-12 00:01:17 +00:00
Raymond Hettinger
0eec08794c
Explain argument unpacking
2003-08-08 23:32:46 +00:00
Raymond Hettinger
b233e54409
Nits.
2003-07-15 23:16:01 +00:00
Raymond Hettinger
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
Raymond Hettinger
fa6cce1fdd
Minor fixups and added sections for iterators and generators.
2003-07-11 18:58:11 +00:00
Fred Drake
dfda8d79ee
- explain about making Python scripts executable on Unix in more
...
detail
- fix minor markup nit
2003-07-07 21:00:29 +00:00
Raymond Hettinger
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
Raymond Hettinger
ccd615c1a7
SF bug #762990 : Awful Grammar in Python Tutorial
...
Fixed a nit.
2003-06-30 04:27:31 +00:00
Skip Montanaro
32a5e878d7
minor wordsmithing
2003-06-29 16:01:51 +00:00
Fred Drake
ded8e740df
Correct markup errors that prevented formatting.
2003-06-28 11:50:34 +00:00
Martin v. Löwis
7928f388c4
Explain source encodings. Fixes #683486 .
2003-06-28 08:11:55 +00:00
Fred Drake
2664cbbeba
Remove heading from orphan section.
2003-06-20 14:27:27 +00:00
Fred Drake
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
Fred Drake
6bab183d4e
Markup nits.
2003-05-20 15:28:58 +00:00
Raymond Hettinger
a02469f969
More message updates and minor fixes.
2003-05-07 17:49:36 +00:00
Raymond Hettinger
a2f84ceda5
Update traceback message
2003-05-07 17:11:15 +00:00
Skip Montanaro
45a9c93236
add missing parens - verified w/ interpreter - sorry to dismiss your comment
...
Fred
2003-05-07 16:01:43 +00:00
Skip Montanaro
b4f12424a5
replace most uses of `...` by repr(...), noting that `...` is discouraged,
...
but convenient in interactive sessions.
2003-05-07 15:29:12 +00:00
Fred Drake
03e929e7e0
Fix some markup nits.
2003-04-22 14:30:53 +00:00
Alex Martelli
a70b19147f
Adding new built-in function sum, with docs and tests.
2003-04-22 08:12:33 +00:00
Raymond Hettinger
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
Guido van Rossum
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
Fred Drake
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
Raymond Hettinger
7fbd01262c
Clarify packages in tutorial. Closes SF bug #616211 .
2002-10-26 03:13:57 +00:00
Fred Drake
55803bca98
Describe __path__ along with the rest of the package description.
...
Closes SF bug #626554 .
2002-10-22 21:00:44 +00:00
Martin v. Löwis
36a4d8c20e
Remove mentionings of DOS.
2002-10-10 18:24:54 +00:00
Raymond Hettinger
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
Raymond Hettinger
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
Michael W. Hudson
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
Fred Drake
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
Raymond Hettinger
ae7ef57cba
GvR pointed out that only enclosing function bodies are part of nested scopes.
2002-08-07 20:20:52 +00:00
Raymond Hettinger
861bb02448
Describe nested scopes in the tutorial. Closes SF bug 500704.
2002-08-07 16:09:48 +00:00
Fred Drake
33fd5f7e02
Fix typo reported to python-docs.
2002-06-26 21:25:15 +00:00
Raymond Hettinger
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
Raymond Hettinger
7951f60f45
Fix spacing in loop example
2002-06-25 03:17:03 +00:00
Fred Drake
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
Neal Norwitz
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
Andrew M. Kuchling
e7bd876f9d
Message for NameError has changed
2002-05-02 14:31:55 +00:00
Fred Drake
38f71973e5
Documentation for the enumerate() function/type.
...
This closes SF patch #547162 .
2002-04-26 20:29:44 +00:00
Fred Drake
6cb64f9e46
"Shortcut" should be "short-circuit".
...
This closes SF bug #526277 .
2002-03-08 00:54:43 +00:00
Fred Drake
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
Fred Drake
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
Fred Drake
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
Fred Drake
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
Fred Drake
fcf94681ed
Update lambda description to reflect nested scopes. This was noted by
...
Andrew Koenig.
2001-12-03 21:47:37 +00:00
Fred Drake
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
Fred Drake
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
Fred Drake
a815916472
Fix thinko in a comment about seeking with a file object.
...
Reported by Francesco Trentini.
2001-10-16 03:25:00 +00:00
Fred Drake
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
Fred Drake
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
Fred Drake
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