Commit graph

5904 commits

Author SHA1 Message Date
Fred Drake
2884d6de15 Fix a variety of small markup nits. 2003-07-02 12:27:43 +00:00
Fred Drake
3ede7848a9 - note that super() only applies to new-style classes;
closes SF bug #764003
- fix markup for consistency
2003-07-01 16:31:26 +00:00
Fred Drake
901a41e757 normalize markup for consistency 2003-07-01 16:17:50 +00:00
Tim Peters
93ceaea01f showwarning() calls formatwarning(), not showwarning().
Bugfix candidate.
2003-07-01 14:37:59 +00:00
Raymond Hettinger
9c8f78deab Improve the wording a bit 2003-07-01 07:19:17 +00:00
Raymond Hettinger
69d6356eb9 Fix spelling, grammar, usage, and markup. 2003-07-01 06:29:18 +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
Brett Cannon
20def8bb19 Make temporary change of using _strptime for time.strptime permanent.
Flesh out docs to better explain time.strptime (closes bug #697990).
2003-07-01 05:16:08 +00:00
Neal Norwitz
ecc7171007 Add versionadded info for the 2 new threading module functions 2003-06-30 21:47:47 +00:00
Thomas Heller
675580f4fc Document the DISTUTILS_DEBUG variable.
Closes sf #761401.

Backport candidate.
2003-06-30 19:33:29 +00:00
Fred Drake
220e83946d We are now post-beta 2. 2003-06-30 13:38:38 +00:00
Fred Drake
f647b63624 Added missing name (textwrap.dedent() docs). 2003-06-30 12:18:52 +00:00
Raymond Hettinger
ccd615c1a7 SF bug #762990: Awful Grammar in Python Tutorial
Fixed a nit.
2003-06-30 04:27:31 +00:00
Fred Drake
5728815e7b Fix broken markup, & tweak a couple of things for consistency. 2003-06-29 18:12:23 +00:00
Jeremy Hylton
bfccb35b58 Add settrace() and setprofile() functions to the threading library. 2003-06-29 16:58:41 +00:00
Fred Drake
85d27576a3 Update copyright years. 2003-06-29 16:55:47 +00:00
Skip Montanaro
32a5e878d7 minor wordsmithing 2003-06-29 16:01:51 +00:00
Raymond Hettinger
be2528d866 SF patch #760257: add socket.timeout exception
(Contributed by Bob Halley)

Add documentation for the new socket.timeout exception.
2003-06-29 04:55:59 +00:00
Raymond Hettinger
5918f8de67 Minor fixes to punctuation and grammar. 2003-06-29 04:53:23 +00:00
Fred Drake
3e2244c9e1 Bump version information for Python 2.3 beta 2. 2003-06-29 02:17:28 +00:00
Fred Drake
6595e15331 Document PyThreadState_SetAsyncExc(). 2003-06-29 02:14:31 +00:00
Barry Warsaw
6891cd3aa3 A few minor improvements 2003-06-28 15:22:16 +00:00
Jim Fulton
6c71091fbe Rewrote the docs for supporting cyclic garbage collection to reflect
the new way that once writes types.

Deleted the old section and sample code and added a new section
building on the Noddy example.
2003-06-28 13:29:16 +00:00
Jim Fulton
9c3e957251 Updated the depenencies to reflect changes in the sample code for
building new types.
2003-06-28 13:27:57 +00:00
Jim Fulton
18a6be9748 Added tests for sample modules. 2003-06-28 11:54:40 +00:00
Jim Fulton
f0e38d1cd2 Added s setup module to make it easier to test the sample modules. 2003-06-28 11:54:20 +00:00
Jim Fulton
7050e929e6 Fixed bug in implementation of tp_init function. It should be an int
function, not a PyObject *.
2003-06-28 11:54:03 +00:00
Jim Fulton
4b59f9165d Changed the assignment of PyType_GenericNew to tp_new slot. Now do
this in module initialization before calling PyType_Ready.  (Sorry
Tim.) This is necessary to compile on cygwin.  AFAIK, we support
cygwin. If so, then we need to write extentions this way.
2003-06-28 11:53:29 +00:00
Jim Fulton
db6a569de7 Changed the assignment of PyType_GenericNew to tp_new slot. Now do
this in module initialization before calling PyType_Ready.  (Sorry
Tim.) This is necessary to compile on cygwin.  AFAIK, we support
cygwin. If so, then we need to write extentions this way.

Fixed bug in implementation of tp_init function. It should be an int
function, not a PyObject *.
2003-06-28 11:53:12 +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
Raymond Hettinger
3567a876c7 Add take() to examples. Tighten the islice() example 2003-06-28 05:44:36 +00:00
Fred Drake
5d2f515dd4 fix markup nits 2003-06-28 03:09:06 +00:00
Raymond Hettinger
6f3eaa67e5 SF patch #761519: Fixes for bugs 760703 and 757821
SF bug #760703: SocketHandler and LogRecord don't work well together
SF bug #757821: logging module docs

Applied Vinay Sajip's patch with a few minor fixups and a NEWS item.

Patched __init__.py - added new function
makeLogRecord (for bug report 760703).

Patched handlers.py - updated some docstrings and
deleted some old commented-out code.

Patched test_logging.py to make use of makeLogRecord.

Patched liblogging.tex to fill documentation gaps (both
760703 and bug 757821).
2003-06-27 21:43:39 +00:00
Tim Peters
6ebe61fa80 A hack to ease compatibility with pre-2.3 Pythons: by default, doctest
now accepts "True" when a test expects "1", and similarly for "False"
versus "0".  This is un-doctest-like, but on balance makes it much
more pleasant to write doctests that pass under 2.2 and 2.3.  I expect
it to go away again, when 2.2 is forgotten.  In the meantime, there's
a new doctest module constant that can be passed to a new optional
argument, if you want to turn this behavior off.

Note that this substitution is very simple-minded:  the expected and
actual outputs have to consist of single tokens.  No attempt is made,
e.g., to accept [True, False] when a test expects [1, 0].  This is a
simple hack for simple tests, and I intend to keep it that way.
2003-06-27 20:48:05 +00:00
Fred Drake
095f817330 Don't assume the name of the table of contents will be contents.html;
that won't be right when mkhowto is called with --numeric (as it is
for the Python Tutorial).  Save the actual name we use when we build
the table of contents, then use that in the page head metadata.  The
node2label.pl script will munge this properly when --numeric isn't
given, so this works in both cases.
Closes SF bug #761830.
2003-06-27 18:26:01 +00:00
Fred Drake
25b5358cf2 Add definitions of the test and testlist symbols in the grammar so
there are no gaps in the definitions.
Closes SF bug #726150.
2003-06-27 17:12:43 +00:00
Fred Drake
6ab8b40337 fix link-hovering so <a name='...'> (no href attribute) doesn't get
the hovering background
2003-06-27 16:32:27 +00:00
Raymond Hettinger
df9eff061e * Markup nits for the Invoking Descriptors section
* Documented __slots__
* Documented __metaclass__

