Document reflection

Added some class description to the 3 objects used in reflection.
Tried to explain as much of the design as I could but had to leave
some out as I didn't fully understand it (put a TODO for this instead).

Also touched a bit the code to better match the intent: some paint
flags were set in a caller instead of in PaintLayerReflectionInfo or
a function never called wasn't marked as such.

Review URL: https://codereview.chromium.org/1391943005

Cr-Commit-Position: refs/heads/master@{#353920}
7 files changed