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
cbe801697b
Add punctuation mark; add some examples
2006-07-27 19:07:29 +00:00
f60eeb1738
Update URL; add example
2006-07-27 18:53:33 +00:00
623005e94a
Add missing word
2006-07-27 18:42:41 +00:00
5ee6616528
Typo fix ('publically' is rare, poss. non-standard)
2006-07-27 18:41:21 +00:00
9dd8dc3fee
Add example
2006-07-27 18:37:33 +00:00
48fae7acd2
Resync optparse with Optik 1.5.3: minor tweaks for/to tests.
2006-07-23 16:05:51 +00:00
b110bad2d9
More RFC 2231 improvements for the email 4.0 package. As Mark Sapiro rightly
...
points out there are really two types of continued headers defined in this
RFC (i.e. "encoded" parameters with the form "name*0*=" and unencoded
parameters with the form "name*0="), but we were were handling them both the
same way and that isn't correct.
This patch should be much more RFC compliant in that only encoded params are
%-decoded and the charset/language information is only extract if there are
any encoded params in the segments. If there are no encoded params then the
RFC says that there will be no charset/language parts.
Note however that this will change the return value for Message.get_param() in
some cases. For example, whereas before if you had all unencoded param
continuations you would have still gotten a 3-tuple back from this method
(with charset and language == None), you will now get just a string. I don't
believe this is a backward incompatible change though because the
documentation for this method already indicates that either return value is
possible and that you must do an isinstance(val, tuple) check to discriminate
between the two. (Yeah that API kind of sucks but we can't change /that/
without breaking code.)
Test cases, some documentation updates, and a NEWS item accompany this patch.
2006-07-21 14:51:07 +00:00
3fda93604c
markup fix
2006-07-20 20:11:57 +00:00
9325ba6df4
Updated documentation for TimedRotatingFileHandler relating to how rollover files are named. The previous documentation was wrongly the same as for RotatingFileHandler.
2006-07-20 16:28:39 +00:00
caebe22038
Fix bug #1520914 . Starting in 2.4, time.strftime() began to check the bounds
...
of values in the time tuple passed in. Unfortunately people came to rely on
undocumented behaviour of setting unneeded values to 0, regardless of if it was
within the valid range. Now those values force the value internally to the
minimum value when 0 is passed in.
2006-07-18 04:41:36 +00:00
83fa22f564
document xmlcore (still minimal; needs mention in each of the xml.* modules)
...
SF bug #1504456 (partial)
2006-07-17 05:47:52 +00:00
76e268bb62
typo
2006-07-14 21:45:48 +00:00
b69a3c2bda
Updates for the ctypes documentation.
2006-07-14 18:22:50 +00:00
7d1d43630e
Bug #1223937 : CalledProcessError.errno -> CalledProcessError.returncode.
2006-07-14 14:04:45 +00:00
76c5af6216
Fix the wrong description of LibraryLoader.LoadLibrary, and document
...
the DEFAULT_MODE constant.
2006-07-12 14:25:18 +00:00
06c68b800c
Patch #1519566 : Remove unused _tofill member.
...
Make begin_fill idempotent.
Update demo2 to demonstrate filling of concave shapes.
2006-07-10 22:11:28 +00:00
32a8361f2d
After approval from Anthony, merge the tim-current_frames
...
branch into the trunk. This adds a new sys._current_frames()
function, which returns a dict mapping thread id to topmost
thread stack frame.
2006-07-10 21:08:24 +00:00
56640df6c3
Patch #1504046 : Add documentation for xml.etree.
...
/F wrote the text docs, Englebert Gruber massaged it to latex and I
did some more massaging to try and improve the consistency and
fix some name mismatches between the declaration and text.
2006-07-10 02:36:41 +00:00
b6b175229b
Fix RFC number.
2006-07-07 08:15:12 +00:00
2bfe3a9dbf
Cover ImportWarning, PendingDeprecationWarning and simplefilter() in the warnings module docs
2006-07-06 13:41:34 +00:00
56829d5b4a
Revert the __module_name__ changes made in rev 47142. We'll revisit this in Python 2.6
2006-07-06 12:53:04 +00:00
b979b35f70
Document the changes in svn revision 47263, from patch #1517790 .
2006-07-06 09:11:22 +00:00
f40aed930a
Document the Struture and Union constructors.
2006-07-06 08:58:40 +00:00
d41f4ce0c8
no need to elaborate "string".
2006-07-05 15:50:05 +00:00
f41beacecb
Patch #1517490 : fix glitches in filter() docs.
2006-07-05 14:18:45 +00:00
2eda1b78f9
[Bug #1511911 ] Clarify description of optional arguments to sorted()
...
by improving the xref to the section on lists, and by
copying the explanations of the arguments (with a slight modification).
2006-07-03 14:16:09 +00:00
f896795103
[Bug #1515932 ] Clarify description of slice assignment
2006-07-03 14:07:30 +00:00
82c276ea33
Document functions added in 2.3 and 2.5.
2006-07-03 11:12:06 +00:00
6f42dfce7c
- consistency nit: always include "()" in \function and \method
...
(*should* be done by the presentation, but that requires changes all over)
- avoid spreading the __name meme
2006-06-30 19:29:25 +00:00
348b7c8304
Document decorator usage of property.
2006-06-30 18:47:56 +00:00
4ef256cab0
add string methods to index
2006-06-29 19:20:09 +00:00
ecfec78b7b
[Bug #1508766 ] Add docs for uuid module; this puts the module in the 'Internet Protocols' section. Arguably this module could also have gone in the chapters on strings or encodings, maybe even the crypto chapter. Fred, please move if you see fit.
2006-06-28 14:27:21 +00:00
146d3924b0
[Bug #1508766 ] Add docs for uuid module; docs written by George Yoshida, with minor rearrangements by me.
2006-06-28 14:25:20 +00:00
999a336ad7
Make full module name available as __module_name__ even when __name__ is set to something else (like '__main__')
2006-06-28 10:41:47 +00:00
978ec9a89f
Small fixes, mostly in the markup.
2006-06-22 19:07:36 +00:00
066769c307
Fix typos.
...
Fix doctest example.
Mention in the tutorial that 'errcheck' is explained in the ref manual.
Use better wording in some places.
Remoce code examples that shouldn't be in the tutorial.
Remove some XXX notices.
2006-06-18 21:27:04 +00:00
3f1f7bec74
Update url.
...
Old url returned status code:301 Moved permanently.
2006-06-17 16:39:13 +00:00
Georg Brandl
Neal Norwitz
George Yoshida
Martin v. Löwis
Andrew M. Kuchling
Thomas Heller
Skip Montanaro
Vinay Sajip
Ronald Oussoren
Brett Cannon
Fred Drake
Ka-Ping Yee
Raymond Hettinger
Nick Coghlan
Armin Rigo
Anthony Baxter
Marc-André Lemburg
Gregory P. Smith
Andrew McNamara
Matt Fleming
Phillip J. Eby
Tim Peters
Barry Warsaw
Greg Ward
Fredrik Lundh
Peter Astrand