This patch fixes decorator evaluation order
and makes newlines between decorators
mandatory.

Changes in this patch:

     - Change Grammar/Grammar to require
       newlines between adjacent decorators.
       
     - Fix order of evaluation of decorators
       in the C (compile.c) and python
       (Lib/compiler/pycodegen.py) compilers
     
     - Add better order of evaluation check
       to test_decorators.py (test_eval_order)

     - Update the decorator documentation in
       the reference manual (improve description
       of evaluation order and update syntax
       description)

The order of evaluation issue is slightly
more subtle than it first appears - there
are two orders involved:

    - evaluation of decorator expressions
    - evaluation of the returned decorators

This patch arranges for the evaluation order
to be exactly the same as you get with the
manual way of writing decorators, which I
think is the least surprising way of doing
things.

Logged In: YES 
user_id=1017234

Used Brett's evaluation order (see
http://mail.python.org/pipermail/python-dev/2004-August/047835.html)

Logged In: YES 
user_id=6656

Anthony couldn't get SF CVS to talk to him, so I've checked
this in as

Doc/ref/ref7.tex revision 1.40
Grammar/Grammar revision 1.51
Lib/compiler/pycodegen.py revision 1.72
Lib/compiler/transformer.py revision 1.43
Lib/test/test_decorators.py revision 1.5
Modules/parsermodule.c revision 2.84
Python/compile.c revision 2.319
Python/graminit.c revision 2.37