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
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
1349437e4c
When referring to namespaces, always say "namespaces" instead of
...
"name spaces".
Inconsistency noted by Keith Briggs <keith.briggs@bt.com>.
2000-09-12 16:23:48 +00:00
46dfa5f4ed
require list comprehensions to start with a for clause
2000-08-22 02:43:07 +00:00
1aebadf0e5
Ka-Ping Yee <ping@lfw.org>:
...
Further examples of list comprehensions.
2000-08-16 21:44:03 +00:00
81f7eb6c6b
Fix some markup errors that prevented formatting, and one that didn't.
2000-08-12 20:08:04 +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
518e55c7f2
Rip out the information about the PSA, since the fate of that is not
...
certain.
Update the information about the mailing list, using the python.org
address instead of cwi.nl, and point to the pipermail archives. Also
update the daily average message count (at the risk of scaring people
off), using the mail archive at http://www.egroups.com/group/python-list
for the first half of 2000 for statistical information.
2000-07-27 20:55:12 +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
5443c49fbb
Markup improvements in sections relating to interactive behavior.
...
Clarify some of the details of readline-related configuration.
2000-07-08 05:18:54 +00:00
30f76ffd00
Update version numbering from 1.6 to 2.0.
2000-06-30 16:06:19 +00:00
e99d1dbc74
Clarify the description of the else clause for try/except, and add an
...
explanation of why you'd want to use it.
Based on a question from Michael Simcich <msimcich@accesstools.com>.
2000-04-17 14:56:31 +00:00
9dc30bb956
Marc-Andre Lemburg <mal@lemburg.com>:
...
Tutorial information about Unicode strings in Python, with some markup
adjustments from FLD.
2000-04-06 14:17:03 +00:00
69fbf33680
Fixed typo in example code; spotted by Everett Lipman
...
<lipman@sphere.niddk.nih.gov>.
2000-04-04 19:53:06 +00:00
20082d92f2
Merge in changes from the 1.5.2p2 release.
2000-04-03 04:26:58 +00:00
37f1574f2e
Use \citetitle and \programopt as appropriate.
1999-11-10 16:21:37 +00:00
0ba58158c5
Added "import string" to a couple of examples that describe string
...
module functions, to clarify that the import is not automatic.
Suggested by Koray Oner <Koray.Oner@Eng.Sun.COM>.
1999-09-14 18:00:49 +00:00
2900ff9382
Added paragraph explaining that except clauses can't be empty; that
...
pass can be used if needed. By Dan Wolfe <wolfeman@apple.com>.
1999-08-24 22:14:57 +00:00
f1ad207f2a
Made several grammatical corrections based on comments from Daniel
...
Barcla <danielb@digitalfocus.com>.
Also added example of what happens when a parameter is set both
positionally and by a keyword (one of Daniels suggestions related to
that paragraph).
1999-06-30 15:32:50 +00:00
f64f8a0877
Fixed typo reported by Bennett Benson
...
<BennettBenson@mn.mediaone.net>.
1999-06-10 15:30:21 +00:00
bdadf0f7f3
Explain comments at the start of chapter 3. This is needed since they
...
appear in the examples without any further explanation, and the
tutorial doesn't have this information explicit anywhere else.
Omission reported by Jon Black <jblack@Ridgeway-Sys.com>.
1999-04-29 13:20:25 +00:00
c0fcbc1ac6
Update starship URLs.
1999-04-29 02:30:04 +00:00
511281ac00
In list of sequence comparison examples, "=" should be "==". Reported
...
by Mirko Liss <n89553@hrz.uni-paderborn.de>.
1999-04-16 13:17:04 +00:00
93aa0f23a7
Fixed latex2html weirdness with footnotes.
1999-04-05 21:39:17 +00:00
4b1a07ae18
Fixed grammatical error reported by Donald Wallace Rouse II
...
<dwr2@ix.netcom.com>.
1999-03-12 18:21:32 +00:00
ee84d5972f
Lots of nits to respond to various comments from users.
1999-03-10 17:25:30 +00:00
6b86a42c7f
Document -OO; "unsafe" optimization that removes docstrings.
...
Marc-Andre Lemburg.
1999-01-28 15:07:47 +00:00
e51aa5b2cd
Minor clarifications by Sean Reifschneider:
...
- add example of string literal concatenation
- add clarifying comment to the example of the if statement
1999-01-06 23:14:14 +00:00
cc09e8dc82
Clarified what Python versions the interactivity chapter applies to,
...
and what it doesn't apply to.
1998-12-28 21:21:36 +00:00
f790b16d00
Change "for" explanation slightly based on comment passed along by
...
Blake Winton <BlakeW@pcdocs.com>.
1998-11-30 20:37:24 +00:00
db70d06464
Eliminate remaining \verb/.../ constructs; there's no need for them.
1998-11-17 21:59:04 +00:00
c62cf36e76
The last two example functions in the section about default argument
...
values (4.7.1) should return l, not a. Reported by Axel Boldt.
1998-10-24 13:15:28 +00:00
b7833d3c0c
Add a \label to the section "Fancier Output Formatting" (it's referenced from
...
the KOE docs).
Some markup nits.
1998-09-11 16:21:55 +00:00
aee5e26f4b
Add warning that mutable argument defaults are evaluated only once;
...
with examples and workaround. This keeps coming up, and I believe
that this section in the tutorial may have been (in part) the source
of the confusion. While it didn't show examples with [] for a default,
it also didn't emphasize enough why that would be a bad idea, and
while it did say that defaults are evaluated at the point of function
definition, the example was not relevant for this issue.
1998-08-07 17:45:09 +00:00
9f86b662d1
Update to use a separate page for front matter.
1998-07-28 21:55:19 +00:00
a4289a79f8
In the example iterating over sys.argv and opening each argument,
...
change it to iterate over sys.argv[1:]. Suggestion by Gerry Wiener.
1998-07-07 20:18:06 +00:00
108943c216
Added a section to the chapter on modules, describing the package system.
...
The text is almost completely from GvR's essay on packages; some
introductory paragraphs have been removed, and everything after the
'Details' section in the HTML has been dropped (seems too technical). A
paragraph has been added after the sample package layout stating that there
must be a file called__init__.py in a directory to make it a package.
1998-07-01 13:58:55 +00:00
002f7aae08
Note that no .pyc/.pyo files are created for script files.
1998-06-28 19:16:38 +00:00
a8a1b9bc65
There's no point in mentioning F6 as an alternate EOF on DOS -- it
...
doesn't work on modern Windows systems, and Control-Z works
everywhere.
1998-06-22 14:28:39 +00:00
13c8ef62e6
Say a bit more about .pyc and .pyo files.
1998-05-29 19:12:23 +00:00
7238988657
Fixed example to load the startup file from a script (didn't test for the
...
file's existance).
Removed some XXX comments about extension modules which support pickling.
Added text from AMK about the readline and rlcompleter modules.
Thanks, AMK!
1998-04-13 01:31:10 +00:00
c303e67f3c
The built-in exceptions are not still strings, so make no claims about them.
1998-04-12 02:48:47 +00:00
e7957184d2
Change \sectcode to logical markup.
1998-04-04 07:17:47 +00:00
a594bafde7
Normalized case rules in section headings.
...
Moved stuff from "Recent Additions to 1.1" to "More on Defining Functions".
This means there's now a short section on "Defining Functions" immediately
followed by a long section "More on Defining Functions."
1998-04-03 05:16:31 +00:00
391564f10f
Small markup nits, a few grammatical fixes, and a clarification of the binary
...
mode for files under MacOS.
Updated the traffic figure for c.l.p in the "What Now?" chapter; see comments.
1998-04-01 23:11:56 +00:00
6659c30b67
Convert LaTeX support to create a new class of documents. HTML generation
...
now requires LaTeX2HTML 98.1p1 or newer (& and is still in progress).
This means that doing things to change the formatting of the manuals (at the
"normal user" level, like A4 paper), can happen in just one place, rather
than in each document file.
1998-03-03 22:02:19 +00:00
6c2176eea7
Added \label{}s for logical addressing.
1998-02-26 21:47:54 +00:00
8842e867af
Remove \bcode / \ecode everywhere.
...
Make all the indentations in {verbatim} environments have column 0 of the
listing in column 0 of the file.
Remove pagenumbering / pagestyle cruft.
Use more logical and less physical markup.
1998-02-13 07:16:30 +00:00
ed68854b40
"lists objects" --> "list objects" (Section "More on Lists".)
1998-02-11 22:29:17 +00:00
8d486b1779
In the appendix, all sections were marked as subsections, and so had section
...
numbers "A.0.#". Fixed.
1998-02-11 22:12:18 +00:00
ca6567fb3f
Use \url{} to mark URLs.
1998-01-22 20:44:18 +00:00
af8a015c93
Consistency: "{\bf ...}" ==> "\strong{...}"
...
"{\em ...}" ==> "\emph{...}"
Not at all sure what to do with "{\rm ...}".
Leaving it for now.
1998-01-14 14:51:31 +00:00
4d4f9e726a
Removed \mytableofcontents; just use \tableofcontents.
1998-01-13 22:25:02 +00:00
3f20592c3e
Consistency:
...
"Unix" ==> "\UNIX{}"
"C" ==> "\C{}"
"C++" ==> "\Cpp{}"
1998-01-13 18:56:38 +00:00
dca8792b52
Added openright option the the \documentclass{} for each of the manuals.
1998-01-13 16:53:23 +00:00
1f8449af4e
Revise prologue and frontmatter to use latex2e (not in 2.09 compatibility
...
mode) and take advantage of changes in myformat.sty.
1998-01-09 05:36:43 +00:00
dccc298e3d
Took out some disclaiming text (even from the title!). Rewritten
...
abstract. Alas, I didn't get to do anything else before the release
:-(
1997-12-30 04:40:25 +00:00
eee08cdd54
Make examples consistently use 4-space indentation.
...
Use \file{} for file names.
Prefer \code{blat} and \emph{blat} to {\tt blat} and {\em blat}; this matches
current style in the Library Reference a bit better.
Made the example startup banner current. The version number should be
bumped before the next release.
1997-12-04 15:43:15 +00:00
9e63faaa66
Change Python-as-executable-script example to use "#! /usr/bin/env python"
...
since that's now the recommended way to do it.
In pickling discussion, change "code{pickle}" (not missing leading "\") to
"This" since the immediately preceeding sentence ended with the same text
(with the proper "\"). Fixes a formatting bug and an odd glitch in the
writing.
1997-10-15 14:37:24 +00:00
0245569fd1
New version (interim) by AMK.
1997-07-17 16:21:52 +00:00
6dc2aae3cd
(tut.tex): Normalized all uses of "UNIX" and "{\UNIX}" to use "\UNIX{}",
...
per usage needed for GNU info processing. Based on comments from
Tamito Kajiyama.
1996-12-13 21:56:03 +00:00
76e47f3d75
Change last Ellipses to Ellipsis :-(
1996-11-02 17:05:21 +00:00
fd255e433f
(tut.tex): Added matching \normalsize after \small font control command
...
(and the contents it was supposed to be affecting). The latest
LaTeX2HTML handles these, but didn't close it as expected. This
handles that problem and does not affect the PostScript output.
1996-10-29 15:50:05 +00:00
3a26dd88af
Done with the "New in 1.4" chapter.
1996-10-24 22:12:48 +00:00
6a05f951cd
Got rid of most XXXes in the News chapter. Bumped the version to 1.4.
1996-10-22 19:27:46 +00:00
58124880cc
A first stab at describing what's new in 1.4. Still many XXX'es left.
...
Also would like to add an "author's note" at the beginning, basically
pointing everyone to the books.
1996-10-08 17:29:56 +00:00
97662c89fa
Version number; started chapter on what's new in 1.4
1996-08-23 15:35:47 +00:00
34e1777807
Note that EOF is ^Z on DOS. Spell Unix as \UNIX in some more places.
...
Note that .pyc files are platform independent.
1996-06-10 19:44:49 +00:00
bf032a97b9
mention syslog upgrade
1995-10-11 19:28:39 +00:00
aa93ca834b
mention Fred Drake's parser module
1995-10-11 17:47:45 +00:00
288527a162
updated version and date
1995-10-09 21:02:17 +00:00
691d4ec0bf
a fe more things: apply 3rd arg, ni, ihooks, rexec
1995-10-08 01:14:57 +00:00
9beefa2f85
describe more 1.3 changes
1995-10-08 00:38:51 +00:00
a67dee30bf
move uncomfortable backslash
1995-09-13 17:34:25 +00:00
eafe32a639
chapter on new things in 1.3
1995-08-10 14:18:10 +00:00
abfa2cae9f
added pointer to libimp.tex for __import__ example
1995-07-07 22:57:02 +00:00
96628a90c4
typos, layout and other small things
1995-04-10 11:34:00 +00:00
1133aec893
versions and dates
1995-03-15 11:34:18 +00:00
47b4c0fb35
replace ASCII by macro call
1995-03-15 11:25:32 +00:00
8675115e5f
a few typographical changes (e.g. -- => ---) and lots of new stuff in the WWW chapter
1995-02-28 17:14:32 +00:00
bcc958259a
no need to reference doc strings for documented modules
1995-02-16 16:28:48 +00:00
194e57caa6
added chapter on new things in 1.2
1995-02-15 15:51:38 +00:00
e5f8b60429
spam -> foo (etc.) in examples
1995-01-04 19:12:49 +00:00
cfb45e476e
typos
1994-11-10 23:04:43 +00:00
94ed6f5f63
Oops! version numbers again!
1994-10-06 17:08:42 +00:00
29766b2da6
Add simpler __getattr__ example and document __call__
1994-10-06 15:33:25 +00:00
ca3f6c8c01
Removed description of class.init() method.
...
Added news about new operator overloading and __getattr__ etc.
1994-10-06 14:08:53 +00:00
16cd7f9f12
Moved author and date to boilerplate.tex.
...
Added copyright.tex to all files.
Added descr of check_interval to libsys.tex.
Corrected lotsa typos in tut.tex (thanks to George M. Sipe).
Corrected mktuple (should be newtupleobject) example in ext.tex.
1994-10-06 10:29:26 +00:00
c1be9d59e4
* Doc/tut.tex (subsection{Lambda Forms}): fix typo in lambda
...
example
1994-08-30 12:08:58 +00:00
16d6e7109d
Lots of small corrections by Andrew Kuchling (plus all new rotor docs)
1994-08-08 12:30:22 +00:00
6938f06047
Merge alpha100 branch back to main trunk
1994-08-01 12:22:53 +00:00
3cbc16d904
* lib2.tex (sys): updated sys.std{in,out,err} docs. Added
...
sys.tracebacklimit.
* tut.tex (Exceptions): change text printed by traceback.
* lib5.tex (audioop): added minmax.
* lib5.tex (audioop.getsample): move wandered paragraph back
* lib3.tex, partparse.py: undo mucking with \nopagebreak (didn't work).
* partparse.py: ignore \nopagebreak command
* ref5.tex: added description of lambda forms.
* ref7.tex: added reference to lambda forms to section on function
definition.
* lib1.tex: removed lambda as built-in function (it is now a special
form). Also removed feature of filter, map, reduce to turn a string
argument into an anonymous function.
1993-12-17 12:13:53 +00:00
83eb962528
* {lib,ref,ext,tut}.tex: added explicit \date{<date> \\ <release>}.
...
* lib2.tex: change bogus \\var to \var.
1993-11-23 16:28:45 +00:00
db65a6ce55
* ext.tex: did most of the tedious changes from plain ASCII text to LaTeX.
...
* text2latex.py: automatically put function names in \code{}.
* lib.tex, ref.tex, ext.tex, qua.tex, tut.tex: use new P.O.Box number in
address.
1993-11-05 17:11:16 +00:00
4bd023f882
* lib3.tex (module string): added rindex().
...
* lib1.tex (section{Built-in Functions}): added bagof(), lambda(), map()
and reduce(). Repharased apply(). Removed or rephrased references to
exec() (now the exec stmt).
* lib4.tex: posix.exec --> posix.execv
* ref4.tex, ref8.tex, tut.tex: builtin --> __builtin__
* lib3.tex (module string): added atof() and atol(), and ato[fl]_error.
1993-10-27 13:49:20 +00:00
b2c6556fb0
Lots of small changes collected over months...
1993-05-12 08:53:36 +00:00
95cd2ef162
Incorporated Jan-Hein's changes and texinfo conversion.
1992-12-08 14:37:55 +00:00
7b3c8a1422
Added hint about changing the prompt in $PYTHONSTARTUP
1992-09-08 09:20:13 +00:00
9a4e3fc56a
Changed references to /usr/local into /usr/local/bin.
...
Documented $PYTHONSTARTUP
1992-09-03 21:27:55 +00:00
084b0b2c16
Fixed botched lay-out in class example
1992-08-14 09:19:56 +00:00
da8c3fd979
Fixed descr of try/finally
1992-08-09 13:55:25 +00:00
5e0759d351
Add chapter on classes (mostly from ../misc/CLASSES).
1992-08-07 16:06:24 +00:00
379537805b
Moved a4wide option to myformat.sty
1992-04-06 14:04:04 +00:00
d33024c451
Copied doc style from other docs
1992-04-05 15:06:12 +00:00
573805afd6
_ can now be a normal character.
1992-03-06 10:56:03 +00:00
cdc9355367
Set parskip to 0 in the table of content.
1992-02-11 15:53:13 +00:00
a8d754e876
Cosmetic changes; added more subsections to chapter 2; new syntax (==).
1992-01-07 16:44:35 +00:00
481ae68911
The Reference Manual is now official.
1991-11-25 17:28:03 +00:00
8f96f7734c
Fixed dictionary example to use commas instead of semicolons.
...
(This was actually a bug in the interpreter!)
1991-11-12 15:45:03 +00:00
6fc178f46d
Too much to describe changed...
1991-08-16 09:13:42 +00:00
dd0108081b
Mention "-c command" option.
1991-06-07 14:31:11 +00:00
4410c758a1
*** empty log message ***
1991-06-04 20:22:18 +00:00
67fa160744
Minor improvements. Removed footnote about CWI pathnames.
1991-04-23 14:14:57 +00:00
56098fa2d4
Use garamod as alternative style.
1991-02-19 12:54:06 +00:00
5ce78f11fc
Changed code environment into \bcode and \ecode macros.
...
Small lay-out improvements.
Took out a ref or two to "python -s".
1991-01-25 13:27:18 +00:00
2292b8e98a
Most silly things fixed.
1991-01-23 16:31:24 +00:00
7d9f8d70b9
Small changes. Use description instead of list env.
1991-01-22 11:45:00 +00:00
d9bf55d0d0
Initial revision
1991-01-11 16:35:08 +00:00
Fred Drake
Ka-Ping Yee
Tim Peters
Skip Montanaro
Thomas Wouters
Guido van Rossum
Andrew M. Kuchling