Note that for the current releaesed alpha revision of the PDK, a final pass has not been done on the header files to ensure that all comments are accurate/up to date. In addition, there is obviously a lot that has not been explained or has been glossed over.
So to clarify, ask away!