1) added clarifying notes 2) added an example for stackoverflow question about package private methods