Added Pin.readPulse documentation

Make sure it's got everything you want/need and let me know if there's anything you would like to change/add.