added some explanatory comments
Merge remote-tracking branch 'upstream/master'