Commit Graph

7826 Commits

Author SHA1 Message Date
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
Nick Coghlan 84faa85775 Add a Context Types section to parallel the Iterator Types section (uses the same terminology as the 2.5a1 implementation) 2006-04-23 15:13:32 +00:00
George Yoshida a1d3b1011e wrap SyntaxError with \exception{} 2006-04-23 09:27:10 +00:00
Greg Ward ab05edc0d1 Update optparse to Optik 1.5.1. 2006-04-23 03:47:58 +00:00
George Yoshida 51a23fe266 - add versionadded tag
- make arbitrary arguments come last
2006-04-22 15:27:14 +00:00
George Yoshida 3c134a2046 Typo fixes 2006-04-22 15:10:49 +00:00
Neal Norwitz 8694a6db0e Add libctypes as a dep 2006-04-22 06:07:46 +00:00
Andrew M. Kuchling 1da4a94719 Add Gregory K. Johnson's revised version of mailbox.py (funded by
the 2005 Summer of Code).

The revision adds a number of new mailbox classes that support adding
and removing messages; these classes also support mailbox locking and
default to using email.Message instead of rfc822.Message.

The old mailbox classes are largely left alone for backward compatibility.
The exception is the Maildir class, which was present in the old module
and now inherits from the new classes.  The Maildir class's interface
is pretty simple, though, so I think it'll be compatible with existing
code.

(The change to the NEWS file also adds a missing word to a different
news item, which unfortunately required rewrapping the line.)
2006-04-22 02:32:43 +00:00
Andrew M. Kuchling 3ccdb6ab36 Typo fixes 2006-04-22 01:51:41 +00:00
Phillip J. Eby a93ee47422 Guido wrote contextlib, not me, but thanks anyway. ;) 2006-04-21 21:53:37 +00:00
Thomas Heller 9f7e58afa7 Documentation for ctypes.
I think that 'generic operating system services' is the best category.
Note that the Doc/lib/libctypes.latex file is generated from reST sources.
You are welcome to make typo fixes, and I'll try to keep the reST sources
in sync, but markup changes would be lost - they should be fixed in the tool
that creates the latex file.
The conversion script is external/ctypes/docs/manual/mkpydoc.py.
2006-04-21 18:29:17 +00:00
George Yoshida cd84b92f08 Correct the grammar 2006-04-21 16:34:17 +00:00
George Yoshida 0d840285c7 Fix a markup.
This generated a ugly code, "P>".
2006-04-21 16:21:12 +00:00
Andrew M. Kuchling e78eeb1544 Add item 2006-04-21 13:26:42 +00:00
Andrew M. Kuchling fb08e73714 Add \label to make better HTML filenames 2006-04-21 13:08:02 +00:00
Andrew M. Kuchling 42c6e2f6b2 Add two items; typographical improvement for the 'with' statement; minor edits 2006-04-21 13:01:45 +00:00
Andrew M. Kuchling ba67a8a202 Typo, grammar fixes. This file could use another proofreading pass. 2006-04-21 12:58:30 +00:00
Andrew M. Kuchling 3a7b58e9ad Add TODO item 2006-04-21 12:57:58 +00:00
Andrew M. Kuchling 84a7ee7e91 Typo fixes 2006-04-21 12:38:41 +00:00
Skip Montanaro 262fb9256b Allow pstats.Stats creator to specify an alternate to stdout. 2006-04-21 02:31:07 +00:00
Andrew M. Kuchling 3b675d299c Change a footnote to a parenthetical (in two senses) paragraph 2006-04-20 13:43:21 +00:00
Andrew M. Kuchling af015cfcbf Argh, make another markup fix 2006-04-20 13:39:40 +00:00
Andrew M. Kuchling 33432183d8 Markup fix 2006-04-20 13:38:36 +00:00
Andrew M. Kuchling 63fe9b5ae2 Add some items; add "New module" consistently; make contextlib.closing example more interesting and more correct (thanks Gustavo!); add a name 2006-04-20 13:36:06 +00:00
Skip Montanaro 94785ef142 Correct implementation and documentation of os.confstr. Add a simple test
case.  I've yet to figure out how to provoke a None return I can test.
2006-04-20 01:29:48 +00:00
Andrew M. Kuchling 6719131129 Write datetime.strptime() item; show use of @contextmanager in defining __context__ methods; minor edits; add two names 2006-04-19 12:55:39 +00:00
George Yoshida e7670a329e fix typo 2006-04-18 16:18:15 +00:00
Andrew M. Kuchling 952f196ae7 Add item 2006-04-18 12:38:19 +00:00
Martin v. Löwis bd30f52881 Patch #790710: Add breakpoint command lists in pdb. 2006-04-17 17:08:37 +00:00
George Yoshida 297bf82920 fix long option markup 2006-04-17 15:44:59 +00:00
Andrew M. Kuchling 0d660c0236 Update status of document 2006-04-17 14:01:36 +00:00
Andrew M. Kuchling f7823a341c Remove translated code hidden inside a comment environment; latex2html gets confused and includes half of it anyway 2006-04-17 14:00:31 +00:00
Andrew M. Kuchling 45bb98e8b9 Add item 2006-04-16 19:53:27 +00:00
Andrew M. Kuchling de0a23f74c Describe contextlib module. (Done for today...) 2006-04-16 18:45:11 +00:00
Andrew M. Kuchling d058d0036a Write most of the 'writing context managers' section. I'd like comments on it,
but wait for a few hours before you read it; I'm still revising it
    and will be tackling contextlib next.
