8158e84930
Fix erroneous docstring comment.
2004-09-06 07:04:09 +00:00
785c65ccd2
Markup nits.
2004-09-06 01:01:08 +00:00
bb30af4565
Add missing close parenthesis.
2004-09-06 00:42:14 +00:00
18c6960964
SF bug #901654 : split method documentation can be improved
...
* Discuss the algorithmic distinctions between s.split() and s.split(sep).
* Document the split behavior for empty strings.
* Note the behavior when maxsplit is zero.
* Include short examples.
2004-09-06 00:12:04 +00:00
1b262977a0
Rework some wording.
2004-09-05 19:42:15 +00:00
2a72f19528
SF bug #1020540 : a wrong link from "frame object" in lib index
2004-09-04 21:14:34 +00:00
1fbf9c5ec1
Added IGNORE_EXCEPTION_DETAIL comparison option. The need is explained
...
in the new docs.
DocTestRunner.__run: Separate the determination of the example outcome
from reporting that outcome, to squash brittle code duplication and
excessive nesting.
2004-09-04 17:21:02 +00:00
a01a2ee933
Applying modified version of patch #1018386 , which fixes
...
some escaping bugs in SRE.
2004-09-03 17:06:10 +00:00
0bbf137fbd
Make the api of the _dispatch() method more concrete. I have no idea if
...
this is the right way to document such things (Fred, help me out here :-),
but I got misled by the existing documentation and assumed the parameter
list was a *args sort of thing.
2004-09-03 00:04:05 +00:00
ecd5754925
Remove rotor reference
2004-08-31 13:49:36 +00:00
ab459f71d6
Remove docs for xreadlines, mpz, rotor
2004-08-31 13:22:43 +00:00
e723863ba1
Remove xreadlines reference
2004-08-31 13:21:07 +00:00
a46fd8480f
Remove TERMIOS docs
2004-08-31 13:05:59 +00:00
e4133d8d67
Use correct constant; remove reference to TERMIOS.py
2004-08-31 13:05:36 +00:00
17952b78e1
Updated doc for getLogger()
2004-08-31 10:21:51 +00:00
38330fe5ef
The distinction between comparison flags and reporting flags isn't unique
...
to unittest, so make it official: new module constants COMPARISON_FLAGS
and REPORTING_FLAGS, which are bitmasks or'ing together the relevant
individual option flags.
set_unittest_reportflags(): Reworked to use REPORTING_FLAGS, and
simplified overly complicated flag logic.
class FakeModule: Removed this; neither documented nor used.
2004-08-30 16:19:24 +00:00
ae882f7984
Patch #941486 : add os.path.lexists(). Also fix bug #940578 by using lexists in glob.glob.
2004-08-30 10:19:56 +00:00
356a4599ac
Teach the random module about os.urandom().
...
* Use it for seeding when it is available.
* Provide an alternate generator based on it.
2004-08-30 06:14:31 +00:00
e064b41f5a
Patch #914575 : difflib side by side diff support, diff.py s/b/s HTML option.
2004-08-29 16:34:40 +00:00
dc3883f671
Patch #934711 : Expose platform-specific entropy.
2004-08-29 15:46:35 +00:00
6ab78cd0c0
SF feature request #992967 : array.array objects should support sequences.
...
Made the constructor accept general iterables.
2004-08-29 07:50:43 +00:00
592ef6110f
Correct incorrect "it's" to "its".
2004-08-26 10:40:12 +00:00
f33683fd40
Fine tune a word.
2004-08-26 04:52:46 +00:00
cf53355fcf
Thinko repair.
2004-08-26 04:50:38 +00:00
a07bcd46f3
Reorg of exception section. Now that there are fewer details needing
...
explanation, it's easier to push the remaining insufferably anal details
into a "fine print" section at the bottom.
2004-08-26 04:47:31 +00:00
f4fd79ca49
Small wording fixups.
2004-08-26 03:11:56 +00:00
a89f88d53f
Added REPORT_ONLY_FIRST_FAILURE flag, which supresses output after the
...
first failing example in each test.
2004-08-26 02:45:51 +00:00
71f55af826
Renamed UNIFIED_DIFF->REPORT_UDIFF; CONTEXT_DIFF->REPORT_CDIFF; and
...
NDIFF_DIFF->REPORT_NDIFF. This establishes the naming convention that
all reporting options should begin with "REPORT_" (since reporting
options are a different class from output comparison options; but they
are both set in optionflags).
2004-08-26 01:41:51 +00:00
0e448073d6
Restored half of a \versionadded only half of which should have been
...
deleted.
2004-08-26 01:02:08 +00:00
e8bbfe4e63
Patch #1015012 . Improve markup and punctuation in libsocket.tex
2004-08-26 00:51:16 +00:00
3203efb55f
Patch #1014930 . Expose current parse location to XMLParser.
2004-08-26 00:37:31 +00:00
19b1958730
Only recognize the expected output as an exception if it *starts* with
...
a traceback message. I.e., examples that raise exceptions may no
longer generate pre-exception output. This restores the behavior of
doctest in python 2.3. The ability to check pre-exception output is
being removed because it makes the documentation simpler; and because
there are very few use cases for it.
2004-08-25 23:07:03 +00:00
be83737c7c
Patch #798244 : More urllib2 examples.
2004-08-25 11:24:42 +00:00
8d494f3241
Patch #1015021 : Stop claiming that coerce can return None.
...
Will backport to 2.3.
2004-08-25 10:42:41 +00:00
08b07def43
Ah whoops, we didn't turn string into a package (thanks Neal!)
2004-08-25 03:09:58 +00:00
8bee76106e
PEP 292 classes Template and SafeTemplate are added to the string module.
...
This patch includes test cases and documentation updates, as well as NEWS file
updates.
This patch also updates the sre modules so that they don't import the string
module, breaking direct circular imports.
2004-08-25 02:22:30 +00:00
c885443479
Stop producing or using OverflowWarning. PEP 237 thought this would
...
happen in 2.3, but nobody noticed it still was getting generated (the
warning was disabled by default). OverflowWarning and
PyExc_OverflowWarning should be removed for 2.5, and left notes all over
saying so.
2004-08-25 02:14:08 +00:00
07fda7e3a0
Updated the socketpair() docstring and documentation to explain that the
...
default famility is AF_UNIX if defined for the platform, otherwise the
default is AF_INET.
2004-08-23 05:16:23 +00:00
656f7e4b40
Removed redundant versionadded{} for NDIFF_DIFF. Virtually everything
...
in this section is new in 2.4, and that's all mentioned already in
versionadded{} thingies at the end of the section. It hurts readability
to have them after every line <wink>.
2004-08-23 00:26:42 +00:00
8bd5cb342c
Add version info
2004-08-22 21:48:37 +00:00
c6cbab0db4
Added NDIFF_DIFF option.
2004-08-22 19:43:28 +00:00
7109b287cf
Fix grammar, spotted by Hye-Shik Chang
2004-08-20 23:13:26 +00:00
8e3bec5418
Correct argument specifications of load_compiled and load_source: the file
...
argument is optional on both (the format string is "ss|O!").
2004-08-20 14:38:56 +00:00
c89061817b
Quote # as \# to make lib compile again.
2004-08-20 14:37:05 +00:00
8623b36ee0
Try to improve grammar and use versionadded
2004-08-20 02:36:27 +00:00
525b315326
Fix markup. versionchanged automatically adds a period, so remove the extra one.
2004-08-20 01:52:42 +00:00
026f8dc103
Now that they've settled down, document doctest directives.
2004-08-19 16:38:58 +00:00
75b9da4aaf
Patch #995126 : Correct directory size, and generate GNU tarfiles by default.
2004-08-18 13:57:44 +00:00
deacce2c87
Patch #800236 : add HTTPResponse.getheaders().
2004-08-18 12:46:26 +00:00
01884d56f4
Deprecate sys.exitfunc in favor of the atexit module.
...
Per Guido, sys.exitfunc will be kept around for backwards compatability
but atexit will become the one preferred way to do it.
2004-08-18 02:50:00 +00:00
8de636e2ae
SF bug #951482 : New module: doc versus action
...
Strengthen the warnings about creating bogus objects using the new module.
2004-08-17 02:31:55 +00:00
cb40ba1f5e
SF bug #805304 : super instances don't support item assignment
...
Document a nuance of super(). It is designed to work well with dotted
attribute lookup but not with equivalent implicit lookups using operators
or statements.
2004-08-17 02:21:45 +00:00
7ec7584813
Typo fix
2004-08-16 16:12:23 +00:00
8df4e6b020
Fix punctuation typo.
2004-08-15 23:51:38 +00:00
2864b808c7
Add a notes section to the docs:
...
* Discuss representation error versus loss of significance.
* Document special values including qNaN, sNaN, +0, -0.
* Show the suprising display of non-normalized zero values.
2004-08-15 23:47:48 +00:00
e5069019e7
Add get_history_item and replace_history_item functions to the readline
...
module. Closes patch #675551 . My apologies to Michal Vitecek for taking so
long to process this.
2004-08-15 14:32:06 +00:00
b112d6ed78
bug 990669: os.path.normpath may alter the meaning of a path if it contains
...
symbolic links. This has been documented in a comment since 1992, but is now in
the library reference as well.
2004-08-14 14:41:32 +00:00
83e259a2c2
Another microburst of snail-like progress.
2004-08-13 21:55:21 +00:00
41a65ea7fe
Doctest has new traceback gimmicks in 2.4. While trying to document
...
them (which they are now), I had to rewrite the code to understand
it. This has got to be the most DWIM part of doctest -- but in context
is really necessary.
2004-08-13 03:55:05 +00:00
ee6511b309
Fix the version number in which changes were made
2004-08-13 02:34:06 +00:00
2603960525
Markup fiddling.
2004-08-13 01:49:12 +00:00
8a3b69ca8f
Excruciatingly slow progress on the docs. Option flags / directive names
...
are documented now, and ripped out a bunch of "private name" convolutions.
2004-08-12 22:31:25 +00:00
5e897959db
This is my patch
...
[ 1004703 ] Make func_name writable
plus fixing a couple of nits in the documentation changes spotted by MvL
and a Misc/NEWS entry.
2004-08-12 18:12:44 +00:00
ba100c98ad
clarify the behavior of the .first() and .last() methods for empty
...
databases
this should be backported to the release23-maint branch
2004-08-10 19:22:48 +00:00
d62d507b9a
added missing documentation for UseForeignDTD() (new in 2.3)
...
someone should backport to the release23-maint branch
2004-08-10 17:18:32 +00:00
fb568ca52a
add descriptions for many of the new error codes
2004-08-10 16:47:18 +00:00
9d92d5a9ac
minor changes to make this format again
2004-08-10 15:41:03 +00:00
c2388a2b9c
Start rewriting doctest's LaTeX docs. Damn, this is slow going!
2004-08-10 01:41:28 +00:00
24884a5ccc
[Patch #1005465 ] Markup tweaks
2004-08-09 17:36:56 +00:00
151df0794d
- make a module reference a hyperlink
...
- wrap a long line
2004-08-09 14:12:05 +00:00
9dc19c2515
Ooops - for some reason I had the wrong versionadded...
2004-08-09 05:59:09 +00:00
331708b226
Patch #1003700 : Add socketpair function to socket module.
2004-08-09 04:51:41 +00:00
feec4533e2
Bug 1003935: xrange overflows
...
Added XXX comment about why the undocumented PyRange_New() API function
is too broken to be worth the considerable pain of repairing.
Changed range_new() to stop using PyRange_New(). This fixes a variety
of bogus errors. Nothing in the core uses PyRange_New() now.
Documented that xrange() is intended to be simple and fast, and that
CPython restricts its arguments, and length of its result sequence, to
native C longs.
Added some tests that failed before the patch, and repaired a test that
relied on a bogus OverflowError getting raised.
2004-08-08 07:17:39 +00:00
2ee6a7027a
[Patch #999280 ] Update kwargs in pickle docs to match implementations
2004-08-07 20:25:55 +00:00
17e33e4c93
[Bug #914375 ] Crude modulefinder docs, but the module's code is very hard to read and it's not clear which bits are public and which aren't. The module's author should really be doing this (and using docstrings in the code, too)
2004-08-07 20:13:34 +00:00
32dbddafd5
Remove various modules that have been documented
2004-08-07 19:21:59 +00:00
59a27f1d6e
Various minor edits
2004-08-07 19:10:36 +00:00
4cbe95cdd1
[Bug #866222 ] Update docs to match the module
2004-08-07 19:06:48 +00:00
1baa248021
Fix
...
[ 1000841 ] "make pdf" failure w/ 2.4 docs
in the suggested way, by uglifying a URL.
2004-08-07 17:39:35 +00:00
0188cdb115
[Bug #998066 ] Mention result mismatch
2004-08-07 17:28:17 +00:00
8def876d36
[Bug #873146 ] Document pickletools module (haven't tested the LaTeX yet)
2004-08-07 16:53:59 +00:00
049e7aaa0f
Point out that the setdefault defaults the value to None. Inspired by
...
Michael Chermside's thinking about patch #748126 (the chief upshot of
which thinking was "reject it!").
2004-08-07 16:41:34 +00:00
cbbee6fed5
[Bug #984952 ] Include more material from PEP 307.
...
I haven't tried to include all the material on old-style classes using protocols 0,1. The details are lengthy; someone who knows
more about the pickle module should decide if they're important enough
to be in the docs or not.
2004-08-07 16:24:18 +00:00
14d535c3d4
[Bug #984952 ] Include some material from PEP 307
2004-08-07 15:49:24 +00:00
6f937b1c30
[Bug #998307 ] Use open() instead of file() in docs
2004-08-07 15:11:24 +00:00
34ed2b020a
Typo fix; use 'in-place' instead of 'inplace'
2004-08-06 18:55:09 +00:00
52a21b8e65
SF patch #980695 : efficient string concatenation
...
(Original patch by Armin Rigo).
2004-08-06 18:43:09 +00:00
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
fee6f33e08
more markup nits
2004-03-23 21:40:07 +00:00
e05c3e0fbb
fix markup nits
2004-03-23 20:30:59 +00:00
824b1b2da8
Added command line options for profile.py - one for stats output file
...
and one for sort order when using stdout. Uses optparse.
2004-03-23 18:44:39 +00:00
1eb4bfc657
Added global runctx function to profile to fix SF Bug #716587
2004-03-22 20:12:56 +00:00
07973dab97
Modified string.split documentation to reflect behaviour of splitting emtpy string. Closes SF bug #811604
2004-03-21 16:59:59 +00:00
20a8336ff7
concrete example of why retaining old objects is good
2004-03-21 16:05:30 +00:00
8b6cc2e7f2
Removed extra period from \versionchanged entry; macro adds period
...
automatically.
2004-03-21 14:10:18 +00:00
508c57d544
Clarify docs on where .pth files can exist.
2004-03-20 21:41:28 +00:00
fe703e0650
SF bug #918371 : hasattr()'s return type
...
Replace 1 and 0 with True and False.
2004-03-20 18:25:31 +00:00
8e6ad6fbe9
Expand on the semantics of reload(). Closes #919099 .
2004-03-19 15:20:16 +00:00
5c5316f111
Add a new unicode codec: ptcp154 (Kazakh)
2004-03-19 08:06:07 +00:00
d1de45f549
Fix capitalization of title for subsection 2.
2004-03-18 07:37:15 +00:00
bdda9f389a
The example files need to be opened with the "b" flag.
2004-03-17 01:24:17 +00:00
49f9bd15ff
SF feature request #686323 : Minor array module enhancements
...
array.extend() now accepts iterable arguments implements as a series
of appends. Besides being a user convenience and matching the behavior
for lists, this the saves memory and cycles that would be used to
create a temporary array object.
2004-03-14 05:43:59 +00:00
9168c70438
SF Patch #912462 : Relocate \end tag to the right place.
...
(Submitted by George Yoshida)
2004-03-09 05:53:15 +00:00
31017aed36
SF #904720 : dict.update should take a 2-tuple sequence like dict.__init_
...
(Championed by Bob Ippolito.)
The update() method for mappings now accepts all the same argument forms
as the dict() constructor. This includes item lists and/or keyword
arguments.
2004-03-04 08:25:44 +00:00
d1080a3418
Have strftime() check its time tuple argument to make sure the tuple's values
...
are within proper boundaries as specified in the docs.
This can break possible code (datetime module needed changing, for instance)
that uses 0 for values that need to be greater 1 or greater (month, day, and
day of year).
Fixes bug #897625 .
2004-03-02 04:38:10 +00:00
0a4977c2f3
Replace left(), right(), and __reversed__() with the more general purpose
...
__getitem__() and __setitem__().
Simplifies the API, reduces the code size, adds flexibility, and makes
deques work with bisect.bisect(), random.shuffle(), and random.sample().
2004-03-01 23:16:22 +00:00
738ec90ca1
Improvements to collections.deque():
...
* Add doctests for the examples in the library reference.
* Add two methods, left() and right(), modeled after deques in C++ STL.
* Apply the new method to asynchat.py.
* Add comparison operators to make deques more substitutable for lists.
* Replace the LookupErrors with IndexErrors to more closely match lists.
2004-02-29 02:15:56 +00:00
fb0521f153
Use versionadded for new features
2004-02-28 16:00:23 +00:00
3e0877ef88
Add version changed/added to doc
2004-02-28 15:19:33 +00:00
59e02c110d
fix typo in reference to RFC 3464 DSN MIME type
2004-02-24 20:58:10 +00:00
e2b4b32025
Implementation of patch 869468
...
Allow the user to create Tkinter.Tcl objects which are
just like Tkinter.Tk objects except that they do not
initialize Tk. This is useful in circumstances where the
script is being run on machines that do not have an X
server running -- in those cases, Tk initialization fails,
even if no window is ever created.
Includes documentation change and tests.
Tested on Linux, Solaris and Windows.
Reviewed by Martin von Loewis.
2004-02-18 05:59:53 +00:00
70a6b49821
Replace backticks with repr() or "%r"
...
From SF patch #852334 .
2004-02-12 17:35:32 +00:00
5de33786a9
SF patch #892821 : example for urllib2 has SyntaxError
...
(Contributed by George Yoshida.)
2004-02-08 20:25:01 +00:00
4c9800d663
SF bug #892854 : typo in textwrap doc page
...
(Reported by Drew Perttula.)
2004-02-08 18:09:32 +00:00
5c5eb86347
* Incorporate Skip's suggestions for documentation (explain the word deque
...
comes from and show the differences from lists).
* Add a rotate() method.
2004-02-07 21:13:00 +00:00
7209294112
a couple other sunos4 support items removed
2004-02-07 12:50:19 +00:00
c058fd14a9
* Fix ref counting in extend() and extendleft().
...
* Let deques support reversed().
2004-02-07 02:45:22 +00:00
3ba85c2e8a
Have deques support high volume loads.
2004-02-06 19:04:56 +00:00
21ae4f983e
minor markup adjustments
2004-02-03 20:55:15 +00:00
4458ece4d7
Clarify minor point about the ref() and proxy() constructors.
...
This matches what is already documented for corresponding feature of the C API.
2004-02-03 19:44:26 +00:00
dd256d97cc
Add documentation for collections.deque().
2004-01-29 07:35:45 +00:00
e52f3b1e56
Add documentation for collections.deque().
2004-01-29 07:27:45 +00:00
756b3f3c15
* Move collections.deque() in from the sandbox
...
* Add unittests, newsitem, and whatsnew
* Apply to Queue.py mutex.py threading.py pydoc.py and shlex.py
* Docs are forthcoming
2004-01-29 06:37:52 +00:00
bd12b181c8
fix whitespace style (inconsistent with the rest of the docs)
2004-01-27 21:08:04 +00:00
fcc51767bd
update signature of the socket constructor
...
(could someone backport this to Python 2.3.x please?)
2004-01-27 18:21:26 +00:00
ee3c6074c3
add missing period
2004-01-26 19:40:18 +00:00
913829cb1d
fix markup
2004-01-26 19:39:13 +00:00
db8d1c26d3
add references between getopt and optparse docs
2004-01-26 19:30:21 +00:00
226f697560
fix method name in example code
2004-01-23 04:05:27 +00:00
1fe9750200
add direct link to the article in DDJ
...
closes SF bug #871402
2004-01-21 18:30:28 +00:00
ba0485a92d
expand on notion of row object type
2004-01-21 13:47:04 +00:00
7895146c40
typo
2004-01-21 13:34:35 +00:00
734fb5724f
Add a Guido inspired example for groupby().
2004-01-20 20:04:40 +00:00
3e2a306920
Add CJK codecs support as discussed on python-dev. (SF #873597 )
...
Several style fixes are suggested by Martin v. Loewis and
Marc-Andre Lemburg. Thanks!
2004-01-17 14:29:29 +00:00
621b443b8d
- add warning that hotshot doesn't work well with threads
...
- fix some markup
2004-01-16 17:30:16 +00:00
990a46b732
minor markup improvements
2004-01-16 16:07:04 +00:00
3bbd115735
markup changes
2004-01-13 23:41:32 +00:00
44a98237d8
[Bug #873205 ] Update URL
2004-01-11 23:00:16 +00:00
7e6bbe1516
The format of the string data used in the imageop module is described
...
as "This is the same format as used by gl.lrectwrite() and the imgfile
module." This implies a certain byte order in multi-byte pixel
formats. However, the code was originally written on an SGI
(big-endian) and *uses* the fact that bytes are stored in a particular
order in ints. This means that the code uses and produces different
byte order on little-endian systems.
This fix adds a module-level flag "backward_compatible" (default not
set, and if not set, behaves as if set to 1--i.e. backward compatible)
that can be used on a little-endian system to use the same byte order
as the SGI. Using this flag it is then possible to prepare
SGI-compatible images on a little-endian system.
This patch is the result of a (small) discussion on python-dev and was
submitted to SourceForge as patch #874358 .
2004-01-10 20:43:43 +00:00
c62af02ced
Fix some digicool addresses I noticed
2004-01-08 15:01:08 +00:00
115147921c
add link to the red-dove.com page about the logging package
2004-01-08 14:59:02 +00:00
91f5cbe264
SF bug #872461 : list.extend() described as experimental
2004-01-08 00:31:50 +00:00
c14149e6ef
Show how to re-enable GC during timings.
2004-01-04 21:19:18 +00:00
ad9aaeea6d
Documentation for new RFC 3548 functions.
2004-01-04 01:14:01 +00:00
6237ef1ddc
in the section "The interpreter stack":
...
- rearranged a bit to avoid duplicated information
- provide more complete (and hopefully less confusing) descriptions of
the return values for most of these functions
(close SF bug #563298 )
2004-01-01 07:21:14 +00:00
621c53ee9f
Add sets to list of picklable objects.
2004-01-01 05:53:51 +00:00
fcadf6bdaf
fix reference to File Object documentation
...
closes SF bug #825810
2004-01-01 03:41:27 +00:00
9b4dab4da1
SF patch #859286 : documentation bool change fix
...
(Contributed by George Yoshida.)
2003-12-31 18:37:28 +00:00
a180581511
use conventional whitespace in interactive example
2003-12-31 07:41:52 +00:00
50e7a11af1
Correct misrepresentation of print (it uses str(), not `...` for
...
conversion). Hopefully I've not messed up the formatting.
2003-12-31 06:32:38 +00:00
af78512712
- general markup cleanup
...
- rearrange so two small sections become one; this avoids an extra
page in the HTML format
2003-12-31 05:18:46 +00:00
Raymond Hettinger
Brett Cannon
Tim Peters
Gustavo Niemeyer
Skip Montanaro
Andrew M. Kuchling
Vinay Sajip
Johannes Gijsbers
Martin v. Löwis
Edward Loper
Dave Cole
Barry Warsaw
Neal Norwitz
Michael W. Hudson
Fred Drake
Phillip J. Eby
Matthias Klose
Hye-Shik Chang
Anthony Baxter
Jim Fulton
Guido van Rossum
Kurt B. Kaiser
Nicholas Bastin
Walter Dörwald
Piers Lauder
Greg Ward
David Ascher
Sjoerd Mullender