Neal Norwitz
051314f924
SF #664011 , move tarfile module in docs
2003-01-07 22:36:04 +00:00
Raymond Hettinger
8ef3d8d5d1
Fix spelling.
2003-01-06 18:41:01 +00:00
Neal Norwitz
488609e43a
SF #642236 , optparse LaTeX docs by Johannes Gijsbers
2003-01-06 16:51:37 +00:00
Fred Drake
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
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
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
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
Neal Norwitz
e149798c7f
Add some version info for new methods and class
2003-01-02 15:32:00 +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
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
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
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
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
Fred Drake
81e4aa7054
- re-mark ESR's warning about extended registry syntax
...
- document InterpolationSyntaxError
2002-12-30 23:50:19 +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
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