updated readme to includes "self" in postMessage examples. General update to pmapi.js
added a few comment fixes, added missing functions, added new demo page