241c2e9692
Remove another lie.
2003-02-06 18:38:11 +00:00
847f37543f
Correct lie about METH_NOARGS functions.
...
Backport candidate.
2003-02-06 18:37:11 +00:00
93cf58b015
Typo fixes
2003-02-06 18:04:43 +00:00
80fd7851ac
Mention FutureWarning for large ints
2003-02-06 15:14:04 +00:00
ba37524b7c
Fix description of filterwarnings() parameters (error noted by Richard Jones at
...
http://mechanicalcat.net/cgi-bin/log/python/turning_warnings_off.html )
2003-02-06 14:38:45 +00:00
292f56cd26
Provide version changed info
2003-02-06 05:02:39 +00:00
983b008824
Updated version of [ 558544 ] cmd.py: add instance-specific stdin/out
...
This patch adds stdin, stdout as optional arguments to the cmd.Cmd
constructor (defaulting to sys.stdin, sys.stdout), and changes the Cmd
methods throughout to use self.stdout.write() and self.stdin.foo for
output and input. This allows much greater flexibility for using cmd -
for instance, hooking it into a telnet server.
Patch for library module and for documentation.
2003-02-06 01:45:11 +00:00
570e35870a
Markup fixes; in particular, the tables are now reasonable width
2003-02-05 21:15:38 +00:00
604ade4ebd
supports_unicode_filenames was not in the right location.
2003-02-04 19:13:07 +00:00
57d575240c
Update to better reflect the usage of struct_time instances throughout;
...
continuing to call these "time tuples" is misleading at best.
Closes SF bug #671731 ; will backport to 2.2.x.
2003-02-04 15:12:06 +00:00
5bbeb8d1ad
Twiddle.
2003-02-04 15:01:37 +00:00
4b37364fc8
Bug #678077 : Suggest alternative to os.getlogin()
2003-02-03 15:36:26 +00:00
b9ba4e6d75
[Bug #679251 ] Use correct constant name
2003-02-03 15:16:15 +00:00
1ff49a7734
* Add description of PyInt_FromString.
...
* Correct description of PyFloat_FromString. While ignored, the pend
argument still has to be given.
* Typo in PyLong_FromString.
2003-02-03 05:13:24 +00:00
ae31e9b8c7
Add PyFloat_FromString. Left the char **pend argument out of the
...
description since while there, it is useless and ignored, according to Tim's
commen. (PyInt_FromString is also not described, but PyLong_FromString is.
Is the former deprecated?)
2003-02-03 03:56:36 +00:00
96ef8115dd
Move itertools module from the sandbox and into production.
2003-02-01 00:10:11 +00:00
f9b0cc7df6
Document __module__.
2003-01-31 18:52:45 +00:00
2e0b18af30
Change the treatment of positions returned by PEP293
...
error handers in the Unicode codecs: Negative
positions are treated as being relative to the end of
the input and out of bounds positions result in an
IndexError.
Also update the PEP and include an explanation of
this in the documentation for codecs.register_error.
Fixes a small bug in iconv_codecs: if the position
from the callback is negative *add* it to the size
instead of substracting it.
From SF patch #677429 .
2003-01-31 17:19:08 +00:00
89fc4f3e56
Fix typo
2003-01-31 05:44:25 +00:00
2adbb83a24
SF bug #671447 : StringIO doc doesn't say it's sometimes read-only.
2003-01-31 05:17:33 +00:00
008a36ac20
Fix markup error.
2003-01-30 22:22:59 +00:00
301eb71fb9
Author markup: Andrew got to it first
2003-01-30 01:03:38 +00:00
49c595589e
Make the footer at the end of a \verbatiminput stand out a little
...
more, to make it easier to tell apart from the verbatim content.
2003-01-29 05:14:44 +00:00
7934bc23a8
Move a footnote to the end of the sentence, so the note mark won't
...
interfere with the flow of the sentence.
2003-01-29 05:10:27 +00:00
c23e0192c9
More markup changes for consistency.
2003-01-28 22:09:16 +00:00
68e6d57bb9
Various minor markup adjustments.
2003-01-28 22:02:35 +00:00
7821d7230c
Added missing dependency.
2003-01-28 21:53:05 +00:00
a31bb379f8
Update register example
2003-01-27 16:36:34 +00:00
0a9cc58c85
Adjust some of Skip's latest changes slightly; these really are things
...
that should stand out.
2003-01-27 16:32:04 +00:00
9db20c62ff
Make the "notice" environments somewhat similar, with less difference
...
between the "note" and "warning" flavors.
2003-01-27 16:31:16 +00:00
13a28634ac
* add \versionadded{} strings as appropriate
...
* remove doc for defunct IllegalKeywordArgument exception
* add note that HTTP class is for backward compatibility and refer reader to
online docstrings for help
2003-01-27 15:00:38 +00:00
2ef85a729e
Fix minor typos.
2003-01-25 21:46:53 +00:00
cd5c8c2120
SF #638299 , LaTeX documentation for logging package
...
Replace existing doc with new version from Vinay.
Fixed markup and wrapped long lines from patch.
Needs review.
2003-01-25 21:29:41 +00:00
daae32721a
Fix markup
2003-01-25 21:08:30 +00:00
f536827c65
Include version annotation for PyObject_Call().
2003-01-25 07:48:13 +00:00
8bd62afca9
Fix typo reported to python-docs.
2003-01-25 03:47:35 +00:00
8d81a012ef
date and datetime comparison: when we don't know how to
...
compare against "the other" argument, we raise TypeError,
in order to prevent comparison from falling back to the
default (and worse than useless, in this case) comparison
by object address.
That's fine so far as it goes, but leaves no way for
another date/datetime object to make itself comparable
to our objects. For example, it leaves Marc-Andre no way
to teach mxDateTime dates how to compare against Python
dates.
Discussion on Python-Dev raised a number of impractical
ideas, and the simple one implemented here: when we don't
know how to compare against "the other" argument, we raise
TypeError *unless* the other object has a timetuple attr.
In that case, we return NotImplemented instead, and Python
will give the other object a shot at handling the
comparison then.
Note that comparisons of time and timedelta objects still
suffer the original problem, though.
2003-01-24 22:36:34 +00:00
6d9f9b3b67
Fred drives and fixes a formatting nit.
2003-01-24 17:33:30 +00:00
2a44a8d332
SF bug 660872: datetimetz constructors behave counterintuitively (2.3a1).
...
This gives much the same treatment to datetime.fromtimestamp(stamp, tz) as
the last batch of checkins gave to datetime.now(tz): do "the obvious"
thing with the tz argument instead of a senseless thing.
2003-01-23 20:53:10 +00:00
10cadce41e
Reimplemented datetime.now() to be useful.
2003-01-23 19:58:02 +00:00
f196a0a4dd
"Premature" doc changes, for new astimezone() rules, and the new
...
tzinfo.fromutc() method. The C code doesn't implement any of this
yet (well, not the C code on the machine I'm using now), nor does
the test suite reflect it. The Python datetime.py implementation and
test suite in the sandbox do match these doc changes. The C
implementation probably won't catch up before Thursday (Wednesday is
a scheduled "black hole" day this week <0.4 wink>).
2003-01-22 04:45:50 +00:00
b01c39bb94
SF bug 671779: Error in tzinfo.dst() docs
...
tzinfo dst() should return timedelta(0) if DST is not effect, not 0.
2003-01-21 16:44:27 +00:00
1f7a271f0b
more tweaks
2003-01-21 01:52:39 +00:00
190613cee9
* document open() function
...
* promote the example and the documented restrictions to \subsection status
* document the flag parameter of the DbfilenameShelf class
2003-01-21 01:38:47 +00:00
327098a613
New rule for tzinfo subclasses handling both standard and daylight time:
...
When daylight time ends, an hour repeats on the local clock (for example,
in US Eastern, the clock jumps from 1:59 back to 1:00 again). Times in
the repeated hour are ambiguous. A tzinfo subclass that wants to play
with astimezone() needs to treat times in the repeated hour as being
standard time. astimezone() previously required that such times be
treated as daylight time. There seems no killer argument either way,
but Guido wants the standard-time version, and it does seem easier the
new way to code both American (local-time based) and European (UTC-based)
switch rules, and the astimezone() implementation is simpler.
2003-01-20 22:54:38 +00:00
f4ca5a2f45
Fix typo
2003-01-19 14:57:12 +00:00
e701dcbabd
SF patch #634866 : Alex Martelli's corrections to the ref manual.
...
Backport candidate. All but one or two of these changes
are applicable to 2.2.2.
2003-01-19 13:08:18 +00:00
9543b34006
SF patch #670423 : Add missing identity tests to operator.c
2003-01-18 23:22:20 +00:00
aac8c58f0b
Various markup changes.
2003-01-17 22:50:10 +00:00
42b567fce9
Fix a couple of markup errors.
2003-01-17 22:47:33 +00:00
376f0ef30c
Clean up some files that LaTeX2HTML drops in the HTML output directory
...
sometimes.
2003-01-17 21:25:04 +00:00
ee1bded046
Correct typos in example code.
2003-01-17 16:20:23 +00:00
13dd9d9978
Patch #662454 : import a.b as c is ok, fixes #660811 .
2003-01-16 11:30:08 +00:00
a5caa6fcd9
reference the os module and the lock flags in the os.open() function.
...
(Someone please review what I wrote for accuracy.)
2003-01-15 21:08:19 +00:00
3801ec7ff3
Document that __cmp__() is not defined for sets.
...
Note, that list.sort() is undefined for lists of sets.
Add the ... prompt to the example so it runs in doctest.
2003-01-15 15:46:05 +00:00
0c6774d92b
Patch #661719 : Expose compilation errors as exceptions on request.
2003-01-15 11:51:06 +00:00
d69663d300
Patch #473586 : Implement CGIXMLRPCRequestHandler.
2003-01-15 11:37:23 +00:00
a974b3939f
Move the date/time section into the modules section; it was in the
...
C API section by mistake
2003-01-13 19:09:03 +00:00
c1dd174682
Link to MRO article
...
Mention deprecation of string exceptions
2003-01-13 13:59:22 +00:00
2bd1568d35
SF patch 664183 and SF bug 664044: Note that both u'%s' % 'x' and
...
'%s' % u'x' return a unicode object.
2003-01-13 04:29:19 +00:00
06daee9dd7
Try to make a sentance more readable.
2003-01-12 15:04:54 +00:00
e68fbc44aa
SF #665570 , curses causes interpreter crash
...
The interpreter doesn't crash, but it does call exit() in libncurses.
Add a note to this effect.
Will backport
2003-01-12 14:56:19 +00:00
8ec17a0a8d
Minor correction and clarification.
2003-01-11 23:15:47 +00:00
3cb68a2512
Remove extra 'types'
...
Change a couple of list -> mylist
2003-01-10 13:52:30 +00:00
6fe1299b09
SF bug #652888 : bad documentation for the "type" builtin
...
Clarified that not all types are included. The OP was looking for a
StaticMethodType.
Also, added a note and example suggesting the use of int,str, etc.
instead of IntType, StrType, etc.
Renamed the crummy variable name in the example from "list" to "mylist".
2003-01-10 09:33:08 +00:00
312141c51f
Purged reference to defunct datetimetz.
2003-01-09 19:52:17 +00:00
9b44571caa
Various minor edits
2003-01-09 13:46:30 +00:00
0f0e6b9d48
Markup fix
2003-01-09 12:51:50 +00:00
003720235b
Massive fiddling to reflect that datetimetz and timetz no longer exist.
...
WARNING: It would be a minor miracle if the LaTeX stuff still worked.
s/field/member/ generally everywhere, to conform with most other usage in
the docs.
s/daylight savings time/daylight saving time/ generally everywhere,
because the latter spelling is anally correct.
2003-01-09 04:10:05 +00:00
326c72a839
Add notes about the linuxaudiodev and ossaudiodev modules.
2003-01-08 07:21:53 +00:00
55d555f012
command doesn't work, but program does, not sure it's correct, though
2003-01-08 05:27:42 +00:00
19b6f60f5c
There's no such method as has_option() -- should be has_extn().
2003-01-08 03:04:42 +00:00
d4fee28717
Rewrite awkward/ungrammatical sentence.
...
Typo fix.
2003-01-08 03:02:26 +00:00
d97b01cb82
Bump version number
2003-01-08 02:09:40 +00:00
b6604b3e69
Document EX_OK and friends.
2003-01-07 22:43:25 +00:00
051314f924
SF #664011 , move tarfile module in docs
2003-01-07 22:36:04 +00:00
674b0bfde6
Add tarfile module
2003-01-07 00:07:19 +00:00
ef893fe452
Add Tix and rexec changes
2003-01-06 20:04:17 +00:00
8ef3d8d5d1
Fix spelling.
2003-01-06 18:41:01 +00:00
488609e43a
SF #642236 , optparse LaTeX docs by Johannes Gijsbers
2003-01-06 16:51:37 +00:00
11f89b75e1
Strike any hint that from-import-* could ever be reasonable; it's a
...
vile abomination and should be eradicated!
2003-01-06 16:38:10 +00:00
2e3ae21060
Fix some nits Guido brought up last August:
...
- give subsection pages nicer names
- shorten some really long table cells; table cells can't wrap in the
typeset version of the documentation
2003-01-06 15:50:32 +00:00
2b0a3d33f8
Fix markup so this will format again.
2003-01-06 15:03:11 +00:00
9f5b07dd92
SF bug #592859 : os.chmod is underdocumented
...
Document constants for permission bits.
2003-01-06 13:31:26 +00:00
1772f17666
SF bug #661848 and #631055 : Clarify use of __all__.
2003-01-06 12:54:54 +00:00
b9ef4aea5e
SF #651082 , tarfile module implementation from Lars Gustäbel
2003-01-05 23:19:43 +00:00
6d23b170cf
Fix a typo
2003-01-05 22:20:51 +00:00
75a6e3bd1a
datetime_from_timet_and_us(): ignore leap seconds if the platform
...
localtime()/gmtime() insists on delivering them, + associated doc
changes.
Redid the docs for datetimtez.astimezone().
2003-01-04 18:17:36 +00:00
adf642038e
A new implementation of astimezone() that does what we agreed on in all
...
cases, plus even tougher tests of that. This implementation follows
the correctness proof very closely, and should also be quicker (yes,
I wrote the proof before the code, and the code proves the proof <wink>).
2003-01-04 06:03:15 +00:00
69bf8f3f4e
SF bug #655271 : Slightly modify locals() doc
...
Clarify the operation of locals().
2003-01-04 02:16:22 +00:00
2ca243368f
SF bug #651149 : Review libshelve.tex when possible
...
Minor fixes to markup, spelling, parameter names, and abbreviations.
2003-01-04 01:53:38 +00:00
8827d0c338
Replaced the flawed "local time" example tzinfo class with the guts
...
of Guido's later Local.py (from the datetime sandbox).
2003-01-03 22:26:57 +00:00
fdf65d9106
Grammatical fix: change possessive "it's" to "its".
2003-01-03 21:09:57 +00:00
aa1d3aa643
Spread the blame (err, I mean credit) for ossaudiodev around a bit.
2003-01-03 18:03:21 +00:00
5a22453d33
Write PEP 301 section
...
Mention difference between 2.2.2 and 2.3 True and False
2003-01-03 16:52:27 +00:00
87cebbf601
Add SSL support for imaplib; add empty PEP301 section
2003-01-03 16:24:28 +00:00
d15f4e3d42
[Patch #658093 ] Documentation support for PEP 301
...
Add two sections to this manual about package meta-data and about
registering packages
2003-01-03 15:42:14 +00:00
1618cedfac
Add contributor.
2003-01-03 10:41:50 +00:00
04b89950b0
Fix error in previous correction; thanks, Just!
2003-01-02 23:50:18 +00:00
d5ac8d0b39
Fix PEP 302 description; bump version number
2003-01-02 21:33:15 +00:00
397301eccb
The tzinfo methods utcoffset() and dst() must return a timedelta object
...
(or None) now. In 2.3a1 they could also return an int or long, but that
was an unhelpfully redundant leftover from an earlier version wherein
they couldn't return a timedelta. TOOWTDI.
2003-01-02 21:28:08 +00:00
4abd5f0fce
Allow list sort's comparison function to explicitly be None. See SF patch
...
661092.
2003-01-02 20:51:08 +00:00
710fb1548a
astimezone() internals: if utcoffset() returns a duration, complain if
...
dst() returns None (instead of treating that as 0).
2003-01-02 19:35:54 +00:00
e55534665f
Update the copyright year.
2003-01-02 16:31:35 +00:00
e149798c7f
Add some version info for new methods and class
2003-01-02 15:32:00 +00:00
9e86ad7072
Fix an example
2003-01-02 13:42:32 +00:00
74bcac4cae
- documented Ellipsis, NotImplemented
...
- minor markup changes
- indented for consistency with newer content
2003-01-02 05:13:51 +00:00
d0859aaaaa
Add dependency info for the recently added lib/libconsts.tex.
2003-01-02 05:00:12 +00:00
45e482fd3d
Document that apply() is deprecated. See:
...
http://mail.python.org/pipermail/python-dev/2003-January/031556.html
2003-01-02 04:54:04 +00:00
f36151556f
A quicker astimezone() implementation, rehabilitating an earlier
...
suggestion from Guido, along with a formal correctness proof of the
trickiest bit. The intricacy of the proof reveals how delicate this
is, but also how robust the conclusion: correctness doesn't rely on
dst() returning +- one hour (not all real time zones do!), it only
relies on:
1. That dst() returns a (any) non-zero value if and only if daylight
time is in effect.
and
2. That the tzinfo subclass implements a consistent notion of time zone.
The meaning of "consistent" was a hidden assumption, which is now an
explicit requirement in the docs. Alas, it's an unverifiable (by the
datetime implementation) requirement, but so it goes.
2003-01-01 21:51:37 +00:00
0233bd9c7d
mention built-in constants.
2003-01-01 20:37:14 +00:00
1f041e7aa8
process libconsts.tex
2003-01-01 20:34:00 +00:00
17804b1df4
new section - builtin constants
2003-01-01 20:33:38 +00:00
33fb554a13
Revert merge from 2.3 alpha 1 release branch; the change does not
...
apply to the trunk.
2003-01-01 04:50:32 +00:00
88ad134e36
Merging in changes from r23a1-branch. Doc/makefile had conflicts, which
...
I leave to Fred to sort out.
2003-01-01 02:14:12 +00:00
8f1f8f13e4
The trunk is (nominally) post-alpha.
2002-12-31 20:26:25 +00:00
f15fb2926b
Results of a rewrite pass
2002-12-31 18:34:54 +00:00
0f8e543159
- use classdesc where we can (for better indexing)
...
- more style consistency crud
2002-12-31 18:31:48 +00:00
436eadd455
General style conformance. Markup some unmarked constructs.
2002-12-31 18:13:11 +00:00
f621232c0d
Use funcdesc instead of classdesc to be consistent with out sections.
2002-12-31 17:24:50 +00:00
e2c649126e
Further cleanup of exceptions. All interpolation-related exceptions
...
now derive from InterpolationError, which is not raised directly (only
subclasses get raised). This matches what the docs already said.
2002-12-31 17:23:27 +00:00
6222958500
Spelling fix
2002-12-31 16:37:03 +00:00
cbd6cd2312
Add markup for time object.
...
Cleanup whitespace.
Fix unbalanced parenthesis.
2002-12-31 16:30:49 +00:00
9532298c82
Removed the now-untrue (or soon-to-be untrue) part of the astimezone()
...
docs. Replaced it with an XXX block, because the hoped-for treatment
of DST endcases remains unclear (Guido doesn't really like raising an
exception when it's impossible to deliver a correct result, but so
far I have no way in hand to consistently deliver a defined incorrect
result either).
2002-12-31 16:01:47 +00:00
2852cbaf26
Document the new ,netrc awareness in nntplib.
2002-12-31 15:28:44 +00:00
f91b4619e0
Barry raised reasonable objections to the macro name \mimeheader, so
...
we'll simply revert to \mailheader since there's no other good name.
2002-12-31 15:23:09 +00:00
f14730a49a
- correct the deprecation markups so this formats again
...
- some minor cleanups
2002-12-31 15:10:49 +00:00
c5f5f87f74
Complete the markup for timedelta objects.
...
Fix a curly brace that should have been a paren.
2002-12-31 14:26:54 +00:00
ae3bbf57bf
Add posix.loadavg()
...
Add some times
2002-12-31 14:03:45 +00:00
f3edea5b90
Use the name (path) specified in the parameter list
2002-12-31 13:38:28 +00:00
96a60e4af5
Patch #658927 : Add getctime to os.path.
...
Document that getatime and getmtime may return floats.
2002-12-31 13:11:54 +00:00
5c37a7717d
Document standard encodings.
2002-12-31 12:39:07 +00:00
ee711092eb
SmartCookie and SerialCookie were recently deprecated
2002-12-31 12:27:11 +00:00
99448e5214
InterpolationSyntaxError was added in 2.3
2002-12-31 12:23:10 +00:00
a3661e1267
Update version numbers.
2002-12-31 05:51:05 +00:00
2714706188
Phrase repair.
2002-12-31 04:41:38 +00:00
8e7ec7cec8
Minor markup and spelling repair.
2002-12-31 04:39:05 +00:00
5095a47408
Add a hurriedly-written section on the datetime module
2002-12-31 02:48:59 +00:00
974ab9d865
Add lots of items.
...
The only thing missing now is the new date/time stuff.
2002-12-31 01:20:30 +00:00
81e4aa7054
- re-mark ESR's warning about extended registry syntax
...
- document InterpolationSyntaxError
2002-12-30 23:50:19 +00:00
66162de80d
Add entries for the dummy_thread and dummy_threading modules.
2002-12-30 23:01:14 +00:00
740f80029c
- fix use of \refmodule markup
...
- correct some module names, add hyperlinks
- wrap some long lines
2002-12-30 23:00:36 +00:00
2969233f9a
Add dummy_thread[ing] sections and reference these from libthread[ing].
2002-12-30 22:34:10 +00:00
ad50ca91a9
Brett Cannon's dummy_thread and dummy_threading modules (SF patch
...
622537), with some nitpicking editorial changes.
2002-12-30 22:30:22 +00:00
a37e5cce4b
We're using strictly American spellings, so there's no diaresis over
...
the i in naive.
More markup fixups.
2002-12-30 21:26:42 +00:00
bad8ff089a
A step on the way to making tzinfo classes writable by mortals: get rid
...
of the timetz case. A tzinfo method will always see a datetimetz arg,
or None, now. In the former case, it's still possible that it will get
a datetimetz argument belonging to a different timezone. That will get
fixed next.
2002-12-30 20:52:32 +00:00
567332abc4
Start something that might make table notes easier to deal with,
...
eventually.
2002-12-30 20:51:27 +00:00
9bdeee492a
Clean up a table so it passes formatting.
2002-12-30 20:35:32 +00:00
0de926fd12
Added the \var{} markup so the tables will look good.
2002-12-30 20:21:21 +00:00
6005a344ce
Added markup upto line 233.
2002-12-30 20:01:24 +00:00
Michael W. Hudson
Andrew M. Kuchling
Neal Norwitz
Anthony Baxter
Fred Drake
Skip Montanaro
Raymond Hettinger
Jeremy Hylton
Walter Dörwald
Tim Peters
Barry Warsaw
Martin v. Löwis
Greg Ward
Guido van Rossum
Eric S. Raymond