annotation improvement

A few days ago I committed a patch with which I tried to improve the
coordinate handling of annotation.
And I updated the annotation guide which describes the change in some detail.

And here is an example

I hope this is useful for others as this has been one of my wishlist.