cpython/Doc/ref
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
..
ref.tex Oops. License is still an appendix. 2003-05-28 12:12:55 +00:00
ref1.tex add information about alternate implementations, noting that documentation 2005-07-20 04:33:01 +00:00
ref2.tex Remove dots in \version{changed,added} argument and 2006-01-15 07:55:35 +00:00
ref3.tex Move the PEP 343 documentation and implementation closer to the 2006-04-25 10:56:51 +00:00
ref4.tex wrap SyntaxError with \exception{} 2006-04-23 09:27:10 +00:00
ref5.tex Note version added for conditional expressions 2006-02-27 16:31:12 +00:00
ref6.tex Yield is now allowed in try-finally, so update docs accordingly 2006-03-25 00:46:43 +00:00
ref7.tex Move the PEP 343 documentation and implementation closer to the 2006-04-25 10:56:51 +00:00
ref8.tex Change the grammar productions to use the new productionlist environment; 2001-07-06 22:49:53 +00:00
reswords.py Whitespace normalization, via reindent.py. 2004-07-18 06:25:50 +00:00