Neal Norwitz
b25229d823
Fix SF bug #766288 , property() example gives syntax error
2003-07-05 17:37:58 +00:00
Skip Montanaro
eec26f982a
Correct documentation of check interval - it's 100 by default, not 10 any
...
longer. Pointed out by Alex Martelli.
2003-07-02 21:38:34 +00:00
Skip Montanaro
5e4e39f12a
Note that csv files (when they are actual files) must be opened in 'b'inary
...
mode. Note that the only restriction on the csvfile passed to writer
objects is that it have a write method.
2003-07-02 15:32:48 +00:00
Raymond Hettinger
774816f817
SF bug #764616 : execfile(filename,...) not execfile(file,...)
...
Clarify parameter name.
2003-07-02 15:31:54 +00:00
Raymond Hettinger
f8020e0211
Grammar nit. SF bug #757822
2003-07-02 15:10:38 +00:00
Fred Drake
c5528b1f5c
Revert the previous change; this is now dealt with in a better way.
2003-07-02 14:44:55 +00:00
Fred Drake
6675881aab
There's a better way to deal with the "comment" environment; I found
...
this in SF patch #732174 .
2003-07-02 14:44:08 +00:00
Fred Drake
629dd99802
Make the "install schema" tables follow the same table style we use
...
elsewhere (lines between columns).
2003-07-02 14:33:11 +00:00
Fred Drake
89de74ee94
The Macintosh Modules Reference now formats to GNU info without errors
...
(which is not to say it's right), so re-enable it.
Documenting Python and Installing Python Modules still have problems
when converting to GNU info, so we'll continue to leave them out for
now.
2003-07-02 14:25:04 +00:00
Fred Drake
3b09558710
Fill out the set of macros and environments supported somewhat.
...
Some of this is still pretty iffy.
2003-07-02 14:22:48 +00:00
Fred Drake
1ec0bdf899
The datetime C API really isn't usable outside the datetime module
...
implementation, so remove this decoy (it break formatting of the GNU
info version of the docs).
2003-07-02 13:42:51 +00:00
Fred Drake
2884d6de15
Fix a variety of small markup nits.
2003-07-02 12:27:43 +00:00
Fred Drake
3ede7848a9
- note that super() only applies to new-style classes;
...
closes SF bug #764003
- fix markup for consistency
2003-07-01 16:31:26 +00:00
Fred Drake
901a41e757
normalize markup for consistency
2003-07-01 16:17:50 +00:00
Tim Peters
93ceaea01f
showwarning() calls formatwarning(), not showwarning().
...
Bugfix candidate.
2003-07-01 14:37:59 +00:00
Raymond Hettinger
9c8f78deab
Improve the wording a bit
2003-07-01 07:19:17 +00:00
Raymond Hettinger
69d6356eb9
Fix spelling, grammar, usage, and markup.
2003-07-01 06:29:18 +00:00
Raymond Hettinger
8ee006097f
SF #751062 : Tutorial: remove string exceptions, add parnassus, #posts
...
(Contributed by Gerritt Holl)
* Remove the last mentions of string exceptions
* Reference a third-party repository of programs
* Minor clarification of comp.lang.py posting volumes
2003-07-01 06:19:34 +00:00
Brett Cannon
20def8bb19
Make temporary change of using _strptime for time.strptime permanent.
...
Flesh out docs to better explain time.strptime (closes bug #697990 ).
2003-07-01 05:16:08 +00:00
Neal Norwitz
ecc7171007
Add versionadded info for the 2 new threading module functions
2003-06-30 21:47:47 +00:00
Thomas Heller
675580f4fc
Document the DISTUTILS_DEBUG variable.
...
Closes sf #761401 .
Backport candidate.
2003-06-30 19:33:29 +00:00
Fred Drake
220e83946d
We are now post-beta 2.
2003-06-30 13:38:38 +00:00
Fred Drake
f647b63624
Added missing name (textwrap.dedent() docs).
2003-06-30 12:18:52 +00:00
Raymond Hettinger
ccd615c1a7
SF bug #762990 : Awful Grammar in Python Tutorial
...
Fixed a nit.
2003-06-30 04:27:31 +00:00
Fred Drake
5728815e7b
Fix broken markup, & tweak a couple of things for consistency.
2003-06-29 18:12:23 +00:00
Jeremy Hylton
bfccb35b58
Add settrace() and setprofile() functions to the threading library.
2003-06-29 16:58:41 +00:00
Fred Drake
85d27576a3
Update copyright years.
2003-06-29 16:55:47 +00:00
Skip Montanaro
32a5e878d7
minor wordsmithing
2003-06-29 16:01:51 +00:00
Raymond Hettinger
be2528d866
SF patch #760257 : add socket.timeout exception
...
(Contributed by Bob Halley)
Add documentation for the new socket.timeout exception.
2003-06-29 04:55:59 +00:00
Raymond Hettinger
5918f8de67
Minor fixes to punctuation and grammar.
2003-06-29 04:53:23 +00:00
Fred Drake
3e2244c9e1
Bump version information for Python 2.3 beta 2.
2003-06-29 02:17:28 +00:00
Fred Drake
6595e15331
Document PyThreadState_SetAsyncExc().
2003-06-29 02:14:31 +00:00
Barry Warsaw
6891cd3aa3
A few minor improvements
2003-06-28 15:22:16 +00:00
Jim Fulton
6c71091fbe
Rewrote the docs for supporting cyclic garbage collection to reflect
...
the new way that once writes types.
Deleted the old section and sample code and added a new section
building on the Noddy example.
2003-06-28 13:29:16 +00:00
Jim Fulton
9c3e957251
Updated the depenencies to reflect changes in the sample code for
...
building new types.
2003-06-28 13:27:57 +00:00
Jim Fulton
18a6be9748
Added tests for sample modules.
2003-06-28 11:54:40 +00:00
Jim Fulton
f0e38d1cd2
Added s setup module to make it easier to test the sample modules.
2003-06-28 11:54:20 +00:00
Jim Fulton
7050e929e6
Fixed bug in implementation of tp_init function. It should be an int
...
function, not a PyObject *.
2003-06-28 11:54:03 +00:00
Jim Fulton
4b59f9165d
Changed the assignment of PyType_GenericNew to tp_new slot. Now do
...
this in module initialization before calling PyType_Ready. (Sorry
Tim.) This is necessary to compile on cygwin. AFAIK, we support
cygwin. If so, then we need to write extentions this way.
2003-06-28 11:53:29 +00:00
Jim Fulton
db6a569de7
Changed the assignment of PyType_GenericNew to tp_new slot. Now do
...
this in module initialization before calling PyType_Ready. (Sorry
Tim.) This is necessary to compile on cygwin. AFAIK, we support
cygwin. If so, then we need to write extentions this way.
Fixed bug in implementation of tp_init function. It should be an int
function, not a PyObject *.
2003-06-28 11:53:12 +00:00
Fred Drake
ded8e740df
Correct markup errors that prevented formatting.
2003-06-28 11:50:34 +00:00
Martin v. Löwis
7928f388c4
Explain source encodings. Fixes #683486 .
2003-06-28 08:11:55 +00:00
Raymond Hettinger
3567a876c7
Add take() to examples. Tighten the islice() example
2003-06-28 05:44:36 +00:00
Fred Drake
5d2f515dd4
fix markup nits
2003-06-28 03:09:06 +00:00
Raymond Hettinger
6f3eaa67e5
SF patch #761519 : Fixes for bugs 760703 and 757821
...
SF bug #760703 : SocketHandler and LogRecord don't work well together
SF bug #757821 : logging module docs
Applied Vinay Sajip's patch with a few minor fixups and a NEWS item.
Patched __init__.py - added new function
makeLogRecord (for bug report 760703).
Patched handlers.py - updated some docstrings and
deleted some old commented-out code.
Patched test_logging.py to make use of makeLogRecord.
Patched liblogging.tex to fill documentation gaps (both
760703 and bug 757821).
2003-06-27 21:43:39 +00:00
Tim Peters
6ebe61fa80
A hack to ease compatibility with pre-2.3 Pythons: by default, doctest
...
now accepts "True" when a test expects "1", and similarly for "False"
versus "0". This is un-doctest-like, but on balance makes it much
more pleasant to write doctests that pass under 2.2 and 2.3. I expect
it to go away again, when 2.2 is forgotten. In the meantime, there's
a new doctest module constant that can be passed to a new optional
argument, if you want to turn this behavior off.
Note that this substitution is very simple-minded: the expected and
actual outputs have to consist of single tokens. No attempt is made,
e.g., to accept [True, False] when a test expects [1, 0]. This is a
simple hack for simple tests, and I intend to keep it that way.
2003-06-27 20:48:05 +00:00
Fred Drake
095f817330
Don't assume the name of the table of contents will be contents.html;
...
that won't be right when mkhowto is called with --numeric (as it is
for the Python Tutorial). Save the actual name we use when we build
the table of contents, then use that in the page head metadata. The
node2label.pl script will munge this properly when --numeric isn't
given, so this works in both cases.
Closes SF bug #761830 .
2003-06-27 18:26:01 +00:00
Fred Drake
25b5358cf2
Add definitions of the test and testlist symbols in the grammar so
...
there are no gaps in the definitions.
Closes SF bug #726150 .
2003-06-27 17:12:43 +00:00
Fred Drake
6ab8b40337
fix link-hovering so <a name='...'> (no href attribute) doesn't get
...
the hovering background
2003-06-27 16:32:27 +00:00
Raymond Hettinger
df9eff061e
* Markup nits for the Invoking Descriptors section
...
* Documented __slots__
* Documented __metaclass__
Shamelessly plagarized from Guido's tutorial.
2003-06-27 06:57:56 +00:00
Raymond Hettinger
d0cda1dc9f
SF patch #760792 : "wo" in "word" now valid but not documented as such
...
Revised version of a contribution from Gerrit Holl.
Update the docs for the extended behavior of __contains__
2003-06-26 19:32:10 +00:00
Raymond Hettinger
daa340418b
* Fixed an unmatched parenthesis early in the text.
...
* Clarified the meaning of lexicographic sequence ordering as discussed on
comp.lang.python: http://groups.google.com/groups?th=e163c9f9ba114493
2003-06-26 17:41:40 +00:00
Fred Drake
f91888bb46
markup consistency nits
2003-06-26 03:11:57 +00:00
Fred Drake
4db3661e24
remove _ from label: LaTeX rejects this due to all the magic we use to
...
get the _ character to format like a normal character
2003-06-26 03:11:20 +00:00
Raymond Hettinger
2b9bc08ee7
Removed useless intra-section references which jump to the top of the
...
section instead of the specific item being referenced.
2003-06-25 20:36:20 +00:00
Raymond Hettinger
2dd8c42638
SF bug #696777 : How to make a class iterable using a member generator.
...
* Added a note that a container class can implement the iterator protocol
by defining its __iter__() method as a generator.
2003-06-25 19:03:22 +00:00
Raymond Hettinger
03ec6d538a
* Document how descriptors are invoked.
...
* Fix minor parenthesis matching errors in ref3.tex.
2003-06-25 18:29:36 +00:00
Raymond Hettinger
35fd926195
SF bug #757822 : Additional index items, other minor details
...
* Minor grammatical fix.
2003-06-25 15:07:45 +00:00
Martin v. Löwis
9e9a7c3dd7
Patch #640236 : Better eplain unused data.
2003-06-21 14:15:25 +00:00
Martin v. Löwis
171be76bdd
Patch #755683 : Document that there might be a maximum indentation limit.
...
Fixes #700827
2003-06-21 13:40:02 +00:00
Barry Warsaw
47db252786
Add some documentation which describes how to use the email package
...
instead of rfc822 as the Message factory.
2003-06-20 22:04:03 +00:00
Neal Norwitz
3a03de4a27
SF #757229 , fix libsocket.tex typo
2003-06-20 17:11:39 +00:00
Fred Drake
2664cbbeba
Remove heading from orphan section.
2003-06-20 14:27:27 +00:00
Fred Drake
0799d0a9e3
Update link to Python book information.
2003-06-20 14:00:49 +00:00
Skip Montanaro
f5ed9819b0
Avoid using 'dir' as a variable name and use os.path.join() to create
...
paths.
2003-06-19 18:10:37 +00:00
Raymond Hettinger
befa37dd05
Minor updates:
...
* Updated comment on design of imap()
* Added untraversed object in izip() structure
* Replaced the pairwise() example with a more general window() example
2003-06-18 19:25:37 +00:00
Fred Drake
3a8fbe7eec
Include "instances of most classes" in a warning about mutable objects
...
as default values of function/method parameters.
2003-06-18 17:14:29 +00:00
Raymond Hettinger
b5155e30ce
Fix typo.
2003-06-18 01:58:31 +00:00
Raymond Hettinger
96a8233b64
SF patch #751038 fixing SF bug#750092: exec doesn't need newline
...
Patch contributed by Steven Taschuk.
2003-06-18 01:32:24 +00:00
Walter Dörwald
93719b56ed
Updated documentation for the new slice arguments for list.index().
2003-06-17 16:19:56 +00:00
Skip Montanaro
364ca40c2a
SF Patch 569574 - enhancements to cgitb for plain text display
2003-06-17 12:58:31 +00:00
Neal Norwitz
938b7a0f63
Fix some markup nits
2003-06-17 02:37:06 +00:00
Tim Peters
9ca3f02dc0
^D means EOF on Unix but not on Windows. Expand the example's prompt to
...
tell Windows Truth too.
Bugfix candidate.
2003-06-15 23:08:45 +00:00
Brett Cannon
9e6fedd2ec
Add explicit text for where an obindex call for generators was since obindex does not cause output of its argument.
2003-06-15 22:57:44 +00:00
Jack Jansen
097da0dc01
Documented the fact that the main class now mimicks the OSA "application" class.
2003-06-13 14:59:26 +00:00
Raymond Hettinger
7e902b27e0
* Added missing documentation for object().
...
* Noted the Py2.3 in the optional arg for bool().
2003-06-11 09:15:26 +00:00
Raymond Hettinger
3985df2c99
SF bug #660022 : parameters for int(), str(), etc.
...
* Indicate that arguments are optional for most builtin type constructors.
* Replace e.g. in staticmethod() and classmethod() docs.
* Add \code{} markup to some in-line code examples.
2003-06-11 08:16:06 +00:00
Raymond Hettinger
132fa373d1
Add docs for get_grouped_opcodes().
2003-06-11 07:50:44 +00:00
Raymond Hettinger
80b3f685b4
SF bug: 751941 Invisible HTML tag
...
Added missing jump target labels.
2003-06-10 21:41:22 +00:00
Barry Warsaw
9caa0d1642
guess_all_extensions(): Return the empty list instead of None when
...
there are no matching types. Updated the docs and docstrings. Added
some unit tests.
2003-06-09 22:27:41 +00:00
Raymond Hettinger
e07b83591f
Document context_diff() and unified_diff()
2003-06-09 21:44:59 +00:00
Neal Norwitz
305908cffd
SF #735051 , add time.tzset documentation
2003-06-08 13:57:19 +00:00
Gustavo Niemeyer
9556fba685
- urllib2.py now knows how to order proxy classes, so the user doesn't
...
have to insert it in front of other classes, nor do dirty tricks like
inserting a "dummy" HTTPHandler after a ProxyHandler when building an
opener with proxy support.
2003-06-07 17:53:08 +00:00
Raymond Hettinger
b268f03459
SF bug #749759 : comparisons yield bool not int
...
Minor documentation fix.
2003-06-06 02:52:14 +00:00
Skip Montanaro
a1045567e0
QUOTE_ALWAYS -> QUOTE_ALL
2003-06-04 15:30:13 +00:00
Martin v. Löwis
19a5a710fc
Patch #744238 : Explain that different string types also may compare equal.
2003-05-31 08:05:49 +00:00
Martin v. Löwis
7472336444
Patch #744877 : Explain filter in terms of list comprehension. Remove
...
explanation of int in terms of string.atoi. Explain sum in terms of
reduce.
2003-05-31 08:02:38 +00:00
Fred Drake
d691c42a38
Include both </tr> tags in the thead, not just the first.
2003-05-29 19:46:29 +00:00
Neal Norwitz
847207acff
SF bug #719367 , string exceptions are deprecated
...
Remove references to string based exceptions in the doc.
2003-05-29 02:17:23 +00:00
Neal Norwitz
d3d5768e5e
isdatadescriptor() was added recently.
2003-05-29 02:10:31 +00:00
Greg Ward
2748a4aa7e
Typo fix.
2003-05-29 01:41:51 +00:00
Greg Ward
fb1b5a164d
Rewrite the description of setparameters() so it actually reflects the
...
code (which has also been recently overhauled, so that it can be
documented without embarassment).
'error' has been renamed to 'OSSAudioError'.
Minor wordsmithing.
2003-05-29 01:39:32 +00:00
Gregory P. Smith
dad58601a0
Remove the note about the BerkeleyDB license. Barry indicates that
...
sleepycat has told him that since python is OSS and berkeleydb is
being distributed with python for the bsddb library all is fine.
2003-05-28 16:20:03 +00:00
Jeremy Hylton
a95d3b78c8
Oops. License is still an appendix.
2003-05-28 12:12:55 +00:00
Jeremy Hylton
a8e71c13e9
Update dependencies.
2003-05-28 12:10:14 +00:00
Jeremy Hylton
2fb6124afd
Appendix was removed.
2003-05-28 12:04:38 +00:00
Jeremy Hylton
c428112d29
Rename lib__future__.tex to libfuture.tex and add link in lib.tex.
2003-05-28 11:57:52 +00:00
Jeremy Hylton
cf9c46719c
*** empty log message ***
2003-05-28 11:51:11 +00:00
Gregory P. Smith
5772513f0f
Include a link to the pybsddb web documentation for the modern object
...
oriented DbEnv & Db object BerkeleyDB interface.
Include a note about Sleepycat's BerkeleyDB license with regards to
distributing it within non-opensource applications and include a link
to their website for license details.
Document that 'r' is the default flag for the legacy bsddb btopen(),
hashopen(), and rnopen() functions. This is apparently different than the
dbm libraries in other languages according to Bug #732951 . Changing
the default from 'r' to 'c' would break backwards compatibility with
legacy bsddb applications; documenting the default should suffice.
2003-05-28 07:56:45 +00:00
Greg Ward
451a766953
More wordsmithing and cleanup.
2003-05-26 01:51:33 +00:00
Raymond Hettinger
8fb665a51a
Fix ref counts in initialization code.
2003-05-25 17:59:38 +00:00
Greg Ward
c316d0d391
Lots of wordsmithing and typographical improvement.
2003-05-23 02:44:46 +00:00
Fred Drake
5af41c55e6
Correct dependency information -- the Python docs load the "About this
...
document" text from html/stdabout.dat, not html/about.dat.
2003-05-22 15:28:55 +00:00
Fred Drake
4864bfb88f
Minor elaboration in the information about reporting errors.
2003-05-22 15:09:27 +00:00
Fred Drake
6ce0b60063
update version history
2003-05-22 14:58:02 +00:00
Jeremy Hylton
e41195fab6
Add documentation for __future__
2003-05-21 21:45:01 +00:00
Jeremy Hylton
8bea5dc879
Move future statement here from appendix a.
2003-05-21 21:43:00 +00:00
Andrew M. Kuchling
28137a09d6
Don't mention __slots__ as a technique for error avoidance
2003-05-20 18:12:21 +00:00
Fred Drake
15eac1f95c
Fix markup nits.
2003-05-20 16:21:51 +00:00
Tim Peters
dbaf04ead6
Straighten out the docs for os.system(); the Unix and Windows behaviors
...
really can't be smushed together.
Bugfix candidate.
2003-05-20 16:15:58 +00:00
Fred Drake
6bab183d4e
Markup nits.
2003-05-20 15:28:58 +00:00
Fred Drake
e5a55519a8
Remove unused line numbers from example code.
...
Line numbering of examples is not used elsewhere.
2003-05-20 15:21:08 +00:00
Raymond Hettinger
f9c2eda3c1
Fix missing parethesis.
2003-05-20 05:31:16 +00:00
Brett Cannon
235d1efe12
Add docs for key_file and cert_file arguments for HTTPSConnection. Copied from socket.ssl docs.
2003-05-20 02:56:35 +00:00
Skip Montanaro
7789237331
* Correct Sniffer doc to correspond to the implementation.
...
* Add optional delimiters arg to Sniffer.sniff() which restricts the set of
candidate field delimiters.
2003-05-19 15:33:36 +00:00
Walter Dörwald
9e46abed50
Fix array.array.insert(), so that it treats negative indices as
...
being relative to the end of the array, just like list.insert() does.
This closes SF bug #739313 .
2003-05-18 03:15:10 +00:00
Raymond Hettinger
047c54bb24
Missing parenthesis.
2003-05-16 14:36:26 +00:00
Jim Fulton
1f325562f0
Added some missing PyObject* casts in the deallocators.
...
Added some defines for PyMODINIT_FUNC so that the examples work
with Python 2.2.
I think I'm done hacking this documentation. Yippie! :)
2003-05-16 13:53:43 +00:00
Jim Fulton
a24d73ddb1
Added a missing PyObject* cast to the dealloc examples.
...
Added a note that the mechanism for defining new tyoes documented here
only works for Python 2.2 and higher.
2003-05-16 13:51:58 +00:00
Jim Fulton
aea763bde7
Removed reference to the out-of-date (and not very useful)
...
Objects/xxobject.c example.
Updated the discussion of type checking to refer to
PyObject_TypeCheck.
2003-05-16 13:32:59 +00:00
Guido van Rossum
8f512a22cd
Add docs for MessageBeep.
2003-05-16 01:42:22 +00:00
Andrew M. Kuchling
7696344182
[Bug #471893 ] Replace security material with a warning against unpickling
...
untrusted data.
2003-05-14 16:51:46 +00:00
Fred Drake
126d366ea6
document Stats.dump_stats(), new for Python 2.3
2003-05-14 14:29:27 +00:00
Fred Drake
c868d16e11
When an external application we use exits normally, exit with the same
...
exit code they returned. All other types of exit from child processes
are normalized to a return code of 1.
Closes SF bug #732143 .
2003-05-14 04:16:14 +00:00
Guido van Rossum
bf1bef820c
Add optional 'onerror' argument to os.walk(), to control error
...
handling.
2003-05-13 18:01:19 +00:00
Andrew M. Kuchling
e9a54a3eaf
[Bug #713722 ] Delete dangling references to unwritten sections
2003-05-13 15:02:06 +00:00
Andrew M. Kuchling
c85bf58276
[Bug #732124 ] Clarify .pos, .endpos by saying 'method' instead of 'function'
...
Also, put match() description before search(); search() refers to match()
2003-05-13 14:40:24 +00:00
Andrew M. Kuchling
8d17709c5c
Remove more markup from headers
2003-05-13 14:26:54 +00:00
Andrew M. Kuchling
433307b75d
[Bug #729297 ] Remove markup in section headers
2003-05-13 14:23:54 +00:00
Andrew M. Kuchling
eabd9a1314
[Bug #729817 ] Document the rexec and Bastion modules as dead
2003-05-13 14:16:18 +00:00
Andrew M. Kuchling
032bd0a9a8
Fix typo
2003-05-13 14:13:58 +00:00
Brett Cannon
1213bdd16d
Fix and add reference to urllib.urlencode for parse_qsl? functions.
2003-05-13 02:50:36 +00:00
Jim Fulton
d2eadc6946
Updated simple example. This should have been checked in the other
...
day, but I missfired in CVS.
2003-05-12 17:42:56 +00:00
Fred Drake
7af9f4dac3
Add a specific mention of the term "operator overloading" and add an
...
index entry. Suggested to python-docs.
2003-05-12 13:50:11 +00:00
Raymond Hettinger
bf3a75283c
Fix minor typos.
2003-05-12 03:23:51 +00:00
Fred Drake
8f53cdcfce
- object is a class type, not a function
...
- when marking a function, the trailing () should be included
consistently
2003-05-10 19:46:39 +00:00
Raymond Hettinger
b4c1d9be8f
Fix unbalanced parethesis.
2003-05-10 08:51:28 +00:00
Raymond Hettinger
0dfd7a9361
Missing parenthesis found by texcheck.py
2003-05-10 07:40:56 +00:00
Martin v. Löwis
5467d4c0e3
Patch #612627 : Add encoding attribute to file objects, and determine
...
the terminal encoding on Windows and Unix.
2003-05-10 07:10:12 +00:00
Raymond Hettinger
eca984fcce
Fix missing parenthesis.
2003-05-10 04:21:08 +00:00
Raymond Hettinger
52136a8bea
Fixed spacing and unbalanced brackets or parenthesis.
2003-05-10 03:35:37 +00:00
Fred Drake
9f545c489a
Make this format again.
2003-05-09 19:10:12 +00:00
Skip Montanaro
a30dffbb53
add a note about accessing user-defined functions with an import statement
...
in the setup parameter
2003-05-09 18:21:02 +00:00
Fred Drake
3ec4dfd812
Make this format again.
2003-05-09 18:18:46 +00:00
Fred Drake
8b6ed26dc7
- remove bogus \end{description}
...
- fix two typos
2003-05-09 15:04:56 +00:00
Jack Jansen
1662162c04
Documented the new autoGIL module.
2003-05-09 14:45:04 +00:00
Jim Fulton
3ff5bb20b7
Fixed small typo Pointed out by Michael Hudson.
2003-05-08 10:35:07 +00:00
Jim Fulton
83cedcf660
Fixed a typo in an example dealloc routine that calls it's "self"
...
argument "obj" rather than "self".
2003-05-08 10:32:10 +00:00
Greg Ward
86e1790cad
Clarify the dedent() example a bit by indenting the input lines unevenly.
2003-05-08 02:12:35 +00:00
Greg Ward
8f6329c547
SF patch #598163 (Ville Vainio, vvainio@users.sourceforge.net):
...
document dedent() function.
2003-05-08 02:09:49 +00:00
Brett Cannon
066f3928b2
Library documentation for the 'test' package. Still needs to be checked by Fred.
2003-05-07 22:02:17 +00:00
Jim Fulton
aed0a4a138
Rewrote the basic section of the chapter on defining new types.
...
Changed the example to show how to create types the new way:
- Use a class new method rather than a new function.
- Use self->ob_type->tp_free in deallocators
- Use attribute descriptors rather than set/getattr methods.
- Make the type usable as a base type.
I split the example into 3 parts:
1. The minimal new type
2. Adding attributes and methods.
3. Finer control over attributes.
It's much simpler to define builtin types. These updates hopefully
show this.
I also made minor wording changes in two other places.
I still need to update xxobject.c
2003-05-07 19:48:13 +00:00
Raymond Hettinger
a02469f969
More message updates and minor fixes.
2003-05-07 17:49:36 +00:00
Raymond Hettinger
a2f84ceda5
Update traceback message
2003-05-07 17:11:15 +00:00
Andrew M. Kuchling
fcf6b3ecde
Add list.insert() change for negative positions
...
Add ~ to MvL's last name
Fix use of all-caps for a name
Bump version number
2003-05-07 17:00:35 +00:00
Skip Montanaro
45a9c93236
add missing parens - verified w/ interpreter - sorry to dismiss your comment
...
Fred
2003-05-07 16:01:43 +00:00
Skip Montanaro
b4f12424a5
replace most uses of `...` by repr(...), noting that `...` is discouraged,
...
but convenient in interactive sessions.
2003-05-07 15:29:12 +00:00
Skip Montanaro
6d9f45bc3f
add a note about the undocumented bsddb185 module
2003-05-06 20:40:17 +00:00
Jeremy Hylton
6cb52ddc3c
Refer reader to platform library docs for specific semantics.
...
Resolves SF bugs 697989, 697988, 697986.
2003-05-05 16:46:26 +00:00
Greg Ward
d72312857e
Scattered wording and typographical improvements (up to but not
...
including the "Callback Options" section).
2003-05-03 21:22:58 +00:00
Greg Ward
649625bc05
Rename "The Tao of Option Parsing" section to "Philosophy".
...
Remove first-person usage from it. Various wording tweaks.
2003-05-03 20:41:37 +00:00
Greg Ward
1f53517a8c
Use True/False instead of 1/0 when talking about store_true/store_false.
...
Particularly important since they now store True and False rather than 1
and 0!
2003-05-03 20:13:08 +00:00
Greg Ward
c50b088cfd
Add a big comment about cross-platform issues (especially OpenBSD).
...
This should be turned into a footnote by someone who actually
understands OSS and its relationship to Linux, FreeBSD, OpenBSD, NetBSD,
etc.
2003-05-03 19:45:47 +00:00
Greg Ward
bf8f1b55a8
Use TeX quotes -- ``foo'' -- as appropriate.
...
Remove whitespace around em-dashes.
2003-05-03 19:41:45 +00:00
Greg Ward
b4e3319302
Fix various markup errors: use \longprogramopt{} more, and use it
...
correctly. (Closes SF #731689.) Use \emph{} in a few places.
2003-05-03 19:16:36 +00:00
Martin v. Löwis
ec31047c0c
Use \versionchanged, not \versionadded.
2003-05-03 10:59:13 +00:00
Martin v. Löwis
7829e5661c
Patch #731514 : Update recursion documentation to mention simple recursion.
2003-05-03 10:57:53 +00:00
Martin v. Löwis
e59e2bab8f
Patch #711902 : Cause pydoc to show data descriptor __doc__ strings.
2003-05-03 09:09:02 +00:00
Fred Drake
8b34e7cc40
- add title attributes to the navigation icons on the navigation bars;
...
this causes some browsers to offer descriptive tooltips when the
mouse hovers over the linked icon
- clean up the code in this area
2003-05-03 02:07:22 +00:00
Fred Drake
05404c3d7c
add link types for the remaining links in the navigation panels
2003-05-02 20:30:18 +00:00
Fred Drake
bf8ec3e035
- add link relationships to some of the links in the navigation panels
...
- implement custom_REL_hook() so LaTeX2HTML uses currently recommended
link types; those work fine with tools like the Mozilla Site
Navigation Bar
2003-05-02 20:18:01 +00:00
Raymond Hettinger
341deb74e7
The previous made the stop argument optional.
...
It is better to be explicit and just allow stop to be None.
2003-05-02 19:44:20 +00:00
Raymond Hettinger
14ef54cd83
SF bug #730685 : itertools.islice stop argument is not optional
...
* itertools.islice() stop argument did not perform as documented.
* beefed-up test suite
2003-05-02 19:04:37 +00:00
Fred Drake
98b2576424
Avoid extraneous blank line generated in the middle of the document
...
head.
2003-05-02 18:21:22 +00:00
Fred Drake
f06b90534b
Remove section number from the title for use in the
...
<meta name='description' ...> element in the document head.
2003-05-02 18:08:16 +00:00
Fred Drake
90fc0b356f
At the site of an indexed reference to print, point to the relevant
...
documentation. Closes SF bug #723136 .
2003-04-30 16:44:36 +00:00
Fred Drake
b876bcc561
work around mostly-minor formatting problems; the encodings.idna
...
example still doesn't come out quite right: a bug in the formatting
tools
2003-04-30 15:03:46 +00:00
Fred Drake
d4be747e1e
- comment out \moduleauthor that broke formatting until the formatting
...
tools can be fixed; added XXX comment
- general markup fixes
2003-04-30 15:02:07 +00:00
Fred Drake
c95628e3f2
- clean up some extra punctuation hidden in indexing markup
...
- fix a typo and one markup nit
- normalize whitespace
2003-04-29 13:56:40 +00:00
Fred Drake
83c19ee06b
Clarify that the timeout argument to read_until() is in seconds.
2003-04-29 13:39:05 +00:00
Raymond Hettinger
6e887bb05f
SF bug #729096 : getopt online documentation example improvement
...
A newbie found it difficult to translate the exampe into a
case that used only short options or long options but not both.
He tried to shorten the tuple search but forgot the trailing comma,
The appropriate pattern is an equality check.
Revised the example to point him in the right direction.
Backport candidate.
2003-04-29 04:35:36 +00:00
Brett Cannon
a2f8737faf
Add comment that urlopen opens local files without universal newlines
2003-04-29 04:11:12 +00:00
Tim Peters
a1af767c4d
Reworded fabs() for consistency with the others. Noted that all
...
return values are floats.
2003-04-28 21:32:03 +00:00
Tim Peters
a390c6e194
walk() docs: Emphasize that the recursive-delete example is dangerous.
2003-04-28 19:15:10 +00:00
Tim Peters
5501b5e3d7
SF bug 728097: tmpnam problems on windows 2.3b, breaks test.test_os.
...
tmpnam() appears essentially useless on Windows, and it finally broke
the test for Irmen de Jong. Read the long new comment in test_tmpnam()
for details. Since the MS implementation is insane, it might be good
if we supplied a different implementation.
Bugfix candidate.
2003-04-28 03:13:03 +00:00
Tim Peters
bf89b3a1f7
walk() docs: Worked "walking" into the description and the text. Added
...
a brief example where bottom-up walking is essential.
2003-04-28 02:09:43 +00:00
Tim Peters
965697fc4b
Clarified new text about math exceptions.
...
Bugfix candidate.
2003-04-26 15:11:08 +00:00
Skip Montanaro
5118341530
Add note about platform-specific behavior arising from discussion on bug
...
711019.
2003-04-26 02:59:00 +00:00
Fred Drake
2f36b3e205
Version updates for Python 2.3.
2003-04-26 00:52:30 +00:00
Fred Drake
9635268ea9
organizational and markup cleansing
2003-04-25 18:02:34 +00:00
Fred Drake
c440af5495
Updated information on package metadata to reflect recent additions.
...
This is a modified form of SF patch #718027 (mostly markup changes).
2003-04-25 16:43:28 +00:00
Fred Drake
d198f38505
- add availability statements for some of the new APIs
...
- lots of general cleanup
2003-04-25 16:16:02 +00:00
Fred Drake
53e5b71bbc
Add modified versions of the examples from Sean Reifschneider
...
(SF patch #545480 ).
2003-04-25 15:27:33 +00:00
Guido van Rossum
b016752d8b
Fix a copy-paste error: the paragraph about inet_ntop's use was copied
...
literally from inet_pton.
2003-04-25 15:26:58 +00:00
Skip Montanaro
5d0136e297
reflect csv's change back to a module. Document the new sniffer api.
2003-04-25 15:14:49 +00:00
Fred Drake
9f48045ec0
Use a simpler \note instead of a "See also" section to refer to the
...
os.walk() generator.
2003-04-25 15:12:47 +00:00
Neal Norwitz
6eb502f267
Add versionadded for has_ipv6 attribute
2003-04-25 14:53:48 +00:00
Neal Norwitz
cabf56f8b4
Fix markup
2003-04-25 14:52:41 +00:00
Fred Drake
2194a4eede
markup adjustments
2003-04-25 14:50:06 +00:00
Tim Peters
c4e0940042
New generator os.walk() does a bit more than os.path.walk() does, and
...
seems much easier to use. Code, docs, NEWS, and additions to test_os.py
(testing this sucker is a bitch!).
2003-04-25 07:11:48 +00:00
Guido van Rossum
47dfa4a89a
Patch by Jp Calderone:
...
- The socket module now provides the functions inet_pton and inet_ntop
for converting between string and packed representation of IP addresses.
See SF patch #658327 .
This still needs a bit of work in the doc area, because it is not
available on all platforms (especially not on Windows).
2003-04-25 05:48:32 +00:00
Andrew M. Kuchling
f8d0c075b2
[Patch #628208 ] Document the allow_none argument
2003-04-25 00:29:31 +00:00
Skip Montanaro
3bd3c8403a
* minor tweaks relating to the package nature of the beast
...
* added an (incomplete) description of the utils.Sniffer class
2003-04-24 18:47:31 +00:00
Barry Warsaw
50889239c3
Updated a bunch of docs to describe how message ids and strings are
...
Unicode in GNUTranslations. Also provide better descriptions of
*gettext() overridden methods, esp. w.r.t. the behavior in the face of
fallbacks.
2003-04-24 18:14:49 +00:00
Andrew M. Kuchling
035272be91
Add some more items
2003-04-24 16:38:20 +00:00
Fred Drake
c11076e0da
Bump the release information.
2003-04-24 16:37:21 +00:00
Fred Drake
d859d470a1
Add cross-references between urllib.urlencode() and cgi.parse_qs[l]().
...
Closes SF bug #724751 .
2003-04-24 16:22:47 +00:00
Raymond Hettinger
024aaa1bfe
SF Patch 549151: urllib2 POSTs on redirect
...
(contributed by John J Lee)
2003-04-24 15:32:12 +00:00
Fred Drake
1d5854fdc4
Note the platform module.
2003-04-24 15:24:46 +00:00
Andrew M. Kuchling
13b4c41748
Mention deprecation of rotor module
2003-04-24 13:23:43 +00:00
Andrew M. Kuchling
bbb9a55327
[Patch #679505 ] Document that this module is deprecated
2003-04-24 13:19:09 +00:00
Brett Cannon
317ad7a5ee
Fixed docs for urlretrieve() to match code in the case of opening a local file.
...
Also some typos and removed trailing whitespace on the lines.
2003-04-24 02:31:14 +00:00
Fred Drake
c22b2999f6
fix some markup errors
2003-04-23 20:38:41 +00:00
Skip Montanaro
54a234a566
clarify - restrict version mention to the trunk version
2003-04-23 20:35:14 +00:00
Skip Montanaro
1bd1d858ae
added note about character set limitations in passwords.
2003-04-23 20:22:12 +00:00
Thomas Heller
34d7f0927b
Document the new functions PyInt_AsUnsignedLongMask(), PyInt_AsUnsignedLongLongMask(),
...
PyLong_AsUnsignedLongMask(), PyLong_AsUnsignedLongLongMask().
2003-04-23 19:51:05 +00:00
Tim Peters
2d1c846b73
Clarified new fsync() docs.
2003-04-23 19:47:14 +00:00
Thomas Heller
42a1172cf4
Document the new format codes B, H, I, k, K.
2003-04-23 19:27:35 +00:00
Fred Drake
444e434011
Update the package list whenever we build distfiles.
...
This is used on www.python.org.
2003-04-23 15:04:52 +00:00
Tim Peters
11b2306960
Enable os.fsync() for Windows, mapping it to MS's _commit() there. The
...
docs here are best-guess: the MS docs I could find weren't clear, and
some even claimed _commit() has no effect on Win32 systems (which is
easily shown to be false just by trying it).
2003-04-23 02:39:17 +00:00
Raymond Hettinger
863983e8e5
Add comment on performance.
...
Fix missing right parenthesis.
Add three examples.
2003-04-23 00:09:42 +00:00
Fred Drake
70995830a6
markup corrections
2003-04-22 18:54:53 +00:00
Fred Drake
282be3ab89
- explain the start argument to sum()
...
- various adjustments to sum() markup and explanation
2003-04-22 14:52:08 +00:00
Fred Drake
03e929e7e0
Fix some markup nits.
2003-04-22 14:30:53 +00:00
Alex Martelli
a70b19147f
Adding new built-in function sum, with docs and tests.
2003-04-22 08:12:33 +00:00
Gustavo Niemeyer
48f3dcc93e
- Changed shlex.split() method to have more useful and
...
meaningful parameters.
2003-04-20 01:57:03 +00:00
Gustavo Niemeyer
cf146d31e7
- Included examples documenting how the lastindex member of
...
match objects work.
2003-04-20 01:48:59 +00:00
Martin v. Löwis
153c9e493e
Patch #553171 : Add writeback parameter. Also add protocol parameter.
2003-04-19 20:59:03 +00:00
Guido van Rossum
a26854095b
- Several methods of nntplib.NNTP have grown an optional file argument
...
which specifies a file where to divert the command's output
(already supported by the body() method). (SF patch #720468 )
Thanks to Terry Carroll.
2003-04-19 18:04:57 +00:00
Andrew M. Kuchling
e36b690087
Mention the bz2 module
...
Various rewrites
2003-04-19 15:38:47 +00:00
Barry Warsaw
b05df5796a
Added some more documentation to as_string() to make it clear that
...
it's a convenience only. Give an example of what to do for more
flexibility.
2003-04-18 23:03:53 +00:00
Martin v. Löwis
338bcbccfa
Change email address.
2003-04-18 22:04:34 +00:00
Martin v. Löwis
faf71ea5b3
Fix spelling of cedillas.
2003-04-18 21:48:56 +00:00
Martin v. Löwis
07d4fb6f17
Correct methoddesc environments.
2003-04-18 21:48:13 +00:00
Martin v. Löwis
382f078437
Add lib/libstringprep.tex lib/libdocxmlrpc.tex.
2003-04-18 21:45:26 +00:00
Martin v. Löwis
281b2c6211
Patch #536883 : SimpleXMLRPCServer auto-docing subclass.
2003-04-18 21:04:39 +00:00
Fred Drake
cf6d74aedd
- accepted (slightly) modified version of docs for the OptionGroup
...
class; closes SF patch #697941
- use em-dashes intead of en-dashes
- section references: use a "tie" between the word "section" and the
section number, use quotation marks around section titles
- other minor markup corrections/cleanups
2003-04-18 15:50:13 +00:00
Martin v. Löwis
2548c730c1
Implement IDNA (Internationalized Domain Names in Applications).
2003-04-18 10:39:54 +00:00
Neal Norwitz
10cf21802d
Use True in a few more places.
...
Use isinstance(somestring, basestring) instead of type() as per PEP 8
2003-04-17 23:09:08 +00:00
Neal Norwitz
a6bdf2aef6
Oops, missed updating doc to correct version for split
2003-04-17 23:07:13 +00:00
Fred Drake
30b6e8230b
Added documentation for the handle_pi() method, based on SF patch #662464 .
...
Closes SF bug #659188 , patch #662464 .
2003-04-17 22:36:52 +00:00
Fred Drake
aa3b5d2ec5
markup banalities
2003-04-17 21:49:04 +00:00
Gustavo Niemeyer
68d8cef89a
Implemented posix-mode parsing support in shlex.py, as dicussed in
...
mailing list, and in patch #722686 .
2003-04-17 21:31:33 +00:00
Raymond Hettinger
2ed6dff796
As discussed on python-dev, revised docs to note that
...
PyObject_IsTrue() can have an error result.
Also, added missing docs for PyObject_Not().
Will backport.
2003-04-16 17:28:12 +00:00
Neal Norwitz
1475c49211
Add version info for name2codepoint and codepoint2name
2003-04-16 13:21:06 +00:00
Walter Dörwald
5688b7ac3e
Add two dictionaries to htmlentitydefs: name2codepoint maps
...
HTML entity names to Unicode codepoints (as integers).
codepoint2name is the reverse mapping. From SF patch #722017 .
2003-04-16 09:46:13 +00:00
Guido van Rossum
0fc8f00252
- pythunrun.c, Py_Finalize(): move the call to _Py_PrintReferences()
...
even farther down, to just before the call to
_PyObject_DebugMallocStats(). This required the following changes:
- pystate.c, PyThreadState_GetDict(): changed not to raise an
exception or issue a fatal error when no current thread state is
available, but simply return NULL without raising an exception
(ever).
- object.c, Py_ReprEnter(): when PyThreadState_GetDict() returns NULL,
don't raise an exception but return 0. This means that when
printing a container that's recursive, printing will go on and on
and on. But that shouldn't happen in the case we care about (see
first bullet).
- Updated Misc/NEWS and Doc/api/init.tex to reflect changes to
PyThreadState_GetDict() definition.
2003-04-15 15:12:39 +00:00
Guido van Rossum
3a3cca5b82
- list.insert(i, x) now interprets negative i as it would be
...
interpreted by slicing, so negative values count from the end of the
list. This was the only place where such an interpretation was not
placed on a list index.
2003-04-14 20:58:14 +00:00
Andrew M. Kuchling
b43f15e1ce
Add a name
2003-04-14 18:47:28 +00:00
Andrew M. Kuchling
44c62ef5ee
Typo fix
2003-04-14 15:32:18 +00:00
Andrew M. Kuchling
d39078ba2d
Mention timeit module
...
Fix error in description of logging package's 'propagate'
Mention default arg to dict.pop()
Link to more module docs
(I wonder if I should adopt some convention such as linking the first
mention of all new modules to the LibRef?)
Various text changes
Bump version number and Python version
2003-04-13 21:44:28 +00:00
Andrew M. Kuchling
ba887bb04e
Use simpler import
2003-04-13 21:13:02 +00:00
Barry Warsaw
125b9b0736
Back out of setting the default charset to iso-8859-1.
2003-04-11 21:28:10 +00:00
Neal Norwitz
06c7b62a83
Fix markup
2003-04-11 18:48:03 +00:00
Barry Warsaw
a1ce93f87c
From http://mail.python.org/pipermail/i18n-sig/2003-April/001557.html
...
- Expose NullTranslations and GNUTranslations to __all__
- Set the default charset to iso-8859-1. It used to be None, which
would cause problems with .ugettext() if the file had no charset
parameter. Arguably, the po/mo file would be broken, but I still think
iso-8859-1 is a reasonable default.
- Add a "coerce" default argument to GNUTranslations's constructor. The
reason for this is that in Zope, we want all msgids and msgstrs to be
Unicode. For the latter, we could use .ugettext() but there isn't
currently a mechanism for Unicode-ifying msgids.
The plan then is that the charset parameter specifies the encoding for
both the msgids and msgstrs, and both are decoded to Unicode when read.
For example, we might encode po files with utf-8. I think the GNU
gettext tools don't care.
Since this could potentially break code [*] that wants to use the
encoded interface .gettext(), the constructor flag is added, defaulting
to False. Most code I suspect will want to set this to True and use
.ugettext().
- A few other minor changes from the Zope project, including asserting
that a zero-length msgid must have a Project-ID-Version header for it to
be counted as the metadata record.
2003-04-11 18:36:43 +00:00
Jack Jansen
bae5c965e8
Moved all the scripting stuff to a separate section, added all the
...
missing bits (well, all the bits I could think of) and updated the
rest.
2003-04-11 15:35:28 +00:00
Neal Norwitz
ffe33b7f24
Attempt to make all the various string *strip methods the same.
...
* Doc - add doc for when functions were added
* UserString
* string object methods
* string module functions
'chars' is used for the last parameter everywhere.
These changes will be backported, since part of the changes
have already been made, but they were inconsistent.
2003-04-10 22:35:32 +00:00
Neal Norwitz
4efd91713b
Add a space after expression to be consistent
2003-04-10 21:51:29 +00:00
Fred Drake
12dd7b12c6
Minor markup adjustments.
2003-04-09 18:15:57 +00:00
Guido van Rossum
6db771871e
Try to discourage use of PyObject_Type().
2003-04-09 18:02:23 +00:00
Andrew M. Kuchling
a6b1c75b7a
Re-indent example; fix typo
2003-04-09 17:26:38 +00:00
Jack Jansen
d5e0a5a08e
Created a minimal MacOSX section.
2003-04-09 15:12:38 +00:00
Fred Drake
fcd845a7ed
Lots of small markup adjustments.
2003-04-09 04:06:37 +00:00
Fred Drake
61a0a73d76
Add dependency information for the hotshot package docs.
2003-04-09 03:25:07 +00:00
Anthony Baxter
fda5e27ec9
extra punctuation removed
2003-04-09 03:03:46 +00:00
Fred Drake
567b0a6445
Add dependency information for the timeit module docs.
2003-04-09 02:41:36 +00:00
Skip Montanaro
d6e9fe386a
+ libtimeit
2003-04-09 01:39:06 +00:00
Skip Montanaro
ca652746ff
doc for timeit module/script - mostly just a recast of Tim's docstring
2003-04-09 01:38:53 +00:00
Fred Drake
2c2068c4d1
Added example of using positional and keyword args with atexit.register().
...
Based on a suggestion from a reader.
2003-04-08 17:46:53 +00:00
Fred Drake
de7ad2caac
Markup fix.
2003-04-08 17:37:47 +00:00
Tim Peters
730f5535ba
s/referrents/referents/g. Gotta love that referrers remains rife with rs.
2003-04-08 17:17:17 +00:00
Tim Peters
0f81ab6d88
Finished implementing gc.get_referrents(): dealt with error and end
...
cases, wrote docs, added a test.
2003-04-08 16:39:48 +00:00
Anthony Baxter
cb8ed53014
add note suggested by rhettinger about example.
2003-04-07 12:21:56 +00:00
Anthony Baxter
b3303efec6
patch [ 698505 ] docs for hotshot module
2003-04-07 12:19:15 +00:00
Fred Drake
2a04623ddd
- add the "download_url" field to the pre-2.2.3 metadata compatibility note
...
- fix some markup nits
2003-03-31 16:23:09 +00:00
Fred Drake
007fadd59d
Fix symbol in grammar; this should fix some hyperlinking in the HTML
...
version.
2003-03-31 14:53:03 +00:00
Martin v. Löwis
24b8881f61
Patch #701395 : Correct documentation of PyUnicode_Splitlines.
2003-03-30 16:40:42 +00:00
Martin v. Löwis
b9a0f91218
Rename LONG_LONG to PY_LONG_LONG. Fixes #710285 .
2003-03-29 10:06:18 +00:00
Ka-Ping Yee
bd379e9627
PyWeakref_GetObject returns None (not NULL) when the referent is gone.
2003-03-28 18:07:16 +00:00
Martin v. Löwis
3ae0f7a7cf
Replace criterium with criterion. Fixes #705120 .
2003-03-27 16:59:38 +00:00
Neal Norwitz
24fcd23eae
Back out previous change as discussed on python-checkins
2003-03-22 16:19:52 +00:00
Neal Norwitz
1e942bd3f4
Add lib/mimelib.tex to dependencies
2003-03-22 00:23:04 +00:00
Barry Warsaw
bfa893f3ac
email is at version 2.5 now
2003-03-21 21:14:48 +00:00
Andrew M. Kuchling
a092ba1adc
Add PEP 307 section
2003-03-21 18:32:43 +00:00
Andrew M. Kuchling
a978e10676
Add PEP305 section
2003-03-21 18:10:12 +00:00
Andrew M. Kuchling
c71bb97e2f
Update datetime section a bit
2003-03-21 17:23:07 +00:00
Neal Norwitz
0135b65c01
Add new CSV module to doc dependancies
2003-03-21 00:28:30 +00:00
Skip Montanaro
5fbf8362a3
include csv doc section - Fred, you may want to change the location
2003-03-20 23:35:00 +00:00
Skip Montanaro
b4a0417e91
new CSV file processing module - see PEP 305
2003-03-20 23:29:12 +00:00
Fred Drake
4cee220ff3
- added example of using a comparison function with list.sort(), and
...
explained the construction of a [(key, value), ...] list as an
alternative
- note that support for cmpfunc=None was added in 2.3
2003-03-20 22:17:59 +00:00
Fred Drake
62364ffb80
- apply SF patch #700798 : fixes and cleanups for descriptor info
...
- use a TeX "tie" to prevent word-wrapping in "section x.y"-like text
2003-03-20 18:17:16 +00:00
Skip Montanaro
2a403e8a7e
add descriptions of {get,set}defaulttimeout.
2003-03-20 17:58:12 +00:00
Fred Drake
5c7b2487cd
- explain what a UNC path is in the makedirs() description, since
...
they're actually mentioned there
- remove some extraneous paragraph separations
- \versionadded --> \versionchanged in one place
2003-03-20 17:39:38 +00:00
Michael W. Hudson
43ed43bfc1
Take out my (long since disabled) POSIX signal mask handling code.
...
I'm not going to have the time or energy to get this working x-platform
-- anyone who does is welcome to the code!
2003-03-13 13:56:53 +00:00
Raymond Hettinger
60de2e837f
SF bug #699237 : Tutorial uses omitted slice indices before explaining them
...
Moved up the explanation of slice default arguments.
2003-03-12 04:46:52 +00:00
Barry Warsaw
45c3941510
Update the package version number
2003-03-12 03:43:09 +00:00
Barry Warsaw
a996d4f137
For email 2.5b1, we no longer add a trailing newline to
...
MIMEText.__init__()'s _text argument if it doesn't already end in a
newline. This may be controversial.
2003-03-11 05:03:25 +00:00
Barry Warsaw
52b39f5b47
body_line_iterator() now takes a decode argument.
2003-03-11 04:40:14 +00:00
Barry Warsaw
20ebc37013
Describe what happens when decode=True and the payload has bogus
...
base64 data.
2003-03-10 16:13:50 +00:00
Greg Ward
cd930f5258
openmixer()'s 'mode' parameter has been removed.
2003-03-10 03:18:19 +00:00
Greg Ward
f882c77d70
Expand description of ossaudiodev.error exception.
...
Improve descriptions of open(), openmixer().
2003-03-10 03:05:21 +00:00
Greg Ward
3e34f59ce2
Rewrite intro paragraphs and add a "See also" box for the link to the
...
official OSS docs.
Markup fixes: change \code{} variously to \function{}, \method{}, or
\constant{} as appropriate.
2003-03-10 02:09:51 +00:00
Greg Ward
074472ba98
Fix two unformatted lists: one is now an 'enumerate' environment, the
...
other a 'tableii'.
Formatting/typo fix.
2003-03-10 00:24:42 +00:00
Greg Ward
41a28e374c
Add libossaudiodev.tex.
2003-03-10 00:07:14 +00:00
Greg Ward
33bcd987dd
Wrap all paragraphs to 72 columns.
...
Two spaces between sentences.
Fix em-dashes -- should be "---" not " - ".
Spelling fix.
2003-03-09 23:57:34 +00:00
Greg Ward
620e343c0a
Documentation for the ossaudiodev module.
...
Initial revision supplied by Nicholas FitzRoy-Dale <wzdd@lardcave.net>
(emailed to me [gward@python.net ] 2003-03-08 23:37 +1100).
2003-03-09 23:34:52 +00:00
Raymond Hettinger
5284b4474e
Add contributor name.
2003-03-09 07:19:38 +00:00
Raymond Hettinger
42182ebaf6
SF 698520: Iterator for urllib.URLOpener
...
Contributed by Brett Cannon.
2003-03-09 05:33:33 +00:00
Skip Montanaro
959c7727f4
Add a little more verbiage about the bsddb module/package change. It's
...
clear from recent discussions on c.l.py that people are a bit confused about
the differences between the old bsddb, the new bssdb, the bsddb3/PyBSDDB
package and changes to file formats. Tried to clarify the issues.
2003-03-07 15:45:15 +00:00
Fred Drake
9e1595e6e4
Minor clarification about the ob_size field.
2003-03-07 15:02:03 +00:00
Raymond Hettinger
a3e1e4cd79
SF patch #693753 : fix for bug 639806: default for dict.pop
...
(contributed by Michael Stone.)
2003-03-06 23:54:28 +00:00
Neal Norwitz
1930949a8a
Fix SF bug #697256 , PyMarshal_WriteShortToFile() documented, but not implemented
...
Remove prototype and doc. Backport candidate.
2003-03-06 22:04:24 +00:00
Barry Warsaw
1a2c37316b
Describe Charset.__repr__().
2003-03-06 06:07:34 +00:00
Barry Warsaw
f32e313914
Describe the new Header.encode() argument "splitchars".
2003-03-06 06:06:54 +00:00
Martin v. Löwis
73d538b9c6
Always initialize Py_FileSystemDefaultEncoding on Unix in Py_Initialize,
...
and not as a side effect of setlocale. Expose it as sys.getfilesystemencoding.
Adjust test case.
2003-03-05 15:13:47 +00:00
Michael W. Hudson
9c20615d4f
Back in June in revision 1.98 Steve (accidentally, presumably) wiped
...
out a month's worth of checkins to libstdtypes.tex (including my
extended slice docs).
I think this checkin merges them all back in, but if you make one of
these checkins:
revision 1.97
date: 2002/06/14 00:27:13; author: nnorwitz
Use \code{True} (or False) instead of true/false.
Not sure if code is correct, but that is what's in this file.
I've seen \constant{True} in other places.
----------------------------
revision 1.95
date: 2002/05/22 20:39:43; author: bwarsaw
Jack's documentation for the U mode character on the file()
constructor, vetted by Barry.
----------------------------
revision 1.94
date: 2002/05/21 18:19:15; author: rhettinger
Patch 543387. Document deprecation of complex %, //,and divmod().
----------------------------
revision 1.93
date: 2002/05/15 15:45:25; author: rhettinger
Added missing index entries for mapping methods. Closes patch
#548693 .
some checking may be in order.
2003-03-05 14:42:09 +00:00
Michael W. Hudson
2ab1d08f90
I thought it was common practice to check things compiled before
...
checking them in? Oh well, this fixes various obvious mistakes and
changes a subsubsubsection (which doesn't exist) into a subsubsection
(which does). I'm not sure this matches the intent, but it seems to
read OK on a quick skim.
2003-03-05 14:20:58 +00:00
Andrew M. Kuchling
55fa3bb250
Point e-mail address at the SIG
2003-03-04 19:36:11 +00:00
Andrew M. Kuchling
69700ef573
Weaken recommendation of Friedl book; fix reference
2003-03-04 14:17:05 +00:00
Andrew M. Kuchling
02a0b3b81a
[bug #692016 ] update description of {m,n} modifier; you can omit the lower bound
2003-03-04 14:12:24 +00:00
Andrew M. Kuchling
85f3227a74
[bug #696771 ] Remove misleading parenthetical aside
2003-03-04 14:07:51 +00:00
Just van Rossum
96b1c903f5
Patch #683592 revisited, after discussions with MvL:
...
- Implement the behavior as specified in PEP 277, meaning os.listdir()
will only return unicode strings if it is _called_ with a unicode
argument.
- And then return only unicode, don't attempt to convert to ASCII.
- Don't switch on Py_FileSystemDefaultEncoding, but simply use the
default encoding if Py_FileSystemDefaultEncoding is NULL. This means
os.listdir() can now raise UnicodeDecodeError if the default encoding
can't represent the directory entry. (This seems better than silcencing
the error and fall back to a byte string.)
- Attempted to decribe the above in Doc/lib/libos.tex.
- Reworded the Misc/NEWS items to reflect the current situation.
This checkin also fixes bug #696261 , which was due to os.listdir() not
using Py_FileSystemDefaultEncoding, like all file system calls are
supposed to.
2003-03-03 17:32:15 +00:00
Michael W. Hudson
f008998668
Fix bug
...
[ 555817 ] Flawed fcntl.ioctl implementation.
with my patch that allows for an array to be mutated when passed
as the buffer argument to ioctl() (details complicated by
backwards compatibility considerations -- read the docs!).
2003-03-03 12:29:42 +00:00
Guido van Rossum
41bcbe3050
Commit MvL's doc patch for SF bug #221327 . This adds an example of
...
calling into Python from a C thread.
2003-03-02 13:17:20 +00:00
Andrew M. Kuchling
563389fdee
Add updates for alpha2
2003-03-02 02:31:58 +00:00
Andrew M. Kuchling
41c3e00851
Expand itertools paragraph
2003-03-02 02:13:52 +00:00
Guido van Rossum
46d3dc37e4
- New function sys.exc_clear() clears the current exception. This is
...
rarely needed, but can sometimes be useful to release objects
referenced by the traceback held in sys.exc_info()[2]. (SF patch
#693195.) Thanks to Kevin Jacobs!
2003-03-01 03:20:41 +00:00
Guido van Rossum
d41eea05f4
SF doc patch #692001 , properties and __getattribute__. I added some
...
stuff, and changed 'property' to 'descriptor'.
2003-02-28 14:11:45 +00:00
Andrew M. Kuchling
c61402ba26
Update PyPI link
2003-02-26 19:00:52 +00:00
Andrew M. Kuchling
b6b4613ae4
[Bug #693474 , reported by Stuart Bishop]
...
Fix errors in the list of setup() arguments
2003-02-26 18:58:46 +00:00
Jack Jansen
5860dab401
Documented linkmodel and WMAvailable().
2003-02-24 11:02:36 +00:00
Neal Norwitz
7aba3d471f
Fix SF bug #691276 , shutil.copytree documentation bug
2003-02-23 21:36:47 +00:00
Raymond Hettinger
61fe64d5de
User requested changes to the itertools module.
...
Subsumed times() into repeat().
Added cycle() and chain().
2003-02-23 04:40:07 +00:00
Michael W. Hudson
f5dd753f4d
I'm am the PyPy sprint waiting for a Grand Renaming so I killed a few
...
seconds making the doc for get_completer marginally less minimal :)
2003-02-21 20:11:09 +00:00
Neal Norwitz
b7d1d3cf23
Add some minimal doc for get_completer added for patch 676342
2003-02-21 18:57:05 +00:00
Raymond Hettinger
1b56de05d5
Fill in missing table entries.
2003-02-21 05:42:13 +00:00
Raymond Hettinger
a97e4f3a49
SF bug #685775 : turtle circle() documentation error
2003-02-21 03:14:08 +00:00
Raymond Hettinger
3004b090ad
SF bug #690377 : Dud footnote reference in distutils docs
2003-02-21 02:47:09 +00:00
Raymond Hettinger
1b18ba49ab
Markup and nits.
2003-02-21 01:45:34 +00:00
Neal Norwitz
d08baa9504
Add some notes about HIGHEST_PROTOCOL.
2003-02-21 00:26:33 +00:00
Fred Drake
cade71387e
Added a note about the new itertools module. (Omission noted by
...
Gerrit Holl in email to python-docs.)
2003-02-19 16:08:08 +00:00
Andrew M. Kuchling
3749507296
logging.warn() renamed to warning()
2003-02-19 13:46:18 +00:00
Fred Drake
7f90c7fcb3
Bump version number.
2003-02-18 22:11:58 +00:00
Neal Norwitz
6fa635df7a
SF patch #687683 , Patches to logging (updates from Vinay)
...
Mostly rename WARN -> WARNING
Other misc tweaks
Update tests (not in original patch)
2003-02-18 14:20:07 +00:00
Andrew M. Kuchling
d87eeb9477
Add two acks; bump version number
2003-02-18 00:56:56 +00:00
Andrew M. Kuchling
7ee9b51ba5
[Bug #688261 ] Fix optparse example and output
2003-02-18 00:48:23 +00:00
Andrew M. Kuchling
acddabc6ec
[Bug #683416 ] Make PEP263 coverage a bit more explicit, and add it to the
...
porting section
2003-02-18 00:43:24 +00:00
Neal Norwitz
f927f14eda
Fix SF bug #687655 , String formatting conversions misleading
2003-02-17 18:57:06 +00:00
Skip Montanaro
117910dc44
Migrate definitions of several platform-dependent path-related variables
...
into the relevant path modules. See patch #686397 .
2003-02-14 19:35:31 +00:00
Fred Drake
002a5de202
extsep description:
...
- avoid "e.g." in text
- record version information
(should be backported)
2003-02-14 06:39:37 +00:00
Skip Montanaro
47e46e2347
add missing description of os.extsep
2003-02-14 05:45:31 +00:00
Raymond Hettinger
2835e37be5
SF bug #663701 : sets module review
...
Renamed hook methods to use the double underscore convention.
2003-02-14 03:42:11 +00:00
Raymond Hettinger
e544f6f682
SF bug #663701 . The caret wasn't printing well in the PDF documentation.
2003-02-14 01:49:09 +00:00
Neal Norwitz
d8d2cf476e
Remove deps on mac doc files which have been removed
2003-02-14 01:45:53 +00:00
Skip Montanaro
15f742dbac
first cut at a shell script to view a single section from the library
...
reference manual
2003-02-13 18:30:08 +00:00
Neal Norwitz
12d31e2e9d
Try to doc the new pickle details being implemented as part of PEP 307.
...
Needs review.
2003-02-13 03:12:48 +00:00
Neal Norwitz
2294c0d4ec
Cleanup from patch #683257 :
...
Add missing INCREFs and re-indent returns to be consistent.
Add \n\ for lines in docstring
Add a pathetic test
Add docs
2003-02-12 23:02:21 +00:00
Jack Jansen
7aeba45b84
Updated the Mac documentation to the current state of affairs.
2003-02-12 09:58:33 +00:00
Gustavo Niemeyer
a33d0aa693
Unparenting BZ2File, as discussed in SF patch #661796 .
...
* Modules/bz2module.c
(BZ2FileObject): Now the structure includes a pointer to a file object,
instead of "inheriting" one. Also, some members were copied from the
PyFileObject structure to avoid dealing with the internals of that
structure from outside fileobject.c.
(Util_GetLine,Util_DropReadAhead,Util_ReadAhead,Util_ReadAheadGetLineSkip,
BZ2File_write,BZ2File_writelines,BZ2File_init,BZ2File_dealloc,
BZ2Comp_dealloc,BZ2Decomp_dealloc):
These functions were adapted to the change above.
(BZ2File_seek,BZ2File_close): Use PyObject_CallMethod instead of
getting the function attribute locally.
(BZ2File_notsup): Removed, since it's not necessary anymore to overload
truncate(), and readinto() with dummy functions.
(BZ2File_methods): Added xreadlines() as an alias to BZ2File_getiter,
and removed truncate() and readinto().
(BZ2File_get_newlines,BZ2File_get_closed,BZ2File_get_mode,BZ2File_get_name,
BZ2File_getset):
Implemented getters for "newlines", "mode", and "name".
(BZ2File_members): Implemented "softspace" member.
(BZ2File_init): Reworked to create a file instance instead of initializing
itself as a file subclass. Also, pass "name" object untouched to the
file constructor, and use PyObject_CallFunction instead of building the
argument tuple locally.
(BZ2File_Type): Set tp_new to PyType_GenericNew, tp_members to
BZ2File_members, and tp_getset to BZ2File_getset.
(initbz2): Do not set BZ2File_Type.tp_base nor BZ2File_Type.tp_new.
* Doc/lib/libbz2.tex
Do not mention that BZ2File inherits from the file type.
2003-02-11 18:46:20 +00:00
Neal Norwitz
ada859c111
Remove duplicate word (rules)
2003-02-11 14:30:39 +00:00
Michael W. Hudson
eb189934ce
Fix so it compiles at least.
...
"make lib" takes a while, doesn't it?
2003-02-11 14:24:13 +00:00
Michael W. Hudson
3e245d800d
Add item pertaining to
...
[ 680429 ] __module__ broken for extension classes
2003-02-11 14:19:56 +00:00
Michael W. Hudson
065f5facea
Sundry very picky changes.
2003-02-10 19:24:50 +00:00
Michael W. Hudson
aab0260682
Remove erroneous period.
2003-02-10 19:21:16 +00:00
Michael W. Hudson
1e71b04258
Update advice about __module__ and __name__ and tp_name wrt. new types.
...
Add \refs to GC section that were XXXed out.
2003-02-10 19:18:21 +00:00
Michael W. Hudson
bbe17f50eb
A typo, and desist from inaccurately describing some things as lists.
2003-02-10 19:12:42 +00:00
Andrew M. Kuchling
72df65ac0e
Add Neil's suggestions for avoiding this warning
2003-02-10 15:08:16 +00:00
Raymond Hettinger
60eca9331a
C Code:
...
* Removed the ifilter flag wart by splitting it into two simpler functions.
* Fixed comment tabbing in C code.
* Factored module start-up code into a loop.
Documentation:
* Re-wrote introduction.
* Addede examples for quantifiers.
* Simplified python equivalent for islice().
* Documented split of ifilter().
Sets.py:
* Replace old ifilter() usage with new.
2003-02-09 06:40:58 +00:00
Tim Peters
07534a607b
Comparison for timedelta, time, date and datetime objects: __eq__ and
...
__ne__ no longer complain if they don't know how to compare to the other
thing. If no meaningful way to compare is known, saying "not equal" is
sensible. This allows things like
if adatetime in some_sequence:
and
somedict[adatetime] = whatever
to work as expected even if some_sequence contains non-datetime objects,
or somedict non-datetime keys, because they only call __eq__.
It still complains (raises TypeError) for mixed-type comparisons in
contexts that require a total ordering, such as list.sort(), use as a
key in a BTree-based data structure, and cmp().
2003-02-07 22:50:28 +00:00
Andrew M. Kuchling
b8a3905112
Update URL
2003-02-07 20:22:33 +00:00
Fred Drake
693aea2eb4
- make some links into the reference documentation relative for
...
off-line readers
- fix some minor typos and markup errors
2003-02-07 14:52:18 +00:00
Raymond Hettinger
2012f174ea
SF bug #681003 : itertools issues
...
* Fixed typo in exception message for times()
* Filled in missing times_traverse()
* Document reasons that imap() did not adopt a None fill-in feature
* Document that count(sys.maxint) will wrap-around on overflow
* Add overflow test to islice()
* Check that starmap()'s argument returns a tuple
* Verify that imap()'s tuple re-use is safe
* Make a similar tuple re-use (with safety check) for izip()
2003-02-07 05:32:58 +00:00
Neal Norwitz
2b09bc4d57
Fix SF bug #675259 , os.environ leaks under FreeBSD and Mac OS X
...
Even with the extra work to cleanup the env, *BSD still leaks. Add a note.
Will backport.
2003-02-07 02:27:36 +00:00
Neal Norwitz
694d9b3541
Update doc to reflect code changes for obsoleting use_statcache parameter
2003-02-06 21:17:17 +00:00
Michael W. Hudson
241c2e9692
Remove another lie.
2003-02-06 18:38:11 +00:00
Michael W. Hudson
847f37543f
Correct lie about METH_NOARGS functions.
...
Backport candidate.
2003-02-06 18:37:11 +00:00
Andrew M. Kuchling
93cf58b015
Typo fixes
2003-02-06 18:04:43 +00:00
Andrew M. Kuchling
80fd7851ac
Mention FutureWarning for large ints
2003-02-06 15:14:04 +00:00
Andrew M. Kuchling
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
Neal Norwitz
292f56cd26
Provide version changed info
2003-02-06 05:02:39 +00:00
Anthony Baxter
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
Andrew M. Kuchling
570e35870a
Markup fixes; in particular, the tables are now reasonable width
2003-02-05 21:15:38 +00:00
Fred Drake
604ade4ebd
supports_unicode_filenames was not in the right location.
2003-02-04 19:13:07 +00:00
Fred Drake
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
Fred Drake
5bbeb8d1ad
Twiddle.
2003-02-04 15:01:37 +00:00
Andrew M. Kuchling
4b37364fc8
Bug #678077 : Suggest alternative to os.getlogin()
2003-02-03 15:36:26 +00:00
Andrew M. Kuchling
b9ba4e6d75
[Bug #679251 ] Use correct constant name
2003-02-03 15:16:15 +00:00
Skip Montanaro
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
Skip Montanaro
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
Raymond Hettinger
96ef8115dd
Move itertools module from the sandbox and into production.
2003-02-01 00:10:11 +00:00
Jeremy Hylton
f9b0cc7df6
Document __module__.
2003-01-31 18:52:45 +00:00
Walter Dörwald
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
Raymond Hettinger
89fc4f3e56
Fix typo
2003-01-31 05:44:25 +00:00
Raymond Hettinger
2adbb83a24
SF bug #671447 : StringIO doc doesn't say it's sometimes read-only.
2003-01-31 05:17:33 +00:00
Fred Drake
008a36ac20
Fix markup error.
2003-01-30 22:22:59 +00:00
Raymond Hettinger
301eb71fb9
Author markup: Andrew got to it first
2003-01-30 01:03:38 +00:00
Fred Drake
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
Fred Drake
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
Fred Drake
c23e0192c9
More markup changes for consistency.
2003-01-28 22:09:16 +00:00
Fred Drake
68e6d57bb9
Various minor markup adjustments.
2003-01-28 22:02:35 +00:00
Fred Drake
7821d7230c
Added missing dependency.
2003-01-28 21:53:05 +00:00
Andrew M. Kuchling
a31bb379f8
Update register example
2003-01-27 16:36:34 +00:00
Fred Drake
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
Fred Drake
9db20c62ff
Make the "notice" environments somewhat similar, with less difference
...
between the "note" and "warning" flavors.
2003-01-27 16:31:16 +00:00
Skip Montanaro
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
Raymond Hettinger
2ef85a729e
Fix minor typos.
2003-01-25 21:46:53 +00:00
Neal Norwitz
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
Neal Norwitz
daae32721a
Fix markup
2003-01-25 21:08:30 +00:00
Fred Drake
f536827c65
Include version annotation for PyObject_Call().
2003-01-25 07:48:13 +00:00
Fred Drake
8bd62afca9
Fix typo reported to python-docs.
2003-01-25 03:47:35 +00:00
Tim Peters
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
Barry Warsaw
6d9f9b3b67
Fred drives and fixes a formatting nit.
2003-01-24 17:33:30 +00:00
Tim Peters
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
Tim Peters
10cadce41e
Reimplemented datetime.now() to be useful.
2003-01-23 19:58:02 +00:00
Tim Peters
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
Tim Peters
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
Skip Montanaro
1f7a271f0b
more tweaks
2003-01-21 01:52:39 +00:00
Skip Montanaro
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
Tim Peters
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
Raymond Hettinger
f4ca5a2f45
Fix typo
2003-01-19 14:57:12 +00:00
Raymond Hettinger
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
Raymond Hettinger
9543b34006
SF patch #670423 : Add missing identity tests to operator.c
2003-01-18 23:22:20 +00:00
Fred Drake
aac8c58f0b
Various markup changes.
2003-01-17 22:50:10 +00:00
Fred Drake
42b567fce9
Fix a couple of markup errors.
2003-01-17 22:47:33 +00:00
Fred Drake
376f0ef30c
Clean up some files that LaTeX2HTML drops in the HTML output directory
...
sometimes.
2003-01-17 21:25:04 +00:00
Raymond Hettinger
ee1bded046
Correct typos in example code.
2003-01-17 16:20:23 +00:00
Martin v. Löwis
13dd9d9978
Patch #662454 : import a.b as c is ok, fixes #660811 .
2003-01-16 11:30:08 +00:00
Skip Montanaro
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
Raymond Hettinger
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
Martin v. Löwis
0c6774d92b
Patch #661719 : Expose compilation errors as exceptions on request.
2003-01-15 11:51:06 +00:00
Martin v. Löwis
d69663d300
Patch #473586 : Implement CGIXMLRPCRequestHandler.
2003-01-15 11:37:23 +00:00
Andrew M. Kuchling
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
Andrew M. Kuchling
c1dd174682
Link to MRO article
...
Mention deprecation of string exceptions
2003-01-13 13:59:22 +00:00
Raymond Hettinger
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
Neal Norwitz
06daee9dd7
Try to make a sentance more readable.
2003-01-12 15:04:54 +00:00
Neal Norwitz
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
Fred Drake
8ec17a0a8d
Minor correction and clarification.
2003-01-11 23:15:47 +00:00
Neal Norwitz
3cb68a2512
Remove extra 'types'
...
Change a couple of list -> mylist
2003-01-10 13:52:30 +00:00
Raymond Hettinger
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
Tim Peters
312141c51f
Purged reference to defunct datetimetz.
2003-01-09 19:52:17 +00:00
Andrew M. Kuchling
9b44571caa
Various minor edits
2003-01-09 13:46:30 +00:00
Andrew M. Kuchling
0f0e6b9d48
Markup fix
2003-01-09 12:51:50 +00:00
Tim Peters
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
Fred Drake
326c72a839
Add notes about the linuxaudiodev and ossaudiodev modules.
2003-01-08 07:21:53 +00:00
Neal Norwitz
55d555f012
command doesn't work, but program does, not sure it's correct, though
2003-01-08 05:27:42 +00:00
Greg Ward
19b6f60f5c
There's no such method as has_option() -- should be has_extn().
2003-01-08 03:04:42 +00:00
Greg Ward
d4fee28717
Rewrite awkward/ungrammatical sentence.
...
Typo fix.
2003-01-08 03:02:26 +00:00
Andrew M. Kuchling
d97b01cb82
Bump version number
2003-01-08 02:09:40 +00:00
Barry Warsaw
b6604b3e69
Document EX_OK and friends.
2003-01-07 22:43:25 +00:00
Neal Norwitz
051314f924
SF #664011 , move tarfile module in docs
2003-01-07 22:36:04 +00:00
Andrew M. Kuchling
674b0bfde6
Add tarfile module
2003-01-07 00:07:19 +00:00
Andrew M. Kuchling
ef893fe452
Add Tix and rexec changes
2003-01-06 20:04:17 +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
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
Greg Ward
1d5d8cf61f
Typo fix.
2002-12-17 18:14:21 +00:00
Michael W. Hudson
cfd3884882
This is Richie Hindle's patch
...
[ 643835 ] Set Next Statement for Python debuggers
with a few tweaks by me: adding an unsigned or two, mentioning that
not all jumps are allowed in the doc for pdb, adding a NEWS item and
a note to whatsnew, and AuCTeX doing something cosmetic to libpdb.tex.
2002-12-17 16:15:34 +00:00
Neal Norwitz
212b43f90c
Add markup for base parameter
2002-12-17 01:24:11 +00:00
Neal Norwitz
046b8a7244
Fix SF # 641111, Undocumented side effect of eval
...
Try to clear up confusion about the current globals being copied
into a globals dict passed to eval(). This wording (more or less)
was suggested in bug report. It should probably be made clearer.
Backport candidate.
2002-12-17 01:08:06 +00:00
Neal Norwitz
e9ce25e512
Fix SF #642742 , property() builtin not documented
...
Added doc for functions new to 2.2: classmethod property staticmethod super
Taken from docstrings. Could use review.
Hope there wasn't a reason why these shouldn't have been added.
Backport candidate.
2002-12-17 01:02:57 +00:00
Neal Norwitz
0f30dbd991
Fix SF # 626275, missing DECREF's in embedding example
...
Tested w/valgrind, all paths except the return on PyInt_AsLong() failure
I think I got all of these right.
Backport candidate.
2002-12-17 00:40:38 +00:00
Gustavo Niemeyer
786ddb29c9
Fixed bug
...
[#521782 ] unreliable file.read() error handling
* Objects/fileobject.c
(file_read): Clear errors before leaving the loop in all situations,
and also check if some data was read before exiting the loop with an
EWOULDBLOCK exception.
* Doc/lib/libstdtypes.tex
* Objects/fileobject.c
Document that sometimes a read() operation can return less data than
what the user asked, if running in non-blocking mode.
* Misc/NEWS
Document the fix.
2002-12-16 18:12:53 +00:00
Gustavo Niemeyer
78429a6aa6
Fixing bug
...
[#448679 ] Left to right
* Python/compile.c
(com_dictmaker): Reordered evaluation of dictionaries to follow strict
LTR evaluation.
* Lib/compiler/pycodegen.py
(CodeGenerator.visitDict): Reordered evaluation of dictionaries to
follow strict LTR evaluation.
* Doc/ref/ref5.tex
Documented the general LTR evaluation order idea.
* Misc/NEWS
Documented change in evaluation order of dictionaries.
2002-12-16 13:54:02 +00:00
Andrew M. Kuchling
8e5b53b3d9
Rewrite to produce a complete sentence
2002-12-15 20:17:38 +00:00
Just van Rossum
edd179ee77
typo fix.
2002-12-15 13:14:22 +00:00
Raymond Hettinger
45bda57c1d
Added missing markup.
...
Replaced British spelling of 'behaviour' with 'behavior'.
Noted the new optional argument in math.log(x [,base]).
2002-12-14 20:20:45 +00:00
Raymond Hettinger
866964c3a3
Apply SF patch 652930: Add optional base argument to math.log(x[, base]).
2002-12-14 19:51:34 +00:00
Andrew M. Kuchling
6c50df2d90
Add Tkinter threading change
...
Fix markup errors
Rewrite a sentence
2002-12-13 12:53:16 +00:00
Thomas Heller
63b4dd33c9
Description of description was really confusing, and added some markup.
2002-12-12 19:35:00 +00:00
Thomas Heller
2c3bfc2a1a
Raw documentation for the bdist_wininst postinstallation script.
...
People are already using it, so these docs are certainly better than
no docs at all. Markup is mostly missing and the layout is probably
ugly, but this can be fixed later.
Question: there are references to MS docs for the CSIDL_... constants
and the IShellLink interface. Are these pointers sufficient, or should
the MS docs reworded and repeated here?
2002-12-12 18:54:19 +00:00
Walter Dörwald
d9a6ad3beb
Enhance issubclass() and PyObject_IsSubclass() so that a tuple is
...
supported as the second argument. This has the same meaning as
for isinstance(), i.e. issubclass(X, (A, B)) is equivalent
to issubclass(X, A) or issubclass(X, B). Compared to isinstance(),
this patch does not search the tuple recursively for classes, i.e.
any entry in the tuple that is not a class, will result in a
TypeError.
This closes SF patch #649608 .
2002-12-12 16:41:44 +00:00
Just van Rossum
b083cb3901
Patch #651621 , approved by MvL.
...
This patch allows ZipFile.writestr() to be called with
an archive file name instead of a ZipInfo instance:
z = ZipFile("myarchive.zip", "w")
z.writestr("foo/baz/file.ext", data)
z.close()
I found the old writestr() method very inconvenient
for simple (but common) things.
If called with a file name instead of a ZipInfo
instance, the date_time is set to the current date/time,
which makes sense to me for anonymous data.
2002-12-12 12:23:32 +00:00
Andrew M. Kuchling
449a87d791
Various additions and changes suggested by Raymond Hettinger
2002-12-11 15:03:51 +00:00
Martin v. Löwis
0479104a91
Patch #651006 : Better explain what component might be empty.
2002-12-11 12:55:53 +00:00
Raymond Hettinger
d2bef8256b
Update comments about the performance of xrange().
2002-12-11 07:14:03 +00:00
Tim Peters
85f7f83d71
Added a word to the heapq description in response to user confusion.
2002-12-10 21:04:25 +00:00
Skip Montanaro
3bf99e3e87
Add support for binary pickles to the shelve module. In some situations
...
this can result in significantly smaller files. All classes as well as the
open function now accept an optional binary parameter, which defaults to
False for backward compatibility. Added a small test suite, updated the
libref documentation (including documenting the exported classes and fixing
a few other nits) and added a note about the change to Misc/NEWS.
2002-12-08 18:36:24 +00:00
Fred Drake
27cae1f7c5
Revise the __all__ index entry a touch.
2002-12-07 16:00:00 +00:00
Raymond Hettinger
f9229d98ae
Add __all__ to Reference Manual index.
...
Closes SF 643227.
2002-12-07 09:39:15 +00:00
Thomas Heller
ead60e5d1c
Typo: propogate -> propagate
...
Bugfix candidate.
2002-12-06 22:42:13 +00:00
Fred Drake
edb635ff5c
Remove extra ")" in example.
2002-12-06 18:52:28 +00:00
Fred Drake
08d10f985e
Typo: "dead lock" --> "deadlock"
2002-12-06 16:45:05 +00:00
Walter Dörwald
6d5f30eaed
Document that the second argument to PyObject_IsInstance
...
may be a tuple. This closes SF patch
http://www.python.org/sf/649095
Backport to release22-maint will follow.
2002-12-06 10:09:16 +00:00
Fred Drake
a41b2bb981
Fix problem in example code. It's minor in this particular example,
...
but can lead to mysterious problems in real applications.
2002-12-03 22:57:37 +00:00
Fred Drake
7af24bd237
Fix example regular expressions that simulate scanf() constructs.
2002-12-03 18:49:17 +00:00
Martin v. Löwis
71aa6d6db9
Patch #646824 : Remove extra \end.
2002-12-03 18:09:02 +00:00
Andrew M. Kuchling
b1e4bf9dc1
Bug #647387 : corrections to the logging section by Vinay Sanjip
2002-12-03 13:35:17 +00:00
Mark Hammond
8af50bcf40
_ssl.pyd available for Windows.
2002-12-03 06:13:35 +00:00
Neal Norwitz
75bc8ba0d7
Fix SF # 646578, Documentation Typo
2002-12-02 04:42:58 +00:00
Neal Norwitz
ae6bf4adfa
Remove unused variable
2002-12-02 04:40:21 +00:00
Andrew M. Kuchling
53262577eb
Add ossaudiodev; fix typo
2002-12-01 14:00:21 +00:00
Just van Rossum
3eb166b49b
Slightly improved version of patch #642578 : "Expose PyImport_FrozenModules
...
in imp". This adds two functions to the imp module: get_frozenmodules()
and set_frozenmodules().
2002-11-29 20:47:40 +00:00
Andrew M. Kuchling
b6f7959093
Fix value of 'propagate' (noted by Chris Reedy)
...
Rewrite paragraph
2002-11-29 19:43:45 +00:00
Walter Dörwald
fb97443e57
Fix typo.
2002-11-29 16:39:07 +00:00
Andrew M. Kuchling
b492fa9101
Mention dict.fromkeys()
...
Various edits
2002-11-27 19:11:10 +00:00
Andrew M. Kuchling
5ef2b214cd
Update e-mail address
2002-11-27 18:53:38 +00:00
Andrew M. Kuchling
d680a86206
Bug #643631 : MacOS 9 details missing from inst.tex
...
Fill in the missing details. (From Jack Jansen)
2002-11-27 13:34:20 +00:00
Raymond Hettinger
e33d3df030
SF Patch 643443. Added dict.fromkeys(iterable, value=None), a class
...
method for constructing new dictionaries from sequences of keys.
2002-11-27 07:29:33 +00:00
Fred Drake
e9cfcef71e
Clarify the interpretation of the __getstate__() return value for
...
new-style classes.
Closes SF bug #637941 .
2002-11-27 05:26:46 +00:00
Fred Drake
4add68bbbc
Add missing dependency information for the "What's New" document.
2002-11-26 22:13:41 +00:00