[master] + add some comments
[master] Add additional documentation (so we don't forget what the hell is going on here).

Fix issue with PoolSlice.elementCount() were wrong values would be calculated in the case where the array being used was equal to STRIDE (16).  The fix may not be optimal (i.e., there may be a way to make it branch-less).
[master] Minor comment touch-up.