Fred Drake
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
Fred Drake
2b0a3d33f8
Fix markup so this will format again.
2003-01-06 15:03:11 +00:00
Raymond Hettinger
9f5b07dd92
SF bug #592859 : os.chmod is underdocumented
...
Document constants for permission bits.
2003-01-06 13:31:26 +00:00
Raymond Hettinger
1772f17666
SF bug #661848 and #631055 : Clarify use of __all__.
2003-01-06 12:54:54 +00:00
Neal Norwitz
b9ef4aea5e
SF #651082 , tarfile module implementation from Lars Gustäbel
2003-01-05 23:19:43 +00:00
Neal Norwitz
6d23b170cf
Fix a typo
2003-01-05 22:20:51 +00:00
Tim Peters
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
Tim Peters
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
Raymond Hettinger
69bf8f3f4e
SF bug #655271 : Slightly modify locals() doc
...
Clarify the operation of locals().
2003-01-04 02:16:22 +00:00
Raymond Hettinger
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
Tim Peters
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
Greg Ward
fdf65d9106
Grammatical fix: change possessive "it's" to "its".
2003-01-03 21:09:57 +00:00
Greg Ward
aa1d3aa643
Spread the blame (err, I mean credit) for ossaudiodev around a bit.
2003-01-03 18:03:21 +00:00
Andrew M. Kuchling
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
Andrew M. Kuchling
87cebbf601
Add SSL support for imaplib; add empty PEP301 section
2003-01-03 16:24:28 +00:00
Andrew M. Kuchling
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
Raymond Hettinger
1618cedfac
Add contributor.
2003-01-03 10:41:50 +00:00
Andrew M. Kuchling
04b89950b0
Fix error in previous correction; thanks, Just!
2003-01-02 23:50:18 +00:00
Andrew M. Kuchling
d5ac8d0b39
Fix PEP 302 description; bump version number
2003-01-02 21:33:15 +00:00
Tim Peters
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
Skip Montanaro
4abd5f0fce
Allow list sort's comparison function to explicitly be None. See SF patch
...
661092.
2003-01-02 20:51:08 +00:00
Tim Peters
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
Guido van Rossum
e55534665f
Update the copyright year.
2003-01-02 16:31:35 +00:00
Neal Norwitz
e149798c7f
Add some version info for new methods and class
2003-01-02 15:32:00 +00:00
Andrew M. Kuchling
9e86ad7072
Fix an example
2003-01-02 13:42:32 +00:00
Fred Drake
74bcac4cae
- documented Ellipsis, NotImplemented
...
- minor markup changes
- indented for consistency with newer content
2003-01-02 05:13:51 +00:00
Fred Drake
d0859aaaaa
Add dependency info for the recently added lib/libconsts.tex.
2003-01-02 05:00:12 +00:00
Fred Drake
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
Tim Peters
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
Skip Montanaro
0233bd9c7d
mention built-in constants.
2003-01-01 20:37:14 +00:00
Skip Montanaro
1f041e7aa8
process libconsts.tex
2003-01-01 20:34:00 +00:00
Skip Montanaro
17804b1df4
new section - builtin constants
2003-01-01 20:33:38 +00:00
Fred Drake
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
Tim Peters
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
Fred Drake
8f1f8f13e4
The trunk is (nominally) post-alpha.
2002-12-31 20:26:25 +00:00
Andrew M. Kuchling
f15fb2926b
Results of a rewrite pass
2002-12-31 18:34:54 +00:00
Fred Drake
0f8e543159
- use classdesc where we can (for better indexing)
...
- more style consistency crud
2002-12-31 18:31:48 +00:00
Fred Drake
436eadd455
General style conformance. Markup some unmarked constructs.
2002-12-31 18:13:11 +00:00
Raymond Hettinger
f621232c0d
Use funcdesc instead of classdesc to be consistent with out sections.
2002-12-31 17:24:50 +00:00
Fred Drake
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
Raymond Hettinger
6222958500
Spelling fix
2002-12-31 16:37:03 +00:00
Raymond Hettinger
cbd6cd2312
Add markup for time object.
...
Cleanup whitespace.
Fix unbalanced parenthesis.
2002-12-31 16:30:49 +00:00
Tim Peters
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
Eric S. Raymond
2852cbaf26
Document the new ,netrc awareness in nntplib.
2002-12-31 15:28:44 +00:00
Fred Drake
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
Fred Drake
f14730a49a
- correct the deprecation markups so this formats again
...
- some minor cleanups
2002-12-31 15:10:49 +00:00
Raymond Hettinger
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
Andrew M. Kuchling
ae3bbf57bf
Add posix.loadavg()
...
Add some times
2002-12-31 14:03:45 +00:00
Neal Norwitz
f3edea5b90
Use the name (path) specified in the parameter list
2002-12-31 13:38:28 +00:00
Martin v. Löwis
96a60e4af5
Patch #658927 : Add getctime to os.path.
...
Document that getatime and getmtime may return floats.
2002-12-31 13:11:54 +00:00
Martin v. Löwis
5c37a7717d
Document standard encodings.
2002-12-31 12:39:07 +00:00
Neal Norwitz
ee711092eb
SmartCookie and SerialCookie were recently deprecated
2002-12-31 12:27:11 +00:00
Neal Norwitz
99448e5214
InterpolationSyntaxError was added in 2.3
2002-12-31 12:23:10 +00:00
Fred Drake
a3661e1267
Update version numbers.
2002-12-31 05:51:05 +00:00
Guido van Rossum
2714706188
Phrase repair.
2002-12-31 04:41:38 +00:00
Guido van Rossum
8e7ec7cec8
Minor markup and spelling repair.
2002-12-31 04:39:05 +00:00
Andrew M. Kuchling
5095a47408
Add a hurriedly-written section on the datetime module
2002-12-31 02:48:59 +00:00
Andrew M. Kuchling
974ab9d865
Add lots of items.
...
The only thing missing now is the new date/time stuff.
2002-12-31 01:20:30 +00:00
Fred Drake
81e4aa7054
- re-mark ESR's warning about extended registry syntax
...
- document InterpolationSyntaxError
2002-12-30 23:50:19 +00:00
Fred Drake
66162de80d
Add entries for the dummy_thread and dummy_threading modules.
2002-12-30 23:01:14 +00:00
Fred Drake
740f80029c
- fix use of \refmodule markup
...
- correct some module names, add hyperlinks
- wrap some long lines
2002-12-30 23:00:36 +00:00
Guido van Rossum
2969233f9a
Add dummy_thread[ing] sections and reference these from libthread[ing].
2002-12-30 22:34:10 +00:00
Guido van Rossum
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
Fred Drake
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
Tim Peters
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
Fred Drake
567332abc4
Start something that might make table notes easier to deal with,
...
eventually.
2002-12-30 20:51:27 +00:00
Fred Drake
9bdeee492a
Clean up a table so it passes formatting.
2002-12-30 20:35:32 +00:00
Raymond Hettinger
0de926fd12
Added the \var{} markup so the tables will look good.
2002-12-30 20:21:21 +00:00
Raymond Hettinger
6005a344ce
Added markup upto line 233.
2002-12-30 20:01:24 +00:00
Barry Warsaw
d1adc8a6af
Describe the new `errors' argument to Header.__init__() and
...
Header.append()
2002-12-30 19:17:37 +00:00
Andrew M. Kuchling
fa91858c6c
More markup additions
2002-12-30 14:20:16 +00:00
Andrew M. Kuchling
d6d7cfaada
Minor grammar fix, and clarification
2002-12-30 03:08:27 +00:00
Andrew M. Kuchling
c97868ee2f
Mark up more text
2002-12-30 03:06:45 +00:00
Raymond Hettinger
40f6217092
SF patch 658251: Install a C implementation of the Mersenne Twister as the
...
core generator for random.py.
2002-12-29 23:03:38 +00:00
Raymond Hettinger
c7b076928c
Incorporate Skip's suggestion to use SciPy's validation test near
...
equality. Note, there is another flavor that compares to a given
number of significant digits rather than decimal places. If there
is a demand, that could be added at a later date.
2002-12-29 17:59:24 +00:00
Raymond Hettinger
f8bcfb13f1
SF Bug 645777: list.extend() works with any iterable and is no longer
...
experimental.
2002-12-29 05:49:09 +00:00
Tim Peters
276a8f3b80
astimezone(): document that None is an OK argument.
2002-12-27 21:41:32 +00:00
Eric S. Raymond
56b3184e89
Added a useful warning to the documentation.
2002-12-27 20:05:36 +00:00
Martin v. Löwis
33e94437ca
Document killpg.
2002-12-27 10:21:19 +00:00
Martin v. Löwis
438b534ad0
Patch #657889 : Implement posix.getloadavg.
2002-12-27 10:16:42 +00:00
Tim Peters
60c76e4016
Make comparison and subtraction of aware objects ignore tzinfo if the
...
operands have identical tzinfo members (meaning object identity -- "is").
I misunderstood the intent here, reading wrong conclusion into
conflicting clues.
2002-12-27 00:41:11 +00:00
Just van Rossum
8982595870
Backing out patch #642578 in anticipation of final acceptance of PEP 302.
2002-12-25 23:13:34 +00:00
Raymond Hettinger
e11b510a5b
SF 658405: calendar.py to rely on the datetime module instead of the time
...
module.
The code is shorter, more readable, faster, and dramatically increases the
range of acceptable dates.
Also, used the floor division operator in leapdays().
2002-12-25 16:37:19 +00:00
Tim Peters
80475bb4d2
Implemented datetime.astimezone() and datetimetz.astimezone().
2002-12-25 07:40:55 +00:00
Tim Peters
52d134874f
Removed blurb admonishing users to raise an exception if the datetime
...
argument to a tzinfo method doesn't have a matching tzinfo member.
2002-12-24 16:34:13 +00:00
Tim Peters
2483b61e03
Added note about technical pickle limitation on tzinfo instances.
2002-12-24 16:30:58 +00:00
Tim Peters
1cff9fc97c
tzinfo.{utcoffset,dst} can return timedelta (or integer or None).
...
{timetz,datetimetz}.{uctcoffset,dst} do return timedelta (or None).
2002-12-24 16:25:29 +00:00
Neal Norwitz
c7d8c68c65
Fix SF #658023 , "What's New in 2.3", s12, verbatim error
...
Remove space between \end {verbatim}
2002-12-24 14:51:43 +00:00
Tim Peters
12bf339aea
Implemented .replace() methods for date, datetime, datetimetz, time and
...
timetz.
2002-12-24 05:41:27 +00:00
Tim Peters
29fb9c7e07
Brought the strftime explanation into synch with the plain-text sandbox
...
docs, and moved its section to the end (before the "C API" section,
which latter doesn't really belong in the Library manual).
2002-12-23 22:21:52 +00:00
Fred Drake
446f32367b
Add in the datetime docs now that they pass LaTeX. Still ugly, but that can
...
be fixed.
2002-12-23 19:03:00 +00:00
Fred Drake
bbdb250862
Lots of markup changes. This is still pretty sad, but passes LaTeX
...
and is mostly readable.
2002-12-23 18:58:06 +00:00
Fred Drake
ce5200842e
Move the examples of concrete tzinfo classes to a separate file, so the
...
verbatim environment does not bollux page breaking.
2002-12-23 18:52:19 +00:00
Fred Drake
4a80a3ec21
Added docs for (draft) pkgutil module.
2002-12-23 16:53:59 +00:00
Andrew M. Kuchling
c4a3f413a7
Bump version number
2002-12-23 12:50:50 +00:00
Tim Peters
8ed8320827
Fixed longstanding bug in the description of strftime's %W code.
2002-12-20 17:15:39 +00:00
Andrew M. Kuchling
ca2623a2f9
Check in current, unfinished, draft of datetime docs
...
(Fred, don't bother to add to lib.tex or to proofread this yet.)
2002-12-18 14:59:11 +00:00
Fred Drake
e0f02f0826
Fix some small markup nits.
2002-12-18 02:07:14 +00:00
Neal Norwitz
3e93b4d222
Fix typo spotted by Richie Hindle
2002-12-18 01:20:29 +00:00
Greg Ward
3ebf56c60f
Two more typo fixes.
2002-12-17 23:27:41 +00:00