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
Neal Norwitz
3a03de4a27
SF #757229 , fix libsocket.tex typo
2003-06-20 17:11:39 +00:00
Fred Drake
2664cbbeba
Remove heading from orphan section.
2003-06-20 14:27:27 +00:00
Fred Drake
0799d0a9e3
Update link to Python book information.
2003-06-20 14:00:49 +00:00
Skip Montanaro
f5ed9819b0
Avoid using 'dir' as a variable name and use os.path.join() to create
...
paths.
2003-06-19 18:10:37 +00:00
Raymond Hettinger
befa37dd05
Minor updates:
...
* Updated comment on design of imap()
* Added untraversed object in izip() structure
* Replaced the pairwise() example with a more general window() example
2003-06-18 19:25:37 +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
Raymond Hettinger
b5155e30ce
Fix typo.
2003-06-18 01:58:31 +00:00
Raymond Hettinger
96a8233b64
SF patch #751038 fixing SF bug#750092: exec doesn't need newline
...
Patch contributed by Steven Taschuk.
2003-06-18 01:32:24 +00:00
Walter Dörwald
93719b56ed
Updated documentation for the new slice arguments for list.index().
2003-06-17 16:19:56 +00:00
Skip Montanaro
364ca40c2a
SF Patch 569574 - enhancements to cgitb for plain text display
2003-06-17 12:58:31 +00:00
Neal Norwitz
938b7a0f63
Fix some markup nits
2003-06-17 02:37:06 +00:00
Tim Peters
9ca3f02dc0
^D means EOF on Unix but not on Windows. Expand the example's prompt to
...
tell Windows Truth too.
Bugfix candidate.
2003-06-15 23:08:45 +00:00
Brett Cannon
9e6fedd2ec
Add explicit text for where an obindex call for generators was since obindex does not cause output of its argument.
2003-06-15 22:57:44 +00:00
Jack Jansen
097da0dc01
Documented the fact that the main class now mimicks the OSA "application" class.
2003-06-13 14:59:26 +00:00
Raymond Hettinger
7e902b27e0
* Added missing documentation for object().
...
* Noted the Py2.3 in the optional arg for bool().
2003-06-11 09:15:26 +00:00
Raymond Hettinger
3985df2c99
SF bug #660022 : parameters for int(), str(), etc.
...
* Indicate that arguments are optional for most builtin type constructors.
* Replace e.g. in staticmethod() and classmethod() docs.
* Add \code{} markup to some in-line code examples.
2003-06-11 08:16:06 +00:00
Raymond Hettinger
132fa373d1
Add docs for get_grouped_opcodes().
2003-06-11 07:50:44 +00:00
Raymond Hettinger
80b3f685b4
SF bug: 751941 Invisible HTML tag
...
Added missing jump target labels.
2003-06-10 21:41:22 +00:00
Barry Warsaw
9caa0d1642
guess_all_extensions(): Return the empty list instead of None when
...
there are no matching types. Updated the docs and docstrings. Added
some unit tests.
2003-06-09 22:27:41 +00:00
Raymond Hettinger
e07b83591f
Document context_diff() and unified_diff()
2003-06-09 21:44:59 +00:00
Neal Norwitz
305908cffd
SF #735051 , add time.tzset documentation
2003-06-08 13:57:19 +00:00
Gustavo Niemeyer
9556fba685
- urllib2.py now knows how to order proxy classes, so the user doesn't
...
have to insert it in front of other classes, nor do dirty tricks like
inserting a "dummy" HTTPHandler after a ProxyHandler when building an
opener with proxy support.
2003-06-07 17:53:08 +00:00
Raymond Hettinger
b268f03459
SF bug #749759 : comparisons yield bool not int
...
Minor documentation fix.
2003-06-06 02:52:14 +00:00
Skip Montanaro
a1045567e0
QUOTE_ALWAYS -> QUOTE_ALL
2003-06-04 15:30:13 +00:00
Martin v. Löwis
19a5a710fc
Patch #744238 : Explain that different string types also may compare equal.
2003-05-31 08:05:49 +00:00
Martin v. Löwis
7472336444
Patch #744877 : Explain filter in terms of list comprehension. Remove
...
explanation of int in terms of string.atoi. Explain sum in terms of
reduce.
2003-05-31 08:02:38 +00:00
Fred Drake
d691c42a38
Include both </tr> tags in the thead, not just the first.
2003-05-29 19:46:29 +00:00
Neal Norwitz
847207acff
SF bug #719367 , string exceptions are deprecated
...
Remove references to string based exceptions in the doc.
2003-05-29 02:17:23 +00:00
Neal Norwitz
d3d5768e5e
isdatadescriptor() was added recently.
2003-05-29 02:10:31 +00:00
Greg Ward
2748a4aa7e
Typo fix.
2003-05-29 01:41:51 +00:00
Greg Ward
fb1b5a164d
Rewrite the description of setparameters() so it actually reflects the
...
code (which has also been recently overhauled, so that it can be
documented without embarassment).
'error' has been renamed to 'OSSAudioError'.
Minor wordsmithing.
2003-05-29 01:39:32 +00:00
Gregory P. Smith
dad58601a0
Remove the note about the BerkeleyDB license. Barry indicates that
...
sleepycat has told him that since python is OSS and berkeleydb is
being distributed with python for the bsddb library all is fine.
2003-05-28 16:20:03 +00:00