1f89e2abcc
Fix markup error that suppressed space.
...
Closes SF bug #554257 . Not relevant to older releases.
2002-05-10 12:37:56 +00:00
d05c74f42d
Add a note explaining the interaction between unbuffered input and
...
xreadlines.xreadlines().
This closes SF patch #552804 .
2002-05-06 16:02:42 +00:00
b9032018ff
Update the xrange object description to reflect the removal of deprecated
...
features.
2002-05-02 21:37:23 +00:00
4d707a5d08
Remove extra period produced by previous change.
2002-05-02 17:54:18 +00:00
4b270518b7
Correct information on support for repietition & concatenation for buffer
...
and xrange objects.
This closes SF bug #550555 .
2002-05-02 05:56:04 +00:00
7f781c9aab
Add Pickler.clear_memo() so the pickle and cPickle modules are more similar.
2002-05-01 20:33:53 +00:00
a65375c3e3
Explain what os.read() returns at end of file.
...
This closes SF bug #550409 . Applying to release21-maint & release22-maint.
2002-05-01 03:31:42 +00:00
7938fab285
Add missing right-parenthesis.
2002-05-01 03:23:03 +00:00
52cc670711
Add a note about when the "%r" formatting code was added.
2002-04-30 14:54:47 +00:00
81b9251d59
Mostly in SequenceMatcher.{__chain_b, find_longest_match}:
...
This now does a dynamic analysis of which elements are so frequently
repeated as to constitute noise. The primary benefit is an enormous
speedup in find_longest_match, as the innermost loop can have factors
of 100s less potential matches to worry about, in cases where the
sequences have many duplicate elements. In effect, this zooms in on
sequences of non-ubiquitous elements now.
While I like what I've seen of the effects so far, I still consider
this experimental. Please give it a try!
2002-04-29 01:37:32 +00:00
d3e6678713
Slightly expand and clarify the differences between getegid(), getgid(),
...
getpgrp(), and setpgid().
This closes SF bug #547939 .
2002-04-26 20:59:40 +00:00
a7bb2b9b30
Be more consistent, both internally and with recommended practice.
...
This closes SF bug #547953 .
2002-04-26 20:44:14 +00:00
38f71973e5
Documentation for the enumerate() function/type.
...
This closes SF patch #547162 .
2002-04-26 20:29:44 +00:00
99d17006c1
Add text about circular references caused by storing frames in local
...
variables. This closes SF bug #543148 .
2002-04-23 21:21:20 +00:00
106c1a0e7a
WCOREDUMP(), WIFCONTINUED(), WCONTINUED, WUNTRACED: New.
...
isatty(), WIFEXITED(), WIFSIGNALED(), WIFSTOPPED(): Changed to return
bools instead of ints.
2002-04-23 15:58:02 +00:00
8388895fe4
SF patch [ 545523 ] patch for 514433 bsddb.dbopen (NULL)
...
closes SF #514433
can now pass 'None' as the filename for the bsddb.*open functions,
and you'll get an in-memory temporary store.
docs are ripped out of the bsddb dbopen man page. Fred may want to
clean them up.
Considering this for 2.2, but not 2.1.
2002-04-23 02:11:05 +00:00
de02bcb265
Apply patch diff.txt from SF feature request
...
http://www.python.org/sf/444708
This adds the optional argument for str.strip
to unicode.strip too and makes it possible
to call str.strip with a unicode argument
and unicode.strip with a str argument.
2002-04-22 17:42:37 +00:00
b02ea65f92
typo
2002-04-17 19:33:06 +00:00
933f159a2f
Add a version annotation for the help() function.
2002-04-17 12:54:04 +00:00
6c7bc31089
added small clarification to the descriptions of encode() and decode()
2002-04-16 15:12:10 +00:00
e19a5bcc7b
Be consistent in presenting the signatures.
2002-04-15 19:46:40 +00:00
154985587b
Add docs for os.fchdir().
2002-04-15 19:41:27 +00:00
068325ef92
Apply the second version of SF patch http://www.python.org/sf/536241
...
Add a method zfill to str, unicode and UserString and change
Lib/string.py accordingly.
This activates the zfill version in unicodeobject.c that was
commented out and implements the same in stringobject.c. It also
adds the test for unicode support in Lib/string.py back in and
uses repr() instead() of str() (as it was before Lib/string.py 1.62)
2002-04-15 13:36:47 +00:00
06a83e90aa
Patch #543447 : Add posix.mknod.
2002-04-14 10:19:44 +00:00
8b1c47bb8b
Document the optional argument to the .strip(), .rstrip(), .strip() string
...
methods.
Part of SF feature #444708 .
2002-04-13 02:43:39 +00:00
d4c0e5fd5b
BDFL agreed with Tim: rehabilitate randint().
2002-04-12 20:01:47 +00:00
e027d9818f
Add Raymond Hettinger's d.pop(). See SF patch 539949.
2002-04-12 15:11:59 +00:00
81bdc93d2f
Explain octal escapes. Fixes #542226 .
2002-04-11 12:24:12 +00:00
2854c478be
Remove mention of 'pre' module
...
(2.2 bugfix candidate?)
2002-04-10 21:28:31 +00:00
3b2625ff82
document all the valid encoding values
2002-04-10 04:37:09 +00:00
6b35370c65
Update docs for bool changes by Guido around April 6
2002-04-09 18:15:00 +00:00
688357e035
Patch #512005 : getrusage() returns struct-like object.
2002-04-08 21:28:20 +00:00
bc82ab1c9f
Do not call "knee" a standard module, and point to the new location.
...
This addresses the issue in SF bug #515745 .
2002-04-08 05:22:30 +00:00
d3dab2b192
Update doc to reflect Tim's changes to bool.
2002-04-05 02:21:09 +00:00
a2c2595024
Add a version annotation regarding the urlopen(proxies={...}).
2002-04-04 20:58:02 +00:00
5ca3a08cc0
The rest of the documentation for manual proxy configuration for a basic
...
urlopen().
This is part of SF patch #523415 .
2002-04-04 20:34:36 +00:00
d21670328c
Documentation for manual proxy configuration, by Andy Gimblett.
...
This closes SF patch #523415 .
2002-04-04 20:09:50 +00:00
ce5df49957
SF 539024, Fix broken link to numpy
2002-04-04 14:02:45 +00:00
77f6a65eb0
Add the 'bool' type and its values 'False' and 'True', as described in
...
PEP 285. Everything described in the PEP is here, and there is even
some documentation. I had to fix 12 unit tests; all but one of these
were printing Boolean outcomes that changed from 0/1 to False/True.
(The exception is test_unicode.py, which did a type(x) == type(y)
style comparison. I could've fixed that with a single line using
issubtype(x, type(y)), but instead chose to be explicit about those
places where a bool is expected.
Still to do: perhaps more documentation; change standard library
modules to return False/True from predicates.
2002-04-03 22:41:51 +00:00
aee113d368
Add an experimental mechanism to support extending the pprint formatting.
...
Partly responds to SF bug #505152 .
2002-04-02 05:08:35 +00:00
4dfb7a81c1
Explain that os.spawn*() return the process handle on Windows.
...
Clarify that os.waitpid() on Windows takes a process handle, not a process ID.
This closes SF bug #537582 .
2002-04-01 23:30:47 +00:00
d5a072f2eb
Fix up the documentation of the type codes to give both the C and Python
...
types for each code, and give the actual C types.
Clarified the support for slice operations and note when some TypeError
exceptions are raised.
This closes SF bugs 518767 and 536469.
2002-04-01 23:05:10 +00:00
8d62e94761
Minor wording change.
2002-03-28 21:06:17 +00:00
bb6bbc45c0
add exception class hierarchy. This should probably be done differently,
...
but at least the content is there.
2002-03-28 20:53:22 +00:00
47cdf6fb6f
Add documentation on the hasfree data object.
2002-03-28 19:34:53 +00:00
e3a3ceb2b1
Minor consistency adjustments.
2002-03-28 12:40:45 +00:00
2e64c34850
Expose C library's gettext. Fixes #516412 .
2002-03-27 18:49:02 +00:00
8a79727b53
add seealso referring to site module doc where people can learn how to
...
extend sys.path using .pth files.
2002-03-27 17:29:50 +00:00
57f8e06e4f
Document the finditer() function and method.
...
This closes SF bug #520904 .
Explain that many of the escapes supported by string literals are also
supported by the RE compiler, and list which ones.
This closes SF bug #529923 .
2002-03-25 20:22:59 +00:00
3787c9d94c
Added description of binhex.Error.
2002-03-25 16:37:56 +00:00
1e962cb61b
document InvalidURL exception
2002-03-24 16:55:57 +00:00
ccbb0edf0e
Add local_hostname to SMTP.__init__().
2002-03-24 15:41:40 +00:00
79f181395b
Add more example exceptions that unpickling can raise.
2002-03-22 22:16:03 +00:00
e22d3dfcc1
Fix grammar
2002-03-21 12:58:54 +00:00
b25c2b0a4a
[Apply SF patch #504943 ]
...
This patch makes it possible to pass Warning instances as the first
argument to warnings.warn. In this case the category argument
will be ignored. The message text used will be str(warninginstance).
2002-03-21 10:38:40 +00:00
1abca4a515
SF# 522426, add doc for common parameter for filecmp.cmpfiles()
2002-03-20 18:55:09 +00:00
1268678395
Adjust some poor wording in the text that explains what events are used
...
for (reported by Keith Briggs).
Wrap some very long lines.
2002-03-19 14:37:44 +00:00
2f31d561d5
Clarify that copy_reg.pickle() is not intended for use with "classic" classes.
...
This was stated before, but a minor grammatical error made it difficult to be
sure of the meaning.
This closes SF bug #530143 .
2002-03-19 03:33:33 +00:00
a8b663806b
Remove extra verb; reported by Detlef Lannert.
2002-03-18 16:45:01 +00:00
5c137c2251
Patch #495598 : add an -q (quiet) option to pycompile.
2002-03-18 12:44:08 +00:00
10acc8f9e2
added note that xmlrpclib won't marshal instances of subclasses of the
...
builtin types
2002-03-17 23:15:02 +00:00
587c98c863
Patch #430706 : Persistent connections in BaseHTTPServer.
2002-03-17 18:37:22 +00:00
8e0c82a35f
Fix stupid typo in example.
2002-03-16 14:01:12 +00:00
f275803fe9
Clarify the descriptions of the positive and negative lookbehind assertions.
...
Added examples of positive lookbehind assertions.
This closes SF bug #529708 .
2002-03-16 05:58:12 +00:00
dc8d40717c
update text to refer to ServerProxy class in preference to Server, which is
...
only retained for backward compatibility with older versions of the library.
2002-03-14 17:35:25 +00:00
f981617645
"level" keyword argument in example should be "stacklevel".
...
This closes SF bug #517684 .
2002-03-12 19:49:31 +00:00
8f01b680c8
Change Windows file.truncate() to (a) restore the original file position,
...
and (b) stop trying to prevent file growth.
Beef up the file.truncate() docs.
Change test_largefile.py to stop assuming that f.truncate() moves the
file pointer to the truncation point, and to verify instead that it leaves
the file position alone. Remove the test for what happens when a
specified size exceeds the original file size (it's ill-defined, according
to the Single Unix Spec).
2002-03-12 03:04:44 +00:00
fb05db2cae
file_truncate(): provide full "large file" support on Windows, by
...
dropping MS's inadequate _chsize() function. This was inspired by
SF patch 498109 ("fileobject truncate support for win32"), which I
rejected.
libstdtypes.tex: Someone who knows should update the availability
blurb. For example, if it's available on Linux, it would be good to
say so.
test_largefile: Uncommented the file.truncate() tests, and reworked to
do more. The old comment about "permission errors" in the truncation
tests under Windows was almost certainly due to that the file wasn't open
for *write* access at this point, so of course MS wouldn't let you
truncate it. I'd be appalled if a Unixish system did.
CAUTION: Someone should run this test on Linux (etc) too. The
truncation part was commented out before. Note that test_largefile isn't
run by default.
2002-03-11 00:24:00 +00:00
10b3eac278
[Bug #486527 ] Note that the caller has to ensure there are no control
...
characters in strings being passed via XML-RPC.
Fix some typos.
2.2.1 bugfix candidate.
2002-03-08 17:46:02 +00:00
a4f8313cbb
add SSL class submitted by Tino Lange
2002-03-08 01:53:24 +00:00
da8a6dd072
Added missing version annotation for dict().
2002-03-06 02:29:30 +00:00
9479c958c5
Remove extra indenatation from sample interpreter session.
...
Remove whitespace from the middle of an inline RE example; it was OK for
the typeset formats, but LaTeX2HTML is more touchy about this.
2002-03-05 04:02:39 +00:00
a8e1d81bdc
add simple example of avoiding backtracking
2002-03-04 23:08:28 +00:00
29001ff234
Patch #523268 , #522027 : return enhanced tuples.
2002-03-01 10:47:37 +00:00
dbd55b3737
Patch #523268 , #522027 : return enhanced tuples.
2002-03-01 10:38:44 +00:00
9986633609
Patch 520694: arraymodule.c improvements:
...
- make array.array a type
- add Py_UNICODE arrays
- support +=, *=
2002-03-01 10:27:01 +00:00
b6b2aa6c75
Fix error in explanation of the interaction between $ and MULTILINE mode.
...
Reported by Steve Alexander.
2002-02-25 18:56:45 +00:00
9f4341b3b0
SF bug #501591 : dir() doc is old
...
Bugfix candidate.
+ Updated dir() description to match actual 2.2 behavior.
+ Replaced the dir(sys) example with dir(struct), because the former
was way out of date and is bound to change frequently, while the
latter is stable.
+ Added a note cautioning that dir() is supplied primarily for
convenience at an interactive prompt (hoping to discourage its
use as the foundation of introspective code outside the core).
2002-02-23 04:40:15 +00:00
f8b1f2431b
Grammar tweak.
2002-02-22 21:24:32 +00:00
ba902fda3c
SF #515041 , Update path for 2.3
2002-02-19 02:58:54 +00:00
e73ad2a21f
Use the standard expression for the availability statement for alarm().
2002-02-15 20:59:43 +00:00
8d1fdafd89
note that the alarm function is not available on Windows.
2002-02-15 20:36:19 +00:00
928051fb26
The "%" character does not need to be escaped in verbatim environments.
...
This closes SF bug #517811 .
2002-02-15 04:12:59 +00:00
7bc6f7ac7b
Consistently use \textasciicircum to produce a ^ character.
...
LaTeX really falls flat on this one!
2002-02-14 15:19:30 +00:00
ab034fab03
Implement os.waitpid() for Windows, in a way that's compatible with Linux
...
where their capabilities intersect. Would be nice if people using non-
MSVC compilers (Borland etc) took a whack at doing something similar for
them (this code relies on the MS _cwait function).
2002-02-01 11:27:43 +00:00
c318260a71
added handle_error method description
2002-01-31 17:32:24 +00:00
c48a3ca161
Add new constants usable with os.popen() on Windows.
...
NOTE: this seems a mess wrt which symbols are available on which
platforms. I can't fix it, but I didn't add to it <wink>, and
included an XXX comment about names claimed to be available on
Windows that aren't. If anyone can figure out the whole ugly truth,
I'm sure a better organization will suggest itself.
2002-01-30 05:49:46 +00:00
ef180dc3d0
Document that get_referrers can return unreachable but uncollected objects.
...
Fixes #505453 .
2002-01-26 20:11:50 +00:00
744f67fb62
Add keyword.kwlist to the public API.
2002-01-24 16:38:53 +00:00
4f3a62d9bc
There's no need for typechecks on the second and third argument of
...
new.instancemethod() -- the instancemethod object is now a perfectly
general container.
This fixes SF bug ##503091 (Pedro Rodriquez): new.instancemethod fails
for new classes
This is a 2.2.1 candidate.
2002-01-15 19:21:05 +00:00
3d62f8ca35
Fix a simple typo. Has this to be fixed also in other branches?
2002-01-14 08:37:39 +00:00
a55ffaeee9
Add a per-message fallback mechanism for translations.
2002-01-11 06:58:49 +00:00
1be6419871
Add fallback argument to translation(). Request fallbacks on install.
...
Fixes #500595 .
2002-01-11 06:33:28 +00:00
7731ed47cb
Do not mask the name of a built-in function in example code.
...
Based on comment sent to python-docs.
2002-01-05 04:00:03 +00:00
5e74d36f9d
Fix indentation error in example from the Tkinter Life Preserver.
...
This closes SF bug #499505 .
2002-01-05 03:56:54 +00:00
d93d68bd13
Fix minor typo reported in SF patch #497951 .
2002-01-05 01:52:41 +00:00
c33e077838
SF patch #497420 (Eduardo Pérez): ftplib: ftp anonymous password
...
Instead of sending the real user and host, use "anonymous@" (i.e. no
host name at all!) as the default anonymous FTP password. This avoids
privacy violations.
2001-12-28 20:54:28 +00:00
7c9a53dfc0
Elaborate the descriptions for onecmd(), precmd(), and postcmd() so they are
...
useful.
2001-12-27 05:10:18 +00:00
fd7f115a0e
Fix wrongly-named formal parameters in three places: begin_y was used twice
...
instead of begin_y and begin_x for derwin(), subpad(), and subwin().
Reported for derwin() by Eric Huss.
Added class annotations for the window methods so they would be properly
described in the index.
2001-12-26 22:08:44 +00:00
ab2dc1d730
Added index entries similar to some recommended by Skip, and used the word
...
"interpolation" in the text, to make the string formatting material easier to
find.
This closes SF bug #487165 .
Bugfix: this should be applied for Python 2.2.1.
2001-12-26 20:06:40 +00:00
ef338ec5f9
More index entries.
2001-12-26 19:48:43 +00:00
39960f6ec9
Fix the erroneous availability annotation for s.makefile() from the last
...
checkin (my fault!).
Wrap some long lines and fix some markup inconsistencies.
2001-12-22 19:07:58 +00:00
87fa3aa12c
Add notes that fromfd() and s.makefile() are Unix-specific.
...
This fixes SF bug #495896 .
Fix up various markup consistency & style guide conformance nits.
2001-12-21 17:45:03 +00:00
5c7983113c
Add a reference to the signal module to the os.kill() description.
...
This closes SF bug #495609 .
2001-12-21 03:58:47 +00:00
dce2e1161a
Fix typo in httplib example.
...
This fixes SF bug #495221 .
2001-12-21 03:52:04 +00:00
8c8e871530
Fix the availability statement for the spawn*() functions to reflect the
...
actual availability on Windows.
This fixes SF bug #495191 .
2001-12-20 17:24:11 +00:00
34a37b807a
Re-commit Ping's patch to the cgi and cgitb documentation, using the
...
right version this time. Thanks, Ping!
(This was from SF patch #494582 , "\index -> \indexii" version.)
2001-12-20 17:13:09 +00:00
4b1b3bfac1
Add entry for the pydoc documentation.
2001-12-18 16:32:30 +00:00
96be564027
Add documentation for the pydoc module; contributed by Ka-Ping Yee.
...
This closes SF patch #494622 .
2001-12-18 16:31:44 +00:00
732299ff63
Add documentation for the help() built-in; contributed by Ka-Ping Yee.
...
This is part of SF patch #494622 .
2001-12-18 16:31:08 +00:00
e088970ce0
Merge in Ping's changes to the cgitb documentation, and add a version
...
annotation as well.
This closes SF patch #494582 .
2001-12-18 15:51:55 +00:00
0c0b5305ae
Mark the mpz module deprecated as of Python 2.2.
2001-12-16 01:54:55 +00:00
c57772870b
Add a link to the mxNumber package.
2001-12-15 20:37:40 +00:00
b40501b05e
Add link to the gmpy project.
2001-12-15 18:37:24 +00:00
dda7dcb3f7
Add a missing "cycle".
2001-12-14 21:19:08 +00:00
526c7a0101
Ensure that complex() only accepts a string argument as the first arg,
...
and only if there is no second arg.
This closes SF patch #479551 .
2001-12-13 19:52:22 +00:00
a0b767625b
Minor adjustments.
2001-12-13 04:25:37 +00:00
1529ef860e
Document that isleap() returns exactly 1 or 0, which is guaranteed by the
...
docstring.
This closes SF bug #485794 .
Additional (very) small details were added.
2001-12-12 05:40:46 +00:00
cf72abab8c
Update link to the SAX homepage.
2001-12-10 18:10:37 +00:00
6048ce95a9
Added documentation for str.decode().
...
This closes SF bug #490823 .
2001-12-10 16:43:08 +00:00
146483964e
Patch supplied by Burton Radons for his own SF bug #487390 : Modifying
...
type.__module__ behavior.
This adds the module name and a dot in front of the type name in every
type object initializer, except for built-in types (and those that
already had this). Note that it touches lots of Mac modules -- I have
no way to test these but the changes look right. Apologies if they're
not. This also touches the weakref docs, which contains a sample type
object initializer. It also touches the mmap test output, because the
mmap type's repr is included in that output. It touches object.h to
put the correct description in a comment.
2001-12-08 18:02:58 +00:00
f9d580346b
Add change notes where im_class is discussed, since the exact meaning changes
...
with Python 2.2.
2001-12-07 23:13:53 +00:00
b62f0e1a7b
Correct the description of im_class. (Fred, this is changed in 2.2.
...
Should this be labeled as changed? How?)
2001-12-07 22:03:18 +00:00
7961930595
Revise description of dumbdbm.open() to reflect that the flag argument is
...
ignored and that mode was ignored before Python 2.2.
This closes SF bug #490098 .
2001-12-07 21:56:13 +00:00
8b7bb7a0f2
Describe the behavior of the read() method when the list of filenames
...
includes files that do not exist, explain the intended use of the interface,
and show how to ensure an expected file really exists.
This closes SF bug #490399 .
2001-12-07 21:35:57 +00:00
b404145936
s/it/if/ in descriptions of spawn mode argument.
2001-12-06 23:37:17 +00:00
c7cb69263d
For ratecv, document that None should be the initial state argument (when
...
I was squashing spurious overflows in the implementation, I got hung up
on this point).
2001-12-06 23:16:09 +00:00
a16433b14e
Re-enabled debugging prints in poplib & documented the set_debuglevel()
...
method.
This closes SF patch #486079 .
2001-12-05 22:37:21 +00:00
d761662b66
asyncore.loop() description contributed by Skip Montanaro.
...
This closes SF bug #489513 .
2001-12-05 21:37:50 +00:00
39368c1053
Added documentation of the sendall() method, and a note to the send() method
...
that it does not guarantee that all data is sent.
This closes SF patch #474307 .
2001-12-05 05:25:59 +00:00
d2a557e51e
Added entry for the "cgitb" module docs.
2001-12-04 22:48:17 +00:00
6e70e8b401
Documentation for the "cgitb" module.
2001-12-04 22:47:42 +00:00
97e3201220
Add a note that the rgbimg module is only built on 32-bit machines (prompted
...
by a question to webmaster).
Re-wrapped a long line.
2001-12-04 16:49:00 +00:00
db5a93cd6a
Update docs to reflect new compile() and compileFile()
2001-12-04 02:48:52 +00:00
b38784e4a0
Slightly improved indexing for the string-% operator, thanks to comments
...
from Skip Montanaro. There is one weirdness in the final index for HTML, but
that is low priority.
2001-12-03 22:15:56 +00:00
1a76386194
Added documentation on the ScrolledText module.
2001-12-03 21:18:30 +00:00
5172adca81
Minor clarification of the zip() description, based on a comment sent to
...
python-docs.
2001-12-03 18:35:05 +00:00
14f5c5fa01
Make no assumption about how modules are built when referring to them; this
...
can vary by platform and installation.
Based on suggestion to python-docs.
2001-12-03 18:33:13 +00:00
1722e4a952
Re-word the intro slightly to avoid reader misunderstanding: strings are not
...
mutable! We do not want to shock anyone.
This closes SF bug #483805 .
Re-factor so that the description of the "access" keyword parameter is not
repeated in both the descriptions of mmap(). Also, only make sure the first
description of mmap() appears in the index. The the index link is followed,
the first is now used to locate the page on the screen; chances are really good
both will be visible. This avoids the problem that the index entry for the
second is selected and the first version is not visible, making the reader
consider that mmap() is not available on Windows.
2001-12-03 18:27:22 +00:00
3570551d6f
Remove most references to __members__ and __methods__, leaving only one pair
...
of references that now state that these attributes have been removed,
directing the reader to the dir() function.
This closes SF bug #456420 .
2001-12-03 17:32:27 +00:00
b22c6720aa
Clean up some material that is not part of the standard documentation.
...
This closes SF bug #487308 .
2001-12-03 06:12:23 +00:00
d745b4e7a4
Add reference to the "String Methods" section to make that information
...
easier to find. Based on the comment from Steve Alexander on the
zope-coders mailing list.
2001-12-02 15:10:46 +00:00
0467775715
Add description of tkCommonDialog.
2001-11-30 19:24:49 +00:00
10cd315963
Change the chapter title to reflect the Tk affinity.
...
Use the new seealso* environment in the section pointing out other GUI
toolkits.
2001-11-30 18:17:24 +00:00
89d63cc450
Minor adjustments to markup for the getDOMImplementation() description.
2001-11-30 16:58:15 +00:00
bd34b6bc3d
Added the convenience constants that are present in PyXML to make these
...
more similar.
2001-11-30 15:37:33 +00:00
38f3b72f9f
Updated documentation for the new httplib interface, by Kalle Svensson.
...
This closes SF bug #458447 .
2001-11-30 06:06:40 +00:00
44b6f84e56
More information about Tix support, contributed by Mike Clarkson.
2001-11-29 21:09:08 +00:00
6995bb61b6
Various cleanups & markup fixes, mostly relating to the stat and statvfs
...
result object changes.
2001-11-29 20:48:44 +00:00
ed0a71911c
Neil Schemenauer suggested a small improvement to one of the example REs.
2001-11-29 20:23:14 +00:00
389aa17ad3
writeline() --> writelines()
...
This closes SF bug #487147 .
2001-11-29 19:04:50 +00:00
1cec7fab1d
New section of regular expression examples contributed by Skip Montanaro,
...
with some extensions and changes from me.
This closes SF patch #472825 .
2001-11-29 08:45:22 +00:00
5107b4cf5f
Re-arrange the modules in the "Internet Data Handling" chapter to try to
...
achieve a more sensible organization.
2001-11-28 07:50:45 +00:00
6a6bb1828b
Clarify that on some systems, lockf() using LOCK_EX requires that the file
...
is opened for writing; this closes SF bug #485342 .
Added notes that file objects are also accepted in the place of file
descriptors.
2001-11-28 07:48:32 +00:00
48704ee478
Add synopsis for the SimpleXMLRPCServer module; used in the chapter-level
...
list of modules.
2001-11-28 07:32:53 +00:00
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
b03d0cc45e
Typo, spotted by Detlef Lannert.
2001-11-26 21:39:40 +00:00
fcb05ab512
Tk-related modules should no longer be listed here.
2001-11-26 21:38:50 +00:00
2744f43f71
Fix typo, extra markup constructs.
...
This closes SF bug #485252 .
2001-11-26 21:30:36 +00:00
560da62fc7
Rename get_referents to get_referrers. Fixes #483815 .
2001-11-24 09:24:51 +00:00
e70dbe0fc5
Update the platform notes for the CGIHTTPServer module; it works on more
...
platforms now, and has since Python 2.0.
This closes SF bug #482943 .
2001-11-19 05:16:35 +00:00
7064d3b581
Fix the default value for feature_namespaces, per discussions on the XML-SIG
...
mailing list. This causes the docs to match the default implementation.
2001-11-19 04:34:50 +00:00
69ab5836ae
Paul Rubin reminds me that of course a class's constructor /could/ get
...
called, if the pickler found a __getinitargs__() method.
2001-11-18 16:24:01 +00:00
ebbd14d7c2
Clarified a couple of issues for the startElement*() handlers:
...
- the attrs value may be re-used by the parser, so the implementation
cannot rely on owning the object.
- an element with no namespace encountered in namespace mode will have a URI
of None, not "" (startElementNS() only).
Fixed a couple of minor markup issues as well.
2001-11-18 04:58:28 +00:00
af0a883041
Relatively large expansion of the docs for gc.garbage.
2001-11-18 04:51:17 +00:00
0c0565dd7f
Toughen up the security warnings a bit.
2001-11-16 22:28:17 +00:00
5e17d20743
Add a clarification that the email package always deals in native line
...
endings, and that it is smtplib's job to convert those to RFC 2821
line endings when sending the message.
2001-11-16 22:16:04 +00:00
666ca80b63
Clean up some markup a little bit more. Make this work with the PDF format,
...
which is a little more strict than the other formats on some things (fixable,
but not tonight).
2001-11-16 06:02:55 +00:00
5545219bf6
Document the urlsplit() and urlunsplit() functions.
2001-11-16 03:22:15 +00:00
c66ff203bb
Switched a couple of sections around.
...
Cleaned up some markup nits.
Add a few more of the Tk-related modules to the list of modules.
2001-11-16 01:05:27 +00:00
69b2d75fc7
A few minor updates to make it clear(er) that pickle should be used
...
instead of marshal for object serialization.
Fred, please proofread!
2001-11-15 23:55:12 +00:00
f595fd975d
A massive rewrite affecting both the pickle and cPickle module
...
documentation. This addresses previously undocumented parts of the
public interfaces, the differences between pickle and cPickle,
security concerns, and on and on.
Fred please proofread!
2001-11-15 23:39:07 +00:00
d44e7ad702
Minor updates to add more pointers to the pickle documentation, and to
...
clarify some of the interface.
2001-11-15 23:37:26 +00:00
fd4f069b12
The turtle docs will be moving to another location in the Tkinter chapter.
2001-11-15 22:10:46 +00:00
482b9a8c0c
Clean up the descriptions of multi-signature functions so we do the right
...
thing in the index.
2001-11-15 20:41:03 +00:00
53556861df
Add entries for the new Tkinter chapter.
2001-11-15 17:25:29 +00:00
7cf4e5b329
Tkinter chapter, contributed by Mike Clarkson. Based in part on the "Tkinter
...
Life Preserver" by Matt Conway.
2001-11-15 17:22:04 +00:00
5ebfd36afa
CVS patch #477161 : New "access" keyword for mmap, from Jay T Miller.
...
This gives mmap() on Windows the ability to create read-only, write-
through and copy-on-write mmaps. A new keyword argument is introduced
because the mmap() signatures diverged between Windows and Unix, so
while they (now) both support this functionality, there wasn't a way to
spell it in a common way without introducing a new spelling gimmick.
The old spellings are still accepted, so there isn't a backward-
compatibility issue here.
2001-11-13 23:11:19 +00:00
da4ffeecf5
No need to have documentation for a module which not accepted in the library.
2001-11-09 21:45:55 +00:00
3b0c82a2f1
Updated the documentation for formatdate().
2001-11-09 17:08:13 +00:00
30bd666c35
Cleaned up some markup stupidity and a usage problem reported by Detlef
...
Lannert. Added descriptions of HTTP_PORT and HTTPS_PORT.
2001-11-09 05:03:05 +00:00
399bc8c281
Fix a variety of typographical, grammatical, and clarity problems reported
...
by Detlef Lannert.
2001-11-09 03:49:29 +00:00
0b66310476
When referring to a formal parameter from the description, use the name given
...
with the signature, not an ad hoc abbreviated form.
2001-11-07 06:28:47 +00:00
66ded524ba
apply() documentation: Remove a detail about the implementation that does
...
not affect the API. Clean up the text about call syntax apply() is
equivalent to. Based on comments by Thomas Guettler.
2001-11-07 06:22:25 +00:00
1a670c8414
Adjust the module synopsis to avoid margin overruns in the PDF format.
2001-11-06 22:14:35 +00:00
10b81ce4e5
A variety of small cleanups, including one to avoid a margin overrun in the
...
PDF version.
2001-11-06 22:13:19 +00:00
5976816698
Remove stray quotes; probably left over from conversion from docstrings.
2001-11-06 22:11:34 +00:00
806d332f02
Remove extra period.
2001-11-06 22:10:47 +00:00
1f774b062e
Update obsolete e-mail address, and remove myself as a module author
2001-11-05 21:34:36 +00:00
4794f0b234
Update obsolete e-mail address
2001-11-05 21:31:33 +00:00
47ccfe2d8f
Remove obsolete e-mail address
2001-11-05 21:31:15 +00:00
f010df4ee5
Update URL, and remove e-mail address reference (readers can get it from
...
the Web page)
2001-11-05 21:30:10 +00:00
2bb077f630
Finally fleshed out the examples section with 4 code samples! Some of
...
my own doing, some originally written by Matthew Dixon Cowles.
2001-11-05 17:50:53 +00:00
c44403995e
Remove email*.tex subsections; they're all \input by email.tex
2001-11-05 01:55:43 +00:00
43dc1fc926
Minor grammar and typo fixes
2001-11-05 01:55:03 +00:00
169ded0d68
Finish SF patch 477059: __del__ on new classes vs. GC.
...
Just doc and NEWS here, about the change in gc.garbage meaning.
2001-11-03 19:57:21 +00:00
7533587d43
Improved error msg when a symbolic group name is redefined. Added docs
...
and NEWS. Bugfix candidate? That's a dilemma for Anthony <wink>: /F
did fix a longstanding bug here, but the fix can cause code to raise an
exception that previously worked by accident.
2001-11-03 19:35:43 +00:00
bc4a1c2588
[Patch #476612 ] Change docs to describe PEP247 interface
2001-11-02 21:44:09 +00:00
d9272d6f11
Add deprecation notice to statcache.
2001-11-02 20:20:19 +00:00
67bd68392c
Make sure there are no weird nesting behaviors; the PDF version will not
...
format if there are (building the "bookmarks" for the reader breaks).
2001-11-02 19:41:23 +00:00
99de218cfc
Promote file objects out of the "Other Objects" category, so they become
...
visible in the table of contents.
2001-10-30 06:23:14 +00:00
b4ea9d0502
Promote built-in functions to come before built-in types.
2001-10-30 06:22:02 +00:00
003047a5f2
Mention the new file() builtin in the section on file objects.
2001-10-30 05:54:04 +00:00
a427a2b8d0
Rename "dictionary" (type and constructor) to "dict".
2001-10-29 22:25:45 +00:00
589abb7212
Add additional information on exceptions from time.mktime() and related to
...
improper time tuples passed to various functions. Based on comments from
Andreas Jung.
2001-10-29 18:01:24 +00:00
e21e2bb121
Fix up a number of small problems with the DOM documentation.
...
There's still a lot to do, but it's better now.
2001-10-26 20:09:49 +00:00
41cf5e0069
Remove unused variable.
2001-10-26 19:50:26 +00:00
ef428a292a
Explain what [].insert() does when the target index is negative.
2001-10-26 18:57:14 +00:00
d5be3b75dd
Add notes pointing out that these classes are kept for backward compatibility
...
and suggeest that new code that does not require compatibility with older
Python versions subclass dictionary, list, or str.
2001-10-26 18:37:27 +00:00
7408da54e2
Many, many small fixes and improvements, most suggested by Detlef Lannert.
2001-10-26 17:40:22 +00:00
ef7d08a661
Some style changes and typo fixes.
2001-10-26 15:04:33 +00:00
de3d060eb2
Typo: destuction --> destruction
...
Reported by Thomas Heller.
2001-10-26 11:27:54 +00:00
1fc240e851
Generalize dictionary() to accept a sequence of 2-sequences. At the
...
outer level, the iterator protocol is used for memory-efficiency (the
outer sequence may be very large if fully materialized); at the inner
level, PySequence_Fast() is used for time-efficiency (these should
always be sequences of length 2).
dictobject.c, new functions PyDict_{Merge,Update}FromSeq2. These are
wholly analogous to PyDict_{Merge,Update}, but process a sequence-of-2-
sequences argument instead of a mapping object. For now, I left these
functions file static, so no corresponding doc changes. It's tempting
to change dict.update() to allow a sequence-of-2-seqs argument too.
Also changed the name of dictionary's keyword argument from "mapping"
to "x". Got a better name? "mapping_or_sequence_of_pairs" isn't
attractive, although more so than "mosop" <wink>.
abstract.h, abstract.tex: Added new PySequence_Fast_GET_SIZE function,
much faster than going thru the all-purpose PySequence_Size.
libfuncs.tex:
- Document dictionary().
- Fiddle tuple() and list() to admit that their argument is optional.
- The long-winded repetitions of "a sequence, a container that supports
iteration, or an iterator object" is getting to be a PITA. Many
months ago I suggested factoring this out into "iterable object",
where the definition of that could include being explicit about
generators too (as is, I'm not sure a reader outside of PythonLabs
could guess that "an iterator object" includes a generator call).
- Please check my curly braces -- I'm going blind <0.9 wink>.
abstract.c, PySequence_Tuple(): When PyObject_GetIter() fails, leave
its error msg alone now (the msg it produces has improved since
PySequence_Tuple was generalized to accept iterable objects, and
PySequence_Tuple was also stomping on the msg in cases it shouldn't
have even before PyObject_GetIter grew a better msg).
2001-10-26 05:06:50 +00:00
7f10cce4c1
Enforce a bit of markup consistency.
...
When describing a Boolean return value, use "true" and "false" instead of
"1" and "0".
Style-guide conformance: no "iff" -- to obscure for many readers. ;-(
2001-10-26 03:04:23 +00:00
3a2c462436
Minor textual adjustment, and style-guide conformance (no use of "iff").
2001-10-26 03:00:39 +00:00
107771a228
Applying proposed patch for bug #474583 , optional support for
...
non-standard but common types. Including Martin's suggestion to add
rejected non-standard types from patch #438790 . Specifically,
guess_type(), guess_extension(): Both the functions and the methods
grow an optional "strict" flag, defaulting to true, which determines
whether to recognize non-standard, but commonly found types or not.
Also, I sorted, reformatted, and culled duplicates from the big
types_map dictionary. Note that there are a few non-equivalent
duplicates (e.g. .cdf and .xls) for which the first will just get
thrown away. I didn't remove those though.
Finally, use of the module as a script as grown the -l and -e options
to toggle strictness and to do guess_extension(), respectively.
Doc and unittest updates too.
2001-10-25 21:49:18 +00:00
61f794918f
Typo: NamedNodeList --> NamedNodeMap
2001-10-25 20:42:57 +00:00
bc006af3d0
Make the deprecation notice use the same form as other such notices.
...
This has sat around in a deprecated state for a *long* time!
2001-10-24 21:56:59 +00:00
0559d95fd6
Minor revision of the text.
2001-10-24 21:10:52 +00:00
98791affc8
Doc and NEWS changes due to Jeremy adding traceback objects to gc.
2001-10-23 01:59:54 +00:00
d05e051aa7
Fixed an example in the use of email.Utils.getaddresses(). The
...
failobj has to be a list or the `+' can fail.
2001-10-22 20:53:45 +00:00
5d9a6b575c
Clarify that the resource module does not attempt to mask platform
...
differences by defining symbols not defined on particular platforms.
This closes SF bug #473433 .
2001-10-22 14:18:23 +00:00
9dbc0bcf9d
Update description of border()
2001-10-20 16:07:41 +00:00
0aa811c527
Use the \note and \warning macros where appropriate.
2001-10-20 04:24:09 +00:00
aad8bb5d7a
When stating that some parameters to makefile() are similar to the open()
...
parameters, given a hyperlink to the right part of the documentation to
make it easier to look those up. Also, refer to the file() function/
constructor instead of open() now that that is where the actual docs for
those parameters live.
This closes SF bug #472004 .
2001-10-19 17:22:29 +00:00
b5507ecd3c
Additional test and documentation for the unicode() changes.
...
This patch should also be applied to the 2.2b1 trunk.
2001-10-19 12:02:29 +00:00
e736d93eab
Added a note about the somewhat kludgey behavior of the message
...
epilogue, based on the discussion in this SF bug report:
https://sourceforge.net/tracker/index.php?func=detail&aid=472481&group_id=25568&atid=384678
2001-10-19 04:34:42 +00:00
b6c1d5239c
SF patch #443759 : Add Interface to readline's add_history
...
This was submitted by Moshe, but apparently he's too busy to check it
in himself. He wrote:
Here is a function in GNU readline called add_history,
which is used to manage the history list. Though Python
uses this function internally, it does not expose it to
the Python programmer. This patch adds direct interface
to this function with documentation.
This could be used by friendly modules to "seed" the
history with commands.
2001-10-19 01:18:43 +00:00
a5e616510e
changed misleading argument name
2001-10-18 20:58:25 +00:00
91b81c4802
Some minor clarifications for find()'s arguments based on SF bug
...
#463572 . Closing.
2001-10-18 19:41:48 +00:00
db7287c0f5
Straighten out the exec*() function descriptions a bit, and clarify a few
...
points in the spawn*() description.
2001-10-18 18:58:30 +00:00
ca836f7e65
Function descriptions must end as well as start!
2001-10-18 14:26:08 +00:00
c405133fce
Elaborate on types and meaning of the setgroups arguments.
2001-10-18 14:07:12 +00:00
61c5edf6fc
Expose setgroups. Fixes feature request #468116 .
2001-10-18 04:06:00 +00:00
61acf067ac
SF bug [ #471111 ] inspect.getframeinfo() needs docs.
...
TeX-ified its docstring.
2001-10-16 23:01:06 +00:00
3c28863e08
Partial patch from SF #452266 , by Jason Petrone.
...
This changes Pythread_start_thread() to return the thread ID, or -1
for an error. (It's technically an incompatible API change, but I
doubt anyone calls it.)
2001-10-16 21:13:49 +00:00
511e2cacc4
[ #403753 ] zlib decompress; uncontrollable memory usage
...
Mostly by Toby Dickenson and Titus Brown.
Add an optional argument to a decompression object's decompress()
method. The argument specifies the maximum length of the return
value. If the uncompressed data exceeds this length, the excess data
is stored as the unconsumed_tail attribute. (Not to be confused with
unused_data, which is a separate issue.)
Difference from SF patch: Default value for unconsumed_tail is ""
rather than None. It's simpler if the attribute is always a string.
2001-10-16 20:39:49 +00:00
ab9b238ced
Fix a few usage and style-guide conformance issues.
2001-10-16 19:22:51 +00:00
64d7863797
Added information about setprofile() and settrace() hooks being thread-
...
specific, and updated some of the comments about the profile hook.
This closes SF bug #471725 .
2001-10-16 14:54:22 +00:00
327798ca4a
Added notes to clarify that binascii.crc32(), zlib.crc32(), and
...
zlib.adler32() are not suitable as general hash functions.
2001-10-15 13:45:49 +00:00
cb43c085e2
Document that keyfile and certfile are now optional.
...
XXX Forgot to mention this in the last socketmodule.c checkin.
2001-10-11 16:17:22 +00:00
c7f8b86307
Describe the HeaderParser class.
2001-10-11 15:45:05 +00:00
8cd015c701
A copy-and-paste job forget the "paste" half.
2001-10-09 20:54:23 +00:00
659a60311d
Allow the profiler's calibration constant to be specified in the constructor
...
call, or via setting an instance or class vrbl.
Rewrote the calibration docs.
Modern boxes are so friggin' fast, and a profiler event does so much work
anyway, that the cost of looking up an instance vrbl (the bias constant)
per profile event just isn't a big deal.
2001-10-09 20:51:19 +00:00
dca939899d
Fix minor cut-and-paste typo.
2001-10-09 19:37:51 +00:00
e0063d20a7
Update the documentation for the isinstance() function to reflect recent
...
changes in the implementation.
Indented all descriptions consistently.
2001-10-09 19:31:08 +00:00
a55d132f08
Add documentation for the MIMEAudio class/module, contributed by
...
Anthony Baxter.
2001-10-09 19:14:17 +00:00
938a8d723c
Improve the documentation for the os.P_* constants used with the os.spawn*()
...
functions to include information about how they affect the operation of
those functions when used as the "mode" parameter.
This closes SF bug #468384 .
Added warnings to the os.tempnam() and os.tmpnam() functions regarding their
security problem. These warning mirror the warnings added to the runtime
by Skip Montanaro.
2001-10-09 18:07:04 +00:00
6959a2fcd7
Note that the values for Boolean options are case-insensitive.
2001-10-09 14:58:24 +00:00
b35f0ce2b8
Update the description of getboolean() to reflect the changes made by
...
SF patch #467580 .
2001-10-08 16:03:20 +00:00
0a1fc4e389
Remove code and docs for the OldProfile and HotProfile classes: code
...
hasn't worked in years, docs were wrong, and they aren't interesting
anymore regardless.
2001-10-07 03:12:08 +00:00
8c2c3d301b
Update the documentation to reflect the changes to ReferenceError.
2001-10-06 06:10:54 +00:00
9835206268
A regexp example was rendered as
...
foo\d
when it was clearly intended to render as
foo$
Fred, is this a right way to fix it? If not, the earlier place in the
same paragraph that does render as
foo$
is also wrong.
2001-10-05 20:06:47 +00:00
244edc8985
Add chroot call. Implements feature #459267 .
2001-10-04 22:44:26 +00:00
fcc16330a4
Update a couple of old addresses that point to CNRI.
2001-10-04 20:40:07 +00:00
3899d74c10
Make clear that tuple() accepts the same kind of arguments as list().
2001-10-04 06:53:20 +00:00
0481d24dd5
CVS patch [ #466628 ] Doc changes for doctest patch ( #466616 ), from
...
Tim Hochberg. Doctest no longer searches imported objects.
2001-10-02 21:01:22 +00:00
d90f509b8f
Fredrik tells me the truefalse parameter for boolean() is not part of the
...
public interface, so we can simplify the documentation.
2001-10-01 21:05:30 +00:00
6c81e2a44f
"boolean" --> "Boolean" (per the style guide).
2001-10-01 17:04:10 +00:00
fe95e65668
Straighten out some markup.
...
"boolean" --> "Boolean" (per the style guide).
2001-10-01 17:03:48 +00:00
e9ba525c2b
Clarify comments about mailbox objects being iterable.
2001-10-01 15:49:56 +00:00
e7877df595
Docs for SF patch #462628
2001-10-01 13:50:15 +00:00
0daad598d0
Patch #462122 : add readline startup and pre_event hooks.
2001-09-30 21:09:59 +00:00
16dc7f44b1
Patch #462190 , patch #464070 : Support quoted printable in the binascii module.
...
Decode and encode underscores for header style encoding. Fixes bug #463996 .
2001-09-30 20:32:11 +00:00
af5910f025
The execfile() docs imply it acts on locals same as exec. But in truth
...
it acts more like assigning to keys in locals(), i.e. modifications to
function locals aren't reflected in the locals when execfile() returns.
2001-09-30 06:32:59 +00:00
1c33daf143
Correct docs for long(float).
2001-09-30 06:18:26 +00:00
0d68246f01
Fix two typos in the text about compile(), and add two caveats from
...
recent user feedback: you must end the input with \n and you must use
\n, not \r\n to represent line endings.
2001-09-29 14:28:52 +00:00
a1c3662e84
forgot to mark use of StringType and UnicodeType in the text.
2001-09-29 13:53:21 +00:00
c7ba0c4c24
added description of StringTypes object
2001-09-29 13:49:41 +00:00
2b05ca3454
Minor markup improvement.
2001-09-29 05:01:59 +00:00
599db7de63
The list.sort() docs require a function that returns -1, 0 or +1. That's
...
never been true, and in particular implies cmp() can't be used(!). Get
closer to the truth.
2001-09-29 01:08:19 +00:00
7988e0249c
Move XML-RPC-related docs to the "Internet Protocols" chapter.
...
Add entry for the SimpleXMLRPCServer module.
2001-09-28 22:03:40 +00:00
e486e0d066
Preliminary documentation for the SimpleXMLRPCServer module.
2001-09-28 22:02:21 +00:00
3c10c68c0e
Use consistent version annotations instead of something ad hoc.
2001-09-28 16:57:16 +00:00
bbf7a407e8
Added note about non-support of UNC paths on Windows.
...
This fixes SF bug #465447 .
2001-09-28 16:14:18 +00:00
b387860c70
State that encode() and encodestring() append a newline to the input data
...
if it does not already end with a newline.
This fixes SF bug #463330 .
2001-09-28 16:01:46 +00:00
33f4d6d1db
Add entries for the email and compiler packages.
2001-09-27 20:11:07 +00:00
90e687863b
Markup adjustments.
2001-09-27 20:09:39 +00:00
e2f9917f9f
Migrate the compiler documentation from the Tools/compiler/doc/ directory.
...
Changes made to make it work in the new location.
2001-09-27 20:06:07 +00:00
3fc291a1d7
Fix some markup errors.
2001-09-27 04:17:20 +00:00
b802a1e7fa
Markup adjustment: \[...\] is math markup and does not translate well when
...
used with text as was done here. Fixed so that the typeset version wraps
the warning text and the HTML version does not create images of the warning
text.
2001-09-27 04:16:27 +00:00
c5f8fe3a27
Updates do email package documentation for markup, style, and
...
organization.
2001-09-26 22:21:52 +00:00
a6a885b6aa
Start making some markup adjustments; Barry has indicated he will work on
...
this before we finish the integration, along with some restructuring.
2001-09-26 16:52:18 +00:00
5e634638e6
The email package documentation, currently organized the way I think
...
Fred prefers. I'm not sure I like this organization, so it may change.
2001-09-26 05:23:47 +00:00
5055545fc0
Clarified some points about the interface to the mmap() function.
...
This closes SF bug #448918 .
2001-09-25 19:00:08 +00:00
c0765c2381
Minor changes.
2001-09-25 16:32:02 +00:00
c825280ea5
Revise the example to be more resiliant in the face of continued use after
...
the object has been pickled; don't mutate the instance dict in the
__getstate__() method. Other minor changes for style. Broke up the
displayed interactive session to get better page-breaking behavior for
typeset versions, and to point out an important aspect of the example.
This closes SF bug #453914 .
2001-09-25 16:29:17 +00:00
9081bb1d21
Added documentation for the SSL interface, contributed by Gerhard Häring.
...
This closes SF patch #461337 .
2001-09-25 15:48:11 +00:00
2c9aa5ea8d
Generalize file.writelines() to allow iterable objects.
2001-09-23 04:06:05 +00:00
8a9c284437
Make difflib.ndiff() and difflib.Differ.compare() generators. This
...
restores the 2.1 ability of Tools/scripts/ndiff.py to start producing
output before the entire comparison is complete.
2001-09-22 21:30:22 +00:00
e0b2d7ac9a
Add a function to compute a class's method resolution order. This is
...
easy for 2.2 new-style classes, but trickier for classic classes, and
different approaches are needed "depending". The function will allow
later code to treat all flavors of classes uniformly.
2001-09-22 06:10:55 +00:00
038d26410d
Note that files are iterable; describe what the iterator returns.
...
This closes SF bug #463738 .
2001-09-22 04:34:48 +00:00
c69205526a
Added reference to Tutorial section on user-defined exceptions for
...
information on defining new exceptions.
This closes SF bug #443559 .
2001-09-21 21:12:30 +00:00
e0af35eb69
Fill in a few more descriptions for xml.parsers.expat.
2001-09-20 20:43:28 +00:00
2e29bfbe1a
Document new file() constructor, with the body of open()'s text, plus a
...
"new in 2.2" blurb at the end. Replace open()'s text by pointing back
to file().
2001-09-20 19:55:29 +00:00
494f2aea8e
Docs and News item for the codecs.py additions.
2001-09-19 11:33:31 +00:00
83eeef4b06
SF patch #461781 by Chris Lawrence: os.path.realpath - Resolve symlinks:
...
Once upon a time, I put together a little function
that tries to find the canonical filename for a given
pathname on POSIX. I've finally gotten around to
turning it into a proper patch with documentation.
On non-POSIX, I made it an alias for 'abspath', as
that's the behavior on POSIX when no symlinks are
encountered in the path.
Example:
>>> os.path.realpath('/usr/bin/X11/X')
'/usr/X11R6/bin/X'
2001-09-17 15:16:09 +00:00
5b7759f9db
Fixed typo in new 'p' description.
2001-09-15 18:16:27 +00:00
88091aae7e
SF bug [ #461674 ] struct 'p' format doesn't work (maybe)
...
Rewrote the 'p' description.
2001-09-15 18:09:22 +00:00
ad2dc3fc44
Update the warning about transporting marshals across boxes with different
...
ideas about sizeof(long).
2001-09-14 20:40:13 +00:00
f2a5f3f721
Markup adjustments for consistency.
2001-09-14 17:48:41 +00:00
f7fcf5eea6
SF patch #461413 (Gerhard Häring): Add STARTTLS feature to smtplib
...
This patch adds the features from RFC 2487 (Secure SMTP
over TLS) to the smtplib module:
- A starttls() function
- Wrapper classes that simulate enough of sockets and
files for smtplib, but really wrap a SSLObject
- reset the list of known SMTP extensions at each call
of ehlo(). This should have been the case anyway.
2001-09-14 16:08:44 +00:00
b9a96282f1
Admit that we'll never add the args for a "call" event to the profile
...
and trace functions; this now declares that None will be passed for the
"call" event.
This closes SF bug/suggestion #460315 .
2001-09-13 16:56:43 +00:00
098d7fae39
Document clearly that the only way to retrieve the return code from the
...
child processes is to use the Popen3 and Popen4 classes.
This fixes SF bug #460512 .
2001-09-11 19:56:51 +00:00
1c66f8965a
Added entry for the hmac module.
2001-09-11 16:59:42 +00:00
aae8da18fd
Documentation for the new login() method of the smtplib.SMTP class,
...
contributed by Gerhard Häring.
This is part of SF patch #460112 .
2001-09-11 16:58:00 +00:00
42706803cd
Documentation for the new hmac module, contributed by Gerhard Häring.
...
This is part of SF patch #460112 .
2001-09-11 16:56:09 +00:00
2732cb4269
Added documentation on the getfirst() and getlist() methods of the
...
cgi.FieldStorage class.
This closes SF patch #453691 .
2001-09-11 16:27:03 +00:00
05a73b1f9a
Update link to the PyOpenGL project in the "gl" module docs.
...
This closes SF bug #459256 .
2001-09-06 19:23:03 +00:00
00bb329521
Document the built-in iter() function.
2001-09-06 19:04:29 +00:00
a20c265aba
Added an additional link to NIST information on secure hashing.
...
This closes SF bug #458785 .
2001-09-06 18:59:43 +00:00
4d17b303bb
Several updates to cover omissions noted by Rich Salz.
...
This closes SF bug #458771 .
2001-09-06 15:51:56 +00:00
f5072b9314
Document the "unixfrom" attribute of the rfc822.Message class.
...
Based on a patch by Skip Montanaro, this closes SF bug #458885 .
2001-09-06 15:07:55 +00:00
b0162f9afc
Patch #416079 : fix the debug string output when receiving telnet commands.
...
added all the telnet options known to arpa/telnet.h
added all the options registered with IANA as of today
added the possibility for the user to have it's own option negotiation callback
2001-09-06 08:51:38 +00:00
bb5a465ca9
typo...
2001-09-05 19:27:13 +00:00
44f8696171
Patch #428326 : New class threading.Timer.
2001-09-05 13:44:54 +00:00
757f7809e1
Add more detail to the descriptions of the shutil functions.
...
This closes SF bug #458223 .
2001-09-04 18:26:27 +00:00
c05fc7dd9d
Added documentation for sys.maxunicode and sys.warnoptions.
...
Fixed a markup error which caused an em dash to be presented as a minus sign.
This closes SF bug #458350 .
2001-09-04 18:18:36 +00:00
32f453eaa4
New restriction on pow(x, y, z): If z is not None, x and y must be of
...
integer types, and y must be >= 0. See discussion at
http://sf.net/tracker/index.php?func=detail&aid=457066&group_id=5470&atid=105470
2001-09-03 08:35:41 +00:00
b86677079d
Move the long minidom example to a separate file; \verbatiminput does the
...
right thing with page breaks in long examples, while the verbatim
environment does not. This causes the example to wrap to the next page
instead of overwriting the page footer and bottom margin.
2001-09-02 06:07:36 +00:00
481cf2c064
Added the "Host" header to the "GET" example.
...
This closes SF bug #457100 .
2001-09-01 02:35:23 +00:00
3c0fc84b15
Update the links to the FIPS document that defines the Secure Hash
...
Algorithm. This closes SF bug #454917 .
2001-08-30 14:42:40 +00:00
692323488b
Add a new function imp.lock_held(), and use it to skip test_threaded_import
...
when that test is doomed to deadlock.
2001-08-30 05:16:13 +00:00
d800cff80d
Added explanation that [...] * n generates shallow copies of [...], so
...
the contents will be shared by multiple references.
This closes SF bug #455694 .
2001-08-28 14:56:05 +00:00
5cb29a49c8
Fix a number of minor markup errors, and improve the consistency a bit.
2001-08-28 14:25:03 +00:00
46ccd1dae5
Plant a mention in the description of backreferences of the fact that
...
while \0 doesn't do what one might expect, \g<0> does.
2001-08-28 12:50:03 +00:00
53da317801
Docs for the PEP 264 changes.
2001-08-27 20:02:17 +00:00
88e0b5bee0
SF patch #454553 by Walter Dörwald: auto-guess content-type header for
...
ftp urls.
2001-08-23 13:38:15 +00:00
0f10f84028
indicate that mktime is platform-dependent. See SF bug 434143.
2001-08-22 12:44:27 +00:00
5ff41d16a8
indicate that the years for which the calendar function will work are
...
platform dependent. See SF bug 434143.
2001-08-22 12:43:38 +00:00
31d833d575
Added documentation for BoundedSemaphore(), contributed by Skip Montanaro.
...
This closes SF patch #452836 .
2001-08-20 18:49:00 +00:00
29bb115bae
Clean up some argument profiles, enrich the docstring.
2001-08-20 13:16:30 +00:00
dbec7d2c16
Improve Windows time.clock() blurb; was missing return type and unit.
2001-08-19 01:38:03 +00:00
b60f2d0977
Framework code for compilerlike scripts.
2001-08-18 09:24:38 +00:00
dbfe5e8507
Document that uu.decode() will always raise a uu.Error if out_file
...
isn't given, and the file in the uu header already exists. Also add a
description of the uu.Error exception class.
2001-08-17 20:01:06 +00:00
739282da83
Re-write the description of the os.spawn*() functions, and cover the
...
whole family instead of just two.
This closes SF bug #451630 .
2001-08-16 21:21:28 +00:00
ce575bac5e
Fix a minor typo and mark an exception name that was missed.
2001-08-14 21:51:50 +00:00
5ef99a0bc5
Describe the new semantics for setting and deleting a function's
...
__dict__ attribute. Deleting it, or setting it to a non-dictionary
result in a TypeError. Note that getting it the first time magically
initializes it to an empty dict so that func.__dict__ will always
appear to be a dictionary (never None).
Closes SF bug #446645 .
2001-08-14 18:22:24 +00:00
280f7253e4
Insert omitted "the".
2001-08-14 11:42:13 +00:00
bf781a95c0
Add the smtpd module to the list of undocumented modules; Barry needs to
...
write the documentation for this module.
2001-08-14 11:38:35 +00:00
6943a29cbf
David Goodger <dgoodger@atsautomation.com>:
...
Documentation for difflib/ndiff refactoring: more of the ndiff functionality
has been moved to the underlying library (difflib).
This closes SF patch #445413 .
2001-08-13 19:31:59 +00:00
84e58ab722
For the escape() function, added a reference to the quoteattrs() function
...
in xml.sax.saxutils, since that is the right function to use for quoting
attribute values.
This closes SF bug #444707 .
Cleaned up a variety of other minor markup errors.
2001-08-11 03:28:41 +00:00
1cf0f1751f
Add a note that the quoteattr() function is useful for HTML and SGML
...
attributes as well.
2001-08-10 22:14:17 +00:00
d635e3c468
Added a warning about reference cycles and memory consumption to the
...
section on functions which return stack frames.
This closes SF bug #449258 .
2001-08-10 17:37:33 +00:00
6d8d72b0cb
Usage fix, problem reported by Keith Briggs.
2001-08-10 16:15:08 +00:00
e89659c02d
Added documentation for the new rich comparison support.
...
This closes SF patch #428320 .
Added documentation for the new floordiv() and truediv() functions.
This is part of SF bug #449093 .
Re-organized the listing of functions to get better logical grouping.
2001-08-10 15:55:09 +00:00
9b75dca192
Expose nl_langinfo through locale where available.
2001-08-10 13:58:50 +00:00
8cc965c1fb
Patch #448474 : Add support for tell() and seek() to gzip.GzipFile.
2001-08-09 07:21:56 +00:00
3a5ec57456
Clean up some of the markup here -- be more consistent in the use of
...
semantic labels instead of presentational markup.
2001-08-08 05:39:29 +00:00
58212724f2
Add a comment on time.time() returning non-decreasing values except when
...
the clock is set back.
This closes SF bug #447945 .
2001-08-05 15:43:04 +00:00
c9908c4f5c
Document IPv6 changes. Contributed by itojun.
2001-08-04 22:22:45 +00:00
b3cc29b493
Note that the mimetypes.MimeTypes class was added in Python 2.2.
2001-08-04 00:48:49 +00:00
d5efb17086
Add documentation for the new aspects of the mimetypes module.
...
This closes the SF bug (feature request) #439710 .
2001-08-03 21:03:14 +00:00
d86038d1be
Apply the new \mailheader macro where appropriate, and fix a few small
...
markup inconsistencies.
2001-08-03 18:39:36 +00:00
5d54879647
Fix some of the example code; the reference objects do not support a
...
get() method; just calling them is sufficient. (There was a get() method
for this in an early version of the implementation.)
Reported by Mats Wichmann.
2001-08-03 03:50:28 +00:00
51629c245a
Add a caveat about boundary conditions and RE concatenation, so that the
...
documents do not make an overly-strong assertion about the properties of
RE concatenation.
Add an example of RE{m,} syntax and what it will and will not match.
2001-08-02 20:52:00 +00:00
905dc558f1
Cleaned up the description of readline.set_completer().
...
Thanks to Nathaniel Gray for reporting the confusion.
2001-08-01 21:42:45 +00:00
e74f8de385
Added an example of a string value for the replacement parameter to
...
re.sub().
This closes SF bug #446136 .
Fixed description of RE modifiers so that RE{#} and RE{#,} are more
clearly described and disambiguated (plain RE{#} had not been described
at all). Reported by Jeremy Craven via email.
2001-08-01 16:56:51 +00:00
630a63cafd
Fix description of buffer_info(), and add a note that there is a better
...
way...
This closes SF bug #444842 .
2001-08-01 16:50:49 +00:00
43211ecda2
Make some adjustments to the markup, and fix up some style-guide issues.
2001-07-29 03:41:23 +00:00
66b6e192b9
Patch #416224 : add readline completion to cmd.Cmd.
2001-07-28 14:44:03 +00:00
54f65094c3
Typo fix.
2001-07-26 21:01:21 +00:00
7321ec437b
SF bug #444510 : int() should guarantee truncation.
...
It's guaranteed now, assuming the platform modf() works correctly.
2001-07-26 20:02:17 +00:00
4f1cd8bdcb
Patch #411138 : Rename config.h to pyconfig.h. Closes bug #231774 .
2001-07-26 13:41:06 +00:00
41d7d58cc4
trivial rewording in footnote 5.
2001-07-25 16:18:19 +00:00
d61e3eab44
Add entry for the new distutils section.
2001-07-24 16:20:13 +00:00
4fefcc3ce4
Overview comments for the distutils package, with links to the distutils
...
manuals for more information. This is being added to make it easier to
find the documentation for the distutils code.
2001-07-24 16:19:24 +00:00
c547b46c06
Be more specific about corner cases in the description of the $ RE syntax,
...
and include an example where the MULTILINE flag makes a real difference.
This closes SF bug #441600 .
2001-07-23 21:14:59 +00:00
6fd3b22847
When explaining the enterabs() method, using the modern spelling of apply(),
...
and relax the type of the argument list from tuple to sequence.
2001-07-23 19:28:09 +00:00
6fdb90c0ca
Remove self-reference from the anydbm module.
...
This closes SF patch #443788 .
2001-07-23 19:22:42 +00:00
8a2adcf812
Typo: Added missing "if".
...
This is part of SF patch #442788 .
2001-07-23 19:20:56 +00:00
c046e97dc2
Add StopIteration to the list of exceptions *not* derived from StandardError.
...
Slightly re-word discussion of SystemExit and fork().
This is part of SF patch #443788 .
2001-07-23 19:19:39 +00:00
63bc2e0fcb
Convert the use of apply(f, args) to the new spelling: f(*args).
...
This is part of SF patch #443788 .
2001-07-23 19:16:22 +00:00
f69868f304
Add a missing "\" to the markup.
2001-07-20 19:03:44 +00:00
960fdf9ac3
Added the constants ascii_letters, ascii_lowercase, and ascii_uppercase
...
to the string module. This was determined to be the right approach in
SF bug #226706 .
2001-07-20 18:38:26 +00:00
a3a1668904
apply patch item #416254
2001-07-20 11:04:19 +00:00
acd32d3be5
Added function xml.sax.saxutils.quoteattr().
...
This closes SF bug #440351 . It should not be moved to Python 2.1.1.
2001-07-19 16:10:15 +00:00
53d285a9af
Remove some false statements.
2001-07-19 03:49:33 +00:00
28bafb8b5d
Fix a few typos
2001-07-19 01:17:15 +00:00
72182027a8
"Make small changes, but carry a big diff."
...
Minor local consistency adjustments.
A couple of small tweaks to the setdlopenflags() description.
For setprofile() and settrace(), convert some references to become
hyperlinks in the HTML version.
2001-07-18 17:52:58 +00:00
1a2302b3b2
Add some symbolic names to support hyperlinked references.
2001-07-18 17:40:19 +00:00
5d808fba00
Made a few minor style & markup changes to the new {get,set}dlopenflags()
...
descriptions; added availability notes.
2001-07-18 16:35:05 +00:00
f0473d511b
Patch #412229 : Add functions sys.getdlopenflags and sys.setdlopenflags.
...
Add dlopenflags to PyInterpreterState, and use it in dlopen calls.
2001-07-18 16:17:16 +00:00
efaef13c81
Update the availability information for os.tempnam(), os.tmpfile(), and
...
os.tmpnam().
2001-07-17 20:39:18 +00:00
e78661bf90
Fix a couple of minor markup nits.
...
Footnotes should be added *after* punctuation, not before.
(Yes, this should be merged with the descr branch. Sorry, Tim!)
2001-07-17 05:17:58 +00:00
95400a28e4
Updated the documentation in several respects:
...
- This module, despite its name, now should conform to RFC 2822, the
update to RFC 822.
- This module doesn't just represent "email headers", but entire email
messages.
- Added documentation for other useful public functions such as
quote(), unquote(), praseaddr(), and dump_address_pair().
2001-07-16 20:47:58 +00:00
687a17deaa
Revise the description of time.clock() so that it correctly describes the
...
Windows version of the function as well as the Unix flavor.
This fixes SF bug #441357 .
2001-07-16 15:40:57 +00:00
8ee679f0ce
Minor changes to match the style guide.
2001-07-14 02:50:55 +00:00
4124a0b343
Correct a couple of errors noted by Alex Martelli.
2001-07-14 02:46:01 +00:00
7fc8abb396
Remove comments about XML and HTML; those sections are no
...
longer part of this chapter.
Minor change to match the style guide.
2001-07-14 02:44:43 +00:00
3d97e35a20
Add entry for xmlrpclib documentation.
2001-07-12 23:40:13 +00:00
5ddf7adf84
Several markup adjustments so this will format and be more consistent with
...
the rest of the documnentation.
2001-07-12 23:39:24 +00:00
f4bdb57e15
Fix return value for m.group() for groups not in the part of the RE that
...
matched; reported by Paul Moore.
Wrapped several long lines.
2001-07-12 14:13:43 +00:00
bf5a774bcb
On int/long to the negative int/long power, let float handle it
...
instead of raising an error. This was one of the two issues that the
VPython folks were particularly problematic for their students. (The
other one was integer division...) This implements (my) SF patch
#440487 .
2001-07-12 11:27:16 +00:00
e304bb9eec
First version of xmlrpclib docs. Probably has markup errors; is not complete,
...
could probably stand to have some of the internal things like Marshaller
documented. But I think it does a decent job on the entry points and
externally visible things.
Fred and Fredrik, do your stuff! You both need to proof this.
2001-07-12 02:39:45 +00:00
682d5f3cda
Follow the recommended practices for keystroke representation; this
...
improves internal consistency in the documentation.
2001-07-12 02:09:51 +00:00
9bbc933fcb
Added information about the timeout parameter to the poll() method for
...
polling objects. This closes SF bug #439823 .
Fixed a minor markup bug.
2001-07-11 18:48:39 +00:00
907e76b620
Fix up a few style nits -- avoid "e.g." and "i.e." -- these make
...
translation more difficult, as well as reading the English more
difficult for non-native speakers.
2001-07-06 20:30:11 +00:00
ab1df4fe88
Fix up a few style nits -- avoid "e.g." and "i.e." -- these make
...
translation more difficult, as well as reading the English more
difficult for non-native speakers.
Add an index entry for the Telnet protocol.
Always refer to the protocol as Telnet instead of telnet.
2001-07-06 20:23:02 +00:00
91f2f26d75
Fix up a few style nits -- avoid "e.g." and "i.e." -- these make
...
translation more difficult, as well as reading the English more
difficult for non-native speakers.
2001-07-06 19:28:48 +00:00
45c23e61d8
Explain the exit code for the wait() method, including a reference to
...
the os.W*() functions used to interpret the return value.
This fixes SF bug #429361 .
2001-07-06 17:17:12 +00:00
bcd1df746d
The fpectl module does not work on Windows, so remove Windows from the
...
\platform statement.
Also fix a minor style consistency nit in an example.
2001-07-05 21:17:08 +00:00
a939911345
Fix a markup error: do not omit a method's parameter list if it is
...
empty.
2001-07-05 21:14:03 +00:00
25211f5724
Added more information on the differences between the htmllib and HTMLParser
...
modules.
2001-07-05 16:34:36 +00:00
5fe2c139d5
List constraints on xrange() objects.
2001-07-05 15:27:19 +00:00
3f56166b1a
Rip out the fancy behaviors of xrange that nobody uses: repeat, slice,
...
contains, tolist(), and the start/stop/step attributes. This includes
removing the 4th ('repeat') argument to PyRange_New().
2001-07-05 13:27:48 +00:00
20006b2d51
Marked the parameters to Stats.print_*() as optional.
...
This closes SF bug #438032 .
2001-07-02 21:22:39 +00:00
4efb6e9643
Turns out Neil didn't intend for *all* of his gen-branch work to get
...
committed.
tokenize.py: I like these changes, and have tested them extensively
without even realizing it, so I just updated the docstring and the docs.
tabnanny.py: Also liked this, but did a little code fiddling. I should
really rewrite this to *exploit* generators, but that's near the bottom
of my effort/benefit scale so doubt I'll get to it anytime soon (it
would be most useful as a non-trivial example of ideal use of generators;
but test_generators.py has already grown plenty of food-for-thought
examples).
inspect.py: I'm sure Ping intended for this to continue running even
under 1.5.2, so I reverted this to the last pre-gen-branch version. The
"bugfix" I checked in in-between was actually repairing a bug *introduced*
by the conversion to generators, so it's OK that the reverted version
doesn't reflect that checkin.
2001-06-29 23:51:08 +00:00
0c209047ba
Correct a markup error for an accented character.
...
Reported by Milan Zamazal <pdm@zamazal.org>.
2001-06-29 16:25:07 +00:00
58c95391fa
Removed some stray periods, and fix up a number of visible markup
...
consistency errors (mostly omitted "()" at the end of function and
method names).
Reported by Milan Zamazal <pdm@zamazal.org>.
2001-06-29 16:21:47 +00:00
f29ca18df3
SourceForge bug #437041 :
...
Use a portable format in the example that creates a timestamp suitable for
use in email, also updating it and the footnote from RFC 822 to RFC 2822.
2001-06-29 15:39:53 +00:00
9f9bd6af78
Simplify an example based on comment from Thomas Holenstein <thomas@hex.ch>:
...
Do not use an extra flag variable to test only once in one subsequent if
statement.
2001-06-29 14:59:01 +00:00
69940973db
Remove duplicate ', ' in dbhash.open()'s argument list.
2001-06-27 13:49:59 +00:00
e9218a1a8e
Remove the restriction on a mapping's .update() method.
2001-06-26 20:32:59 +00:00
3e7b1a04a0
Teach the types module about generators. Thanks to James Althoff on the
...
Iterators list for bringing it up!
2001-06-25 19:46:25 +00:00
b037d33245
Updated link to zlib's home page.
2001-06-25 15:30:13 +00:00
e7e03cd0cf
Fix typo
2001-06-23 16:26:44 +00:00
ff00fdae23
Correct erroneous description of precmd.
2001-06-23 14:42:43 +00:00
8058bfa6fc
Contributed updates from Harald Hanche-Olsen, giving details of the branch
...
cuts for the complex math functions. Includes a brief description of
what branch cuts are.
2001-06-23 03:16:29 +00:00
307cb05764
Re-organize a little, clean up some markup.
...
Added some comments about sys.exit(), SystemExit, and preventing restricted
code from exiting the interpreter.
This closes SF bug #434743 .
2001-06-22 18:21:53 +00:00
f66cb5d0eb
Corrected an error in the information on supporting weak references in
...
extension types (the docs reflected a development version of the API).
This closes SF bug #435066 .
2001-06-22 17:20:29 +00:00
93438bf0a2
Fix & clean up the information about building Python with large file support
...
for Linux.
This closes SF bug #434975 .
2001-06-22 16:01:20 +00:00
d5df09cfb6
Update to include the license information in a less annoying place.
2001-06-20 21:37:34 +00:00
6016e39250
Document the new encodestring() and decodestring() functions. Also,
...
add some description of what the quotetabs argument does for the
encode*() functions. Finally, add a "see also" pointing to the base64
module.
2001-06-19 19:44:42 +00:00
918f2c722a
Document that filter is added in 2.2.
2001-06-16 08:14:04 +00:00
54d10fd2cd
Add a version annotation for the Q and q format codes.
2001-06-15 14:13:07 +00:00
8fcd4b5ab3
Fix an improperly placed comma.
2001-06-14 13:57:16 +00:00
4a6c5c568f
Fixed reference to table notes for {}.keys() and {}.items() -- these
...
references did not get updated when the notes were renumbered in a
previous update.
This fixes SF bug #432208 .
2001-06-12 03:31:56 +00:00
7a3bfc3a47
Added q/Q standard (x-platform 8-byte ints) mode in struct module.
...
This completes the q/Q project.
longobject.c _PyLong_AsByteArray: The original code had a gross bug:
the most-significant Python digit doesn't necessarily have SHIFT
significant bits, and you really need to count how many copies of the sign
bit it has else spurious overflow errors result.
test_struct.py: This now does exhaustive std q/Q testing at, and on both
sides of, all relevant power-of-2 boundaries, both positive and negative.
NEWS: Added brief dict news while I was at it.
2001-06-12 01:22:22 +00:00
0b9bc20e66
Add the appropriate availability annotations for the popen*() family of
...
functions -- these are not available on traditional Mac OS platforms.
Corrected the version annotations for the spawn*() functions and related
constants; these were added in Python 1.6, not 1.5.2.
2001-06-11 18:25:34 +00:00
046f4d810d
Fixed parameter order for os.popen2(), os.popen3(), and os.popen(4). Added
...
a reference to these functions and popen() from the "Process Management"
section.
Based on a suggestion from comp.lang.python.
2001-06-11 15:21:48 +00:00
c115835457
Fix recent changes so that this section will format again.
2001-06-11 14:55:01 +00:00
7b9542a3f7
Initial support for 'q' and 'Q' struct format codes: for now, only in
...
native mode, and only when config #defines HAVE_LONG_LONG. Standard mode
will eventually treat them as 8-byte ints across all platforms, but that
likely requires a new set of routines in longobject.c first (while
sizeof(long) >= 4 is guaranteed by C, there's nothing in C we can rely
on x-platform to hold 8 bytes of int, so we'll have to roll our own;
I'm thinking of a simple pair of conversion functions, Python long
to/from sized vector of unsigned bytes; that may be useful for GMP
conversions too; std q/Q would call them with size fixed at 8).
test_struct.py: In addition to adding some native-mode 'q' and 'Q' tests,
got rid of unused code, and repaired a non-portable assumption about
native sizeof(short) (it isn't 2 on some Cray boxes).
libstruct.tex: In addition to adding a bit of 'q'/'Q' docs (more needed
later), removed an erroneous footnote about 'I' behavior.
2001-06-10 23:40:19 +00:00
1dc98c44fe
add warning about situation where code may be executed twice, once when
...
module is __main__ and once when module is imported.
2001-06-08 14:40:28 +00:00
62f9d7c021
In the section on extending the profiler, add some additional discussion
...
about setting up the dispatch table, and update the OldProfile and
HotProfile classes to the current implementations, showing the adjusted
construction for the dispatch table.
2001-06-08 05:04:19 +00:00
e2ccb89513
Document filter.
2001-06-07 19:01:24 +00:00
e24fef0dd2
Fix bug #422702 : Make flag argument to open optional, and document it that way.
2001-06-05 05:33:19 +00:00
b9d973dac5
is -> if in rename description
2001-06-04 15:31:17 +00:00
81e142b907
Document os.getenv().
...
This closes SF bug #429059 .
2001-05-31 20:27:46 +00:00
c19f39272e
Some general cleanup of the threading module documentation, including
...
fixing the reference to Thread.getDeamon() (should be isDaemon()).
This closes SF bug #429070 .
2001-05-31 20:24:07 +00:00
6cba3d0e64
Added entry for HTMLParser documentation.
2001-05-30 04:59:50 +00:00
3b755d43ac
Michel Pelletier <michel@digicool.com>:
...
Documentation for the HTMLParser module, with small changes by FLD.
2001-05-30 04:59:00 +00:00
dc9e7e42c8
readlink() description: Added note that the return value may be either
...
absolute or relative.
remove(), rename() descriptions: Give more information about the cross-
platform behavior of these functions, so single-platform developers
can be aware of the potential issues when writing portable code.
This closes SF patch #426598 .
2001-05-29 18:13:06 +00:00
c80d4dd695
The parameter to the listen() method is not optional, but was marked as
...
optional in the documentation.
This closes SF bug #427985 .
2001-05-29 15:37:45 +00:00
56a71eee65
Add a version annotation for splitdrive(); old, but as long as I managed
...
to end up with the information, it is better recorded than lost.
2001-05-25 16:21:00 +00:00
c6d8f8d2ac
Add descriptions of {}.iteritems(), {}.iterkeys(), and {}.itervalues()
...
in the table of mapping object operations. Re-numbered the list of
notes to reflect the move of the "Added in version 2.2." note to the list
of notes instead of being inserted into the last column of the table.
2001-05-25 04:24:37 +00:00
98cfab6523
One more update related to the new get() and setdefault() methods on the
...
Message object.
2001-05-22 22:00:40 +00:00
6b4593e338
Update to add get() and setdefault() as supported mapping operations, and
...
add a list of the mapping methods which are not supported (per Barry's
comments).
2001-05-22 15:12:46 +00:00
706314909b
Add some clarifications about the mapping interface presented by
...
rfc822.Message objects, based on comments from Barry.
2001-05-22 14:36:30 +00:00
1400baa5d6
Add a "See also" section with useful links. More should be added giving
...
pointers to information about the other mailbox formats; if anyone can
provide the information needed, please let me know!
2001-05-21 21:23:01 +00:00
e9719fe1a7
Fix bug in smtplib example: the prompt said to end the message with ^D,
...
but doing so raised EOFError. This makes it work as advertised and
converts to string methods where reasonable.
This closes SF bug #424776 .
2001-05-20 12:26:04 +00:00
c0dac1a58c
Beef up the unicode() description a bit, based on material from AMK's
...
"What's New in Python ..." documents.
2001-05-15 15:27:53 +00:00
ba7e2c8a27
Add some text to make the dircmp object section more readable, and move
...
some stuff around.
2001-05-11 17:01:32 +00:00
886f113ba9
--sigh--
...
Finish the last set of changes to these files so the conversion does not
break.
2001-05-11 15:49:19 +00:00
47852467f5
Markup adjustments to avoid getting junk in the index.
2001-05-11 15:46:45 +00:00
96d7a70630
Replace "\begin{classdesc}{SomeClass}{\unspecified}" with
...
"\begin{classdesc*}{SomeClass}" -- the rendering of \unspecified was
identical to \moreargs, so this helps clarify things just a little.
2001-05-11 01:08:13 +00:00
e7ec1efe50
Fix typo in weakref.proxy() documentation.
...
This closes SF bug #423087 .
2001-05-10 17:22:17 +00:00
791c351b3d
Update example to no longer use the FCNTL module.
2001-05-10 15:57:17 +00:00
e9735ac215
Remove all mentions of the strop module -- it has been pronounced Evil.
...
(The string "strop" is found in the rexec documentation, but that should
not be changed until strop is actually removed or rexec no longer allows
it.)
2001-05-10 15:05:03 +00:00
d0de57cfbb
Update the fcntl module documentation.
2001-05-09 21:09:57 +00:00
bda3a59a93
Itamar Shtull-Trauring <python@itamarst.org>:
...
Updates zipfile.ZipFile docs to mention the fact that you can create a
ZipFile instance from an arbitrary file-like object.
This closes patch #418011 .
2001-05-09 19:57:37 +00:00
c116b82b77
Work around limitations of the module synopsis table generation to avoid
...
leaking LaTeX2HTML's internal string munging.
This fixes SF bug #420399 .
2001-05-09 15:50:17 +00:00
a7c9ac6544
There is no IMAP class in the imaplib module; the class is IMAP4.
...
There is no imap module; refer to imaplib instead, since it exists.
Move the "See Also:" section in front of the sub-sections, for
consistency with other portions of the library reference.
This closes the library reference portion of SF bug #420216 .
2001-05-09 03:49:48 +00:00
1ef24e1b30
Note that when inplace=1 existing backup files will be removed silently.
...
Closes SF bug #420230 .
2001-05-09 03:24:55 +00:00
a6140be7b3
Michael Hudson <mwh21@cam.ac.uk>:
...
Documentation update to reflect changes to the termios module (noting
that the termios functions can take a file object as well as a file
descriptor).
This closes the documentation portion of SF patch #417081 .
2001-05-08 05:37:52 +00:00
f42cc45f1b
The general iteration support is part of 2.2, not 2.1 -- fixed the version
...
annotations!
Also fixed a typo noted by Neil S.
2001-05-03 04:39:10 +00:00
9cfe1824c2
Add documentation for the StopIteration exception.
2001-05-03 04:30:45 +00:00
287c4cb43a
State that Mailbox objects are iterator objects.
2001-05-02 20:22:12 +00:00
eacdec6b38
Update the filter() and list() descriptions to include information about
...
the support for containers and iteration.
2001-05-02 20:19:19 +00:00
93656e76f9
Added section describing the iterator protocol.
2001-05-02 20:18:03 +00:00
8b3d6ca3df
At the suggestion of Peter Funk, document 'key in dict' and 'key not
...
in dict' after has_key(), with a \versionadded{2.2} note.
2001-04-23 13:22:59 +00:00
82f93c693d
Only document <file>.xreadlines() once; added version annotation.
...
This closes SF bug #417943 .
2001-04-22 01:56:51 +00:00
4cacec5393
Fix a number of minor markup errors.
2001-04-21 05:56:06 +00:00
0dbb4fba4c
Implement, test and document "key in dict" and "key not in dict".
...
I know some people don't like this -- if it's really controversial,
I'll take it out again. (If it's only Alex Martelli who doesn't like
it, that doesn't count as "real controversial" though. :-)
That's why this is a separate checkin from the iterators stuff I'm
about to check in next.
2001-04-20 16:50:40 +00:00
1aec3a16f3
Add versioning notes: many of the signatures changed to allow the time
...
used to be omitted (meaning use the current time) as of Python 2.1.
Users who need cross-version portability need to know things like this.
2001-04-19 04:55:23 +00:00
bc524c4e9f
Cut-&-paste-o noted by Wolfgang Teschner: decompressobj() returns
...
*DE*compression objects, not compression objects!
2001-04-18 20:16:51 +00:00
895aa9da4c
Suggestion from Keith Briggs: refer to RE objects consistently instead of
...
introducing a new term ("regex") without defining it.
2001-04-18 17:26:20 +00:00
293f77af6f
Add note about the version in which GetoptError was added -- this can
...
bite people interested in 1.5.2 compatibility.
2001-04-18 03:18:57 +00:00
c054c75582
Work around the conversion of ">>" and "<<" to guillemets. Reported by Ping.
2001-04-13 17:25:38 +00:00
a3e56a6ceb
Minor markup adjustments.
...
Turn reference to the cmd module into a hyperlink.
2001-04-13 14:34:58 +00:00
4f3980d3cb
Added a test main to the pstats library that can help you browse profile dumps.
2001-04-13 00:23:01 +00:00
47f11ce591
Added warning that FancyURLopener prompts the user on the terminal when
...
basic authentication is needed.
Added documentation for FancyURLopener.prompt_user_passwd(), explaining
that subclasses should provide more appropriate behavior for the hosting
environment.
2001-04-12 20:26:49 +00:00
62a26699c4
Added module synopsis for the chapter summary.
...
Added documentation for TestCase.assertRaises().
Added text for "Mapping concepts to classes", and merged it into the
front matter instead of separating it into a new section.
Removed use of "assert" in examples.
Update the descriptions to reflect further changes from discussions on
the pyunit-interest list.
Added documentation for the defaultTestLoader object and the
TestLoader methods.
Added the assert*() names for the TestCase helper methods.
2001-04-12 19:34:38 +00:00
e20bd19f86
Convert several \seetext references to \seerfc and \seetitle versions.
...
These format somewhat better and include more semantic information in the
source.
2001-04-12 16:47:17 +00:00
0056a427bb
Added a lot of text from Steve Purcell's HTML documentation.
...
Updated reference material substantially based on discussions on the
pyunit-interest mailing list (not all changes are in the code in CVS
yet).
2001-04-12 04:50:06 +00:00
b942c2f788
Fixed bug in example.
...
This closes SF bug #415522 .
Also fix markup error in text following the example.
2001-04-11 21:33:47 +00:00
c3cbbaf513
Added some additional documentation describing how BabylMailbox
...
actually works (it returns a message containing the visible headers,
not the original headers). Doc change approved by Fred; closes SF bug
#412230 .
2001-04-11 20:12:33 +00:00
eedf985056
Include a synopsis for the chapter overview.
2001-04-11 19:17:11 +00:00
2bd0d88360
Fixing bug 405999 -- clarifying differences between Python's
...
getopt and GNU getopt -- Python is like classical UNIX getopt.
2001-04-11 07:33:08 +00:00
29be70195a
Added definition of "test fixture".
...
Added description of optional parameter to the TestSuite constructor.
Added descriptions of the TestLoader and TextTestRunner classes.
Added method descriptions for the TestCase class.
2001-04-10 22:25:06 +00:00
ac154a17a3
Remove the mapping() function from the documentation.
...
Add a description of the ReferenceError exception.
2001-04-10 19:57:58 +00:00
da00cda9fa
Add note that difflib was added in Python 2.1.
2001-04-10 19:56:09 +00:00
cfac6d23fd
Normalize tabs to spaces.
...
Update the attribution for the "Curses Programming with Python" How-To.
Change the way the reference to the Demo/curses/ directory is marked up.
2001-04-10 18:49:09 +00:00
6fda3ac474
Add reference to the DDJ article discussing a similar algorithm.
2001-04-10 18:41:16 +00:00
90a72f8dcd
Add documentation for getmoduleinfo() and getmodulename().
2001-04-10 15:12:34 +00:00
819815abea
Fix typo in example (\b should be \n in string literal).
...
This closes SF bug #414279 .
2001-04-09 15:57:06 +00:00
9c846366ee
Fix a number of bugs and omissions in the AddressList documentation, most
...
noted by Steve Holden.
This closes SF bug #413876 .
2001-04-09 15:42:56 +00:00
501d90471d
Add entry for unittest documentation.
2001-04-07 05:42:14 +00:00
b9ad228798
Start of documentation for the unittest module. Some of this comes from
...
Steve Purcell's documentation, and a lot of it is written based on
using PyUnit and reading the implementation.
There is more to come, but I want to get this check in before I have a
disk crash or anything else bad happens.
2001-04-07 05:41:39 +00:00
4cf1227e56
Change {\em ...} to \emph{...} for consistency with the rest of the Python
...
documentation.
2001-04-05 18:31:27 +00:00
Fred Drake
Tim Peters
Anthony Baxter
Walter Dörwald
Skip Montanaro
Martin v. Löwis
Guido van Rossum
Andrew M. Kuchling
Neal Norwitz
Neil Schemenauer
Piers Lauder
Greg Ward
Thomas Heller
Jeremy Hylton
Barry Warsaw
Marc-André Lemburg
Fredrik Lundh
Eric S. Raymond
Michael W. Hudson
Thomas Wouters
Moshe Zadka