wrote docs for functions starting with "P"