Commit graph

5510 commits

Author SHA1 Message Date
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