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
774816f817
SF bug #764616 : execfile(filename,...) not execfile(file,...)
...
Clarify parameter name.
2003-07-02 15:31:54 +00:00
f8020e0211
Grammar nit. SF bug #757822
2003-07-02 15:10:38 +00:00
c5528b1f5c
Revert the previous change; this is now dealt with in a better way.
2003-07-02 14:44:55 +00:00
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
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
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
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
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
2884d6de15
Fix a variety of small markup nits.
2003-07-02 12:27:43 +00:00
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
901a41e757
normalize markup for consistency
2003-07-01 16:17:50 +00:00
93ceaea01f
showwarning() calls formatwarning(), not showwarning().
...
Bugfix candidate.
2003-07-01 14:37:59 +00:00
9c8f78deab
Improve the wording a bit
2003-07-01 07:19:17 +00:00
69d6356eb9
Fix spelling, grammar, usage, and markup.
2003-07-01 06:29:18 +00:00
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
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
ecc7171007
Add versionadded info for the 2 new threading module functions
2003-06-30 21:47:47 +00:00
675580f4fc
Document the DISTUTILS_DEBUG variable.
...
Closes sf #761401 .
Backport candidate.
2003-06-30 19:33:29 +00:00
220e83946d
We are now post-beta 2.
2003-06-30 13:38:38 +00:00
f647b63624
Added missing name (textwrap.dedent() docs).
2003-06-30 12:18:52 +00:00
ccd615c1a7
SF bug #762990 : Awful Grammar in Python Tutorial
...
Fixed a nit.
2003-06-30 04:27:31 +00:00
5728815e7b
Fix broken markup, & tweak a couple of things for consistency.
2003-06-29 18:12:23 +00:00
bfccb35b58
Add settrace() and setprofile() functions to the threading library.
2003-06-29 16:58:41 +00:00
85d27576a3
Update copyright years.
2003-06-29 16:55:47 +00:00
32a5e878d7
minor wordsmithing
2003-06-29 16:01:51 +00:00
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
5918f8de67
Minor fixes to punctuation and grammar.
2003-06-29 04:53:23 +00:00
3e2244c9e1
Bump version information for Python 2.3 beta 2.
2003-06-29 02:17:28 +00:00
6595e15331
Document PyThreadState_SetAsyncExc().
2003-06-29 02:14:31 +00:00
6891cd3aa3
A few minor improvements
2003-06-28 15:22:16 +00:00
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
9c3e957251
Updated the depenencies to reflect changes in the sample code for
...
building new types.
2003-06-28 13:27:57 +00:00
18a6be9748
Added tests for sample modules.
2003-06-28 11:54:40 +00:00
f0e38d1cd2
Added s setup module to make it easier to test the sample modules.
2003-06-28 11:54:20 +00:00
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
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
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
ded8e740df
Correct markup errors that prevented formatting.
2003-06-28 11:50:34 +00:00
7928f388c4
Explain source encodings. Fixes #683486 .
2003-06-28 08:11:55 +00:00
3567a876c7
Add take() to examples. Tighten the islice() example
2003-06-28 05:44:36 +00:00
5d2f515dd4
fix markup nits
2003-06-28 03:09:06 +00:00
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
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
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
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
6ab8b40337
fix link-hovering so <a name='...'> (no href attribute) doesn't get
...
the hovering background
2003-06-27 16:32:27 +00:00
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
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
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
f91888bb46
markup consistency nits
2003-06-26 03:11:57 +00:00
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
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
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
03ec6d538a
* Document how descriptors are invoked.
...
* Fix minor parenthesis matching errors in ref3.tex.
2003-06-25 18:29:36 +00:00
35fd926195
SF bug #757822 : Additional index items, other minor details
...
* Minor grammatical fix.
2003-06-25 15:07:45 +00:00
9e9a7c3dd7
Patch #640236 : Better eplain unused data.
2003-06-21 14:15:25 +00:00
171be76bdd
Patch #755683 : Document that there might be a maximum indentation limit.
...
Fixes #700827
2003-06-21 13:40:02 +00:00
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
3a03de4a27
SF #757229 , fix libsocket.tex typo
2003-06-20 17:11:39 +00:00
2664cbbeba
Remove heading from orphan section.
2003-06-20 14:27:27 +00:00
0799d0a9e3
Update link to Python book information.
2003-06-20 14:00:49 +00:00
f5ed9819b0
Avoid using 'dir' as a variable name and use os.path.join() to create
...
paths.
2003-06-19 18:10:37 +00:00
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
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
b5155e30ce
Fix typo.
2003-06-18 01:58:31 +00:00
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
93719b56ed
Updated documentation for the new slice arguments for list.index().
2003-06-17 16:19:56 +00:00
364ca40c2a
SF Patch 569574 - enhancements to cgitb for plain text display
2003-06-17 12:58:31 +00:00
938b7a0f63
Fix some markup nits
2003-06-17 02:37:06 +00:00
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
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
097da0dc01
Documented the fact that the main class now mimicks the OSA "application" class.
2003-06-13 14:59:26 +00:00
7e902b27e0
* Added missing documentation for object().
...
* Noted the Py2.3 in the optional arg for bool().
2003-06-11 09:15:26 +00:00
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
132fa373d1
Add docs for get_grouped_opcodes().
2003-06-11 07:50:44 +00:00
80b3f685b4
SF bug: 751941 Invisible HTML tag
...
Added missing jump target labels.
2003-06-10 21:41:22 +00:00
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
e07b83591f
Document context_diff() and unified_diff()
2003-06-09 21:44:59 +00:00
305908cffd
SF #735051 , add time.tzset documentation
2003-06-08 13:57:19 +00:00
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
b268f03459
SF bug #749759 : comparisons yield bool not int
...
Minor documentation fix.
2003-06-06 02:52:14 +00:00
a1045567e0
QUOTE_ALWAYS -> QUOTE_ALL
2003-06-04 15:30:13 +00:00
19a5a710fc
Patch #744238 : Explain that different string types also may compare equal.
2003-05-31 08:05:49 +00:00
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
d691c42a38
Include both </tr> tags in the thead, not just the first.
2003-05-29 19:46:29 +00:00
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
d3d5768e5e
isdatadescriptor() was added recently.
2003-05-29 02:10:31 +00:00
2748a4aa7e
Typo fix.
2003-05-29 01:41:51 +00:00
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
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
a95d3b78c8
Oops. License is still an appendix.
2003-05-28 12:12:55 +00:00
a8e71c13e9
Update dependencies.
2003-05-28 12:10:14 +00:00
2fb6124afd
Appendix was removed.
2003-05-28 12:04:38 +00:00
c428112d29
Rename lib__future__.tex to libfuture.tex and add link in lib.tex.
2003-05-28 11:57:52 +00:00
cf9c46719c
*** empty log message ***
2003-05-28 11:51:11 +00:00
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
451a766953
More wordsmithing and cleanup.
2003-05-26 01:51:33 +00:00
8fb665a51a
Fix ref counts in initialization code.
2003-05-25 17:59:38 +00:00
c316d0d391
Lots of wordsmithing and typographical improvement.
2003-05-23 02:44:46 +00:00
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
4864bfb88f
Minor elaboration in the information about reporting errors.
2003-05-22 15:09:27 +00:00
6ce0b60063
update version history
2003-05-22 14:58:02 +00:00
e41195fab6
Add documentation for __future__
2003-05-21 21:45:01 +00:00
8bea5dc879
Move future statement here from appendix a.
2003-05-21 21:43:00 +00:00
28137a09d6
Don't mention __slots__ as a technique for error avoidance
2003-05-20 18:12:21 +00:00
15eac1f95c
Fix markup nits.
2003-05-20 16:21:51 +00:00
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
6bab183d4e
Markup nits.
2003-05-20 15:28:58 +00:00
e5a55519a8
Remove unused line numbers from example code.
...
Line numbering of examples is not used elsewhere.
2003-05-20 15:21:08 +00:00
f9c2eda3c1
Fix missing parethesis.
2003-05-20 05:31:16 +00:00
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
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
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
047c54bb24
Missing parenthesis.
2003-05-16 14:36:26 +00:00
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
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
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
8f512a22cd
Add docs for MessageBeep.
2003-05-16 01:42:22 +00:00
7696344182
[Bug #471893 ] Replace security material with a warning against unpickling
...
untrusted data.
2003-05-14 16:51:46 +00:00
126d366ea6
document Stats.dump_stats(), new for Python 2.3
2003-05-14 14:29:27 +00:00
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
bf1bef820c
Add optional 'onerror' argument to os.walk(), to control error
...
handling.
2003-05-13 18:01:19 +00:00
e9a54a3eaf
[Bug #713722 ] Delete dangling references to unwritten sections
2003-05-13 15:02:06 +00:00
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
8d17709c5c
Remove more markup from headers
2003-05-13 14:26:54 +00:00
433307b75d
[Bug #729297 ] Remove markup in section headers
2003-05-13 14:23:54 +00:00
eabd9a1314
[Bug #729817 ] Document the rexec and Bastion modules as dead
2003-05-13 14:16:18 +00:00
032bd0a9a8
Fix typo
2003-05-13 14:13:58 +00:00
1213bdd16d
Fix and add reference to urllib.urlencode for parse_qsl? functions.
2003-05-13 02:50:36 +00:00
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
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
bf3a75283c
Fix minor typos.
2003-05-12 03:23:51 +00:00
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
b4c1d9be8f
Fix unbalanced parethesis.
2003-05-10 08:51:28 +00:00
0dfd7a9361
Missing parenthesis found by texcheck.py
2003-05-10 07:40:56 +00:00
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
eca984fcce
Fix missing parenthesis.
2003-05-10 04:21:08 +00:00
52136a8bea
Fixed spacing and unbalanced brackets or parenthesis.
2003-05-10 03:35:37 +00:00
9f545c489a
Make this format again.
2003-05-09 19:10:12 +00:00
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
3ec4dfd812
Make this format again.
2003-05-09 18:18:46 +00:00
8b6ed26dc7
- remove bogus \end{description}
...
- fix two typos
2003-05-09 15:04:56 +00:00
1662162c04
Documented the new autoGIL module.
2003-05-09 14:45:04 +00:00
3ff5bb20b7
Fixed small typo Pointed out by Michael Hudson.
2003-05-08 10:35:07 +00:00
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
86e1790cad
Clarify the dedent() example a bit by indenting the input lines unevenly.
2003-05-08 02:12:35 +00:00
8f6329c547
SF patch #598163 (Ville Vainio, vvainio@users.sourceforge.net):
...
document dedent() function.
2003-05-08 02:09:49 +00:00
066f3928b2
Library documentation for the 'test' package. Still needs to be checked by Fred.
2003-05-07 22:02:17 +00:00
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
Skip Montanaro
Raymond Hettinger
Fred Drake
Tim Peters
Brett Cannon
Neal Norwitz
Thomas Heller
Jeremy Hylton
Barry Warsaw
Jim Fulton
Martin v. Löwis
Walter Dörwald
Jack Jansen
Gustavo Niemeyer
Greg Ward
Gregory P. Smith
Andrew M. Kuchling
Guido van Rossum