Shamelessly plagarized from Guido's tutorial.
2003-06-27 06:57:56 +00:00
Raymond Hettinger
d0cda1dc9f SF patch #760792: "wo" in "word" now valid but not documented as such
Revised version of a contribution from Gerrit Holl.

Update the docs for the extended behavior of __contains__
2003-06-26 19:32:10 +00:00
Raymond Hettinger
daa340418b * Fixed an unmatched parenthesis early in the text.
* Clarified the meaning of lexicographic sequence ordering as discussed on
  comp.lang.python:  http://groups.google.com/groups?th=e163c9f9ba114493
2003-06-26 17:41:40 +00:00
Fred Drake
f91888bb46 markup consistency nits 2003-06-26 03:11:57 +00:00
Fred Drake
4db3661e24 remove _ from label: LaTeX rejects this due to all the magic we use to
get the _ character to format like a normal character
2003-06-26 03:11:20 +00:00
Raymond Hettinger
2b9bc08ee7 Removed useless intra-section references which jump to the top of the
section instead of the specific item being referenced.
2003-06-25 20:36:20 +00:00
Raymond Hettinger
2dd8c42638 SF bug #696777: How to make a class iterable using a member generator.
* Added a note that a container class can implement the iterator protocol
  by defining its __iter__() method as a generator.
2003-06-25 19:03:22 +00:00
Raymond Hettinger
03ec6d538a * Document how descriptors are invoked.
* Fix minor parenthesis matching errors in ref3.tex.
2003-06-25 18:29:36 +00:00
Raymond Hettinger
35fd926195 SF bug #757822: Additional index items, other minor details
* Minor grammatical fix.
2003-06-25 15:07:45 +00:00
Martin v. Löwis
9e9a7c3dd7 Patch #640236: Better eplain unused data. 2003-06-21 14:15:25 +00:00
Martin v. Löwis
171be76bdd Patch #755683: Document that there might be a maximum indentation limit.
Fixes #700827
2003-06-21 13:40:02 +00:00
Barry Warsaw
47db252786 Add some documentation which describes how to use the email package
instead of rfc822 as the Message factory.
2003-06-20 22:04:03 +00:00