Untabify
2006-04-16 18:20:05 +00:00
Andrew M. Kuchling 29b3d08604 Add an item; better crediting; fix error in SQL example; minor edits 2006-04-14 20:35:17 +00:00
Andrew M. Kuchling 8ed29143fc Typo fix 2006-04-14 20:32:36 +00:00
Martin v. Löwis 82972e7f01 Patch #702933: Undocument PyObject_NEW, PyObject_NEW_VAR,
and PyObject_DEL.
2006-04-14 15:58:03 +00:00
Andrew M. Kuchling 121c98cce1 Typo fixes 2006-04-14 12:42:09 +00:00
Andrew M. Kuchling c7095843ae Add more items 2006-04-14 12:41:19 +00:00
Andrew M. Kuchling 984bdd759e Typo fix 2006-04-14 12:07:41 +00:00
Andrew M. Kuchling 75ba244c7b Add an item and a reminder 2006-04-14 10:29:55 +00:00
Gregory P. Smith 3adc4aa2fb raise the minimum supported BerkeleyDB version to 3.3 and add notes to
news about this and a couple other recent fixes.
2006-04-13 19:19:01 +00:00
Andrew M. Kuchling 5d4cf5ecc1 Typo fix 2006-04-13 13:02:42 +00:00
Andrew M. Kuchling 3b4fb041df [Bug #1464571] Mention that generator's .gi_frame can now be None 2006-04-13 12:49:39 +00:00
Andrew M. Kuchling 6fc6976507 Add some items 2006-04-13 12:37:21 +00:00
Andrew M. Kuchling 0f1955daee Include more detail on Coverity results and add a link; minor edits 2006-04-13 12:09:08 +00:00
Andrew M. Kuchling 61434b6d51 Describe sys.subversion, Py_GetBuildInfo()
Add metadata example
2006-04-13 11:51:07 +00:00
Andrew M. Kuchling aa571c9a0a Add missing word 2006-04-13 11:40:29 +00:00
Georg Brandl 9d548374e4 Add two entries about how to actually clear a list. 2006-04-13 08:04:56 +00:00
Martin v. Löwis bb30011880 Stop claiming that Py_Finalize releases all memory.
Fixes part of #1445210.
2006-04-13 07:28:29 +00:00
Neal Norwitz 5f5a69ba9d Fix {} mismatch spotted by George Yoshida. 2006-04-13 03:41:04 +00:00
Andrew M. Kuchling b66871f1c0 Fix typography of Martin's name 2006-04-13 02:10:16 +00:00
Andrew M. Kuchling 28c5f1fa16 Write some ctypes examples 2006-04-13 02:04:42 +00:00
Andrew M. Kuchling 5f445bf3df Mention ASCII as default encoding; update TODO list; use PyCF_ONLY_AST by MvL's suggestion; typographical tidying of MvL's name 2006-04-12 18:54:00 +00:00
Andrew M. Kuchling 8872dbff99 Bump version number; rearrange introduction a bit 2006-04-12 18:52:09 +00:00
Andrew M. Kuchling 6a67e4ead4 Add PEP 243 section 2006-04-12 13:03:35 +00:00
Andrew M. Kuchling f7c6290ca4 Note C API incompatibilities 2006-04-12 12:27:50 +00:00
Andrew M. Kuchling 4e86195a99 Mention access to ASTs 2006-04-12 12:16:31 +00:00
Andrew M. Kuchling 075e0231f1 Complete the ElementTree section 2006-04-11 13:14:56 +00:00