Commit Graph

151 Commits

Author SHA1 Message Date
Fred Drake 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
Fred Drake 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
Fred Drake f64f8a0877 Fixed typo reported by Bennett Benson
<BennettBenson@mn.mediaone.net>.
1999-06-10 15:30:21 +00:00
Fred Drake 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
Fred Drake c0fcbc1ac6 Update starship URLs. 1999-04-29 02:30:04 +00:00
Fred Drake 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
Fred Drake 93aa0f23a7 Fixed latex2html weirdness with footnotes. 1999-04-05 21:39:17 +00:00
Fred Drake 4b1a07ae18 Fixed grammatical error reported by Donald Wallace Rouse II
<dwr2@ix.netcom.com>.
1999-03-12 18:21:32 +00:00
Fred Drake ee84d5972f Lots of nits to respond to various comments from users. 1999-03-10 17:25:30 +00:00
Guido van Rossum 6b86a42c7f Document -OO; "unsafe" optimization that removes docstrings.
Marc-Andre Lemburg.
1999-01-28 15:07:47 +00:00
Guido van Rossum 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
Fred Drake 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
Fred Drake f790b16d00 Change "for" explanation slightly based on comment passed along by
Blake Winton <BlakeW@pcdocs.com>.
1998-11-30 20:37:24 +00:00
Fred Drake db70d06464 Eliminate remaining \verb/.../ constructs; there's no need for them. 1998-11-17 21:59:04 +00:00
Guido van Rossum 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
Fred Drake 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
Guido van Rossum 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
Fred Drake 9f86b662d1 Update to use a separate page for front matter. 1998-07-28 21:55:19 +00:00
Guido van Rossum 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
Andrew M. Kuchling 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
Guido van Rossum 002f7aae08 Note that no .pyc/.pyo files are created for script files. 1998-06-28 19:16:38 +00:00
Guido van Rossum 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
Guido van Rossum 13c8ef62e6 Say a bit more about .pyc and .pyo files. 1998-05-29 19:12:23 +00:00
Fred Drake 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
Fred Drake c303e67f3c The built-in exceptions are not still strings, so make no claims about them. 1998-04-12 02:48:47 +00:00
Fred Drake e7957184d2 Change \sectcode to logical markup. 1998-04-04 07:17:47 +00:00
Fred Drake 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
Fred Drake 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
Fred Drake 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
Fred Drake 6c2176eea7 Added \label{}s for logical addressing. 1998-02-26 21:47:54 +00:00
Fred Drake 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
Fred Drake ed68854b40 "lists objects" --> "list objects" (Section "More on Lists".) 1998-02-11 22:29:17 +00:00
Fred Drake 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
Fred Drake ca6567fb3f Use \url{} to mark URLs. 1998-01-22 20:44:18 +00:00
Fred Drake 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
Fred Drake 4d4f9e726a Removed \mytableofcontents; just use \tableofcontents. 1998-01-13 22:25:02 +00:00
Fred Drake 3f20592c3e Consistency:
"Unix" ==> "\UNIX{}"

"C" ==> "\C{}"

