1884dda233
Warn that settrace() is implementation rather than language
...
definition, per Guido's request in off-list email.
2004-08-05 12:13:46 +00:00
4c8fa42aca
Doc/lib/libfuncs.tex: correct items in itemize
...
Doc/dist/dist.tex: avoid uncommenting the verbose environment (by the py2texi tool)
2004-08-04 23:18:49 +00:00
1cf56d0b8a
Updated Logger.log() documentation to clarify that lvl parameter should be an integer.
2004-08-04 08:36:44 +00:00
e9ddfbb412
SF #989185 : Drop unicode.iswide() and unicode.width() and add
...
unicodedata.east_asian_width(). You can still implement your own
simple width() function using it like this:
def width(u):
w = 0
for c in unicodedata.normalize('NFC', u):
cwidth = unicodedata.east_asian_width(c)
if cwidth in ('W', 'F'): w += 2
else: w += 1
return w
2004-08-04 07:38:35 +00:00
f901abdd62
allow ctime(), gmtime(), and localtime() to take None as equivalent to an omitted arg
...
(closes SF bug #658254 , patch #663482 )
2004-08-03 17:58:55 +00:00
9513e34ac4
Patch #823072 : add option to NOT use ~/.netrc in nntplib.NNTP().
2004-08-03 14:36:32 +00:00
70fcdb8be0
Document general mappings for the locals argument for exec and execfile().
2004-08-03 05:17:58 +00:00
c2a5a63654
PEP-0318, @decorator-style. In Guido's words:
...
"@ seems the syntax that everybody can hate equally"
Implementation by Mark Russell, from SF #979728 .
2004-08-02 06:10:11 +00:00
63a5d0b1cf
re-wrap paragraphs containing long lines
2004-07-30 19:12:38 +00:00
69013d070e
- document the termination condition for cmd.Cmd.cmdloop()
...
- document the use of the return value for cmd.Cmd.do_*() methods
2004-07-30 18:58:54 +00:00
479b7a7cdb
Fix typo.
2004-07-30 16:09:19 +00:00
8ddb638e43
Add closing methoddesc. Add versionadded. Rewrap.
2004-07-30 16:08:49 +00:00
f9fd0d7988
SF bug #997533 : "disjunct" should be "disjoint"
...
* Use plain wording in docs for id().
* Use normal quotation marks instead of single quotes in the description.
2004-07-29 06:06:34 +00:00
f9f0b21653
SF #998170 , fix typo. Backport candidate
2004-07-29 03:48:59 +00:00
bee417439e
Add versionadded info
2004-07-28 02:34:12 +00:00
7b9190b8fc
Patch #998149 : imaplib deleteacl and myrights.
2004-07-27 05:07:19 +00:00
fdccf1ad6e
fix information about what flag database files are opened with by default
2004-07-26 16:33:29 +00:00
cc0f93233a
Patch #605370 : Add description[s] for RFC 2980 compliance.
2004-07-26 12:40:50 +00:00
37ead8f1c3
Patch #997668 : Correct explanation of salts.
...
Will backport to 2.3.
2004-07-26 12:05:16 +00:00
abba5c067d
Explain that most floats are actually integers. This is a common confusion
...
for people using floor(), ceil() and modf().
2004-07-26 05:12:01 +00:00
9a729a1cc5
Typo in new docs.
2004-07-26 04:58:50 +00:00
d6ef19309d
SF bugs 996748: os.environ documentation should indicate unreliability
...
Clarifed that os.environ is captured once; emphasized that it's better
to assign to os.environ than to call putenv() directly (the putenv()
docs said so, but the environ docs didn't).
2004-07-26 00:42:41 +00:00
66bb6e661c
SF bug 996392: math and cmath docs don't specify radians
...
Major rewrite of the math module docs. Slapped in "radians" where
appropriate; grouped the functions into reasonable categories; supplied
many more words to address common confusions about some of the subtler
issues.
2004-07-24 23:00:24 +00:00
336689b9cc
A few trivial edits.
2004-07-23 02:48:24 +00:00
cab5b94592
SF bug #995983 and #995987 : Documentation nits.
2004-07-22 19:33:53 +00:00
7bd33c5e22
This change implements the following gettext features, as
...
discussed recently in python-dev:
In _locale module:
- bind_textdomain_codeset() binding
In gettext module:
- bind_textdomain_codeset() function
- lgettext(), lngettext(), ldgettext(), ldngettext(),
which return translated strings encoded in
preferred system encoding, if
bind_textdomain_codeset() was not used.
- Added equivalent functionality in translate()
function and catalog classes.
Every change was also documented.
2004-07-22 18:44:01 +00:00
b4bf62f807
Added an extra example to the basic example section
2004-07-21 14:40:11 +00:00
bf76075a4b
fix typo, highlight True/False correctly
2004-07-21 02:47:10 +00:00
7728b4719e
SF #994605 , fcntl example is broken
...
The last call to fcntl (which wasn't changed) doesn't work for me, but
the first part works now.
Backport candidate.
2004-07-21 01:41:14 +00:00
d96d1015ef
SF #918101 , allow files >= 8 GB using GNU extension
2004-07-20 22:23:02 +00:00
b0c319a905
Patch #993187 : Make rstrip doc similar to lstrip.
...
Backported to 2.3.
2004-07-19 16:34:01 +00:00
76aa2eff4e
Get doc to build (add missing backslash)
2004-07-19 01:39:54 +00:00
3d7d372ce3
Whitespace normalization, via reindent.py.
2004-07-18 06:25:50 +00:00
2bb146f2f4
Bring CJKCodecs 1.1 into trunk. This completely reorganizes source
...
and installed layouts to make maintenance simple and easy. And it
also adds four new codecs; big5hkscs, euc-jis-2004, shift-jis-2004
and iso2022-jp-2004.
2004-07-18 03:06:29 +00:00
910d8f1e89
Change CJK encoding aliases to their most popular variation of
...
hyphen and underscores in consistency of non-CJK aliases.
(Spotted by Mike Brown at SF #969415 )
2004-07-17 14:44:43 +00:00
872dc5c457
Minor edits
2004-07-17 13:35:43 +00:00
de8332171a
SF bug 990749: os constants missing
...
A LaTeX comment identified the 6 os.O_XXX constants the docs claimed
are available on Windows but aren't. The bug report listed the same 6.
Split these non-Windows constants into a different table with a possibly
correct "Availability:" claim.
2004-07-15 05:46:37 +00:00
9296023938
Improve examples for working with the context API.
2004-07-14 21:06:55 +00:00
d15dc06df0
Implemented thread-local data as proposed on python-dev:
...
http://mail.python.org/pipermail/python-dev/2004-June/045785.html
2004-07-14 19:11:50 +00:00
8cec3ab0e4
- Bug #981530 : Fix UnboundLocalError in shutil.rmtree(). This affects
...
the documented behavior: the function passed to the onerror()
handler can now also be os.listdir.
[I could've sworn I checked this in, but apparently I didn't, or it
got lost???]
2004-07-14 00:48:58 +00:00
2a510ce119
Wordsmithing
2004-07-13 14:03:31 +00:00
71868e74d6
Add another point in the "Restrictions" section about how the handling of FTP
...
URLs will seemingly succeed to read a URL that points to a file whose
permissions you do not have to read.
Backport candidate once everyone agrees with the wording.
2004-07-13 00:48:42 +00:00
20f42c433b
Fixed minor bugs in the example configuration file
2004-07-12 15:48:04 +00:00
d7c7115926
Small elaboration and typo fixes.
2004-07-12 13:22:14 +00:00
5af0e41482
Bug #788520 : Queue class has logic error when non-blocking
...
I don't agree it had a bug (see the report), so this is *not* a candidate
for backporting, but the docs were confusing and the Queue implementation
was old enough to vote.
Rewrote put/put_nowait/get/get_nowait from scratch, to use a pair of
Conditions (not_full and not_empty), sharing a common mutex. The code
is 1/4 the size now, and 6.25x easier to understand. For blocking
with timeout, we also get to reuse (indirectly) the tedious timeout
code from threading.Condition. The Full and Empty exceptions raised
by non-blocking calls are now easy (instead of nearly impossible) to
explain truthfully: Full is raised if and only if the Queue truly
is full when the non-blocking put call checks the queue size, and
similarly for Empty versus non-blocking get.
What I don't know is whether the new implementation is slower (or
faster) than the old one. I don't really care. Anyone who cares
a lot is encouraged to check that.
2004-07-12 00:45:14 +00:00
2363e8fece
Added documentation for the "smtpd" module.
...
Closes SF bug #450803 .
2004-07-11 16:25:25 +00:00
88e8e34ab0
Style nit.
2004-07-11 13:20:11 +00:00
65df07bf23
Minor improvements, fixups and wording changes everywhere.
2004-07-11 12:40:19 +00:00
8932b41669
Patch 851752 (fixes bug 820583)
...
Patch by John J Lee
Reviewed by Jeff Epler / KBK
Doc built OK.
urlopen() may return None if no handler handles the request.
Also clarify what install_opener does.
M liburllib2.tex
2004-07-11 02:13:17 +00:00
cd77dd6321
Fix minor error in example.
2004-07-10 23:06:07 +00:00
91cc5cd188
Clarify docs for inspect.getargspec() that the fourth value is None when there
...
are no default arguments for the function.
2004-07-10 21:13:06 +00:00
3a2418a1d6
[Patch #969900 ] Various corrections and updates to cookielib docs
2004-07-10 18:41:28 +00:00
300ce19592
[Patch #972310 ] Apply correction to docs
2004-07-10 18:28:33 +00:00
099bd524a4
[Bug 949832] Fix example; edit sentence
2004-07-10 16:01:10 +00:00
bf4406971c
Improve Context construction and representation:
...
* Rename "trap_enablers" to just "traps".
* Simplify names of "settraps" and "setflags" to just "traps" and "flags".
* Show "capitals" in the context representation
* Simplify the Context constructor to match its repr form so that only
the set flags and traps need to be listed.
* Representation can now be run through eval().
Improve the error message when the Decimal constructor is given a float.
The test suite no longer needs a duplicate reset_flags method.
2004-07-10 14:14:37 +00:00
0d278b861e
SF bug #987486 : fix typo.
2004-07-10 11:15:56 +00:00
5aa478badf
Module and tests:
...
* Map conditions to related signals.
* Make contexts unhashable.
* Eliminate used "default" attribute in exception definitions.
* Eliminate the _filterfunc in favor of a straight list.
Docs:
* Eliminate documented references to conditions that are not signals.
* Eliminate parenthetical notes such as "1/0 --> Inf" which are no
longer true with the new defaults.
2004-07-09 10:02:53 +00:00
97c9208c6c
Incorporate Facundo's suggestions.
2004-07-09 06:13:12 +00:00
2b2795ac6d
show how easy it is to manipulate individual columns - from a request on
...
c.l.py
2004-07-08 19:49:10 +00:00
536f76b25a
Fix markup, typos, and nits.
2004-07-08 09:22:33 +00:00
e3c330b42a
Replaced some tabs with spaces in verbatim section.
2004-07-07 15:59:49 +00:00
2f55eb4cca
Demonstrate how to round final result.
2004-07-06 01:55:14 +00:00
10959b1c2a
Expand examples to show polymorphism
2004-07-05 21:13:28 +00:00
77e13b4ead
Simplify examples.
2004-07-05 20:27:53 +00:00
c4f93d4410
Doc tested the recipes.
2004-07-05 20:17:13 +00:00
9c719bafbf
Fix typo
2004-07-05 18:56:03 +00:00
d84efb3d93
* Added missing info on construction from a tuple.
...
* Added a recipe section.
2004-07-05 18:41:42 +00:00
8de63a206e
Add decimal docs to the core.
2004-07-05 05:52:03 +00:00
068979cdd6
Textual change to make the doc reflect reality
2004-07-04 04:47:40 +00:00
a13c60b810
Moved example section up to just after the section on Logger objects, and changed it to use the new basicConfig() API
2004-07-03 11:45:53 +00:00
0a4dd390bf
Make weak references subclassable:
...
- weakref.ref and weakref.ReferenceType will become aliases for each
other
- weakref.ref will be a modern, new-style class with proper __new__
and __init__ methods
- weakref.WeakValueDictionary will have a lighter memory footprint,
using a new weakref.ref subclass to associate the key with the
value, allowing us to have only a single object of overhead for each
dictionary entry (currently, there are 3 objects of overhead per
entry: a weakref to the value, a weakref to the dictionary, and a
function object used as a weakref callback; the weakref to the
dictionary could be avoided without this change)
- a new macro, PyWeakref_CheckRefExact(), will be added
- PyWeakref_CheckRef() will check for subclasses of weakref.ref
This closes SF patch #983019 .
2004-07-02 18:57:45 +00:00
214b1c3aae
SF Bug #215126 : Over restricted type checking on eval() function
...
The builtin eval() function now accepts any mapping for the locals argument.
Time sensitive steps guarded by PyDict_CheckExact() to keep from slowing
down the normal case. My timings so no measurable impact.
2004-07-02 06:41:07 +00:00
78bace7442
add cp866 row
2004-07-02 02:14:34 +00:00
ac1075a645
Document that encode() and decode() raise UnicodeError
...
instead of ValueError.
Add a note about error handling schemes added by PEP 293.
2004-07-01 19:58:47 +00:00
ecf7a52bb8
link to the codecs page from the "".encode() description.
2004-07-01 19:26:04 +00:00
2ccf5d689b
use file() in preference to open()
2004-06-30 21:06:45 +00:00
d5cf143482
Check in the updated version of patch #957240 , which doesn't rely
...
on the marshalling characteristics of infinities.
2004-06-30 09:02:33 +00:00
7dd8fda49f
[Bug #978556 ] Update SHA spec URL; bugfix candidate
2004-06-29 13:35:01 +00:00
11b91a0ea3
Added socket.getservbyport(), and make its second argument and that of
...
getservbyname() optional. Update the tests and the docs.
2004-06-28 00:50:43 +00:00
ef82d2fdfe
Patch #923098 : Share interned strings in marshal.
2004-06-27 16:51:46 +00:00
b86aa99eb9
move the note about the bsddb185 module above the "See also" box; that
...
should always go last in the relevant section's main content, but
before child sections
2004-06-24 06:03:59 +00:00
28224f897a
Improve the documented advice on how to best use heapq.heapreplace().
2004-06-20 09:07:53 +00:00
3706855d11
Add apparently missing word for InvalidStateError definition.
...
Closes bug #973901 . Thanks Brian Gough.
2004-06-17 21:34:05 +00:00
9e151d149e
add missing closing quote.
2004-06-17 13:29:11 +00:00
64af6c545c
Comment that getfilesystemencoding returns mbcs even on NT+. Fixes #964870 .
2004-06-16 04:53:46 +00:00
aefde435ef
Reverse argument order for nsmallest() and nlargest().
...
Reads better when the iterable is a generator expression.
2004-06-15 23:53:35 +00:00
b67ad7e671
Patch #826074 : cmath.log optional base argument, fixes #823209
...
(Contributed by Andrew Gaul.)
2004-06-14 07:40:10 +00:00
ad21945d03
Back out #957240 .
2004-06-14 04:58:42 +00:00
965eeca630
SF bug #970042 , lockf() signature uses len, doc refers to length (use length, same as docstring)
2004-06-13 21:11:03 +00:00
2e3dfaf707
Install C version of heapq.nsmallest().
2004-06-13 05:26:33 +00:00
2e6694086f
Minor wording and spacing nits.
2004-06-12 07:59:40 +00:00
34809170e5
Complete the list of weakreferencable objects.
2004-06-12 06:56:44 +00:00
33ecffb65a
SF patch #969791 : Add nlargest() and nsmallest() to heapq.
2004-06-10 05:03:17 +00:00
da4513a88b
make a reference to the SimpleHTTPServer module a hyperlink to the
...
docs
2004-06-09 14:50:19 +00:00
737ea82a5a
Patch #774665 : Make Python LC_NUMERIC agnostic.
2004-06-08 18:52:54 +00:00
7f35404b7b
- markup fix
...
- explain Python/ceval.c from what; lots of people don't use a source
distro any more
2004-06-08 14:01:27 +00:00
bdec50f027
Feature request #935915 : Add os.path.devnull.
2004-06-08 08:29:33 +00:00
f30d60edbc
Patch #510695 : Add TSC profiling for the VM.
2004-06-08 08:17:44 +00:00
44cbfd7819
[Bug #953177 ] Mention .getlist(); text from Paul Moore
2004-06-06 23:28:23 +00:00
0b4d1ee29d
SF 964876 mapping a 0 length file
...
Document that it can't be done on Windows.
2004-06-06 16:51:46 +00:00
e1ca355425
[Bug #918710 ] Add paragraph to clarify docs
2004-06-05 19:25:30 +00:00
175d18840a
avoid backticks in examples; use repr() instead
2004-06-03 16:23:23 +00:00
4a9b8069e0
Document string methods that are locale-dependent. Fixes #935749 .
...
Will backport to 2.3.
2004-06-03 09:47:01 +00:00
eac324b90b
Patch #957240 : Add count parameter to asyncore.loop.
2004-06-03 09:18:35 +00:00
974ed7cfa5
- SF #962502 : Add two more methods for unicode type; width() and
...
iswide() for east asian width manipulation. (Inspired by David
Goodger, Reviewed by Martin v. Loewis)
- Move _PyUnicode_TypeRecord.flags to the end of the struct so that
no padding is added for UCS-4 builds. (Suggested by Martin v. Loewis)
2004-06-02 16:49:17 +00:00
92816de18e
Patch #932930 : suggest the use of rawstrings for backslashes.
2004-05-31 19:01:00 +00:00
2a6ba9097e
Patch #963318 : Add support for client-side cookie management.
2004-05-31 18:22:40 +00:00
027bb633b6
Add weakref support to sockets and re pattern objects.
2004-05-31 03:09:25 +00:00
79cddc56b3
stupid, stupid, stupid... raw_input() already supports readline() if the
...
readline module is loaded.
2004-05-24 14:20:16 +00:00
b98a8ba14d
Add example that uses readline.readline().
2004-05-23 19:06:41 +00:00
0dc23101a0
Exposed readline() function from the readline module.
2004-05-23 17:46:50 +00:00
e36894da3a
Updated to reflect new types.
2004-05-22 16:38:11 +00:00
8bc81fc5c7
Added description for authenticate and namespace
2004-05-20 12:12:58 +00:00
82903148a8
ConfigParser:
...
- read() method returns a list of files parsed successfully
- add tests, documentation
(closes SF patch #677651 )
2004-05-18 04:24:02 +00:00
b4c6091984
ConfigParser:
...
- DuplicateSectionError is only raised by add_section()
(closes SF bug #830449 )
2004-05-18 03:56:51 +00:00
abc086fb0d
ConfigParser:
...
- don't allow setting options to non-string values; raise TypeError
when the value is set, instead of raising an arbitrary exception
later (such as when string interpolation is performed)
- add tests, documentation
(closes SF bug #810843 )
2004-05-18 03:29:52 +00:00
bc12b01d83
ConfigParser:
...
- ensure that option names in interpolations are handled by
self.optionxform in the same way that other references to option
names
- add tests, documentation
(closes SF bug #857881 , patch #865455 )
2004-05-18 02:25:51 +00:00
0e371f2cb6
Make sure "del d[n]" is properly supported. Was necessary because the
...
same method that implements __setitem__ also implements __delitem__.
Also, there were several good use cases (removing items from a queue
and implementing Forth style stack ops).
2004-05-12 20:55:56 +00:00
1cd6e4dc38
fix various descriptions of "ctime"
...
(closes SF patch #870287 )
2004-05-12 03:51:40 +00:00
bb066cf841
fix various typos; thanks, George Yoshida!
...
(closes SF patch #952047 )
2004-05-12 03:07:27 +00:00
f72de0fb8c
add note about the __name__ read-only attribute
...
(closes SF bug #952212 )
2004-05-12 02:48:29 +00:00
0d73621cb2
markup adjustment
2004-05-11 05:29:34 +00:00
dd69b0ab6c
Added a note describing how fp should be opened in binary mode, especially on
...
Windows. Closes SF # 586899.
2004-05-10 23:12:52 +00:00
fb85739494
Point out that %p has no effect on the output hour in strptime unless %I is
...
used to parse the hour.
2004-05-10 18:53:00 +00:00
e7169eb9ed
Add more examples.
2004-05-09 01:15:01 +00:00
e143bbb610
fix documentation for ContentHandler.ignorableWhitespace()
...
(closes SF bug #881707 )
2004-05-06 03:47:48 +00:00
99872c1342
[Bug #810879 ] Document that copyfile() can fail if you don't have permissions; also, fix a double negative.
2004-05-05 17:21:51 +00:00
0fefc140aa
Fix small grammatical mistake.
2004-05-05 16:49:11 +00:00
8aa8c84d18
add an index entry for __getnewargs__()
2004-05-05 04:56:06 +00:00
0de77d1d6e
- note that __getinitargs__() is only for old-style classes
...
- describe __getnewargs__()
(closes SF bug #873246 )
2004-05-05 04:54:37 +00:00
04d92c37f2
Remove list of pickle protocol names used by the copy module; there
...
are enough subtleties to pickling that we don't want misunderstanding
to spread because we don't provide all the information twice. The
reference to the pickle module for information will have to suffice;
at least only one portion of the docs will be out of date. ;-(
2004-05-05 04:24:30 +00:00
cee8879a7d
note that the error code for socket.gaierror will be one of the EAI_*
...
constants
(closes SF bug #837929 )
2004-05-05 04:18:11 +00:00
4fe97ca4ce
SF #814606 : merge from release23-maint branch: clarify/cleanup
...
mixer docs; trim \platform{}, add \versionadded{}.
2004-05-05 01:36:16 +00:00
5068c873e6
Document readline module functions added in Python 2.3. See:
...
http://mail.python.org/pipermail/python-dev/2003-September/037922.html
for background. It appears I forgot to ever submit a bug report or patch.
2004-05-04 19:20:22 +00:00
d7911a3317
Minor documentation nits.
2004-05-01 08:31:36 +00:00
f5f9a370d4
Add an example application to the docs.
2004-04-30 22:52:50 +00:00
6fbf703fa2
the headers in an HTTP request are HTTP headers, not MIME headers
2004-04-29 02:47:38 +00:00
ceeb1918a1
remove out-of-date count of the functions in winsound
2004-04-28 03:57:47 +00:00
0ed663443e
really scream out that people should use the file objects instead of
...
file descriptor operations for normal applications
2004-04-16 15:20:01 +00:00
10659f2540
bring description of optional and keyword args for DictReader and DictWriter
...
classes into line with the actual code. I didn't see any obvious examples
of latex formatting for *args and **kwds so I just guessed.
2004-04-16 03:21:01 +00:00
8efc74d35e
remove bogus markup that caused the docs to be wrong
2004-04-15 06:18:48 +00:00
6b3b046ab0
fix up some markup
2004-04-09 18:26:40 +00:00
94ffbb71a8
give rational filenames to some of the generated HTML
2004-04-08 19:44:31 +00:00
ba813e2089
#928751 , fix typos in socket doc
2004-04-03 18:02:37 +00:00
8123ff6bca
remove out-of-date warning
2004-03-26 17:11:10 +00:00
504ca68e20
Note that reading from a socket may not always return all of the
...
remaining content of a stream when expected to do so.
Closes SF bug #725265 . Should be backported to Python 2.3.x.
2004-03-25 16:51:12 +00:00
267b062432
- make sure the methods minidom adds to the basic DOM are attributed
...
to Node objects in the index (closes SF bug #832251 )
- fix a variety of markup nits
Someone should backport this patch to Python 2.3.x.
2004-03-25 16:39:46 +00:00
2f00c5453e
fix typo
2004-03-25 16:14:17 +00:00
f39c3c7a6b
note that distutils API docs are included in "Distributing Python
...
Modules"
2004-03-25 16:12:08 +00:00
c69ebe8d50
Enable the profiling of C functions (builtins and extensions)
2004-03-24 21:57:10 +00:00
Phillip J. Eby
Matthias Klose
Vinay Sajip
Hye-Shik Chang
Fred Drake
Martin v. Löwis
Raymond Hettinger
Anthony Baxter
Neal Norwitz
Tim Peters
Gustavo Niemeyer
Skip Montanaro
Andrew M. Kuchling
Jim Fulton
Guido van Rossum
Brett Cannon
Kurt B. Kaiser
Nicholas Bastin
Walter Dörwald
Michael W. Hudson
Barry Warsaw
Piers Lauder
Greg Ward