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.