added an explanation of block models
added doc on the pkg modeling.
I even had to look at the cmake code to figure some of these things out!