7c4615b252
Update broken link. Will backport to 2.5.
2007-02-09 12:58:49 +00:00
3156316823
SF: 1397711 Set docs conflated immutable and hashable
2007-02-07 21:04:20 +00:00
3f8aca1164
Patch #1652681 : create nonexistent files in append mode and
...
allow appending to empty files.
2007-02-06 18:38:13 +00:00
129bd52146
No more raising of string exceptions!
...
The next step of PEP 352 (for 2.6) causes raising a string exception to trigger
a TypeError. Trying to catch a string exception raises a DeprecationWarning.
References to string exceptions has been removed from the docs since they are
now just an error.
2007-01-30 21:34:36 +00:00
a05153683c
Bug #1648191 : typo in docs.
2007-01-30 20:21:30 +00:00
391e917b1a
Strengthen warning about using lock()
2007-01-24 20:06:41 +00:00
aef4c6bc00
Patch #1610575 : Add support for _Bool to struct.
2007-01-21 09:33:07 +00:00
1b0ce85271
SF# 1635892: Fix docs for betavariate's input parameters .
2007-01-19 18:07:18 +00:00
3ffcfe2f68
[Part of bug #1599254 ] Add suggestion to Mailbox docs to use Maildir, and warn user to lock/unlock mailboxes when modifying them
2007-01-17 19:55:06 +00:00
f5c034af10
Add a note for strptime that just because strftime supports some extra
...
directive that is not documented that strptime will as well.
2007-01-15 19:12:08 +00:00
2799aab86d
Doc patch matching r53434 (htonl etc. now always take/return positive ints).
2007-01-15 00:02:35 +00:00
1ff01fb0af
Added documentation for WatchedFileHandler (based on SF patch #1598415 )
2007-01-14 21:50:50 +00:00
7ded34d25e
Fix typo.
2007-01-13 12:31:51 +00:00
093b67061a
Deprecate the sets module.
2007-01-13 00:29:49 +00:00
78a132b814
Fix error where the end of a funcdesc environment was accidentally moved too
...
far down.
2007-01-12 07:27:52 +00:00
764a7ec8ca
- Make the documentation match the code and the docstring
2007-01-11 10:26:31 +00:00
d92d3c7197
typo fix
2007-01-05 07:21:35 +00:00
8b96a35d14
Support linking of the bsddb module against BerkeleyDB 4.5.x
...
(will backport to 2.5)
2007-01-05 01:59:42 +00:00
92d54d5e9c
Add EnvironmentVarGuard to test.test_support. Provides a context manager to
...
temporarily set or unset environment variables.
2007-01-04 00:23:49 +00:00
d5624cf6c9
Fix wrong markup of an argument in a method signature.
...
Will backport.
2006-12-21 18:30:56 +00:00
4a8d272dca
Mention the os.SEEK_* constants
2006-12-21 13:40:29 +00:00
2dd7c8c41e
[Bug #1619680 ] in_dll() arguments are documented in the wrong order
2006-12-20 20:20:42 +00:00
a490d59fbb
Some other built-in functions are described with 'sequence' arguments
...
that should really be 'iterable'; this commit changes them.
Did I miss any? Did I introduce any errors?
2006-12-20 20:11:12 +00:00
b688573766
Two grammar fixes
2006-12-20 19:58:11 +00:00
1be2ac9cd6
[Bug #1619674 ] Make sum() use the term iterable, not sequence
2006-12-20 19:57:10 +00:00
ebbeed781d
Patch #1484695 : The tarfile module now raises a HeaderError exception
...
if a buffer given to frombuf() is invalid.
2006-12-19 22:06:46 +00:00
8183c635bc
Updated documentation for findCaller() to indicate that a 3-tuple is now returned, rather than a 2-tuple.
2006-12-19 18:29:11 +00:00
64df22bdb5
[Bug #1613651 ] Document socket.recv_into, socket.recvfrom_into
...
Also, the text for recvfrom told you to read recv() for an explanation of the
'flags' argument, but recv() just pointed you at the man page. Copied the
man-page text to recvfrom(), recvfrom_into, recv_into to avoid the pointless
redirection.
I don't have LaTeX on this machine; hope my markup is OK.
2006-12-19 14:28:23 +00:00
4cd69d43e8
[Bug #1618083 ] Add missing word; make a few grammar fixes
2006-12-18 17:12:31 +00:00
7366fcecdf
Note that guard_warnings_filter was added in 2.6
2006-12-14 02:22:44 +00:00
6d9520c4f0
Add test.test_support.guard_warnings_filter . This function returns a context
...
manager that protects warnings.filter from being modified once the context is
exited.
2006-12-13 23:09:53 +00:00
0adf0846ce
Fix a typo
2006-12-11 01:01:06 +00:00
ebde1498e7
- Fix the build of the library reference in info format.
2006-12-09 12:15:27 +00:00
70f466932c
RFE #1592899 : mention string.maketrans() in docs for str.translate,
...
remove reference to the old regex module in the former's doc.
2006-12-07 09:30:06 +00:00
0a286d0b53
Fix pickle doc typo
...
Patch #1608758
2006-12-05 05:39:50 +00:00
9be4905f42
fix a versionchanged tag
2006-12-04 11:41:54 +00:00
a00bcac003
Patch #1371075 : Make ConfigParser accept optional dict type
...
for ordering, sorting, etc.
2006-12-03 12:01:53 +00:00
73e7e058f5
Bug #1603789 : grammatical error in Tkinter docs.
2006-11-27 18:46:21 +00:00
3f969022c6
Bug #1601630 : little improvement to getopt docs
2006-11-23 09:55:07 +00:00
7ac039653e
Fix SF #1599879 , socket.gethostname should ref getfqdn directly.
2006-11-21 06:23:44 +00:00
1e753863b3
Further markup fix.
2006-11-20 07:12:58 +00:00
942f5e7864
markup fix
2006-11-20 02:24:48 +00:00
07529354db
Patch #1070046 : Marshal new-style objects like InstanceType
...
in xmlrpclib.
2006-11-19 18:51:54 +00:00
540821183b
Bug #1597824 : return the registered function from atexit.register()
...
to facilitate usage as a decorator.
2006-11-16 16:50:59 +00:00
adff8eb8d6
Bug #1597576 : mention that the new base64 api has been introduced in py2.4.
2006-11-16 15:05:14 +00:00
056dac1bcf
Bug #1067760 : Deprecate passing floats to file.seek.
2006-11-12 18:24:26 +00:00
040a927cd1
Patch #1065257 : Support passing open files as body in
...
HTTPConnection.request().
2006-11-12 10:32:47 +00:00
1ee79f16e8
Bug #1594758 : wording improvement for dict.update() docs.
2006-11-11 18:32:47 +00:00
361bc21c51
Bug #1594742 : wrong word in stringobject doc.
2006-11-11 18:29:11 +00:00
48b1007542
[Feature request #1542920 ] Link to wsgi.org
2006-11-10 14:39:01 +00:00
fafdc3b97b
Bug #1592533 : rename variable in heapq doc example, to avoid shadowing
...
"sorted".
2006-11-08 10:04:29 +00:00
9bfc24481f
Fix grammatical error as well.
...
Will backport to release25-maint.
2006-11-07 18:20:47 +00:00
a2dd0f3a17
Fix markup.
...
Will backport to release25-maint.
2006-11-07 18:01:18 +00:00
3230599329
note that user can control directory location even if default dir is used
2006-11-06 14:34:52 +00:00
be1bc3b63a
Fix a code example by adding a missing import.
...
Fixes #1557890 .
Will backport to release25-maint.
2006-11-02 20:22:29 +00:00
b11472358f
Replace the XXX marker in the 'Arrays and pointers' reference manual
...
section with a link to the tutorial sections.
Will backport to release25-maint.
2006-11-02 19:48:24 +00:00
12411005e3
Added relativeCreated to Formatter doc (has been in the system for a long time - was unaccountably left out of the docs and not noticed until now).
2006-10-31 17:34:31 +00:00
4bb9b56501
From SF 1557890, fix problem of using wrong type in example.
...
Will backport.
2006-10-28 22:12:26 +00:00
35692a0c0e
Fix nth() itertool recipe.
2006-10-28 16:04:04 +00:00
d3aad0199e
Point users to the subprocess module in the docs for os.system, os.spawn*, os.popen2, and the popen2 and commands modules
2006-10-27 14:53:41 +00:00
4bc64aaef7
[Bug #1562583 ] Mention the set_reuse_addr() method
2006-10-27 13:06:25 +00:00
14b0cab5d5
[Bug #1583946 ] Reword description of server and issuer
2006-10-27 12:50:38 +00:00
514d0cf40e
[Bug #1585690 ] Note that line_num was added in Python 2.5
2006-10-27 12:18:38 +00:00
1192044445
Some wording changes and markup fixes
2006-10-27 11:37:01 +00:00
ee82c0e6b7
Patch #1567274 : Support SMTP over TLS.
2006-10-27 07:13:28 +00:00
10168f25ad
Patch #1580674 : with this patch os.readlink uses the filesystem encoding to
...
decode unicode objects and returns an unicode object when the argument is one.
2006-10-22 10:45:18 +00:00
5a72372329
Clean up the language of a sentence relating to the connect() function and
...
user-defined datatypes.
2006-10-14 06:36:45 +00:00
a9969a6460
Small grammar fix, thanks Sjoerd.
2006-10-12 11:59:27 +00:00
10f0f691d3
Add a note to fpectl docs that it's not built by default
...
(bug #1556261 ).
2006-10-12 11:41:11 +00:00
7d74a0e287
Bug #1546628 : add a note about urlparse.urljoin() and absolute paths.
2006-10-12 11:14:40 +00:00
fc8375748a
Bug #1575746 : fix typo in property() docs.
2006-10-12 07:38:04 +00:00
fe6e46d42a
Note that the excel_tab class is registered as the "excel-tab" dialect.
...
Fixes 1572471. Make a similar change for the excel class and clean up
references to the Dialects and Formatting Parameters section in a few
places.
2006-10-07 11:05:02 +00:00
c536a64b89
Case fix
2006-10-06 10:41:01 +00:00
3c108b0e44
- update links
...
- remove Sleepycat name now that they have been bought
2006-10-06 00:03:45 +00:00
710513ef83
Clarify what "re-initialization" means for init_builtin() and init_dynamic().
...
Also remove warning about re-initialization as possibly raising an execption as
both call _PyImport_FindExtension() which pulls any module that was already
imported from the Python process' extension cache and just copies the __dict__
into the module stored in sys.modules.
2006-10-05 22:02:31 +00:00
f4686f995e
Documentation clarified to mention optional parameters.
2006-10-03 18:20:26 +00:00
cfbb7df4b0
Documentation omitted the additional parameter to LogRecord.__init__ which was added in 2.5. (See SF #1569622 ).
2006-10-03 18:02:37 +00:00
fb25773862
Bug #1566663 : remove obsolete example from datetime docs.
2006-09-30 09:06:45 +00:00
13782a3359
revise explanation of returns_unicode to reflect bool values
...
and to include the default value
(merged from release25-maint revision 51890)
2006-09-15 16:11:27 +00:00
a58f123602
- fix module name in links in formatted documentation
...
- minor markup cleanup
(forward-ported from release25-maint revision 51888)
2006-09-15 15:18:04 +00:00
c9ded90368
Correct elementtree module index entry.
2006-09-15 05:22:24 +00:00
cdf6afde1a
Fix grammar errors and improve clarity.
2006-09-15 00:34:19 +00:00
ab856873f1
More wordsmithing
2006-09-12 21:21:51 +00:00
32cec80b02
Some editing, markup fixes
2006-09-12 21:09:02 +00:00
abd5520cff
Markup typo fix
2006-09-12 20:50:23 +00:00
af57f6065f
Fix typo in example
2006-09-08 14:05:10 +00:00
6d75567238
Use native SQLite types
2006-09-08 14:03:01 +00:00
2b46434109
Explain SQLite a bit more clearly
2006-09-08 13:36:36 +00:00
c48c9e266f
Bug #1552618 : change docs of dict.has_key() to reflect recommendation
...
to use "in".
2006-09-05 12:44:58 +00:00
a0c95fa4d8
Fix endcase for str.rpartition()
2006-09-04 15:32:48 +00:00
5a901c62cc
Typo fix for decimal docs
2006-09-03 01:06:07 +00:00
f1f42d850f
Fix final documentation nits before backporting decimal module fixes to 2.5
2006-09-03 01:02:00 +00:00
68b6d3b85a
Fix documentation nits for decimal context managers.
2006-09-02 17:07:23 +00:00
e7877d930c
Further corrections to the decimal module context management documentation
2006-09-02 04:04:18 +00:00
eef345aa97
- SF patch #1550263 : Enhance and correct unittest docs
...
- various minor cleanups for improved consistency
2006-09-01 03:57:19 +00:00
8b6999b4c5
Fix the wrongheaded implementation of context management in the decimal module and add unit tests. (python-dev discussion is ongoing regarding what we do about Python 2.5)
2006-08-31 12:00:43 +00:00
f580b104a4
Doc fix: hashlib objects don't always return a digest of 16 bytes.
...
Backport candidate for 2.5.
2006-08-31 08:51:06 +00:00
c85578725b
patch for documentation for recent uuid changes (from ping)
2006-08-22 07:36:59 +00:00
f5af05a211
Tutorial:
...
Clarify somewhat how parameters are passed to functions
(especially explain what integer means).
Correct the table - Python integers and longs can both be used.
Further clarification to the table comparing ctypes types, Python
types, and C types.
Reference:
Replace integer by C ``int`` where it makes sense.
2006-08-16 18:02:11 +00:00
040f76b79c
Slightly revised version of patch #1538956 :
...
Replace UnicodeDecodeErrors raised during == and !=
compares of Unicode and other objects with a new
UnicodeWarning.
All other comparisons continue to raise exceptions.
Exceptions other than UnicodeDecodeErrors are also left
untouched.
2006-08-14 10:55:19 +00:00
30c0d1d174
Reword paragraph to clarify
2006-08-08 18:50:14 +00:00
212b587a52
Patch #1534922 : correct and enhance unittest docs.
2006-08-05 06:10:54 +00:00
f4152c3215
Fix mangled sentence
2006-08-04 21:10:03 +00:00
d856ce0a1f
fix typos
2006-08-04 05:17:47 +00:00
5c387f2e5d
Fix a mistake.
2006-08-02 12:00:13 +00:00
6a0ce407fb
A few nore words about what ctypes does.
...
Document that using the wrong calling convention can also raise
'ValueError: Procedure called with the wrong number of arguments'.
2006-08-02 11:35:31 +00:00
b7697a50fb
[Bug #848556 ] Remove \d* from second alternative to avoid exponential case when repeating match
2006-07-31 16:22:05 +00:00
aa95fdb783
[Bug #1514540 ] Instead of putting the standard types in a section, put them in a chapter of their own. This means string methods will now show up in the ToC. (Should the types come before or after the functions+exceptions+constants chapter? I've put them after, for now.)
2006-07-31 16:10:24 +00:00
ec3a89449e
Remove reference to notation
2006-07-31 15:23:43 +00:00
17159fe26f
Typo fix
2006-07-31 15:22:58 +00:00
759c185ce0
minor tweaks
2006-07-31 03:11:11 +00:00
08bbccf369
minor tweaks
2006-07-31 03:09:45 +00:00
10183b8e40
Redo the comment about the 2.5 change in quoted-newline handling.
2006-07-31 02:27:48 +00:00
e34ac7ce7a
Bug #1002398 : The documentation for os.path.sameopenfile now correctly
...
refers to file descriptors, not file objects.
2006-07-30 11:07:23 +00:00
33c3e29fce
- remove yet another reference to how commonly Tkinter is (thought to be) used
...
- fix an internal section reference
2006-07-30 05:55:39 +00:00
21731118af
remove possibly-outdated comment on what GUI toolkit is most commonly used;
...
it is hard to know whether this is right, and it does not add valuable reference information
at any rate
2006-07-30 05:49:49 +00:00
c3c805e8b2
update information on wxPython, from Robin Dunn
2006-07-30 05:41:28 +00:00
e0d4aecfc2
lots of markup nits, most commonly Unix/unix --> \UNIX
2006-07-30 03:03:43 +00:00
ad416d056f
[Bug #793553 ] Correct description of keyword arguments for SSL authentication
2006-07-30 00:37:56 +00:00
d457a97beb
markup cleanups
2006-07-29 23:34:57 +00:00
2d5c8e3bb1
Fix case for 'Unix'
2006-07-29 21:30:21 +00:00
b9a79c95dc
Follow TeX's conventions for hyphens
2006-07-29 21:27:12 +00:00
a650fb3d6f
fix minor markup error that introduced extra punctuation
2006-07-29 20:21:25 +00:00
abd51a3585
Add a comment to the csv reader documentation that explains why the
...
treatment of newlines changed in 2.5. Pulled almost verbatim from a comment
by Andrew McNamara in <http://python.org/sf/1465014 >.
2006-07-29 20:06:05 +00:00
45540b0922
SF bug #1193966 : Weakref types documentation misplaced
...
The information about supporting weakrefs with types defined in C extensions
is moved to the Extending & Embedding manual. Py_TPFLAGS_HAVE_WEAKREFS is
no longer mentioned since it is part of Py_TPFLAGS_DEFAULT.
2006-07-29 20:04:42 +00:00
9964fdb466
[Patch #1068277 ] Clarify that os.path.exists() can return False depending on permissions. Fred approved committing this patch in December 2004!
2006-07-29 19:50:37 +00:00
956597f4ef
Reorganize the docs for 'file' and 'open()' after some discussion with Fred.
...
We want to encourage users to write open() when opening a file, but
open() was described with a single paragraph and
'file' had lots of explanation of the mode and bufsize arguments.
I've shrunk the description of 'file' to cross-reference to the 'File
objects' section, and to open() for an explanation of the arguments.
open() now has all the paragraphs about the mode string. The bufsize
argument was moved up so that it isn't buried at the end; now there's
1 paragraph on mode, 1 on bufsize, and then 3 more on mode. Various
other edits and rearrangements were made in the process.
It's probably best to read the final text and not to try to make sense
of the diffs.
2006-07-29 18:14:07 +00:00
fbdeaad069
expunge the xmlcore changes:
...
41667, 41668 - initial switch to xmlcore
47044 - mention of xmlcore in What's New
50687 - mention of xmlcore in the library reference
re-apply xmlcore changes to xml:
41674 - line ending changes (re-applied manually), directory props
41677 - add cElementTree wrapper
41678 - PSF licensing for etree
41812 - whitespace normalization
42724 - fix svn:eol-style settings
43681, 43682 - remove Python version-compatibility cruft from minidom
46773 - fix encoding of \r\n\t in attr values in saxutils
47269 - added XMLParser alias for cElementTree compatibility
additional tests were added in Lib/test/test_sax.py that failed with
the xmlcore changes; these relate to SF bugs #1511497 , #1513611
2006-07-29 16:56:15 +00:00
e49741d412
[Bug #1528258 ] Mention that the 'data' argument can be None.
...
The constructor docs referred the reader to the add_data() method's docs,
but they weren't very helpful. I've simply copied an earlier explanation
of 'data' that's more useful.
2006-07-29 15:57:08 +00:00
aab30d0f08
Fix typo
2006-07-29 15:55:30 +00:00
b9d7e04880
[Bug #1530382 ] Document SSL.server(), .issuer() methods
2006-07-29 15:35:21 +00:00
7092f4ce9f
[Bug #1519571 ] Document some missing functions: setup(), title(), done()
2006-07-29 14:42:48 +00:00
dafb1e59c9
[Bug #1529157 ] Mention raw_input() and input(); while I'm at it, reword the description a bit
2006-07-29 14:21:15 +00:00
3ec3f78c8a
Reword paragraph to match the order of the subsequent sections
2006-07-29 14:08:15 +00:00
144691cfd8
Update URL
2006-07-29 14:04:47 +00:00
35f64c12d3
Add example
2006-07-29 13:56:48 +00:00
9fd21e31b6
Bug #835255 : The "closure" argument to new.function() is now documented.
2006-07-29 08:51:21 +00:00
f7575d0cb7
Bug #1529871 : The speed enhancement patch #921466 broke Python's compliance
...
with PEP 302. This was fixed by adding an ``imp.NullImporter`` type that is
used in ``sys.path_importer_cache`` to cache non-directory paths and avoid
excessive filesystem operations during imports.
2006-07-28 21:12:07 +00:00
39d7739e6c
Add example. Should I propagate this example to all the other DBM-ish modules, too?
2006-07-28 12:48:07 +00:00
1d69a7013f
Don't overwrite built-in name; add some blank lines for readability
2006-07-28 12:45:55 +00:00
bd468103e0
Add example
2006-07-28 12:33:19 +00:00
4036f43cac
Add example
2006-07-28 12:32:43 +00:00
984b075978
Typo fix
2006-07-28 12:18:22 +00:00
750c4420a8
Live with that "the hardware address" is an ill-defined
...
concept, and that different ways of trying to find "the
hardware address" may return different results. Certainly
true on both of my Windows boxes, and in different ways
(see whining on python-dev).
2006-07-28 04:51:59 +00:00
00decd7835
Patch #1520294 : Support for getset and member descriptors in types.py,
...
inspect.py, and pydoc.py. Specifically, this allows for querying the type of
an object against these built-in C types and more importantly, for getting
their docstrings printed in the interactive interpreter's help() function.
This patch includes a new built-in module called _types which provides
definitions of getset and member descriptors for use by the types.py module.
These types are exposed as types.GetSetDescriptorType and
types.MemberDescriptorType. Query functions are provided as
inspect.isgetsetdescriptor() and inspect.ismemberdescriptor(). The
implementations of these are robust enough to work with Python implementations
other than CPython, which may not have these fundamental types.
The patch also includes documentation and test suite updates.
I commit these changes now under these guiding principles:
1. Silence is assent. The release manager has not said "no", and of the few
people that cared enough to respond to the thread, the worst vote was "0".
2. It's easier to ask for forgiveness than permission.
3. It's so dang easy to revert stuff in svn, that you could view this as a
forcing function. :)
Windows build patches will follow.
2006-07-27 23:43:15 +00:00
fc0e61d9b6
Add example
2006-07-27 22:49:54 +00:00
752e28ad9f
Add example
2006-07-27 22:49:38 +00:00
4b6d53780d
Reword paragraph
2006-07-27 22:40:05 +00:00
cff784caa7
If binhex is higher-level than binascii, it should come first in the chapter
2006-07-27 19:12:49 +00:00
40b35aa5cc
Mention base64 module; rewrite last sentence to be more positive
2006-07-27 19:11:07 +00:00
Martin v. Löwis
Raymond Hettinger
Lars Gustäbel
Brett Cannon
Georg Brandl
Andrew M. Kuchling
Guido van Rossum
Vinay Sajip
Matthias Klose
Gregory P. Smith
Thomas Heller
George Yoshida
Neal Norwitz
Skip Montanaro
Ronald Oussoren
Fred Drake
Ka-Ping Yee
Nick Coghlan
Armin Rigo
Anthony Baxter
Marc-André Lemburg
Andrew McNamara
Matt Fleming
Phillip J. Eby
Tim Peters
Barry Warsaw