expand section on cython -a output

* explain new "+" signs in front of lines
* explain different shades of yellow
* relation to nogil blocks
Merge pull request #323 from larsmans/annotation-docs

expand doc section on cython -a output