"C++" ==> "\Cpp{}"
1998-01-13 18:56:38 +00:00
Fred Drake dca8792b52 Added openright option the the \documentclass{} for each of the manuals. 1998-01-13 16:53:23 +00:00
Fred Drake 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
Guido van Rossum 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
Fred Drake 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
Fred Drake 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
Guido van Rossum 0245569fd1 New version (interim) by AMK. 1997-07-17 16:21:52 +00:00
Fred Drake 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
Guido van Rossum 76e47f3d75 Change last Ellipses to Ellipsis :-( 1996-11-02 17:05:21 +00:00
Fred Drake 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
Guido van Rossum 3a26dd88af Done with the "New in 1.4" chapter. 1996-10-24 22:12:48 +00:00
Guido van Rossum 6a05f951cd Got rid of most XXXes in the News chapter. Bumped the version to 1.4. 1996-10-22 19:27:46 +00:00
Guido van Rossum 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
Guido van Rossum 97662c89fa Version number; started chapter on what's new in 1.4 1996-08-23 15:35:47 +00:00
Guido van Rossum 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
Guido van Rossum bf032a97b9 mention syslog upgrade 1995-10-11 19:28:39 +00:00
Guido van Rossum aa93ca834b mention Fred Drake's parser module 1995-10-11 17:47:45 +00:00
Guido van Rossum 288527a162 updated version and date 1995-10-09 21:02:17 +00:00
Guido van Rossum 691d4ec0bf a fe more things: apply 3rd arg, ni, ihooks, rexec 1995-10-08 01:14:57 +00:00
Guido van Rossum 9beefa2f85 describe more 1.3 changes 1995-10-08 00:38:51 +00:00
Guido van Rossum a67dee30bf move uncomfortable backslash 1995-09-13 17:34:25 +00:00
Guido van Rossum eafe32a639 chapter on new things in 1.3 1995-08-10 14:18:10 +00:00
Guido van Rossum abfa2cae9f added pointer to libimp.tex for __import__ example 1995-07-07 22:57:02 +00:00
Guido van Rossum 96628a90c4 typos, layout and other small things 1995-04-10 11:34:00 +00:00
Guido van Rossum 1133aec893 versions and dates 1995-03-15 11:34:18 +00:00
Guido van Rossum 47b4c0fb35 replace ASCII by macro call 1995-03-15 11:25:32 +00:00
Guido van Rossum 8675115e5f a few typographical changes (e.g. -- => ---) and lots of new stuff in the WWW chapter 1995-02-28 17:14:32 +00:00
Guido van Rossum bcc958259a no need to reference doc strings for documented modules 1995-02-16 16:28:48 +00:00
Guido van Rossum 194e57caa6 added chapter on new things in 1.2 1995-02-15 15:51:38 +00:00
Guido van Rossum e5f8b60429 spam -> foo (etc.) in examples 1995-01-04 19:12:49 +00:00
Guido van Rossum cfb45e476e typos 1994-11-10 23:04:43 +00:00
Guido van Rossum 94ed6f5f63 Oops! version numbers again! 1994-10-06 17:08:42 +00:00
Guido van Rossum 29766b2da6 Add simpler __getattr__ example and document __call__ 1994-10-06 15:33:25 +00:00
Guido van Rossum ca3f6c8c01 Removed description of class.init() method.
Added news about new operator overloading and __getattr__ etc.
1994-10-06 14:08:53 +00:00
Guido van Rossum 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
Guido van Rossum c1be9d59e4 * Doc/tut.tex (subsection{Lambda Forms}): fix typo in lambda
example
1994-08-30 12:08:58 +00:00
Guido van Rossum 16d6e7109d Lots of small corrections by Andrew Kuchling (plus all new rotor docs) 1994-08-08 12:30:22 +00:00
Guido van Rossum 6938f06047 Merge alpha100 branch back to main trunk 1994-08-01 12:22:53 +00:00
Guido van Rossum 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
Guido van Rossum 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
Guido van Rossum 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
Guido van Rossum 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
Guido van Rossum b2c6556fb0 Lots of small changes collected over months... 1993-05-12 08:53:36 +00:00
Guido van Rossum 95cd2ef162 Incorporated Jan-Hein's changes and texinfo conversion. 1992-12-08 14:37:55 +00:00
Guido van Rossum 7b3c8a1422 Added hint about changing the prompt in $PYTHONSTARTUP 1992-09-08 09:20:13 +00:00
Guido van Rossum 9a4e3fc56a Changed references to /usr/local into /usr/local/bin.
Documented $PYTHONSTARTUP
1992-09-03 21:27:55 +00:00
Guido van Rossum 084b0b2c16 Fixed botched lay-out in class example 1992-08-14 09:19:56 +00:00
Guido van Rossum da8c3fd979 Fixed descr of try/finally 1992-08-09 13:55:25 +00:00
Guido van Rossum 5e0759d351 Add chapter on classes (mostly from ../misc/CLASSES). 1992-08-07 16:06:24 +00:00
Guido van Rossum 379537805b Moved a4wide option to myformat.sty 1992-04-06 14:04:04 +00:00
Guido van Rossum d33024c451 Copied doc style from other docs 1992-04-05 15:06:12 +00:00
Guido van Rossum 573805afd6 _ can now be a normal character. 1992-03-06 10:56:03 +00:00
Guido van Rossum cdc9355367 Set parskip to 0 in the table of content. 1992-02-11 15:53:13 +00:00
Guido van Rossum a8d754e876 Cosmetic changes; added more subsections to chapter 2; new syntax (==). 1992-01-07 16:44:35 +00:00
Guido van Rossum 481ae68911 The Reference Manual is now official. 1991-11-25 17:28:03 +00:00
Guido van Rossum 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
Guido van Rossum 6fc178f46d Too much to describe changed... 1991-08-16 09:13:42 +00:00
Guido van Rossum dd0108081b Mention "-c command" option. 1991-06-07 14:31:11 +00:00
Guido van Rossum 4410c758a1 *** empty log message *** 1991-06-04 20:22:18 +00:00
Guido van Rossum 67fa160744 Minor improvements. Removed footnote about CWI pathnames. 1991-04-23 14:14:57 +00:00
Guido van Rossum 56098fa2d4 Use garamod as alternative style. 1991-02-19 12:54:06 +00:00
Guido van Rossum 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
Guido van Rossum 2292b8e98a Most silly things fixed. 1991-01-23 16:31:24 +00:00
Guido van Rossum 7d9f8d70b9 Small changes. Use description instead of list env. 1991-01-22 11:45:00 +00:00