document the doctrine compiler pass

documentation for https://github.com/symfony/symfony/pull/7599

not sure if this should go to master or the 2.2 branch? the feature is not yet merged.