George Yoshida
2f6ce536ab
Mention that Exception is now a subclass of BaseException.
...
Remove a sentence that says that BaseException inherits from BaseException.
(I guess this is just a copy & paste mistake.)
2006-05-16 18:07:00 +00:00
Andrew M. Kuchling
c0a0decd54
PEP 243 has been withdrawn, so don't refer to it any more.
...
The PyPI upload material has been moved into the section on PEP314.
2006-05-16 16:27:31 +00:00
Andrew M. Kuchling
d779b353fa
Add item
2006-05-16 16:11:54 +00:00
Georg Brandl
8d3342b489
Patch #1435422 : zlib's compress and decompress objects now have a
...
copy() method.
2006-05-16 07:38:27 +00:00
Tim Peters
e6d9506611
Typo repair.
2006-05-13 23:31:05 +00:00
Tim Peters
8931ff1f67
Teach PyString_FromFormat, PyErr_Format, and PyString_FromFormatV
...
about "%u", "%lu" and "%zu" formats.
Since PyString_FromFormat and PyErr_Format have exactly the same rules
(both inherited from PyString_FromFormatV), it would be good if someone
with more LaTeX Fu changed one of them to just point to the other.
Their docs were way out of synch before this patch, and I just did a
mass copy+paste to repair that.
Not a backport candidate (this is a new feature).
2006-05-13 23:28:20 +00:00
George Yoshida
90df06e5e2
Add \exception markup
2006-05-13 06:53:31 +00:00
Gerhard Häring
2b161d9038
Integrated the rest of the pysqlite reference manual into the Python
...
documentation. Ready to be reviewed and improved upon.
2006-05-12 23:49:49 +00:00
George Yoshida
8f505aed46
Duplicated description about the illegal continue usage can be found in nearly the same place.
...
They are same, so keep the original one and remove the later-added one.
2006-05-12 17:25:26 +00:00
George Yoshida
159a1160c1
At first there were 6 steps, but one was removed after that.
2006-05-12 16:40:11 +00:00
Tim Peters
b06d28c160
SF patch #1473132 : Improve docs for tp_clear and tp_traverse,
...
by Collin Winter.
Bugfix candidate (but I'm not going to bother).
2006-05-12 01:57:59 +00:00
Andrew M. Kuchling
7cadf59e14
typo fix
2006-05-11 16:32:24 +00:00
George Yoshida
4917c34b26
Grammar fix
2006-05-11 15:53:27 +00:00
Martin v. Löwis
879768dd97
Change WindowsError to carry the Win32 error code in winerror,
...
and the DOS error code in errno. Revert changes where
WindowsError catch blocks unnecessarily special-case OSError.
2006-05-11 13:28:43 +00:00
Georg Brandl
dd0c312703
Fix two small errors in argument lists.
2006-05-10 20:09:23 +00:00
Andrew M. Kuchling
356af466c8
Clarify description of exception handling
2006-05-10 17:19:04 +00:00
Georg Brandl
38c6a22f38
Patch #1484695 : Update the tarfile module to version 0.8. This fixes
...
a couple of issues, notably handling of long file names using the
GNU LONGNAME extension.
2006-05-10 16:26:03 +00:00
Georg Brandl
f8d9a97ba2
Bug #1484978 : curses.panel: clarify that Panel objects are destroyed on garbage collection.
2006-05-10 16:11:44 +00:00
Georg Brandl
b1582557aa
Bug #1485447 : subprocess: document that the "cwd" parameter isn't used to find the executable. Misc. other markup fixes.
2006-05-10 16:09:03 +00:00
Georg Brandl
e7d9539eba
Bug #1482988 : indicate more prominently that the Stats class is in the pstats module.
2006-05-10 15:59:06 +00:00
Andrew M. Kuchling
0901965134
Minor language edit
2006-05-07 17:14:53 +00:00
Andrew M. Kuchling
fb10858fe7
[Patch #1479977 ] Revised version of urllib2 HOWTO, edited by John J. Lee
2006-05-07 17:12:12 +00:00
George Yoshida
ce5933f582
Use \versionchanged for the feature change
2006-05-06 14:16:51 +00:00
George Yoshida
d3d8ecda15
describe optional arguments for DocFileSuite
2006-05-06 13:09:45 +00:00
Nick Coghlan
d8accb32a5
Get rid of a couple more context object references, fix some markup and clarify what happens when a generator context function swallows an exception.
2006-05-03 13:17:49 +00:00
Nick Coghlan
afd5e63e24
Finish bringing SVN into line with latest version of PEP 343 by getting rid of all remaining references to context objects that I could find. Without a __context__() method context objects no longer exist. Also get test_with working again, and adopt a suggestion from Neal for decimal.Context.get_manager()
2006-05-03 13:02:47 +00:00
Martin v. Löwis
a3a13298b2
Correct some formulations, fix XXX comments.
2006-05-03 04:52:04 +00:00
Tim Peters
4511a713d5
Whitespace normalization.
2006-05-03 04:46:14 +00:00
Fred Drake
3053667d09
fix up whitespace in prompt strings
2006-05-03 02:29:39 +00:00
Fred Drake
5f1cca0a1d
one more place to avoid extra markup (how many will there be?)
2006-05-03 02:29:09 +00:00
Fred Drake
2de7a35e9a
one more place to avoid extra markup
2006-05-03 02:27:40 +00:00
Fred Drake
6b07be9d29
at least comment on why curly-quotes are not enabled
2006-05-03 02:12:47 +00:00
Fred Drake
f25fa6ddb9
avoid ugly markup based on the unfortunate conversions of ">>" and "<<" to
...
guillemets; no need for magic here
2006-05-03 02:04:40 +00:00
Fred Drake
f863609cd6
tell LaTeX2HTML to:
...
- use UTF-8 output
- not mess with the >>> prompt!
2006-05-03 01:48:24 +00:00
Fred Drake
e10b21bd6f
remove unnecessary assignment
2006-05-03 01:46:52 +00:00
Andrew M. Kuchling
f322d68327
Update context manager section for removal of __context__
2006-05-02 22:47:49 +00:00
Armin Rigo
a71fd71c3e
Documentation bug: PySet_Pop() returns a new reference (because the
...
caller becomes the owner of that reference).
2006-05-02 19:52:32 +00:00
Guido van Rossum
da5b701aee
Get rid of __context__, per the latest changes to PEP 343 and python-dev
...
discussion.
There are two places of documentation that still mention __context__:
Doc/lib/libstdtypes.tex -- I wasn't quite sure how to rewrite that without
spending a whole lot of time thinking about it; and whatsnew, which Andrew
usually likes to change himself.
2006-05-02 19:47:52 +00:00
Andrew M. Kuchling
a883701dff
Provide encoding as keyword argument; soften warning paragraph about encodings
2006-05-02 11:30:03 +00:00
Fred Drake
017e68c413
SF #1479988 : add methods to allow access to weakrefs for the
...
weakref.WeakKeyDictionary and weakref.WeakValueDictionary
2006-05-02 06:53:59 +00:00
Neal Norwitz
c4edb0ec81
SF #1479181 : split open() and file() from being aliases for each other.
2006-05-02 04:43:14 +00:00
Andrew M. Kuchling
4bbf66e852
Markup fixes
2006-05-01 17:06:54 +00:00
Andrew M. Kuchling
6849488914
Add item
2006-05-01 16:32:49 +00:00
Andrew M. Kuchling
edbe657174
Markup fixes; add some XXX comments noting problems
2006-05-01 16:30:25 +00:00
Fred Drake
d22c6dbdfa
add dependency
2006-05-01 16:28:54 +00:00
Martin v. Löwis
5f4307491e
Add msilib documentation.
2006-05-01 16:12:44 +00:00
Gerhard Häring
82560ebb8d
Further integration of the documentation for the sqlite3 module. There's still
...
quite some content to move over from the pysqlite manual, but it's a start now.
2006-05-01 15:14:48 +00:00
Andrew M. Kuchling
e3c958c33b
Some ElementTree fixes: import from xml, not xmlcore; fix case of module name; mention list() instead of getchildren()
2006-05-01 12:45:02 +00:00
Fred Drake
6550f03216
- minor clarification in section title
...
- markup adjustments
(there is clearly much to be done in this section)
2006-05-01 06:25:58 +00:00
Andrew M. Kuchling
09612281ef
Add item
2006-04-30 21:19:49 +00:00
Andrew M. Kuchling
4b5caae8b9
Add urllib2 HOWTO from Michael Foord
2006-04-30 21:19:31 +00:00
Georg Brandl
3c1983face
Patch #1479438 : add \keyword markup for "with".
2006-04-30 19:34:19 +00:00
Georg Brandl
3583cff5a9
Patch #1472854 : make the rlcompleter.Completer class usable on non-
...
UNIX platforms.
2006-04-30 18:14:54 +00:00
Georg Brandl
fa42bd7af4
Patch #1470846 : fix urllib2 ProxyBasicAuthHandler.
2006-04-30 07:06:11 +00:00
George Yoshida
5085fe2bcc
Use \versionchanged instead of \versionadded for new parameter support.
2006-04-30 03:49:56 +00:00
Andrew M. Kuchling
c9236111ed
Add two items
2006-04-30 01:07:09 +00:00
Gerhard Häring
eb2e1926ac
This is the start of documentation for the sqlite3 module. Please feel free to
...
find a better place for the link to it than alongside bsddb & friends.
2006-04-29 23:12:41 +00:00
Andrew M. Kuchling
aa013da0b3
Add item
2006-04-29 12:10:43 +00:00
Andrew M. Kuchling
18db487692
Make case of 'ZIP' consistent
2006-04-29 12:10:28 +00:00
Andrew M. Kuchling
b37bcb59bc
Add item
2006-04-29 11:53:15 +00:00
George Yoshida
f674939a2b
grammar fix
2006-04-29 02:43:30 +00:00
George Yoshida
d77167286f
correct a dead link
2006-04-28 16:40:14 +00:00
Georg Brandl
677800723a
Bug #1475009 : clarify ntpath.join behavior with absolute components
2006-04-28 16:36:55 +00:00
George Yoshida
9dea97a224
fix markup glitch
2006-04-28 16:09:45 +00:00
George Yoshida
8bf939864b
markup fix
2006-04-27 13:41:07 +00:00
Andrew M. Kuchling
efd3a09fad
Mention the xmlrpclib.Error base class, which is used in one of the examples
2006-04-27 12:42:54 +00:00
Andrew M. Kuchling
356f938f94
[Bug #1477140 ] Import Error base class
2006-04-27 12:38:35 +00:00
Andrew M. Kuchling
7acb7b40ba
[Bug #1477102 ] Add necessary import to example
...
This may be a useful style question for the docs -- should examples show
the necessary imports, or should it be assumed that the reader will
figure it out? In the What's New, I'm not consistent but usually opt
for omitting the imports.
2006-04-27 12:34:39 +00:00
Andrew M. Kuchling
99714cf9d0
Bump document version
2006-04-27 12:23:07 +00:00
Andrew M. Kuchling
1e649be16e
Now that 2.5a2 is out, revert to the current date
2006-04-27 12:22:37 +00:00
Anthony Baxter
c7d00327ab
2.5a2
2006-04-27 02:11:24 +00:00
Fred Drake
4b8ec63114
add missing word
2006-04-27 00:20:14 +00:00
Fred Drake
dbb8c4123f
- update version numbers in file names again, until we have a better way
...
- elaborate instructions for Cygwin support (closes SF #839709 )
2006-04-27 00:02:24 +00:00
Fred Drake
0999433f40
one more place to use the current Python version
2006-04-26 23:40:32 +00:00
Andrew M. Kuchling
98189244a2
Add labels to all sections
2006-04-26 12:23:39 +00:00
Andrew M. Kuchling
7e5abb9d1f
[Bug #1475080 ] Fix example
2006-04-26 12:21:06 +00:00
Nick Coghlan
790c3c1377
Fix an error in the last contextlib.closing example
2006-04-26 11:50:04 +00:00
Fred Drake
a5f1fd09eb
minor adjustment suggested by Peter Gephardt
2006-04-26 05:19:39 +00:00
Fred Drake
2afbf96f53
markup fixes, cleanup
2006-04-26 05:15:41 +00:00
George Yoshida
3bbbc49060
minor tweak
2006-04-25 14:09:58 +00:00
Andrew M. Kuchling
d798a181ab
Rework context terminology
2006-04-25 12:47:25 +00:00
Andrew M. Kuchling
b33842ac51
Add two items; easy_install is now off the table, though pkgutil still is
2006-04-25 12:31:38 +00:00
Thomas Wouters
34a70c6011
Fix markup glitch in unittest docs. Will backport.
2006-04-25 12:28:56 +00:00
Nick Coghlan
e708cf5d0f
Fix latex typo
2006-04-25 11:05:56 +00:00
Nick Coghlan
a7e820a408
Move the PEP 343 documentation and implementation closer to the
...
terminology in the alpha 1 documentation.
- "context manager" reverts to its alpha 1 definition
- the term "context specifier" goes away entirely
- contextlib.GeneratorContextManager is renamed GeneratorContext
There are still a number of changes relative to alpha 1:
- the expression in the with statement is explicitly called the
"context expression" in the language reference
- the terms 'with statement context', 'context object' or 'with
statement context' are used in several places instead of a bare
'context'. The aim of this is to avoid ambiguity in relation to the
runtime context set up when the block is executed, and the context
objects that already exist in various application domains (such as
decimal.Context)
- contextlib.contextmanager is renamed to contextfactory
This best reflects the nature of the function resulting from the
use of that decorator
- decimal.ContextManager is renamed to WithStatementContext
Simple dropping the 'Manager' part wasn't possible due to the
fact that decimal.Context already exists and means something
different. WithStatementContext is ugly but workable.
A technically unrelated change snuck into this commit:
contextlib.closing now avoids the overhead of creating a
generator, since it's trivial to implement that particular
context manager directly.
2006-04-25 10:56:51 +00:00
Neal Norwitz
327ea38cc4
Revert previous change, SKIP had a versionadded elsewhere
2006-04-25 05:49:42 +00:00
Neal Norwitz
85c767ac87
versionadded for SKIP
2006-04-25 05:04:35 +00:00
Tim Peters
711bf30b89
Patch #1475231 : add a new SKIP doctest option, thanks to
...
Edward Loper.
2006-04-25 03:31:36 +00:00
Andrew M. Kuchling
0a7ed8c2d3
Edits, using the new term
...
'context specifier' in a few places
2006-04-24 14:30:47 +00:00
Nick Coghlan
877cf234c9
Change PEP 343 related documentation to use the term context specifier instead of context object
2006-04-24 04:17:02 +00:00
Tim Peters
8dc73d2dc6
Bug #1337990 : clarified that `doctest` does not support examples
...
requiring both expected output and an exception.
I'll backport to 2.4 next.
2006-04-24 02:03:16 +00:00
Andrew M. Kuchling
d4c2177b78
Add two items
2006-04-23 21:51:10 +00:00
Andrew M. Kuchling
edb575e758
Edits to the PEP 343 section
2006-04-23 21:01:04 +00:00
Skip Montanaro
9ab2f453ac
it's always helpful if the example works...
2006-04-23 19:30:50 +00:00
Skip Montanaro
56a3706fcd
minor tweak
2006-04-23 19:26:33 +00:00
Skip Montanaro
47767c3b17
first cut at trace module doc
2006-04-23 19:14:27 +00:00
Nick Coghlan
09b1bc39e7
Take 2 on mentioning the with statement, this time without inadvertently killing the Unicode examples
2006-04-23 16:35:19 +00:00
Nick Coghlan
e0ea50bc3b
Add a (very) brief mention of the with statement to the end of chapter 8
2006-04-23 16:05:04 +00:00
Nick Coghlan
fee3dfc061
Update with statement documentation to use same terminology as 2.5a1 implementation
2006-04-23 15:39:16 +00:00
Nick Coghlan
5ef9d9fdb9
Update contextlib documentation to use the same terminology as the module implementation
2006-04-23 15:14:37 +00:00